从零到一：DeepSeek Harness 完整学习路径
本路径与 七天学会 DeepSeek Harness Day 1–7 逐日对齐。每日含 Morning / Afternoon / Evening 三段学习、挑战任务、验收标准 与 实验室链接。建议文档学习与动手实验比例约 四六开。
学习路径总览
| Day | 主题 | 核心产出 | 实验室 |
|---|---|---|---|
| 1 | Harness 架构与 Cordis | 跑通 Web UI，画出组件图 | 内核可视化器 |
| 2 | 插件系统 | 最小插件 mount/unmount | 泄漏调试 |
| 3 | 四种预设 | 预设对比报告 | 预设实验室 |
| 4 | 工具与安全 | 审批矩阵草案 | 审批模拟器 |
| 5 | Session 与可观测 | Resume/Fork 实操 | learn Day5 |
| 6 | 多 Agent | Spawn 子任务实验 | learn Day6 |
| 7 | 开发发布 | 发布 dsh-plugin | 社区 |
开课前准备
| 项目 | 要求 |
|---|---|
| 环境 | Node >= 18，Git，编辑器 |
| 账号 | 模型 API Key（DeepSeek 或兼容 OpenAI） |
| 时间 | 每日约 3–4 小时 × 7 天 |
| 阅读 | 入门、快速开始 |
Day 1：Harness 架构认知与 Cordis 内核
当日目标
理解 Agent = Model + Harness。完成当日学习后，你应能独立说明该主题在 Cordis 运行时中的位置，并与 开发指南 术语一致。
Morning（09:00–12:00）— 理论建构
Morning 段聚焦读与讲：先读文档，再对照官方架构。Day 1 推荐阅读 入门介绍（Day1）、开发指南（Day2+）、最佳实践（Day4+）相关章节。
深入讲解（Day 1）：
DeepSeek Harness 的核心命题是 Agent = Model + Harness。大模型（Model）提供语言推理与 tool call 意图；Harness 提供持续运行的环境：Cordis 插件内核挂载模型适配器、工具管道、Session 存储、Web UI 与 MCP 客户端。与「每次 HTTP 请求无状态调用 API」不同，Harness 维护 Session 状态机，使得多轮工具调用、审批等待、上下文压缩可在同一进程内完成。
Cordis 五核心概念（以官方文档为准，通常包括）：插件生命周期、依赖解析、服务 provide/inject、可逆 effect、事件总线。Everything is a Plugin 意味着更换能力即挂载/卸载插件，而非 fork 整仓代码。生产 implications：升级 Bundle 即变更插件组合，必须验证 Teardown 与 Patch 兼容性。
请在 Morning 结束前完成 快速开始 的一键启动，打开 内核可视化器，观察插件 mount 顺序动画，记录至少三个插件名称及其依赖关系。
Afternoon（14:00–17:00）— 动手实验
主题：一键启动、内核可视化、五核心概念
Afternoon 强调手比眼快：每遇到一个配置项，问「它属于 Bundle、Profile 还是 Patch？」每写一行 ctx.effect，立即写 Teardown。
Evening（19:30–21:00）— 挑战与复盘
挑战任务：在 lab 截图插件挂载动画；手绘架构图
验收标准：
- 能解释 Cordis 与 Model 的分工；Web UI 可对话
- 笔记已提交或本地存档，含至少一张 lab 截图链接
- 能向同伴讲解当日一个原理（无笔记念稿）
反思三问：
- 今日哪个概念最容易与 LangChain 混淆？
- 若上生产，今日哪条配置最危险？
- 明日预习需要的前置知识是什么？
Day 2：插件系统深度解析
当日目标
apply / effect / provide。完成当日学习后，你应能独立说明该主题在 Cordis 运行时中的位置，并与 开发指南 术语一致。
Morning（09:00–12:00）— 理论建构
Morning 段聚焦读与讲：先读文档，再对照官方架构。Day 2 推荐阅读 入门介绍（Day1）、开发指南（Day2+）、最佳实践（Day4+）相关章节。
深入讲解（Day 2）：
插件是 { name, apply(ctx) }。apply 是同步入口，在此注册服务、工具、路由；禁止在 apply 内启动无 Teardown 的长生命周期资源。ctx.effect(() => { setup(); return teardown; }) 是生产契约：setup 在 mount 后运行，teardown 在 unmount 必运行。
Bundle / Profile / Patch 三层：Bundle 声明「有哪些插件、默认配置」；Profile 选择环境（standard/code/...）；Patch 是 git 管理的 diff。学习路径中所有「改配置」应练习写 Patch 文件，而非只点 UI。
服务系统允许插件互相 inject 依赖。设计接口时面向「契约」而非具体实现，便于测试 mock 与 Teardown。Day2 下午编写最小插件时，刻意制造一个「无 Teardown 的 setInterval」再在 leak lab 观察内存，建立肌肉记忆。
Afternoon（14:00–17:00）— 动手实验
主题：最小插件、Teardown、Bundle 三层
Evening（19:30–21:00）— 挑战与复盘
挑战任务：编写 hello 插件；泄漏 lab 循环挂载
验收标准：
- Teardown 无泄漏；能说明 Patch 作用
- 笔记已提交或本地存档，含至少一张 lab 截图链接
- 能向同伴讲解当日一个原理（无笔记念稿）
反思三问：
- 今日哪个概念最容易与 LangChain 混淆？
- 若上生产，今日哪条配置最危险？
- 明日预习需要的前置知识是什么？
Day 3：四种预设模式
当日目标
Standard/Code/Minimal/Creator。完成当日学习后，你应能独立说明该主题在 Cordis 运行时中的位置，并与 开发指南 术语一致。
Morning（09:00–12:00）— 理论建构
Morning 段聚焦读与讲：先读文档，再对照官方架构。Day 3 推荐阅读 入门介绍（Day1）、开发指南（Day2+）、最佳实践（Day4+）相关章节。
深入讲解（Day 3）：
四种预设不是皮肤，是不同的 Agent 能力边界：
| 预设 | 工具丰富度 | Token | 风险 | 典型场景 |
|---|---|---|---|---|
| Standard | 中 | 中 | 中 | 通用助手 |
| Code | 高 | 高 | 中高 | 仓库开发 |
| Minimal | 低 | 低 | 低 | CI/评测 |
| Creator | 最高 | 高 | 高 | 隔离创作 |
Creator 必须在独立环境使用，参见 最佳实践 · Creator 隔离。评测 Minimal 与生产 Standard 不可混 Pool。
在 预设对比实验室 用同一 prompt（如「列出当前目录并写 README」）跑四预设，记录：工具调用次数、总 token、是否完成、是否触发审批。
Afternoon（14:00–17:00）— 动手实验
主题：预设对比、Creator 安全、Profile Patch
Evening（19:30–21:00）— 挑战与复盘
挑战任务：同一任务四预设对比表
验收标准：
- 能推荐场景；Creator 风险说清
- 笔记已提交或本地存档，含至少一张 lab 截图链接
- 能向同伴讲解当日一个原理（无笔记念稿）
反思三问：
- 今日哪个概念最容易与 LangChain 混淆？
- 若上生产，今日哪条配置最危险？
- 明日预习需要的前置知识是什么？
Day 4：工具、沙箱与审批
当日目标
工具管道、沙箱、MCP。完成当日学习后，你应能独立说明该主题在 Cordis 运行时中的位置，并与 开发指南 术语一致。
Morning（09:00–12:00）— 理论建构
Morning 段聚焦读与讲：先读文档，再对照官方架构。Day 4 推荐阅读 入门介绍（Day1）、开发指南（Day2+）、最佳实践（Day4+）相关章节。
深入讲解（Day 4）：
工具管道阶段：Schema 注册 → 模型可见 → 调用解析 → 沙箱检查 → 审批策略 → 执行 → 结果写入 Session Log。任一阶段失败都应返回模型可理解的错误，避免 silent fail。
沙箱诚实边界：限制 workspace 路径，不承诺防恶意插件。审批矩阵应多维分级，见 最佳实践。MCP 工具从外部 server 动态进入图谱，风险取决于 server，Harness 侧需 server 白名单 + 分级审批。
Day4 挑战：设计 5 类工具 × 5 种路径/命令场景的审批表，并在 approval-sim 模拟通过/拒绝/人工。
Afternoon（14:00–17:00）— 动手实验
主题：Schema、审批矩阵、approval-sim
Evening（19:30–21:00）— 挑战与复盘
挑战任务：提交 5×5 审批矩阵表
验收标准：
- 能配置沙箱路径；模拟器走通审批
- 笔记已提交或本地存档，含至少一张 lab 截图链接
- 能向同伴讲解当日一个原理（无笔记念稿）
反思三问：
- 今日哪个概念最容易与 LangChain 混淆？
- 若上生产，今日哪条配置最危险？
- 明日预习需要的前置知识是什么？
Day 5：会话、事件溯源与可观测性
标签：Session | 课程页：Day 5 | 实验：Lab
当日目标
Log、Resume/Fork/Replay、OTel。完成当日学习后，你应能独立说明该主题在 Cordis 运行时中的位置，并与 开发指南 术语一致。
Morning（09:00–12:00）— 理论建构
Morning 段聚焦读与讲：先读文档，再对照官方架构。Day 5 推荐阅读 入门介绍（Day1）、开发指南（Day2+）、最佳实践（Day4+）相关章节。
深入讲解（Day 5）：
Session Log 事件类型包括（概念上）：user_message、assistant_message、tool_call、tool_result、approval_request、compression、fork_point 等。append-only 保证审计与 Replay。
Resume：同一 session_id 继续；Fork：新 session_id 继承某 checkpoint 后独立演化；Replay：调试重放，生产写工具应禁用或隔离。
OpenTelemetry：除 model latency 外必看 dsh.tool.* 与 Session 体积。上下文压缩在 token 水位线触发，保留 system + 近期目标 + 关键 tool 错误原文。
Afternoon（14:00–17:00）— 动手实验
主题：长 Session 压缩、指标清单
- 打开 课程 Day 5 跟随实验步骤。
- 在本地仓库创建
learning-notes/day5.md记录命令、截图路径、问题与解决。
Evening（19:30–21:00）— 挑战与复盘
挑战任务：Fork 分支实验；列 OTel 指标
验收标准：
- Resume 成功；说明压缩策略
- 笔记已提交或本地存档，含至少一张 lab 截图链接
- 能向同伴讲解当日一个原理（无笔记念稿）
反思三问：
- 今日哪个概念最容易与 LangChain 混淆？
- 若上生产，今日哪条配置最危险？
- 明日预习需要的前置知识是什么？
Day 6：多 Agent 与高级编排
标签：多Agent | 课程页：Day 6 | 实验：Lab
当日目标
Spawn/Fork、工作流/计划。完成当日学习后，你应能独立说明该主题在 Cordis 运行时中的位置，并与 开发指南 术语一致。
Morning（09:00–12:00）— 理论建构
Morning 段聚焦读与讲：先读文档，再对照官方架构。Day 6 推荐阅读 入门介绍（Day1）、开发指南（Day2+）、最佳实践（Day4+）相关章节。
深入讲解（Day 6）：
Spawn 创建子 Agent：新 Session、可能不同 Profile、独立 quota。用于任务委派、并行探索。Fork 是 Session 分支，用于「what-if」实验而非必然委派。
工作流：步骤 predefined，适合合规；计划：模型 dynamic plan，适合探索。Handoff 应 structured：目标、约束、已完成、禁止操作。
必须配置子 Agent 上限与 Token 预算，防止编排失控。父 Session Log 记录 spawn 关系供审计。
Afternoon（14:00–17:00）— 动手实验
主题：子 Agent quota、handoff 结构
- 打开 课程 Day 6 跟随实验步骤。
- 在本地仓库创建
learning-notes/day6.md记录命令、截图路径、问题与解决。
Evening（19:30–21:00）— 挑战与复盘
挑战任务：Spawn 子 Agent 完成子任务
验收标准：
- 父 Session 有 audit；无 Agent 爆炸
- 笔记已提交或本地存档，含至少一张 lab 截图链接
- 能向同伴讲解当日一个原理（无笔记念稿）
反思三问：
- 今日哪个概念最容易与 LangChain 混淆？
- 若上生产，今日哪条配置最危险？
- 明日预习需要的前置知识是什么？
Day 7：插件开发、发布与生产部署
当日目标
CR 检查表、容器、Patch 版本。完成当日学习后，你应能独立说明该主题在 Cordis 运行时中的位置，并与 开发指南 术语一致。
Morning（09:00–12:00）— 理论建构
Morning 段聚焦读与讲：先读文档，再对照官方架构。Day 7 推荐阅读 入门介绍（Day1）、开发指南（Day2+）、最佳实践（Day4+）相关章节。
深入讲解（Day 7）：
Day7 整合前六日：插件工程化（lint、test、Minimal smoke）、Bundle 打包、容器部署、Patch 版本化、OTel 接入。Code Review 使用 最佳实践检查表。
毕业大作业：发布一个带 dsh-plugin topic 的社区插件（GitHub/GitLab），README 含安装、Profile 要求、env、Teardown 说明、Minimal 测试步骤。参见 社区页。
生产 checklist：Profile 分离、Session 保留、密钥 Vault、canary 升级。完成即具备初级 Harness 平台工程师能力。
Afternoon（14:00–17:00）— 动手实验
主题：社区发布、dsh-plugin topic
Evening（19:30–21:00）— 挑战与复盘
挑战任务：完成毕业大作业插件
验收标准：
- 插件上架；README 含 Profile 说明
- 笔记已提交或本地存档，含至少一张 lab 截图链接
- 能向同伴讲解当日一个原理（无笔记念稿）
反思三问：
- 今日哪个概念最容易与 LangChain 混淆？
- 若上生产，今日哪条配置最危险？
- 明日预习需要的前置知识是什么？
毕业大作业：发布 Cordis 插件
作业要求
- 功能：解决一个真实小问题（如 MCP 工具封装、Session 导出、自定义审批 UI 钩子 — 以官方扩展点为准）。
- 质量：通过 最佳实践 CR 检查表；leak lab 无泄漏。
- 发布：开源仓库打 topic
dsh-plugin；README 中英至少说明用途、Profile、env。 - 证据：Minimal Profile 下 smoke test 录屏或 CI log；在社区 提交链接。
评分 Rubric
| 维度 | 权重 | 优秀标准 |
|---|---|---|
| Teardown 正确性 | 25% | leak lab 循环 50 次平坦 |
| 工具 Schema 质量 | 20% | 模型一次调用成功率 >80% |
| 文档 | 20% | 他人按 README 10 分钟跑通 |
| 安全 | 20% | 最小权限 Profile 声明 |
| 创新 | 15% | 解决非常规问题 |
提交清单
- 仓库 URL +
dsh-plugintopic - Minimal smoke 步骤
- 自述_used Presets
- 已知限制与沙箱声明
能力雷达自评表
完成 Day7 后，对以下维度 1–5 自评（1=陌生，5=能教他人）：
| 维度 | D1 | D2 | D3 | D4 | D5 | D6 | D7 | 自评 |
|---|---|---|---|---|---|---|---|---|
| Cordis 架构 | ● | ○ | ○ | ○ | ○ | ○ | ○ | __ |
| 插件开发与 Teardown | ○ | ● | ○ | ○ | ○ | ○ | ● | __ |
| Profile / 预设选型 | ○ | ○ | ● | ○ | ○ | ○ | ● | __ |
| 工具 / 沙箱 / 审批 | ○ | ○ | ○ | ● | ○ | ○ | ● | __ |
| Session / 溯源 | ○ | ○ | ○ | ○ | ● | ○ | ● | __ |
| 可观测 / OTel | ○ | ○ | ○ | ○ | ● | ○ | ● | __ |
| 多 Agent 编排 | ○ | ○ | ○ | ○ | ○ | ● | ○ | __ |
| 生产部署与 Patch | ○ | ○ | ○ | ○ | ○ | ○ | ● | __ |
● = 当日重点覆盖。目标：Day7 各行自评 ≥4。弱项回看对应 Day 与 FAQ。
上图示意从 Day1 基线分到毕业目标分的跃迁；请用上方自评表填真实分数，而不是只看示意图。
七天之后的学习路线
| 阶段 | 内容 | 资源 |
|---|---|---|
| 巩固 | 阅读 最佳实践 全文 | 文档 |
| 扩展 | 集成 MCP server、OTel 栈 | 开发指南 |
| 社区 | 贡献插件、参与挑战赛 | community.html |
| 源码 | 阅读官方 docs/architecture.md | GitHub |
结语
七天路径的目标不是「用完所有功能」，而是建立 Harness 运行时思维：插件生命周期、Profile 即权限、Session 即审计、Teardown 即发布门禁。带着此思维阅读 FAQ 与 最佳实践，你将能独立设计生产级 Agent 运行时。
祝学习顺利。实战子站：https://dsh.chenxiaoshivivid.top/
Day 1 补充精读
Day 1 的 Morning 理论需与动手对照。许多学员在 Day 1 容易陷入「只跑通 demo 不理解 Profile」的陷阱。请在笔记本用一页纸画出：用户消息进入 Harness 后经过哪些插件、哪些事件写入 Session Log、若触发工具审批 pipeline 如何暂停与恢复。对照 七天学会课程 的视频或文字步骤，暂停在每一步问：若这一步配置错误，OTel 上会出现什么信号？这种「信号驱动学习法」是从教程使用者转变为平台工程师的关键。
| 学习阶段 | 推荐时长 | 产出物 |
|---|---|---|
| Day 1 Morning | 3h | 概念笔记 |
| Day 1 Afternoon | 3h | 代码/配置 |
| Day 1 Evening | 1.5h | 挑战验收 |
精读要点 1：Harness 的插件化架构意味着 Day 1 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 2：Harness 的插件化架构意味着 Day 1 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 3：Harness 的插件化架构意味着 Day 1 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 4：Harness 的插件化架构意味着 Day 1 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 5：Harness 的插件化架构意味着 Day 1 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
Day 2 补充精读
Day 2 的 Morning 理论需与动手对照。许多学员在 Day 2 容易陷入「只跑通 demo 不理解 Profile」的陷阱。请在笔记本用一页纸画出：用户消息进入 Harness 后经过哪些插件、哪些事件写入 Session Log、若触发工具审批 pipeline 如何暂停与恢复。对照 七天学会课程 的视频或文字步骤，暂停在每一步问：若这一步配置错误，OTel 上会出现什么信号？这种「信号驱动学习法」是从教程使用者转变为平台工程师的关键。
| 学习阶段 | 推荐时长 | 产出物 |
|---|---|---|
| Day 2 Morning | 3h | 概念笔记 |
| Day 2 Afternoon | 3h | 代码/配置 |
| Day 2 Evening | 1.5h | 挑战验收 |
精读要点 1：Harness 的插件化架构意味着 Day 2 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合 。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 2：Harness 的插件化架构意味着 Day 2 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 3：Harness 的插件化架构意味着 Day 2 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 4：Harness 的插件化架构意味着 Day 2 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 5：Harness 的插件化架构意味着 Day 2 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
Day 3 补充精读
Day 3 的 Morning 理论需与动手对照。许多学员在 Day 3 容易陷入「只跑通 demo 不理解 Profile」的陷阱。请在笔记本用一页纸画出：用户消息进入 Harness 后经过哪些插件、哪些事件写入 Session Log、若触发工具审批 pipeline 如何暂停与恢复。对照 七天学会课程 的视频或文字步骤，暂停在每一步问：若这一步配置错误，OTel 上会出现什么信号？这种「信号驱动学习法」是从教程使用者转变为平台工程师的关键。
| 学习阶段 | 推荐时长 | 产出物 |
|---|---|---|
| Day 3 Morning | 3h | 概念笔记 |
| Day 3 Afternoon | 3h | 代码/配置 |
| Day 3 Evening | 1.5h | 挑战验收 |
精读要点 1：Harness 的插件化架构意味着 Day 3 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 2：Harness 的插件化架构意味着 Day 3 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 3：Harness 的插件化架构意味着 Day 3 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 4：Harness 的插件化架构意味着 Day 3 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 5：Harness 的插件化架构意味着 Day 3 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
Day 4 补充精读
Day 4 的 Morning 理论需与动手对照。许多学员在 Day 4 容易陷入「只跑通 demo 不理解 Profile」的陷阱。请在笔记本用一页纸画出：用户消息进入 Harness 后经过哪些插件、哪些事件写入 Session Log、若触发工具审批 pipeline 如何暂停与恢复。对照 七天学会课程 的视频或文字步骤，暂停在每一步问：若这一步配置 错误，OTel 上会出现什么信号？这种「信号驱动学习法」是从教程使用者转变为平台工程师的关键。
| 学习阶段 | 推荐时长 | 产出物 |
|---|---|---|
| Day 4 Morning | 3h | 概念笔记 |
| Day 4 Afternoon | 3h | 代码/配置 |
| Day 4 Evening | 1.5h | 挑战验收 |
精读要点 1：Harness 的插件化架构意味着 Day 4 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 2：Harness 的插件化架构意味着 Day 4 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 3：Harness 的插件化架构意味着 Day 4 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 4：Harness 的插件化架构意味着 Day 4 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 5：Harness 的插件化架构意味着 Day 4 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
Day 5 补充精读
Day 5 的 Morning 理论需与动手对照。许多学员在 Day 5 容易陷入「只跑通 demo 不理解 Profile」的陷阱。请在笔记本用一页纸画出：用户消息进入 Harness 后经过哪些插件、哪些事件写入 Session Log、若触发工具审批 pipeline 如何暂停与恢复。对照 七天学会课程 的视频或文字步骤，暂停在每一步问：若这一步配置错误，OTel 上会出现什么信号？这种「信号驱动学习法」是从教程使用者转变为平台工程师的关键。
| 学习阶段 | 推荐时长 | 产出物 |
|---|---|---|
| Day 5 Morning | 3h | 概念笔记 |
| Day 5 Afternoon | 3h | 代码/配置 |
| Day 5 Evening | 1.5h | 挑战验收 |
精读要点 1：Harness 的插件化架构意味着 Day 5 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因 此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 2：Harness 的插件化架构意味着 Day 5 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 3：Harness 的插件化架构意味着 Day 5 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 4：Harness 的插件化架构意味着 Day 5 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 5：Harness 的插件化架构意味着 Day 5 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
Day 6 补充精读
Day 6 的 Morning 理论需与动手对照。许多学员在 Day 6 容易陷入「只跑通 demo 不理解 Profile」的陷阱。请在笔记本用一页纸画出：用户消息进入 Harness 后经过哪些插件、哪些事件写入 Session Log、若触发工具审批 pipeline 如何暂停与恢复。对照 七天学会课程 的视频或文字步骤，暂停在每一步问：若这一步配置错误，OTel 上会出现什么信号？这种「信号驱动学习法」是从教程使用者转变为平台工程师的关键。
| 学习阶段 | 推荐时长 | 产出物 |
|---|---|---|
| Day 6 Morning | 3h | 概念笔记 |
| Day 6 Afternoon | 3h | 代码/配置 |
| Day 6 Evening | 1.5h | 挑战验收 |
精读要点 1：Harness 的插件化架构意味着 Day 6 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 2：Harness 的插件化架构意味着 Day 6 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 3：Harness 的插件化架构意味着 Day 6 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 4：Harness 的插件化架构意味着 Day 6 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 5：Harness 的插件化架构意味着 Day 6 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
Day 7 补充精读
Day 7 的 Morning 理论需与动手对照。许多学员在 Day 7 容易陷入「只跑通 demo 不理解 Profile」的陷阱。请在笔记本用一页纸画出：用户消息进入 Harness 后经过哪些插件、哪些事件写入 Session Log、若触发工具审批 pipeline 如何暂停与恢复。对照 七天学会课程 的视频或文字步骤，暂停在每一步问：若这一步配置错误，OTel 上会出现什么信号？这种「信号驱动学习法」是从教程使用者转变为平台工程师的关键。
| 学习阶段 | 推荐时长 | 产出物 |
|---|---|---|
| Day 7 Morning | 3h | 概念笔记 |
| Day 7 Afternoon | 3h | 代码/配置 |
| Day 7 Evening | 1.5h | 挑战验收 |
精读要点 1：Harness 的插件化架构意味着 Day 7 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 2：Harness 的插件化架构意味着 Day 7 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 3：Harness 的插件化架构意味着 Day 7 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 4：Harness 的插件化架构意味着 Day 7 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
精读要点 5：Harness 的插件化架构意味着 Day 7 所学并非孤立知识点，而是与 Cordis 内核其它模块通过事件总线耦合。修改一个 Plugin 的 tool schema 可能改变 Model 的 tool choice 分布，进而影响 Token 消耗与审批频率。因此验收标准不仅看「功能是否 work」，还要看 Session Log 是否完整、Teardown 是否对称、Profile 是否与预期一致。
Day 1 补充精读
Day 2 补充精读
Day 3 补充精读
Day 4 补充精读
路径强化：每日「为什么这样练」
Day1 深化
架 构认知的验收不是「能背五核心」，而是能指出：一次挂载失败时应查依赖图还是 Teardown。Evening 对比 npx 与源码，是为了理解 Bundle 内容从何而来。
Day2 深化
hello 插件必须走完卸载。不会卸载的开发者，会在 Day7 发布时把生产打成定时器农场。实验室可视化器是为了把 effect 栈变成直觉。
Day3 深化
同一任务三预设对比，是在训练「用数据选型」。不要凭感觉说 Code 一定更省 Token——以你的 Session 为准。
Day4 深化
审批矩阵是安全产品，不是开关。写下你的 auto/ask/deny 表并找同伴攻击它（提示词诱导、路径绕过）。
Day5 深化
Resume/Fork/Replay 各做一次。不能 Replay 的系统，谈不上可调试 Agent。
Day6 深化
团队编排先保证结构化汇总，再追求并行加速。先正确后快。
Day7 深化
发布带 dsh-plugin 的插件是毕业标准：它强迫你写清兼容性与 Teardown。认证材料应包含 Profile 与架构说明，而不仅是代码。
毕业后 30 天计划
周 1：把插件接到真实 webhook/只读 MCP；周 2：补 OTel；周 3：写三条 Replay CI；周 4：做一次审批放宽/收紧的演练与文档化。
自评雷达使用法
每项 1–5 分，低于 3 的项回到对应 Day 重做挑战。不要平均分自欺：安全与 Teardown 低分应阻断「生产负责人」角色。
路径附录：常见卡关与补救
| 卡关症状 | 多发 Day | 补救动作 |
|---|---|---|
| 能聊天但不知道事件从哪来 | Day1–2 | 强制阅读一条 Session 全文并标注事件类型 |
| 插件能挂不能卸 | Day2 | 重做 effect 实验，对照实验室泄漏检测 |
| 分不清四预设 | Day3 | 同一任务三预设表格化对比轮次与工具 |
| 审批规则不生效 | Day4 | 打印 resolved 策略并做必触发用例 |
| 不会 Resume | Day5 | 人为中断长任务后从检查点恢复 |
| 子 Agent 结果很乱 | Day6 | 规定 JSON 汇总 schema，禁止裸文本回传 |
| 不敢发布插件 | Day7 | 先发私有仓库 + 兼容矩阵，再加 topic |
记住：七天路径的终点不是「听过 Cordis」，而是「能把插件安全地装进可观测的运行时」。若某日验收未过，不要用往后一天的新鲜感掩盖；停下来补挑战任务，再前进。