手册/第 07 章
它明确不做的事
一个项目的边界,写在它愿意承认「这不是我的责任」的地方。 dsh 在这方面异常直白——直白到如果只看 README 的头 15 行,你可能会以为它在劝你别用。
不做承诺一:稳定性
这句话和「万物皆插件」是一条链上的两端。既然插件树要不断重组,接口就必然要动。 dsh 没有选择「先冻结核心 API 再长生态」,而是选择「先让组合能力成立,再让生态跟上」。
不做承诺二:安全隔离
SAFETY.md 的措辞比大多数项目更狠,且区分了三层责任:
这是第 05 章「执行世界」的另一面:沙箱是可替换的策略,不是安全承诺。
项目明确说「不要把 dsh 当作不可信工作负载的唯一安全控制」(SAFETY.md:15),
并建议扔进一次性虚拟机或容器里跑。
ctx.sandbox 这一层的价值就不在「更安全」,
而在「策略可以换、可以组合、可以审计」。评估它时该问的是「能不能表达我的规则」,
而不是「它能不能挡住一切」。
不做承诺三:「那个界面」
dsh 没有「主界面」。web、headless、sdk、sdk-minimal、
acp 是五个平级 profile,不是「主程序 + 若干模式」。
连 dsh-base 里也只有模型适配器、工具、持久化、沙箱与审批策略、设置、凭据、遥测——
没有 UI。
| profile | 它多了什么 |
|---|---|
web | dsh-web-app:浏览器应用(packages/client,17 万行) |
headless | dsh-headless:无服务端的一次性 runner |
sdk | dsh-sdk-app:SDK 的 JSON-RPC 服务端 |
acp | dsh-acp-app:只做自动化的 ACP 服务端 |
sdk-minimal | 刻意例外:自己拥有完整显式树,不套用 dsh-base |
不做承诺四:替你决定
dsh 把「怎么配」摊开给你看,而不是替你选:
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 的内容