RagnarPitla/dsh-field-guide

DSH 实地指南

一份独立的、带证据标记的 DeepSeek Harness（dsh）实地指南，外加一个基于它构建并验证过的可用插件。

阅读指南 —— 或者从概览开始，它概括了方法以及六处更正。

这是什么

DeepSeek Harness 是 DeepSeek 发布的一个基于插件的智能体 harness。它迭代很快——在撰写本文的这一周内就发布了八个候选版本——而流传的关于它的信息大多是从少数二手来源压缩而来，其中一些是错误的。

本仓库试图在一个狭窄的维度上做得更好：说明每一条论断是如何被核实的。指南中的每一条事实性陈述都带有一个标记，标明它是通过运行发布的二进制文件验证的、从源码中读出的，还是取自外部来源。当某个被广泛重复的说法被证明是错误的时候，更正会连同其引用一并展示。

它是一张照片，而不是一张地图。本指南固定于 2026-08-21 的提交 b150a55（版本 0.1.1-rc.2），日期为 2026-08-24。它不会针对后续版本进行维护。

目录

| 路径 | 内容 |
|---|---|
| docs/guide.html | 实地指南。一个单一的自包含 HTML 文件，没有外部 CSS、JS 或字体，因此双击即可离线打开 |
| docs/index.html | 站点落地页：方法、六处更正以及空白之处，一屏尽览 |
| plugins/dsh-plugin-dev/ | 一个可用的 dsh 插件，教智能体如何扩展 dsh，已针对真实的技能注册表验证 |

指南涵盖的内容

- 什么是 harness，以及对通常框架的三处更正
- dsh 是什么，以准确的规模来看——一个真实的 Web 会话会启动 104 个活跃插件，而不是通常引用的 227 个包
- 为什么“一切皆插件”是精确的简写而非字面意义上的说法，以及真正的新颖之处可能在哪里
- Bundle vs profile vs agent preset——几乎每一份二手解释都会混淆的区别
- 主机平面 vs 智能体平面，以及使第二个会话与第一个会话发生冲突的 isolate 领域规则
- 实际随附的四个预设，从已安装的包中读出
- 组合、层顺序，以及会让你搭进去一个下午的禁止深度合并规则
- 编写插件：经过验证的三文件配方和三个陷阱
- 插件生态系统，是测量出来的而非猜测的
- 安全态势，从十几个包的 README 整合到一张表中
- 它与 Claude Code、Codex CLI 和 Copilot CLI 的比较
- 六个常被重复的错误，附引用更正
- 这一切是如何被验证的，包括哪些没有被验证

插件

dsh-plugin-dev 附带两项技能，教智能体如何扩展它正在其中运行的 harness——编写和安装插件，以及调试某个 profile 实际加载了什么。

sh
dsh plugin --profile  add ./plugins/dsh-plugin-dev

其内容是编写本指南时经过端到端验证的唯一知识体系，这正是它存在的原因：这些技能之所以准确，是因为其中的每一项主张都是通过实际执行而非阅读得出的。

验证过程可复现：
sh
cd plugins/dsh-plugin-dev && node verify.mjs

这会在一个裸 Cordis 上下文上挂载真实的 @deepseek-ai/dsh-skill 注册表，并断言两项技能均可被发现、正文在剥离 frontmatter 后能够加载，以及配置字段得到遵循。

更正

如果此处有误，请提交 issue。各项主张均固定到某个提交，并标注了具体的核查方式，以便它们能够被质疑和讨论。

已知的缺口列在指南的最后一节。最大的一个：所测试的二进制文件是 0.1.0-rc.7，而非检出目录中的 0.1.1-rc.2，并且从未调用过任何模型，因此此处没有任何内容描述智能体在真实任务中的行为——只描述了系统是如何组装起来的。

范围

这是对某一个 harness 的深入探讨。它刻意不是对 harness 设计的通用论述——第 01 节仅涵盖足以让 DeepSeek 特定材料变得可读的内容，并就此止步。

许可证

MIT。参见 LICENSE。

独立且非官方。与 DeepSeek 无关联、未获其认可或赞助。“DeepSeek Harness”仅用于描述性地标识所描述的软件。引用的文档和源代码摘录仍归其各自作者所有，并在本项目 MIT 许可证条款下为评论和教学目的而复制。