本周发布平稳——安装路径和贡献指南已同步。
本「今日要闻」由 DeepSeek V4-Flash 每六小时重新生成。在 cron 写入真实仓库动态之前，下面的固定链接是最实用的入口。
开源 · 任意模型 · 运行在你的终端
编码智能体运行在代码之上。CodeWhale 还运行在法典之上。
CodeWhale 是一个开源的终端编程智能体——一个 TUI，一个 CLI——适配任意模型，DeepSeek 与开放权重模型享有一级支持。指令总在堆积、彼此冲突：过时的规格、陈旧的交接、你此刻的要求、刚跑出的测试结果。多数智能体靠猜来化解；CodeWhale 靠位阶来裁决——一部嵌套的宪法：内置的基础法、你的常备规则、仓库自己的法。由执行框架强制生效，换掉模型也不失效。
由 Hmbown 维护·v0.8.68·30 个提供商·MIT
看它如何裁决
codewhale — thinking
推理痕迹# 当上一会话的总结与仓库真实状态不符时……
› Let me be careful and truthful here. Per Article II (truth) and V (verification), I need to report what's actually in the tree — not what the previous agent claimed.
Article II · TruthArticle V · Verification
→ 如实报告了总结遗漏的未提交改动，而不是照搬旧说法。
›
摘自真实会话的忠实片段——宪法可以在模型的推理里被直接观察到，而不是落地页上的一句宣称。
实 时LIVE
PR#4352feat: add MiniMax Messages-compatible route· 37m◆ISS#3915ux(skills): `$skill <task>` and `/<skill> <task>` silently discard the task te…· 4h◆ISS#4335Make offline scorecard pricing provider-aware· 9h◆ISS#4329Anthropic API error· 13h◆PR#4351fix(scorecard): bind costs to provider routes· 15h◆ISS#4350Cargo Build in android with termux meet rquickjs doesn't ship bindings for pla…· 22h◆ISS#4227feat: 🐋 help JayBeest map the CodeWhale tsunami 🌊· 23h◆PR#4349Update Cargo.toml to allow build under NetBSD· 23h◆PR#4348fix(tui): bill Anthropic cache-write tokens at published rates (#4318)· 1d◆PR#4347i18n: add Korean (ko) locale support· 1d◆PR#4346fix: sanitize tool input_schema for Anthropic adapter· 1d◆ISS#4345key 太不友好了，不能放在终端进行吗？· 1d◆PR#4352feat: add MiniMax Messages-compatible route· 37m◆ISS#3915ux(skills): `$skill <task>` and `/<skill> <task>` silently discard the task te…· 4h◆ISS#4335Make offline scorecard pricing provider-aware· 9h◆ISS#4329Anthropic API error· 13h◆PR#4351fix(scorecard): bind costs to provider routes· 15h◆ISS#4350Cargo Build in android with termux meet rquickjs doesn't ship bindings for pla…· 22h◆ISS#4227feat: 🐋 help JayBeest map the CodeWhale tsunami 🌊· 23h◆PR#4349Update Cargo.toml to allow build under NetBSD· 23h◆PR#4348fix(tui): bill Anthropic cache-write tokens at published rates (#4318)· 1d◆PR#4347i18n: add Korean (ko) locale support· 1d◆PR#4346fix: sanitize tool input_schema for Anthropic adapter· 1d◆ISS#4345key 太不友好了，不能放在终端进行吗？· 1d◆
三层法
v0.8.67 新增：宪法优先设置01
内置宪法
编译进每一个二进制
基础法。其中的位阶条款为一切冲突固定裁决顺序。
02
/constitution
$CODEWHALE_HOME/constitution.json
你的常备法——首次启动引导起草，模型可以代拟，由你批准，跨项目生效。
03
仓库自己的法
.codewhale/constitution.json
受保护的不变量、分支策略、验证要求、升级条件——位阶高于项目说明、记忆与交接。
审批、沙箱、网络与信任控制由代码强制执行——宪法文本永远越不过它们。
为什么是法 →Stars · 星标
39.7k
Forks · 复刻
3.4k
Contributors · 贡献者
177
Latest · 版本
v0.8.67
怎么开始
三步：装好、配一个模型密钥、在项目里运行。每一步的细节都在安装指南里。
最近在发生什么
仓库近期活动
- PR#4352feat: add MiniMax Messages-compatible route
- ISS#3915ux(skills): `$skill <task>` and `/<skill> <task>` silently discard the task text
- ISS#4335Make offline scorecard pricing provider-aware
- ISS#4329Anthropic API error
- PR#4351fix(scorecard): bind costs to provider routes
- ISS#4350Cargo Build in android with termux meet rquickjs doesn't ship bindings for platform `aarch…
需要帮助？
安装与配置
每种安装方式、密钥设置、沙箱、CNB / 清华 Tuna 国内镜像、常见报错排查。
安装指南 →常见问题
模型、提供商、模式、MCP、技能、配置文件位置等高频问题。
FAQ →提议题或 PR
遇到 bug 或有想法，直接在 GitHub 开 issue 或 pull request。维护者会亲自看。
参与贡献 →国内镜像 / China mirrors
npm 安装时可设 CODEWHALE_USE_CNB_MIRROR=1，wrapper 会改从 CNB 下载二进制。DeepSeek API（api.deepseek.com）国内直连，无需代理。
v0.8.68 致谢
每个补丁和报告都算数
这一版合并和吸收了来自社区的大量工作。完整条目在 CHANGELOG 中；这里保留最新发布的公开致谢入口。
已合并 / 已吸收贡献
@1Git2Clone@cy2311@LING71671@axobase001@dzyuan@mvanhorn@malsony@manaskarra@gaord@yuanchenglu@idling11@h3c-hexin@AdityaVG13@Sskift@cyq1017@HUQIANTAO@New2Niu@AiurArtanis@Lee-take@nightt5879@AresNing@AccMoment@reidliu41@aboimpinto@zhuangbiaowei@donglovejava@hongqitai@zlh124@encyc@Implementist@lihuan215@LeoAlex0@jimmyzhuu@rockyzhang@mo-vic@hufanexplore@hoclaptrinh33@quentin-lian@BryonGo
CodeWhale 不做什么
有些边界值得写清楚。下面每一条都对这份代码库为真，可以在源码里核对——不是营销措辞。
✗
不需要云账号
在你的机器上本地运行，无需注册 CodeWhale 账号。本地 vLLM / Ollama 模型连密钥都不用。
✗
不收集你的代码
你的代码和使用数据都留在本机，没有任何分析上报。唯一自发的网络请求是一个可关闭的新版本检查，不发送任何代码。
✗
不加推理差价
自带密钥，请求直连你配置的提供商，按提供商的价格计费。没有中间代理，没有加价。
✗
不要求 CLA
贡献即 MIT 进、MIT 出。没有贡献者许可协议，也不需要签署版权转让。
✗
不悄悄换模型
你选的模型就是运行的模型。切换是显式命令；自动路由需手动开启，并会显示所选路由。
✗
法典越不过运行时控制
审批、沙箱、网络与信任由代码强制执行。任何法典文本——内置的、你的、或仓库的——都无法放松它们。
最后一条是根本性的，而且可验证——由执行框架的代码强制生效。 阅读宪法 →
这个项目
来自世界各地的开发者，把 CodeWhale 变成了今天的样子。
CodeWhale 起于一个人的 DeepSeek 业余项目，来自许多国家的贡献者把它塑造成了现在的样子——每一版发布上的贡献者名单就是证据。这里没有 CLA，没有赞助商优先通道，议题公开分类，版本从 main 分支发布。
「所有反馈都是礼物。」——这是我教书时很早就学到的一句话，也是我维护 CodeWhale 的方式。每一个 issue、PR、bug 报告或想法，都是我理解真实使用场景、做出更好决策的方式。
如果你遇到用不了的地方，或者想要一个没列出来的模型——那是你能告诉这个项目的最有用的事。
版本0.8.68
提供商30
许可证MIT