# 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](https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/README.md)：npm 运行方式、Node 前置和 developer preview 边界。
- [DSH Architecture](https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/docs/architecture.md)：Cordis 插件树、profile/bundle、session/event 和 capability seam。
- [DSH Headless bundle README](https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/packages/bundle/headless/README.md)：headless 生命周期、flush 和退出码。
- [DSH Session Persistence JSONL README](https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/packages/session/session-persistence-jsonl/README.md)：会话目录、`session.jsonl`/`session.jsonl.zstd` 编码和 append-only 约束。
- [公众号文章《从0到1带你速通DeepSeek Harness》](https://mp.weixin.qq.com/s/xkC1aenHFNSH2BxyzLDfcA)：二手产品介绍，核对到的主题是“一切皆插件”、标准/PTC/极简/创造模式和只追加会话日志；不作为代码 API 事实源。

## 本机命令证据

```text
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 主权门。