0. 分析范围与可信度说明
本教程以只读方式分析本地源码 <DEEPSEEK_HARNESS_SOURCE>，锁定 master 提交 4e84901e6471b79ec0338099867ebb4606d12bb5，版本 0.1.2-alpha.4。教程站真源位于 本站工作区；未修改上游仓库及其中现有未跟踪文件。
版本变化
| 项目 | 旧教程基线 | 当前基线 | 结论 |
|---|---|---|---|
| 版本 | 0.1.0-rc.5 | 0.1.2-alpha.4 | 开发预览版本继续演进 |
| 提交 | 47f943859bef60e4160492346772ded9b24f765a | 4e84901e6471b79ec0338099867ebb4606d12bb5 | 全量复核，不只换行号 |
| 变化 | — | 8,212 files；+448,477 / -161,788 | 目录与职责发生实质变化 |
| workspace packages | 221 | 251 | 新包在架构图和源码地图分层说明 |
| Client | client/runtime、client/web-react | api/session-controller、ui-conversation、ui-renderer | 旧路径已移除 |
| 工具程序化调用 | 旧 Code Mode 叙述 | 当前 PTC 调度、日志和错误语义 | 旧 run_code 心智模型废弃 |
实际使用的能力
- 阅读 README、
package.json、lockfile、Profile/Bundle/Patch、源码、测试和中文开发文档。 - 使用
rg、Git 只读命令搜索文件、符号与版本差异。 - 核对 CLI、Session、Agent Loop、System Prompt、LLM、Tools、Session Controller、Conversation Assembler、UI Renderer 的当前入口。
- 用 Archify 根据真实源码证据生成并校验 10 张独立图。
- 【已执行并验证】11 个定向测试文件共 660 个用例通过；
pnpm dsh --help与隔离DSH_HOME的 Web 默认配置 dump 通过。 - 【仓库声明但未执行】真实模型调用、全仓测试、发布与部署流程。
可信度分类
- 【已验证】：由当前提交源码、配置、测试或本轮实际命令直接证明。例如
ReactLoopAgent位于packages/core/agent-loop/src/agent.ts:70，SessionController.page()位于packages/api/session-controller/src/index.ts:369。 - 【合理推断】：基于结构作出的教学归纳，例如把 Client Session 类比前端外部 Store；类比不代表仓库原文。
- 【待确认】：需要真实 API Key、外部服务、用户环境或发布权限的行为。
文档与源码差异
旧教程的主要失配是已移除 Client 包、旧快照职责边界、旧持久化描述和旧 Code Mode 语义。本版以当前源码为准；full.md 不手工编辑，而由分章真源通过 pnpm prepare:learning 生成。
保护边界
上游仓库中已有未跟踪学习文档和 learning/ 目录，它们不属于本站真源，未读取后写回、未删除、未加入 Git。所有教程修改、图规格和 HTML 仅落在学习站仓库。