DeepSeek Harness 学习手册 第 07 / 11 章 总目录 单页全本 架构图 GitHub

手册/第 07 章

07

它明确不做的事

一个项目的边界,写在它愿意承认「这不是我的责任」的地方。 dsh 在这方面异常直白——直白到如果只看 README 的头 15 行,你可能会以为它在劝你别用。

"DeepSeek Harness is in developer preview and iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES."
DeepSeek Harness 处于开发者预览阶段,正在快速迭代。一定会有破坏兼容性的变更。
— README.md:13

不做承诺一:稳定性

这句话和「万物皆插件」是一条链上的两端。既然插件树要不断重组,接口就必然要动。 dsh 没有选择「先冻结核心 API 再长生态」,而是选择「先让组合能力成立,再让生态跟上」。

Ⅰ代价是真实的
你今天写的插件,下次发版可能要改。这不是 bug,是路线:他明确写了会破坏兼容。 参考上一章——会话格式反而有严格代际保证,因为历史数据丢了没法重建,而插件代码可以改。
Ⅱ反过来说
如果你需要「发版不改变我的工作流」,dsh 现在就不是那个选择—— 这正是 pi 存在的理由(见第 09 章)。

不做承诺二:安全隔离

SAFETY.md 的措辞比大多数项目更狠,且区分了三层责任:

"It has not undergone a security audit and must not be treated as secure or production-ready."
它没有经过安全审计,不得被视为安全的或可用于生产。
— SAFETY.md:7
"Sandboxing, approval prompts, and permission controls can reduce risk, but they do not guarantee isolation or prevent damage."
沙箱、审批提示与权限控制能降低风险,但不能保证隔离,也不能阻止损害。
— SAFETY.md:13

这是第 05 章「执行世界」的另一面:沙箱是可替换的策略,不是安全承诺。 项目明确说「不要把 dsh 当作不可信工作负载的唯一安全控制」(SAFETY.md:15), 并建议扔进一次性虚拟机或容器里跑。

这条对读代码的人也有用 既然沙箱不做保证,那 ctx.sandbox 这一层的价值就不在「更安全」, 而在「策略可以换、可以组合、可以审计」。评估它时该问的是「能不能表达我的规则」, 而不是「它能不能挡住一切」。

不做承诺三:「那个界面」

dsh 没有「主界面」。web、headless、sdk、sdk-minimal、 acp 是五个平级 profile,不是「主程序 + 若干模式」。 连 dsh-base 里也只有模型适配器、工具、持久化、沙箱与审批策略、设置、凭据、遥测—— 没有 UI。

profile它多了什么
webdsh-web-app:浏览器应用(packages/client,17 万行)
headlessdsh-headless:无服务端的一次性 runner
sdkdsh-sdk-app:SDK 的 JSON-RPC 服务端
acpdsh-acp-app:只做自动化的 ACP 服务端
sdk-minimal刻意例外:自己拥有完整显式树,不套用 dsh-base

不做承诺四:替你决定

dsh 把「怎么配」摊开给你看,而不是替你选:

sh · docs/architecture.md:33-35
dsh --profile web --dump-config

打印出这台机器实际启动的插件树,它打印的每一行都可以被你自己的 patch 替换 (architecture.md:37)。此外还有 --dump-config-schema(打印 JSON Schema,不挂载) 和 --dump-default-config(去掉用户层与 --patch 后的裸树)。

这是一种「不做承诺」的正面版本:不承诺某个推荐配置,但承诺你可以看到并改掉每一层。

边界清单

它不做因为
承诺 API 稳定组合层的自由度优先于生态的稳定性
承诺安全隔离沙箱是策略,不是保证(SAFETY.md:13)
定义「官方界面」五种 profile 平级,UI 只是一个插件分支
替你选配置换成「让你看得见并可改」
替你决定策略审批/沙箱是插件,规则写在插件里

把这些连起来看,dsh 的自我定位就清楚了:它是一个「组合能力的提供者」,不是一个「开箱即用的产品」。 产品由上层(apps/web、第三方桌面端、你的 SDK 调用方)来定义。

README.md:13 · developer preview SAFETY.md:13 · 沙箱不保证隔离 architecture.md:23 · dsh-base 的内容

本章学习记录

记录仅保存在当前浏览器。