muse-agent-example/docs/research/2026-08-24-dsh-local-runtime-baseline.md

DSH 本机运行基线

核对日期：2026-08-24 范围：本机 DSH 安装、官方 headless 入口、agent-example DSH 适配接缝。

结论

• 本机此前只有 0.1.0-rc.6 的 npx 缓存和 ~/.dsh 旧 profile；当前已安装官方 @deepseek-ai/dsh@0.1.1-rc.2，命令为 dsh。
• npm latest 当前为 0.1.1-rc.2；官方仓库 master 当前提交为 b150a551b8d465e31e418e1b2eaf5e79bbb7d28e，与该版本对应。
• dsh --profile web --dump-config 与 dsh --profile headless --dump-config 在无 API key 条件下通过。dsh --profile headless "..." 在无凭据时按 MISSING_CREDENTIAL 失败关闭。
• DSH headless bundle 是一次性任务入口：创建新 Agent/session，等待空闲，flush session，再输出最后一条非空 assistant 文本；它没有交互式续接入口。
• agent-example/framework/adapters/dsh/ 当前只开放无工具 fresh 对照运行。Muse 的只读工具白名单尚未在 DSH 中形成执行前闭集，因此非空白名单拒绝启动。生产默认仍为 Pi。

一手来源

• DSH 官方 README：npm 运行方式、Node 前置和 developer preview 边界。
• DSH Architecture：Cordis 插件树、profile/bundle、session/event 和 capability seam。
• DSH Headless bundle README：headless 生命周期、flush 和退出码。
• DSH Session Persistence JSONL README：会话目录、session.jsonl/session.jsonl.zstd 编码和 append-only 约束。
• 公众号文章《从0到1带你速通DeepSeek Harness》：二手产品介绍，核对到的主题是“一切皆插件”、标准/PTC/极简/创造模式和只追加会话日志；不作为代码 API 事实源。

本机命令证据

dsh --version                         -> 0.1.1-rc.2
dsh --profile web --dump-config       -> exit 0
dsh --profile headless --dump-config  -> exit 0
env -u DEEPSEEK_API_KEY dsh --profile headless "print exactly OK"
                                       -> exit 1, MISSING_CREDENTIAL

这些证据只证明安装、profile 组合和无凭据失败路径；没有 API key、预算授权和真实任务回执时，不升级为模型质量、工具能力或 Muse 业务可用性结论。

实现决策

DSH 的“标准模式”适合交互式开发者使用，但 Muse 的框架适配器选择 headless，原因是业务层已经负责生成冻结任务包，适配器只需要一次可追踪执行。creative/Cordis 自修改能力不进入生产角色会话；插件自修改不能替代 Muse 的角色合同、工具白名单、Schema 门和 Canonical 主权门。