读完两代源码，我想聊聊 Kimi Code CLI 的架构取舍

Kimi K3 发布那天，我的时间线被刷屏了，跑分截图和长文解读一茬接一茬。 我在干一件不太合群的事：把同一家公司另一个仓库 clone 下来，读源码。 那个仓库叫 kimi-code，月之暗面的终端 Agent，Kimi Code CLI。读完两代源码，我的结论是：这是国货之光，诚意都写在仓库里。 模型的热闹大家都在看，这个安静的工具却少有人聊。下面只挑读源码时真正让我心动的地方讲。

我先看见的是取舍

我读这个仓库时，最在意的不是功能数量，而是团队主动放弃了什么。 先说开放性。让我意外的不是它支持 MCP 和 ACP，这些在今天的编程 Agent 里是标配，而是团队没有趁机再造一套私有插件格式。skill、MCP server、数据源都从开放标准装进来，来源可以是官方市场，也可以是任意一个 GitHub 仓库。 这个选择换来的工程收益，值得展开说两句。最直接的是隔离：工具跑在 MCP server 的独立进程里，隔着协议和内核通信，工具崩溃、依赖冲突都传不进 Agent 内核，内核也不需要为任何具体工具写一行适配代码。分发成本也被压到很低，skill 就是仓库里的一组文件，装扩展等于 clone 一个 repo，不用打包、签名、过审核，社区里现成的 MCP server 第一天就能接上。还有一笔长期账：插件格式的规范、版本演进和兼容性包袱由开放标准共同承担，团队不用独自养一套私有格式的文档、SDK 和迁移工具。 这会让用户更容易迁移，也意味着工具必须靠体验留人。团队接受了这个风险。 然后是一次很彻底的重写。第一代 kimi-cli 用 Python 开发，已经攒下 9.5k stars。这个体量的项目，继续修补是更容易解释的选择。他们却改用 TypeScript 重写成现在的 kimi-code，同时提供迁移工具，让老用户用一条命令带走配置、MCP 和会话历史。 在已有 9.5k stars 的项目上决定重写，比从零启动更难交代。更打动我的是，他们没有把迁移成本扔给老用户。 开源的处理也类似。kimi-code 采用 MIT 协议，从 Agent 内核到 TUI 都能看到源码，kosong（LLM 抽象层）、kaos 等基础件还被拆成独立包发布。单二进制、毫秒级启动、视频输入这些特性我不展开了。相比功能清单，我更在意这个团队愿意把关键实现放到开发者面前。

再往代码里走一层

我读代码库习惯先找边界。kimi-code 的 packages/ 目录没有让我来回猜：界面、事件流、Agent 内核和模型抽象各自待在自己的位置，依赖关系也能顺着目录读下去。 先上一张全景图： 图：Kimi Code CLI（kimi-code，TypeScript 版）整体架构。官方未提供架构图，本图根据仓库 packages/ 结构与源码整理绘制。 kimi-code 的 Agent 内核不直接画界面，只对外吐一条 wire 事件流。TUI 和 Web 界面消费这条流，IDE 则通过适配层接进来。它们共用一套内核，不需要互相知道对方的存在。这个边界的好处在加新前端时最明显：内核一行不用改，新界面只要会消费事件流就能接上。排查问题也省力，事件流就是内核和界面之间的完整对账单，bug 落在哪一侧，对着流看一眼就知道。 会话本身也是 wire.jsonl 事件日志。回放日志就能恢复现场，持久化和调试因此落在同一套机制里。含金量在出问题时才显出来：复现 bug 不需要用户描述操作步骤，一份 wire.jsonl 扔过来，本地回放就能停在出错前的任意一刻；进程崩溃后的恢复也不用单写快照逻辑，重放日志本身就是恢复。事件溯源在教科书里讲了很多年，在一个终端工具中看到这么完整的实现，我停下来读了好一会儿。 长会话的处理是另一个细节。coder、explore、plan 各自持有独立上下文，完成任务后只把结论交回主对话。中间的搜索和尝试不会全部挤进主上下文，这比单纯调大上下文窗口更合我的胃口。真正的收益是主对话的信噪比不随任务变长而衰减：explore 翻过的几十个文件、coder 失败的中间尝试，都在各自的上下文里生灭，主对话只沉淀结论。长任务后期模型「忘了最初要干什么」的老毛病，很大程度上就是被这个结构压住的。 把镜头再拉远，packages/ 下能看到 agent-core、kosong、kaos、acp-adapter 和 protocol。它们各自有版本和文档，不只是为了整理目录才拆开。拆开的实际好处是复用和替换有了边界：想在自己的项目里拿 kosong 做模型层抽象，不必背走整个 CLI；内核迭代时，protocol 包锁住的接口契约也让各端不至于跟着一起震动。知乎上有工程师评价这套代码「质量非常高，值得研读」。我读过之后，基本同意。

代码里的浪漫

架构之外，这个团队还藏了些彩蛋。 第一代 kimi-cli 的 checkpoint 回滚机制叫 D-Mail，取自《命运石之门》里往过去发送的短信。回滚会话状态，可不就是给过去的自己发一条消息吗。 再往下翻还有：第一代用 Python 类型注解做工具依赖注入，inspect.signature 读函数签名自动装配，没有引任何重型框架；第二代换成 pnpm monorepo，oxlint、vitest、changesets 摆得整整齐齐。语言换了，那股认真劲儿没换。

写在最后

「国货之光」这个词被用滥了，这次我用得心安理得。MIT 协议下完全摊开的代码，拆出来回馈社区的基础件，给老用户修好的迁移之桥，这些都不是口号，是仓库里看得见的东西。 想上手的，官网一行命令的事。我真正想安利的是把源码 clone 下来读一读，看看一个认真的工程团队，是怎么把诚意写进每一个 commit 的。