1. 建议阅读顺序
| 阶段 | 路径 | 为什么 |
|---|---|---|
| 概念 | docs/architecture.zh.md | 先建立全图 |
| 框架 | docs/cordis-primer.md | 理解 Context/Service/Event/Effect |
| 循环 | packages/core/agent-loop/README.zh.md | 知道 turn/step/inbox |
| 状态 | packages/core/session | 理解事件溯源 |
| 能力 | packages/core/tools | 理解工具 schema 与执行 |
| 模型 | packages/llm/llm-deepseek | 理解 wire adapter |
| 启动 | packages/boot/app-boot | 理解配置如何变成插件树 |
2. 仓库的“家族”思维
不要把 packages/ 当成几百个无关 npm 包。按职责看：core 是协议/运行时；llm 是模型 seam；session 是持久数据面；boot 负责装配；preset/context/tool 等家族围绕核心能力扩展；apps 则是产品外壳。
3. 读源码时的四个问题
- 它在
ctx上提供什么 service key？ - 它 inject 哪些依赖？
- 它注册哪些可逆 effect / event listener？
- 它是 service definition、provider 还是 consumer？