图解 Agent 系统

Kimi Code 来源记录 ​

  • 对象与版本：新版 MoonshotAI/kimi-code 的完整提交 75a894e9ad5e8d49509664b3daaa1bbc9bb39432（上游提交日期 2026-06-09；本书核对 2026-09-23）。旧 kimi-cli 不是本篇对象。
  • 取得方式：通过 GitHub 提交页与 raw.githubusercontent.com 读取固定提交的文件；未克隆或运行上游项目。上游 README 将其定位为终端编码 Agent；AGENTS.md 的模块地图将 agent-core 称为统一引擎。
  • 许可与维护：固定版 LICENSE 为 MIT；上游仓库目前可访问，当前发布二进制与该提交的对应关系未核查。正式发布前仍需人工许可与链接终审。
  • 核心源码：packages/agent-core/src/agent/turn/index.ts 的 prompt/steer（120–180）、取消与缓冲（205–279）、runOneTurn（415–510）、runStepLoop 与权限回调（563–718）；packages/agent-core/src/loop/run-turn.ts 的步数、工具续跑与停止检查（74–128）。
  • 文档声明：官方会话与子 Agent文档仅列作后续阅读；本文不据此声称已审计持久化或上下文隔离。
  • 证据等级：主篇与图中的 steer → 缓冲 → step 边界刷新 → 继续/停止 为固定版源码事实；“互动性放在 step 边界”及等待时延的解释为工程推断；CLI 接线、实际延迟、发布版适用性为未知。无产品端到端运行观察。
  • 本书复跑的有限测试（2026-09-24）：在固定提交的稀疏检出中，用 Node 24.19.0、pnpm 10.33.0、pnpm install --filter @moonshot-ai/agent-core... --frozen-lockfile --ignore-scripts 后运行 pnpm -C packages/agent-core exec vitest run test/agent/turn.test.ts test/loop/turn-lifecycle.e2e.test.ts test/loop/abort.e2e.test.ts，结果为 3 个文件、68 个测试通过。其中 turn.test.ts 的 steer/审批用例 使用 mock LLM 与命令执行器，断言等待审批时的 steer 进入同一 turn 的下一步。这只是在本地复跑上游的受控测试，不是实际 CLI、网络模型、并发时延或发布二进制的端到端验证。

在线预览稿：书稿仍在校稿，系统篇以文内固定源码版本为准；静态阅读不等于运行验收。