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

这套课程以官方 deepseek-ai/deepseek-harness 的固定源码为依据，讲清它为什么把 Agent loop、模型、工具、会话、产品界面都做成 Cordis 插件，以及怎样组装一个真正属于自己的 Agent。核心研究快照为 da00f7f5358f2949383b35c14f548bc20187d80c（2026-10-04最新master增量见26章），可运行实验固定 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[检查三次请求里的证据] B --> C[数据源从内存换成文件] C --> D[拒绝读取与限制步骤] D --> E[关闭后读回日志] E --> F[回到源码解释这些行为] F --> G[按需求加入界面和自动化]

学习方式

先读01，在十分钟内运行一个只读取个人笔记的Agent；跟着18–20做完六个检查点。再回02–09，看同一次问答如何经过插件、日志、请求与工具。10–17按“把资料换到远端”“加网页”“每天生成摘要”等具体需求选读。最后用21–26完成选型、排错、版本升级与验收。

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