DeepSeek Harness 深度教程

DeepSeek Harness 深度教程

13 章拆解 DeepSeek Harness（dsh） 的架构设计与实现 —— 一个"一切皆插件"的 agent（智能体）运行外壳

本教程的定位（2026-08-15） 同目录下的 Pi-Agent 深度教程 拆的是 减法哲学的代表作：核心极简、刻意不做 MCP / 子 Agent / 权限弹窗。本教程拆的是它的对立面 —— DeepSeek Harness 把 agent 运行时的每一寸能力都做成了可替换插件，185 个包、四层配置 patch、20 多个抽象 seam（能力接缝）。

两者不是优劣关系，而是同一道题的两种答案。第 13 章有完整对照。

项目背景（公网核实，2026-08-15） DeepSeek Harness 于 2026-08-13 开源 v0.1 开发者预览版（MIT 许可证），官方口号 "一切皆插件"，社区形象代号"黑鲸"，开源初期即获数万 star。本教程写作时距开源仅 3 天，教程正文的技术结论全部来自本机官方包源码与运行时实测，公网信息仅用于背景补充（详见 00-资料索引）。

版本与写作方法 本教程基于 dsh 0.1.0-rc.6（developer preview，官方 README 明示 rc 版本之间会有破坏性变更）。

与 Pi 教程不同，本教程不是翻译或转载，而是基于本机实际运行的 dsh 实例逐条取证写成：195 个官方包的源码与 385 篇官方双语 README、真实会话事件日志、实测的系统提示词与沙箱边界。每一处关键结论都在正文标注了复核路径，你可以在自己的机器上重跑一遍。

一、这套教程解决什么问题

如果你已经读过 Pi 教程，你会带着几个问题来看 dsh：

1. "一切皆插件"到底能做到什么程度？ —— Pi 的答案是"核心固定 + 扩展点开放"，dsh 的答案是"连 agent loop 本身都是一行配置"
2. 一个 agent 运行时需要多少种可替换的能力？ —— 文件、Shell、进程、沙箱、任务、网络、存储、凭据、压缩、委派……dsh 数出了 20 多种，每种都是抽象接口 + 可换实现
3. 插件化的代价是什么？ —— 195 个包换来了什么，又付出了什么

如果你没读过 Pi 教程，本教程也是自洽的：从第 2 章的 cordis 依赖注入框架讲起，不预设你了解任何一个具体 harness。

二、章节结构

第一部分 · 骨架
ch01 开篇总览  →  ch02 cordis 底座  →  ch03 Profile 分层  →  ch04 Seam 架构
                                                                    ↓
第二部分 · 主干
ch05 Agent Loop  →  ch06 模型调用  →  ch07 工具系统  →  ch08 会话  →  ch09 上下文工程
                                                                    ↓
第三部分 · 边界与扩展
ch10 沙箱与权限  →  ch11 委派与编排  →  ch12 技能与人机界面  →  ch13 设计精华

阅读建议：第 1-4 章是骨架，建议按顺序通读——不理解 cordis 的 fiber 和 dispose，后面每一章都会卡住。第 5 章起可按需跳读。

每一章回答三个层次的问题：是什么（概念）、怎么做（源码与实测）、为什么这样做（设计取舍）。

三、素材基线：本教程的每个数字从哪来

本教程的所有事实都可以在一台装了 dsh 的机器上复核。写作时使用的取证路径：

自己动手复核 每章末尾都有「动手复核」小节，给出可直接运行的命令。教程正文里凡是标注 [实测] 的数字，都出自这些命令。

原始资料索引见 00-资料索引，研究背景与结论摘要见 DeepSeek Harness 研究摘要。

四、和 Pi 教程的关系

第 13 章会把这张表展开成完整的哲学对照。

Related Documents

• Pi-Agent 深度教程 —— 减法哲学的对照组
• Harness Engineering 研究报告 —— harness 工程的行业方法论背景
• DeepSeek Harness 研究摘要 —— 本教程的调研过程与核心结论
• 00-资料索引 —— 官方与第三方原始资料清单