CodeWhale v0.8.46 发布 —— 环境变量换名、安装包集成、改名后的第一波问题清单

v0.8.46 就是这个版本的「后遗症清理」。改名以来所有被忽略的角落，这次基本都走到了。

最大的痛点：环境变量到底叫什么

改名才没几天，CodeWhale 终于有了自己的环境变量体系。CODEWHALE_PROVIDER、CODEWHALE_MODEL、CODEWHALE_BASE_URL 三个新变量正式上线，优先级高于旧的 DEEPSEEK_* 变体。

说实话，这个改动看起来只是改了个前缀，但它解决了一个真实的问题：新用户进项目后，如果 README 里写的还是 DEEPSEEK_*，第一反应一定是「这个项目是不是没人维护了」。CODEWHALE_* 变量上线意味着一个至今没被注意到的小尴尬被清掉了——你可以用纯 CodeWhale 的名词体系完成所有配置，不需要知道它前身叫什么。

旧变量当然没删——DEEPSEEK_* 继续兼容。这种「双轨制」在新老交替的窗口期是最顺滑的过渡方式：老用户不动配置，新用户不用学习历史知识。

安装体验：不再需要猜哪个文件

改名后另一个隐蔽的后遗症是安装。之前 release page 上每个平台散落着 codewhale-linux-x64 和 codewhale-tui-linux-x64 两个独立文件，新用户只下载了 dispatcher 没下 TUI，一启动就报 companion binary 缺失。

v0.8.46 做了平台归档包（#2193）：Linux/macOS 一个 tar.gz 打包两个二进制加安装脚本，Windows 一个 .zip 全部带走，外加一个便携版适合 U 盘分发。下载页面也换了——现在自动检测你的架构、显示 SHA256 校验和、提供中国镜像链接（#2192）。

有意思的是，npm 包安装脚本也一起修了（#2191）。之前 npm 包在下载阶段有时只把 dispatcher 拉下来但漏了 TUI，新用户一个 npm install -g codewhale 以为装好了，打开一看 MISSING_COMPANION_BINARY。现在两个二进制一起拉齐，不用再二次排查。

两个 TUI 日常痛点的回应

子智能体自动折叠（#2195）。长会话里 delegate 出去的 agent 在 sidebar 占一长条，session 越久越乱。现在做完的自动折叠成一个头部，不会堆满侧边栏。对比以前「一条一条手动收起」的体验，现在是「不操心」。

Shell 运行状态芯片（#2194）。后台跑 shell 任务时底部多了一个 ⏳ shell running 的标记。之前你开个 docker compose up 放在后台，切去写别的 prompt，过一会儿回来完全忘了后台还有东西在跑。看到芯片你就知道：哦对，还挂着。小改动，但每天用 TUI 拼代码的人大概率用过「忘了」这个状态。

修复里的高光

Model 名称大小写保留（#2109）。normalize_model_name_for_provider 之前一律小写所有 model 名，DeepSeek-V4-Flash 被转成 deepseek-v4-flash，某些大小写敏感的 API 后端直接 404。大部分人不设置自定义 model 名不会碰到，但如果你手动指定了特定型号，之前是必踩的坑。

grep_files 跳过大型目录。.git、node_modules、target 三个目录被加入跳过列表。如果你的项目装了几十个依赖，grep 十几秒卡在 node_modules 里动不了的情况应该不陌生。现在扫文件之前先跳过已知的深度目录，代价不大，但受益的人不少。

版本检测用 semver 了。0.8.10 > 0.8.9——这个比较之前走的是字符串字典序，所以 0.8.10 < 0.8.9，永远检测不到跨版本更新。现在用语义化版本比较，修了。

CVE-2026-8723。飞书桥接的 qs 依赖升到了 >=6.15.2（#2198）。安全更新，一行修一个 CVE。

改名之后的方向：DeepSeek 优先

CHANGELOG 里有一条很短的 Change：v0.8.46 重新聚焦 DeepSeek，先在 DeepSeek 上交付最好的体验，其他第一方 provider 规划在 v0.9.0。这跟上个版本「去掉 Moonshot branding 但完善后端」的操作一脉相承——CodeWhale 在对外宣传时把自己定位为 DeepSeek V4 的专属 harness，但内部保留了 provider 灵活性。只是优先级变了。

升级

npm install -g codewhale
# 或已安装用户
codewhale update

完整更新日志：GitHub Release

📢 关注我，获取最新开源更新日志和开发者工具动态。

#CodeWhale #AI开发 #终端工具 #DevTools #DeepSeek