13. 最终源码阅读清单
按顺序逐项勾选。
| 文件或目录 | 关键符号 | 阅读目标 | 预计难度 | 完成标准 |
|---|---|---|---|---|
README.md | 运行命令 | 知道入口 | 低 | 能说出 web/headless |
docs/cordis-primer.md | Service/inject/effect/dispatch | 理解插件框架 | 低 | 能解释 waterfall |
docs/architecture.md | turn flow/seams/extension map | 建立架构图 | 中 | 能画核心流 |
packages/core/README.md | ctx 键 | 认识 spine | 低 | 能背六项核心服务 |
packages/bundle/base/cordis.patch.yml | rows | 认识默认组合 | 中 | 能找到 tools/agent-loop/llm |
apps/cli/src/bin.ts | parseDshArgs/runProfile | 找到入口 | 低 | 能追踪到 boot |
apps/cli/src/profile-boot.ts | composeProfile/runProfile | 理解启动 | 中 | 能说明 patch 顺序 |
packages/core/session/src/types.ts | SessionEventMap | 掌握事件词汇 | 中高 | 能区分 surface/log-only |
packages/core/session/src/index.ts | Session.append/deriveMessages | 理解派生历史 | 高 | 能解释增量投影 |
packages/core/session/src/surface.ts | SurfaceManager | 理解 replace | 高 | 能解释 compaction 投影 |
packages/core/agent/src/runtime-types.ts | Agent/PreStepDecision | 掌握公开接口 | 中高 | 能解释 followup/steer/inject |
packages/core/agent-loop/src/agent.ts | ReactLoopAgent/turn/step | 追踪主循环 | 高 | 能画出时序图 |
packages/core/agent-loop/src/index.ts | AgentLoop/create/resume | 理解生命周期 | 高 | 能解释 teardown |
packages/core/agent-loop/src/tool-calls.ts | executeToolCalls | 理解工具调度 | 高 | 能解释并发决策 |
packages/core/system-prompt/src/index.ts | assemble/section/tools | 理解 prompt 装配 | 中 | 能注册一个 section |
packages/core/tools/src/index.ts | ToolRuntime/register/execute | 理解工具管线 | 高 | 能写一个 tool |
packages/llm/llm/src/index.ts | LlmRuntime/LlmAdapter | 理解模型 seam | 高 | 能接入 adapter |
packages/boot/app-boot/src/profile.ts | loadProfile/composeEntries | 理解配置组合 | 中 | 能写 patch |
docs/cookbook/extension-cookbook.md | feature -> mechanism | 掌握扩展地图 | 中 | 能选扩展点 |
.agents/notes/implemented/architecture/2026-07-19-gui-web-client-architecture.md | object layer/slots | 理解 Web client | 中高 | 能解释三层 |