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

37 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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