在 DSH 0.1.0-rc.7 上安装后 dsh web 无法启动：`keyed slot "settings.plugin.item" requires options.key`

[znxkxx]

环境

• 插件：dsh-reasoning-settings v0.3.0
• DSH：@deepseek-ai/dsh ^0.1.0-rc.7（npx 安装）
• 安装方式：dsh plugin --profile web add github:JuneLearn/dsh-reasoning-settings
• 平台：Windows / Node v22.23.2 / pnpm 11.22.0

问题

安装插件后执行 dsh web，启动直接失败，报错：

HARNESS
Failed to load plugins
dsh-reasoning-settings
failed to apply loader entry c4addc8e (dsh-reasoning-settings): keyed slot "settings.plugin.item" requires options.key

移除插件后启动恢复正常。

根因分析

settings.plugin.item 是一个 keyed 插槽（官方声明见 dsh-client-ui-settings-plugins：

children: { "settings.plugin.item": { kind: "keyed", scope: "root" } }

官方往该槽注册卡片时都带 key：

ctx.slots.register({ name: "settings.plugin.item", key: SHELL_NS, ... }, BashCard)

而本插件客户端代码 lib/client.js 的 apply() 里注册时用的是 id 而没有 key：

ctx.slots.inject('settings.plugin.item', () => ctx.slots.register({
  name: 'settings.plugin.item',
  id: 'reasoning',      // ← keyed slot 要求 options.key
  order: 20,
  locale: 'settings.reasoning',
  inject: () => ({ api: connection.api, remote: ctx.remote, t }),
}, ReasoningCard))

在 DSH rc.7 中，加载器会强制校验 keyed 插槽的注册必须携带 options.key，因此启动失败。

建议修复

把 id: 'reasoning' 改为 key: 'reasoning'（或两者同时保留），与官方写法保持一致。

复现步骤

1. 在 DSH rc.7 上安装 v0.3.0；
2. 运行 dsh web；
3. 启动失败，输出上述报错。

谢谢！

[wxaef]

我在 Windows + DSH 0.1.0-rc.7 上测试了一下，已经找到可以正常工作的修改方式。

lib/client.js 中原来是：

ctx.slots.register({
  name: 'settings.plugin.item',
  id: 'reasoning',
  ...
})

新版 DSH 的 settings.plugin.item 是 keyed slot，需要使用 key。

不过仅修改成：

key: 'reasoning'

虽然可以消除：

keyed slot "settings.plugin.item" requires options.key

但 Reasoning effort 设置页面不会出现。

我最终测试成功的修改是：

ctx.slots.register({
  name: 'settings.plugin.item',
  key: 'llm-pi-ai',
  ...
})

也就是：

- id: 'reasoning',
+ key: 'llm-pi-ai',

修改后重启 dsh web，Reasoning effort 页面正常出现，插件可以正常使用。

测试环境：

Windows
Node.js v24.5.0
DeepSeek Harness 0.1.0-rc.7

希望能对 rc.7 的兼容修复有帮助。


### 如果你想贡献得更直接

还可以直接给作者提 **Pull Request**。仓库目前 Pull Requests 是 0。:contentReference[oaicite:2]{index=2}

做法就是：

1. 点仓库右上角 **Fork**
2. 在你的 Fork 打开 `lib/client.js`
3. 把：
   ```js
   id: 'reasoning',

改成：

key: 'llm-pi-ai',