DeepSeek Harness：从插件运行时到自己的 Agent

这套课程以官方 deepseek-ai/deepseek-harness 的固定源码为依据，讲清它为什么把 Agent loop、模型、工具、会话、产品界面都做成 Cordis 插件，以及怎样组装一个真正属于自己的 Agent。研究快照为 2026-10-03 的 main da00f7f5358f，可运行实验固定 npm 0.2.0-rc.2；项目仍为 developer preview。

它与之前的 Pi 课程 分域名维护。两套设计的逐项比较在 第 21 章，读者无需先读 Pi 才能使用本课程。

你会得到什么

• 26 章中文 Markdown：设计、源码精读、扩展能力、产品载体、持久化、实战、版本差异与审查。
• 原码行号链接、完整文件清单、包目录地图和可跳转源码阅读页；每处研究结论都区分源码判断与实际运行证据。
• 一套有真实运行时的笔记 Agent：自己的 service、两个 provider、工具、prompt 和步骤预算，TypeScript/Python 两种 SDK 调用。
• 本地模型协议 fixture，使没有 API key 也能执行 SDK、工具调用、错误与取消边界测试。真实 DeepSeek API 调用为单独的可选命令。
• 三位审查者的交叉审查报告和修正记录，另有源码链接、下载重建、浏览器、HTTPS 与公网文件校验。

下载与开读

完整课程 Markdown · 分章 Markdown 与建站资源 · 可运行 Agent 实验

在线也可查看 单文件完整课程、实验完整源码 和 研究边界。图采用 Mermaid，Markdown 压缩包带离线渲染资源。

flowchart LR A[确认版本与基本用法] --> B[理解 Cordis 组合和生命周期] B --> C[读 Session 与 Agent loop] C --> D[理解能力提供者和工具策略] D --> E[实现自己的笔记服务与工具] E --> F[SDK 运行并检查 durable 结果] F --> G[按业务需要加入产品界面和自动化]

学习方式

先读 01–04 获取全局，再沿 05–09 读一次请求的完整路径。10–17 按你要增加的能力选择精读。18–20 是完整可运行教程，不是只有伪代码的提案。最后读 21–26，理解设计选择、研究覆盖、错误排查、版本与验收。

这不是 DeepSeek 官方文档。任何“全部文件已收录”都只表示文件清单完整，不表示 14,000 多个文件的每一行都经过人工语义证明。人工连续阅读范围、未执行的跨平台/真实服务场景与独立审查范围在后文公开，避免把覆盖数量当作正确性保证。