一、我在 DSH 上遇到的四个痛点#

二、插件的做法：不 fork，只插一行#

1
export default class ClaudeCodePresetPlugin {
2
  static name = 'dsh-preset-claude-code';
3
  constructor(ctx, config) { this.ctx = ctx; this.config = config || {}; }
4
}

1
# dsh bundle patch: inserts Claude Code agent preset into DSH host composition
2
- insert:
3
    - id: preset-claude-code
4
      name: '@deepseek-ai/dsh-agent-preset'
5
      config:
6
        id: claude-code
7
        name: Claude Code 模式
8
        order: 0
9
        plugins:
10
          - id: persona
11
            name: '@deepseek-ai/dsh-persona'
12
            config:
13
              complete: true
14
              includeRuntimeContext: true
15
              suffix: Your working directory is {{cwd}}.
16
              prefix: >-
17
                You are Claude Code, Anthropic's official CLI ...
18
                # Core Operating Principles 1. Direct Action: ...
19
          # ... 省略：工具行与两个隔离组，见下图

三、实测一：装上去，但没生效#

装好包、重启客户端、新建会话——预设列表里什么都没有。翻日志找到了这句话：

1
$ dsh plugin --profile t1 add link:/path/to/dsh-preset-claude-code
2
dsh: initialized profile t1 at ~/.dsh/profiles/t1
3
+ dsh-preset-claude-code link:/path/to/dsh-preset-claude-code
4
dsh: warning: dsh-preset-claude-code declares no dsh.bundle
5
     — installed as a plain dependency, not a profile layer

包确实装进了 node_modules，但它从来没有进入组合树。证据两条：

1
# profile manifest 里的 bundle 列表，没有我的包
2
$ python3 -c "import json;print(json.load(open('~/.dsh/profiles/t1/package.json'))['dsh'])"
3
{'profile': {'bundles': ['@deepseek-ai/dsh-base']}}
4

5
# 组合树里搜不到我的 preset
6
$ dsh --profile t1 --dump-config | grep -c preset-claude-code
7
0

原因在官方文档里写着：dsh plugin add 成功之后，DSH 会拿安装结果去对账 dsh.profile.bundles——「每个解析到声明了 "dsh": { "bundle": { "patch": "./cordis.patch.yml" } } 的包的依赖会加入层栈」，没声明的「只作为普通依赖保留，并给一次性警告」。我的 package.json 里当时没有这个字段。

修法四行 JSON：

1
{
2
  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
3
}

再装一遍，证据反转：

1
$ dsh plugin --profile t2 add link:/path/to/dsh-preset-claude-code-fixed
2
$ python3 -c "...['dsh']"
3
{'profile': {'bundles': ['@deepseek-ai/dsh-base', 'dsh-preset-claude-code']}}
4

5
$ dsh --profile t2 --dump-config | grep -n "preset-claude-code" | head -3
6
362:# == dsh-preset-claude-code
7
363:- id: preset-claude-code
8
367:    name: Claude Code 模式

（顺带一提：--dump-config 会给每一行标出它来自哪个层——# == dsh-preset-claude-code 就是这一行来自哪个 bundle 的证据。查「我的插件到底进没进树」，这一个命令够了。）

WARNING

教训：插件「装上了」和「生效了」是两件事。 判定标准只有一个——组合树（dump）里有没有你那一行。这个坑不是靠读文档能避免的：README 的安装说明照着 pnpm 的习惯写，pnpm add 返回成功，人自然认为成功了。

四、实测二：换 persona 到底值多少#

「回复变短了」这种话不算结论，所以做了一次尽量只动一个变量的对照。

设置（除了 persona，全一样）：

两个测量细节值得说一下，因为它们让「感觉」变成了「数」：

• 测试到底跑没跑：测试脚本每次被执行都往 runs.log 追一行。模型说「测试通过」不算数，文件里的记录才算。
• token 与工具调用：从 $DSH_HOME/sessions/**/session.v4.jsonl.zstd（多帧 zstd）解出事件流，统计 assistant/message 的 usage 和 tool/call 的计数，不靠肉眼估。

比 token 数更有意思的是工具路径变了。默认人设下它用 bash 去探路（5 次）；Claude Code 人设下变成先 glob 找结构、再 read 读文件，bash 只用来跑测试（3 次）。这不只是「话少了」，是行为路径变了——从「边试边看」变成「先定位再动手」。

NOTE

边界要说清楚：n=1，一道题，一次运行，样本小，只说明方向，不构成基准测试。另外这次实验是把 persona 前缀挂到 deployment 的 system-prompt 行上跑的（headless 一次性任务没有预设注册表，没法选预设），所以它衡量的是提示词那部分的收益，不等于整个 preset 的收益。要更硬的结论，需要多题、多次、多模型地跑。

五、使用感受#

先说好的：

• 最直观的变化是动手变早了：默认人设下它习惯先叙述再执行，现在是直接调工具；complete: true 把身份完全接管之后，这种自述倾向被压得很明显。
• 改完会自己跑测试，报错自己读栈、自己修、再验一遍——这是我手动提醒次数掉得最多的一项。
• plan mode 那条最实用：动代码之前先把方案摆清楚、等 exit_plan_mode。这段「架构师姿态」是写进 plan-mode 的 section 里的，所以它是提示词级的约束，不是靠模型自觉。
• 工具集是显式列的，所以我很清楚「这个模式下模型手里有什么牌」，而不是跟着宿主走。

再说代价和还没解决的：

1. >- 折叠标量把编号列表拍平了。 dump 出来我的 prefix 是这么一行：# Core Operating Principles 1. Direct Action: ... 2. Codebase Grounding: ...——八个原则挤成一整段，标题和编号的结构信息丢了大半。这是我下一步第一件要改的事：换成 |（literal block）保留换行。
2. complete: true 是双刃剑。 干净（宿主不能追加任何提示词文本）的另一面是：提示词得自己写全，漏了就是真没有。
3. order: 0 只解决排序，不解决默认。 registry 的 default 仍然是 standard；想让它成为默认，还得改 registry 的 default 配置。
4. bundle 层的变更要重启。 装/删 bundle 之后，正在跑的 profile 不会热更新（官方文档明确写了这个启动边界），只有 cordis.patch.yml 的普通编辑才走热重载。桌面端就是「重启客户端」。
5. 校验只能静态做（见 2.2）。这是目前最真实的缺口：这个插件的「正确性」眼下只由一条 grep 式的断言和我的手工 dump 保证。

一句话总结： 提示词层是当前性价比最高的一档——不动模型、不动工具、不动权限，只换一段 persona，换来的行为差异可以量化。尤其对「整天在不同 agent 之间切」的人来说，把工作方式做成一份可安装的配置，比反复口头提醒可靠得多。

六、想自己写一个 preset 插件？三步#

1. 写 cordis.patch.yml：insert 一行 @deepseek-ai/dsh-agent-preset，config 写全（patch 是整行替换，不深合并）；
2. package.json 里声明 dsh.bundle.patch，然后 dsh plugin --profile <name> add <包名或本地路径>；
3. 验证：dsh --profile <name> --dump-config | grep <你的 preset id>，顺手 --dump-config-schema 看你的行有没有进 schema。

如果只是自己用、不打算分发，还有更轻的一条路：dsh --profile web --patch ./cordis.patch.yml——把它当覆盖层用，什么都不用安装。

参考#

• 插件仓库：https://github.com/ABK3528/dsh-preset-claude-code
• dsh CLI 行为参考（profile 启动、插件管理、配置 dump 的分层与覆盖规则）：https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/reference/README.md
• 包文档：@deepseek-ai/dsh-persona（complete / includeRuntimeContext / scope-only 的原因）、@deepseek-ai/dsh-agent-preset-registry（预设注册表与 roster）