插件管家 Eveneve-night/dsh-plugin-steward

dsh-plugin-steward · 插件管家

English · 中文

DeepSeek Harness 的插件管理，从聊天输入区就能打开：列出所有已安装的 bundle，开关插件，编辑每个插件的设置，还能在单个会话里隐藏某个插件的工具和 MCP 服务器。

English · 中文

dsh-plugin-steward 在输入区加一个按钮（🧩 插件），再加一个设置页。宿主端在运行中的 harness 进程里注册几条同源 HTTP 路由；客户端是 web UI 加载的单个未打包模块。它不启动额外进程，也不存任何凭据。

icon

功能

| 功能 | 行为 |
| 目录 | 列出所有已安装的 bundle（第三方和内置）以及每条 loader 记录，含标题、版本、描述、包名和当前状态。 |
| 全局开关 | bundle 走 pluginManager.setBundleEnabled，loader 记录走 setPluginEnabled。结果会报告为已生效 / 需重启 / 被覆盖 / 失败。插件拒绝禁用自己（HTTP 409），入口点不会消失。 |
| 单插件设置 | 每行旁边的 ⚙ 打开设置抽屉。宿主读取该行的 schemastery Config 并推导表单：string、number（带 min/max）、boolean、enum 和 JSON 控件，每项都带默认值；字段易变时还会标 reload。保存时只把改动过的字段通过 configEditor.edit() 发出去。 |
| 按会话限制 | 本对话标签页在单个会话里对模型隐藏某个插件的工具或整个 MCP 服务器。它对该智能体调用 agent.ctx.tools.restrict()，所以对已在运行的会话从下一次请求起生效。策略按会话保存，重载或重启后重新应用。 |
| 自动描述 | 插件没提供 meta.description 时，宿主从插件自己的 README、客户端 slot id 或 package.json 里提炼一句话（≤ 90 字符）。作者写的描述永远优先；✨ 按需重新生成，并标注来源。 |
| 新插件发现 | 每 5 分钟静默扫描一次，把新出现的 bundle 和 loader 记录记为待确认。按钮上显示橙点；面板里一键确认。 |
| 内核区 | DSH 自带、且在当前配置档里实际装配的 bundle，单独列在只读的 内核 标签页里，带 🔒。它们的启用逻辑在后端与第三方插件隔离。 |
| 共存 | 如果装了能力面板类插件（dsh-capability-panel、dsh-capability-composer、@super_camel/dsh-plugin-panel），面板会显示一条提示指向它，不重复实现它的实时上下文状态。 |

入口：

- 输入区工具行左侧（conversation.input.left）的 🧩 插件 → 浮动面板，含 全局 和 本对话 两个标签页。
- Settings → 插件管家（settings.section）→ 发现设置、配置档路径、按会话的策略列表。

安装

from GitHub
dsh plugin add github:Eveneve-night/dsh-plugin-steward

from npm (if published)
dsh plugin add dsh-plugin-steward

也可以用插件管理器把目录本身作为 bundle 安装：

plugin_manager action: install_bundle
target: <path to this checkout>

bundle 会在组合里加一行：

- insert:
- id: plugin-console
name: 'dsh-plugin-steward'

重载一次 Web UI（客户端那一半在页面加载时注入）。改完源码后，对 include:plugin-console 执行 set_plugin，先 enabled: false 再 true。

HTTP 路由

所有路由同源，都在 /plugin-console/api 下，由客户端那一半调用。

| 方法 | 路径 | 用途 |
| GET | /catalog | 完整目录、发现状态、kernel 段、profileBundles；带 ?ack=1 时同时确认 |
| GET | /status | 待处理数量（橙点）和客户端那一半的加载状态 |
| POST | /toggle | {kind:'bundle'\|'row', id, enabled} |
| POST | /ack | 把当前插件集记为已知 |
| GET | /config?id=<entryId> | 某条 loader 行的推导表单描述和显式值 |
| POST | /config | {id, config} → 校验、持久化，再由 Loader 重载 |
| GET | /sessions | 运行中的会话，加上所有已保存的按会话策略 |
| GET | /session?id=<sessionId> | 单个会话的门控视图：可见工具、按插件分组的工具、MCP 服务器、拒绝列表 |
| POST | /session | {id, disabled: string[], disabledMcp: string[]} → 保存并立即生效 |
| DELETE | /session?id=<sessionId> | 清除某个会话的策略并撤销其限制 |
| GET/POST | /settings | 发现设置（自动确认） |
| GET | /describe?id=<package>&refresh=1 | 从插件自己的文件推导描述 |

写入的文件

- <profile>/.plugin-console/state.json — 已知的 bundle/行、待处理的发现项、设置。
- <profile>/.plugin-console/sessions/<sessionId>.json — 按会话的策略（disabled、disabledMcp）。

不改动其他任何东西；全局开关走平台自己的插件管理器。

限制

- 纯 UI 插件（壁纸、小组件、侧边栏）无法按会话开关。 客户端插件在配置档层面加载，槽位注册是全局的。这类插件，管家提供全局开关和打开其设置的方式。
- 按会话门控只覆盖全局注册的工具。 在智能体作用域内注册的工具（由预设或组合注册）仍然可见 —— tools.restrict() 触及不到它们。全局注册的插件和 MCP 服务器都在覆盖范围内。
- 设置表单按 loader 行划分。 一个 bundle 有多行时，可以切换行；没有 Config 的行显示「无可配置项」。
- 嵌套的对象/数组字段回退为 JSON 文本区。
- 自动描述采用启发式规则。 先看 README，再看客户端 slot id，最后看 package.json；来源会标注出来，也可以重新生成。

测试

node dev/smoke-client.mjs # client half: load, 3 slot registrations, panel / this-conversation / settings render
node dev/test-describe.mjs # description derivation against 6 installed plugins
node --check lib/index.js # host half syntax

它做什么

| 功能 | 行为 |
| 统一目录 | 列出全部已安装 bundle（第三方与内建）和全部 loader 行，带标题、版本、描述、包名与当前状态。 |
| 全局启停 | bundle 走 setBundleEnabled，行走 setPluginEnabled，结果区分「已生效 / 需重启 / 被覆盖 / 失败」。插件管家不允许关掉自己（HTTP 409），免得入口消失。 |
| 单插件设置 | 每行右侧 ⚙ 打开设置抽屉：宿主自省该行的 schemastery Config 生成表单（字符串、数字带范围、布尔、枚举、JSON 五类控件，带默认值与「需重载」标记）。保存只提交改动过的字段，经 configEditor.edit() 校验并写回。 |
| 按对话放行 | 面板「本对话」页把某个插件的工具、或某个 MCP 服务器，在这一轮对话里对模型隐藏。它在该 Agent 上调 agent.ctx.tools.restrict()，所以对已开始的对话也生效，下一个请求即可见。策略按会话保存，重载或重启后自动补应用。 |
| 自动描述 | 插件没写 meta.description 时，按它自己的 README、客户端 slot id、package.json 生成一句话（≤90 字）；作者写的描述永远优先，✨ 可手动重新生成，并标注来源。 |
| 自动发现 | 每 5 分钟静默扫描一次，把新出现的 bundle / 行记成「待纳入管理」，按钮上出现橙点，面板里一键认领。 |
| 内核分区 | DSH 本体自带、且当前 profile 真正组装的包单独列成只读「内核」页（🔒）；它们的启用逻辑在后端与第三方插件完全隔离。 |
| 与能力面板共存 | 检测到 dsh-capability-panel / dsh-capability-composer / @super_camel/dsh-plugin-panel 时只显示一条指向提示，不重复实现它的实时上下文状态，也不做双向同步。 |

入口：

- 输入框工具行左侧的 🧩 插件（conversation.input.left）→ 浮层面板，含「全局 / 本对话」两档。
- 设置 → 插件管家（settings.section）→ 发现设置、目录路径、按对话策略清单。

安装

dsh plugin add github:Eveneve-night/dsh-plugin-steward

或者用插件管理器把本目录当作 bundle 安装：

plugin_manager action: install_bundle
target: <本仓库的路径>

组合里会插入一行 plugin-console（见上文 YAML）。刷新一次 Web UI 使客户端半生效；改源码后用 set_plugin 把 include:plugin-console 先设 false 再设 true 即可重载。

接口与写入的文件

接口表同上，全部挂在 /plugin-console/api 下。持久化只有两处： <profile>/.plugin-console/state.json（已知集合、待认领项、设置）与 <profile>/.plugin-console/sessions/<sessionId>.json（按对话策略）。其余不做改动——全局开关走平台自己的插件管理器。

已知边界

- 纯 UI 插件（壁纸 / 挂件 / 侧栏）无法按对话开关：客户端插件在 profile 级加载，slot 注册是全局的。这类插件只提供全局启停与「打开它的设置」。
- 按对话放行只覆盖全局注册的工具：preset / composition 在 agent scope 里注册的工具，tools.restrict() 本身也限制不到。
- 设置表单是按 loader 行的：多行 bundle 可在头部切换行；没有 Config 的行显示「没有可配置项」。
- 嵌套对象 / 数组字段退化为 JSON 文本域。
- 自动描述是启发式的：可能不准，所以标注来源并可手动重生成。

自测

node dev/smoke-client.mjs
node dev/test-describe.mjs
node --check lib/index.js

License

MIT