# @hyzyn/dsh-kit-settings · kit 插件配置入口

在 DSH Web GUI 里补一行**「插件配置」页**，把 dsh-plugin-kit 插件族的配置表单收在一处。

## 为什么需要它

DSH ≥ `0.1.6-alpha.2` 把插件配置从「设置 → 插件 → 插件配置」搬到了侧边栏的「插件」页，
设置里那一行只剩只读清单（官方 `settings.plugin.item` 插槽已退役，见
[官方设计笔记](https://github.com/deepseek-ai/deepseek-harness/blob/master/.agents/notes/implemented/architecture/2026-09-16-plugin-configuration-on-the-plugins-page.zh.md)）。

如果你更习惯「设置里一行、点开就是各插件配置」的形态，装上本包即可恢复：它是官方支持的
`settings.section` 扩展点（官方的「通用设置 / 模型 / 内置插件 / Agent 预设 / 已归档会话」
五行都是这么注册的），不是绕过设计。

## 装什么

```sh
dsh plugin --profile web add @hyzyn/dsh-kit-settings
```

单独装本包不会显示任何卡片——它只是一个**宿主页**。各插件把自己的配置卡片注册进本页声明的
子 slot `settings.kit.item`，所以：

- 装了本包 + 任意 kit 插件 → 设置里出现「插件配置」行，行内是该插件的卡片；
- 只装 kit 插件、不装本包 → 设置里没有这一行（插件照常工作，配置走侧边栏「插件」页）；
- 只装本包、不装任何 kit 插件 → 这一行会显示「暂无可用配置项」。

装 `@hyzyn/dsh-all` 全家桶会自动带上本包。

## 两种配置入口的关系

kit 插件同时提供两个入口，指向**同一份配置**：

| 入口 | 位置 | 形态 |
|---|---|---|
| 官方插件页 | 侧边栏「插件」→ 选插件 → 该行的「配置」 | 新版两视图（一句话摘要 + 表单页） |
| 本包提供的行 | 设置 →「插件配置」 | 可折叠卡片 |

## 实现

- 宿主半体（`src/index.ts`）：只为让本包在 Loader 里成为一行，不注册路由、不占 settings 命名空间。
- 浏览器半体（`client.js`）：注册 `settings.section`（id `kit`，order 16，紧随官方「内置插件」），
  并通过本次注册的 `children` 声明子 slot `settings.kit.item`（`kind: 'list'`），
  再由 `renderSlot('settings.kit.item')` 渲染全部条目。
- 各 kit 插件注册进子 slot 时**不传 `view`**，于是卡片走各自原有的可折叠分支——两种形态共用同一份组件。

## License

Apache-2.0