DeepSeek Harness白皮书：从0到1玩转DeepSeek Harness的新手百科全书

DeepSeek Harness 白皮书第 1 页DeepSeek Harness白皮书从 0 到 1 玩转 DeepSeek Harness 的新手百科全书版本 0.1.0-rc.6 · 2026-08-13 · 14 章 + 附录 A/B/CDeepSeek Harness 白皮书第 2 页目录DeepSeek Harness 白皮书第 3 页学习路径：从 0 到 1 的 3 天计划 > 承诺兑现：**任何开发者，3 天从零到能开发插件。** 本路径把 9 章拆成 3 天，每天有明确目标与验收标准。 Day 1：理解 + 跑起来（第 1-2 章） **目标**：理解 dsh 是什么，能独立启动、对话、配置。 时间任务验收30 分钟读第 1 章（三个直觉 + 能力矩阵）能向别人解释"dsh 和 Claude Code 的区别"30 分钟第 2 章动手：dsh web 对话 + headless能启动 UI 完成一次对话；能跑一条 headless 命令30 分钟配置模型/推理档位 + 排障速查能改 settings.yaml；能解决端口占用**验收**：`dsh --profile headless "你好"` 有回复。 Day 2：理解骨架 + 第一个插件（第 3-4 章） **目标**：理解 profile/插件机制，写出第一个能跑的插件。 时间任务验收1 小时第 3 章（profile、挂载、host/client、扩展点、坑）能挂载社区插件（Git 面板）1.5 小时第 4 章抄写示例提速插件：纯函数 + agent/request 注入插件加载无错，日志出现决策输出**验收**：自己的插件在 dsh 里生效（日志证明注入发生）。 Day 3：实战 + 调优（第 5-6 章） **目标**：能评估插件质量、调优性能、理解生态玩法。 时间任务验收1 小时第 5 章三个真实 PR（安全红线、沙箱约束、测试方法）能说出"写一个 PR 的完整闭环"1 小时第 6 章性能模型（思考占 90%）+ 档位策略 + 坑能给一个任务选档位、预估瓶颈DeepSeek Harness 白皮书第 4 页30 分钟第 8-9 章扫读（工具/上下文、MCP/子代理/工作流）+ 术语表知道 dsh 的能力全貌与扩展方向**验收**：能给 dsh 生态贡献一个小改进或写一篇使用心得。 之后：按需深入 想做什么去读接外部工具第 9 章 MCP + 官方 mcp 包文档并行任务第 9 章子代理确定性流程第 9 章工作流 + 官方 examples生产部署官方架构文档 + 安全模型（sandbox/权限）性能极致第 6 章 + 第 4 章示例源码生态变现第 7 章 + dsh-plugin topic学习原则（白皮书全程） 1. **动手 > 阅读**：每章命令都跑一遍，不看会后悔 2. **先复制后理解**：第 4 章完整代码先跑通，再改参数理解机制 3. **单测 + 实机双证据**：开发插件时两个都要过 4. **善用 --dump-config**：疑惑时看合成配置，比猜快 DeepSeek Harness 白皮书第 5 页第 1 章：认识 DeepSeek Harness > 本章目标：从一个完全零基础的角度，建立对 DeepSeek Harness（dsh）的完整认知——**它是什么、为什么值得学、和主流 Agent 有什么区别、什么时候用它**。读完本章，你不需要任何前置知识，就能理解 dsh 在整个 AI 开发工具版图中的位置。 TL;DR（本章核心，30 秒版） 1. **dsh = Agent 的乐高底座**：官方开源（MIT）的运行时，一切能力都是插件，你可以自由拼装 2. **harness = 模型外面的工程层**：会话、工具、上下文、循环控制——让模型在仓库里真正干活 3. **和 Claude Code 的区别**：Claude Code 是"整车"，dsh 是"底座 + 积木"——可定制面完全不同 4. **生态窗口**：2026-08-13 开源，中文教程此前为零——现在入场是早期 5. **谁该用**：要深度定制/玩生态/跑 CI 的开发者；要开箱即用的选 Claude Code <!-- [fix] 结构核验：补齐本章导航（第 1 章原缺失，与第 3-11 章结构保持一致） --> <details><summary>本章导航</summary> • [1.1 先建立三个直觉](#11-先建立三个直觉)• [1.2 官方定义与核心事实](#12-官方定义与核心事实)• [1.3 架构是怎么"一切皆插件"的](#13-架构是怎么一切皆插件的)• [1.4 DSH 与主流 Agent 的全面对比](#14-dsh-与主流-agent-的全面对比)• [1.5 什么时候用 dsh（选型决策）](#15-什么时候用-dsh 选型决策)• [1.6 常见问题（FAQ）](#16-常见问题 faq)</details> 1.1 先建立三个直觉 在讲技术之前，先用三个类比建立直觉： **① dsh 是什么？——它是"Agent 的乐高底座"。** 想象乐高：官方提供底板和标准积木（运行时 + 核心插件），你可以自由拼装（加插件、换界面、改行为）。对比之下，Claude Code 更像"一辆整车"——很好开，但你想改装发动机得找官方。 **② 为什么需要"harness"这个词？——它是"套在模型外面的工程层"。** 一个模型（DeepSeek V4）本身只会"回复文字"。要让它在你的代码仓库里干活（读文件、跑命令、改代码、多轮循环），外面需要一层工程：会话管理、工具调用、上下文控制、错误恢复。**这层工程就叫 harness**。dsh 是 DeepSeek 官方把这层工程开源出来的产品。 **③ 为什么 2026 年才开源？——因为 Agent 进入"可编程时代"。** DeepSeek Harness 白皮书第 6 页2025 年是"模型能力竞赛"（谁能生成更好的代码）；2026 年进入"Agent 工程竞赛"（谁能更好地组织模型干活）。DeepSeek 开源 harness 的战略意图：**把"如何组织 Agent"这件事变成开放生态**——像当年 Android 开源改变手机生态一样。 1.2 官方定义与核心事实 **一句话定义**：DeepSeek Harness（`dsh`）是 DeepSeek 官方开源的 Agent 运行时，采用"一切皆插件"（everything is a plugin）架构，基于 Cordis 插件容器构建。 事实内容开源时间2026-08-13协议MIT（可商用、可改）语言TypeScript（Node.js ≥ 22）版本线0.1.0-rc.x（当前 rc.6，迭代快，官方明示"将有破坏性变更"）底层Cordishttps://github.com/cordiverse/cordis（可组合插件容器）内置形态web（Web UI）+ headless（一次性 CLI）官方定位官方 README 原话："everything is a plugin"1.