插件工坊 KERBALMans/dsh-plugin-studio

插件工坊 · dsh-plugin-studio

一个页面管好 DeepSeek Harness 的插件和技能：三级自动分类、批量删除、AI 大白话讲解、最后使用时间、一键打包。

它是 dsh-modpack（插件整合包）的下一代：原来的整合包只负责「打包带走」，工坊负责「平时怎么管」。

插件工坊界面

上面这张是真实运行截图，不是设计稿。31 个插件按三级树排列，每行前面有复选框，右侧是最后使用时间和操作按钮。

目录

- 为什么要有它
- 六个功能
- 安装
- 界面说明
- 使用场景
- 常见问题
- 开发
- 跨版本兼容
- HTTP 接口
- 数据存放
- 相关文档

为什么要有它

装了十几个插件之后，Harness 的设置页会变成一长串平铺的列表。你想删掉几个不用的，但：

- 看不出哪个是干什么的 —— 名字是 dsh-plugin-rea，描述是一句英文，删了怕坏；
- 不敢删 —— 不知道删了会不会影响正在用的东西；
- 不知道哪个真的没用 —— 「我好像三个月没碰它了」是感觉，不是证据；
- 插件和技能是两套地方 —— 管了插件还得另外管技能。

工坊把这四件事合到一个页面里：分类 → 看懂 → 看使用记录 → 批量删。

六个功能

1. 三级自动分类，不留「无法判断」

每个插件和技能都会被归到 一级（大类）→ 二级（能力域）→ 三级（它自己） 的三层树里。

一级分类共 8 个（lib/classify.js 的 FAMILIES）：

| 一级 | 管什么 | 举例 |
| 界面与交互 ui | 给用户看和点的 | 壁纸、主题、侧栏、浮层 |
| 工具与执行 tools | 给模型加能力的 | 新工具、斜杠命令、MCP 服务 |
| 网络与数据 net | 联网或读写外部数据 | 抓取、同步、接口、账号 |
| 模型与推理 model | 接模型或改推理过程 | 模型接入、提示词、上下文压缩 |
| 会话与工作区 session | 管会话和文件 | 会话增删、工作区、终端 |
| 运维与诊断 ops | 管插件本身 | 插件管理、技能管理、诊断、备份 |
| 系统与内核 core | Harness 自带底座 | 通常不该删 |
| 其它与待确认 other | 证据不足但已归档 | 附原因，可人工改判 |

关于「不再出现无法判断」：other 这一级在分类法里保留着，但它是一个有归属的归档，不是「判断失败」——每一行无论证据多弱，都会拿到一个 family、一个 domain 和一条 evidence 说明理由，confidence 会诚实地标 low。实际在本机 28 行真实数据上，other 的命中数是 0。

分类不是「第一条规则命中就定案」，而是加权评分：

- PURPOSE（10 分）：作者自己写的标题和描述，只投一票，按「最窄的声明优先」排序；
- CAPABILITY（3–10 分）：代码里真正调用的服务。调 pluginManager 得 10 分、llm 8 分、tools 7 分、sessionQuery 6 分……这是最有辨识度的证据；
- AMBIENT（1–2 分）：几乎所有插件都有的东西。注册一个 UI 插槽、dsh.client 字段、fetch、fs——这些只用来打平手。

为什么不用「注册了 UI 插槽就是 UI 插件」？ 因为那回答的是「它画不画东西」，不是「它是干什么的」。优惠券插件、会话清理插件、插件管理器都画东西，但它们分属网络、会话、运维三个大类。早期版本正是踩了这个坑：9 个插件里 7 个被塞进「界面」，一级分类直接塌成一支，三级树失去意义。

同分时按 TIE_ORDER = ['tools','net','model','session','ops','core','ui','other'] 裁决——更具体的赢，ui 永远最后。

2. 复选框批量删除 + 重启提示

每个插件/技能前面有复选框，可以单选也可以多选，选中后底部出现操作条。点删除会先弹确认框，列出具体哪几个会被删。

删除走的是 Harness 自己的 pluginManager.removeBundle()，不是手删文件。返回结果里的 application 字段决定要不要提示重启：

- applied → 已生效，不用重启；
- restart-required → 弹提示，并说明为什么要重启（lib/remove.js 的 RESTART_TEXT 把 restartReason 翻译成人话）：
- no-hmr —— 这个包没有热重载，改完得重启才能换掉正在跑的代码
- package-moved —— 包被移走了，进程还拿着旧路径
- host-module —— 改的是宿主侧模块，只有重启才重新加载
- unmanaged-plugin —— 这个插件不是包管理器装的，得重启
- module-comparison —— 模块版本对不上，重启才能统一

有些行是不可删的（官方底座、只读、来源不明），它们会显示锁图标，复选框直接禁用，并在 removable=false 时给出原因。

删除是串行的：每删一个都会重写 profile 的依赖清单和 patch 文件，并发会丢改动。

3. AI 大白话分析

点每一行的「讲解」按钮，它会结合三样东西推理：

1. 代码实际做了什么 —— 读 package.json 的入口、dsh.bundle.patch、dsh.client，读源码里的 slots.register(...)、tools.register(...)、llm.prepareCall 等调用，提取注册了哪些插槽、提供了哪些工具名、碰了哪些子系统；
2. 作者自己怎么说的 —— 包的 description、README 开头、locale 里的 meta.description；
3. GitHub 上能找到什么 —— 按包名搜 GitHub，校验仓库名或描述里真的出现了这个包名才算命中（防止同名项目误认），再取 README 开头作为佐证。结果缓存 7 天。

输出是三个字段，全部说人话：
- what —— 它帮你做什么（「会在设置里加一个页面，让你给对话窗口换动态壁纸」）；
- remove —— 删了会怎样（「删掉之后壁纸变回纯色，不影响聊天」）；
- why —— 依据是什么（「代码里注册了 settings.section，并且调用了 theme.overrideTokens」）。

提示词里写死了一条规矩：先说帮你做什么，再说删了会怎样。不给术语，不说「该插件实现了 X 接口」。

4. 最后使用时间

这一列回答「我多久没碰它了」。数据来自 Harness 自己的会话日志（sessionQuery.listSessions() + readSession()，没有这个服务时回落到直接读 ~/.dsh/sessions//session.v4.jsonl.zstd）。

关键设计：区分「用过」和「提过」。

- 真的用过（usedAt / usedVia）：会话日志里出现过 tool/call，工具名匹配这个插件注册的工具。这才显示成「最后使用」。
- 只是被提到（mentionedAt）：名字在对话里被说起过。这不算使用，单独用次要样式显示。

为什么较真？ 早期版本把「被提到」也算成使用，结果我们一边讨论插件、一边所有插件都被标成「刚刚使用」——28 行里 19 行都有时间，这一列直接失去意义。一条错误的信息比没有信息更糟。

日志读取有个坑：session.v4.jsonl.zstd 是多帧 zstd 拼接，zstdDecompressSync(整个文件) 只解第一帧。lib/usage.js 的 decompressFrames() 按 zstd magic 28 B5 2F FD 扫描全部帧偏移，逐帧解压再拼接。

5. 技能管理页（和插件页功能对等）

第二个 tab 管技能，功能和插件页一致：三级分类、搜索筛选、复选框批量删除、一键打包。

技能从四个根目录扫描（lib/skills.js 的 skillRoots()）：

| 根目录 | scope |
| <DSH_HOME>/skills | user-dsh |
| <DSH_HOME>/agents/skills | user-agents |
| <cwd>/.dsh/skills | project-dsh |
| <cwd>/.agents/skills | project-agents |

优先用 skills.list() 服务拿清单，拿不到就自己扫目录（读 SKILL.md 的 frontmatter 取 name / description / when_to_use）。

删除技能有两道守卫：必须是目录、目录里必须有 SKILL.md——防止路径算错时删掉无关目录。

技能的二级分类比插件更细：tools.skill.doc（文档处理，office 系列）、tools.skill.dev（开发与诊断）、tools.skill（其它）。

6. 重命名 + 重新设计的界面

名字从「插件整合包」改成「插件工坊」，包名从 dsh-modpack 改成 dsh-plugin-studio，接口前缀改成 /api/dsh-plugin-studio。

界面设计上遵守了 Harness 客户端的三条硬规矩：

- 只用主题 token —— 13 个 --dsw-alias- / --dsw-specific- 变量，零硬编码色值，深浅色自动跟随；
- 不碰别人的 DOM —— 不 append 到 document.body、不查询别人的元素、不用 innerHTML；
- 样式可清理 —— 一个 标签，用 ctx.effect() 注册，卸载时自动移除。

三个 tab：插件 / 技能 / 整合包。视图可以在「三级树」和「平铺列表」之间切换，树可以逐级折叠，每个分组都有「全选本组」。

安装

方式一：从 GitHub 安装（推荐）

plugin_manager action: install_bundle
target: github:KERBALMans/dsh-plugin-studio

装特定版本：

plugin_manager action: install_bundle
target: github:KERBALMans/dsh-plugin-studio#v1.0.0

方式二：从 tgz 安装（离线/内网）

从 Releases 下载 dsh-plugin-studio-1.0.0.tgz，然后：

plugin_manager action: install_bundle
target: E:\下载路径\dsh-plugin-studio-1.0.0.tgz

方式三：从本地目录安装（改代码时用）

plugin_manager action: install_bundle
target: E:\你的路径\dsh-plugin-studio

安装后 profile 里会出现一个指向源目录的 Junction，改源码即刻同步到 profile 磁盘。

安装完成后

打开 设置 → 插件工坊（在侧栏设置里，位于「插件」下面、「智能体预设」上面）。

装完看不到？ 如果页面没出现，重启一次客户端。运行中的 Host 会缓存已加载的 ES 模块，plugin_manager 报告 application: "applied" 只说明依赖装好了，不说明新代码已经在跑。

改完代码不生效？ 不用重启，禁用再启用一次即可： plugin_manager action: set_plugin target: "include:dsh-plugin-studio" enabled: false plugin_manager action: set_plugin target: "include:dsh-plugin-studio" enabled: true

界面说明

三级分类树

顶部：三个 tab

| tab | 管什么 |
| 插件 | 已安装的插件包（bundle） |
| 技能 | 技能工具（skill），功能与插件页对等 |
| 整合包 | 已保存的整合包，可一键装回 |

每个 tab 右边有计数，比如「插件 31」。右上角是刷新按钮。

工具栏

从左到右：

- 搜索框 —— 按名字、包名、描述搜，实时过滤；
- 筛选 chips —— 全部 / 已启用 / 90 天未用 / 可删除 / 低置信度，可以同时选多个（是"与"关系）；
- 视图切换 —— 三级树 ↔ 列表视图；
- 展开全部 / 收起全部 —— 只在树视图下出现。

三级树

界面与交互 2 个插件 [全选本组] ├─ 主题与外观 1 │ └─ ☐ dsh-plugin-wallpaper-engine │ Wallpaper Engine backgrounds for the DSH web GUI... │ 最后使用：3 天前 [讲解] [展开] └─ 界面插件 1 └─ ☐ ...

- 一级（粗体）：8 个大类之一；
- 二级：能力域，每个大类下 1–5 个；
- 三级：插件本身。

每一级都能点击折叠。二级标题右边有「全选本组」，勾上就选中这一组的所有插件。

每一行长什么样

☐ dsh-plugin-rea 官方 已启用 高置信度 MCP server for reverse engineering tools... 最后使用：2 小时前（工具调用） ▸ 依据：代码里注册了 tools.register，并且调用了 ...
[讲解] [展开]

- 复选框 —— 最左边，点它选中；
- 名称 + 徽章 —— 官方（Harness 自带）、已启用/已停用、高置信度/中置信度/低置信度、只读（不可删）；
- 描述 —— 作者写的一句话；
- 最后使用 —— 见下方说明；
- 依据 —— 折叠的判定理由，展开能看到具体证据；
- 讲解 —— 点它调 AI 生成大白话说明；
- 展开 —— 显示完整描述、包名、版本、来源、注册了哪些插槽/工具。

关于「最后使用」这一列

有两种显示，含义不同：

| 显示 | 含义 |
| 最后使用：2 小时前（工具调用） | 真的用过 —— 会话日志里有工具调用命中它注册的工具 |
| 最后使用：— + 灰字 5 天前提到过 | 只是被提到 —— 名字在对话里出现过，但没有实际调用 |

为什么要区分？ 因为"提到"不等于"使用"。你在对话里说"这个插件不错"，不代表它工作了。如果混在一起，讨论插件的时候所有插件都会显示"刚刚使用"，这一列就失去意义了。

底部操作栏

勾选任意插件后，底部浮出操作栏：

已选 3 个 [打包] [删除] [取消选择]

- 打包 —— 把这 3 个打包成整合包，可以保存或分享；
- 删除 —— 弹确认框，列出具体哪几个会被删，确认后执行。

删除确认框

删除 3 个插件？

dsh-plugin-wallpaper-engine
dsh-aliyun-coupon
dsh-session-clean

这个操作会从 profile 里移除它们，并重写依赖清单。
[取消] [确认删除]

删除后，如果某个包需要重启才能完全卸载，会再弹一个提示说明原因：

- 「这个包没有热重载，改完得重启才能换掉正在跑的代码」
- 「改的是宿主侧模块，只有重启才重新加载」

整合包 tab

显示已保存的整合包列表，每个显示名称、条目数、创建时间。可以删除。

使用场景

场景一：清理长期不用的插件

1. 打开插件工坊
2. 点筛选 chip 90 天未用
3. 列表只剩很久没碰过的插件
4. 逐个看描述和最后使用时间，勾选要删的
5. 点删除，确认

场景二：搞不清某个插件是干什么的

1. 找到那个插件
2. 点 讲解
3. 等几秒，AI 会给出三段说明：
- 它帮你做什么 —— "会在设置里加一个页面，让你给对话窗口换动态壁纸"
- 删了会怎样 —— "删掉之后壁纸变回纯色，不影响聊天"
- 依据是什么 —— "代码里注册了 settings.section，并且调用了 theme.overrideTokens"

场景三：换电脑，把插件配置带走

1. 在插件页勾选想带走的插件
2. 点 打包
3. 起个名字，保存
4. 把 整合包 tab 里的文件拷到新电脑
5. 在新电脑上用 plugin_manager 应用，或者用 studio_list 工具

场景四：管理技能

技能页和插件页功能一样：三级分类、搜索、筛选、批量删除、打包。8 个内置技能会被分成「文档处理技能」（office 系列 7 个）和「开发与诊断技能」（1 个）。

常见问题

装完之后设置里没有「插件工坊」

1. 确认安装成功：plugin_manager action: list_bundles，找 dsh-plugin-studio
2. 如果列表里有，但页面没有，重启客户端
3. 如果列表里没有，重新安装

页面打开是空白的

页面顶部如果有红条提示「客户端与宿主版本不一致」，重启客户端即可。这是防止新旧代码混跑的保护。

AI 讲解一直转圈或报错

AI 功能需要可用的模型。检查：

1. 设置 → 模型 里有没有配置好的模型
2. 网络是否可达（GitHub 检索需要联网）

没有模型时，讲解按钮会显示"当前没有可用的模型"，不会卡住。

最后使用时间一直是空的

说明这个插件注册的工具从来没被调用过。这是正常的——很多插件是纯 UI 的，不注册工具，所以永远不会有"工具调用"记录。这种情况下会显示"未使用过"。

删除按钮是灰的

那一行不可删。原因可能是：

- 它是 Harness 官方底座（removable: false）
- 它是只读的
- 它的来源不明（不是通过包管理器装的）

鼠标悬停能看到具体原因。

删除后插件还在

1. 看删除时有没有弹重启提示。弹了就重启客户端
2. 重启后还在的话，检查 plugin_manager action: list_bundles 确认
3. 如果确实还在，可能是删除失败，重新删一次看错误信息

技能删除后还在

技能的启用/禁用是通过写 .disabled 标记文件实现的。删除会真的删目录，但需要重启才能让 Harness 重新扫描。

开发

目录

dsh-plugin-studio/
├── index.js Host 半：apply()、HTTP 路由、Agent 工具 ├── client.js Client 半：设置页 UI ├── cordis.patch.yml bundle 插入声明 ├── package.json ├── icon.svg ├── locale/{zh,en}.json ├── lib/ │ ├── env.js 路径、请求体、JSON 响应、服务查找 │ ├── caps.js 能力探测（按方法存在性，不看版本号） │ ├── inventory.js 插件清单（pluginManager 优先，文件回落） │ ├── classify.js 三级分类：FAMILIES / DOMAINS / 加权评分 │ ├── usage.js 最后使用时间（会话日志扫描） │ ├── skills.js 技能清单、删除、启停、打包 │ ├── ai.js AI 讲解与 AI 分类 │ ├── remote.js GitHub 检索与缓存 │ └── remove.js 删除与重启提示 └── scripts/ 测试套件（见下）

测试

八个套件，全部不需要跑起 GUI：

node scripts/smoke.mjs # 能力探测、清单回落、分类法自检
node scripts/analyse.mjs # 真实数据跑完整管线
node scripts/routes.mjs # 每个 HTTP 路由
node scripts/actions.mjs # 打包、保存、删除、分类的读写
node scripts/ai.mjs # AI 路由在无模型时的降级
node scripts/style.mjs # 样式与模块契约审计
node scripts/render.mjs # 用 React 替身渲染出真实 HTML
node scripts/compat.mjs # 跨版本契约

调试用：

node scripts/scores.mjs # 打印每行的评分明细
node scripts/why.mjs <包名片段> # 某一行为什么被分到那里
node scripts/measure.mjs # 用 headless Edge 量布局

改完代码怎么生效

不用重启客户端：

plugin_manager action: set_plugin target: "include:dsh-plugin-studio" enabled: false
plugin_manager action: set_plugin target: "include:dsh-plugin-studio" enabled: true

禁用再启用会强制 Host 重新加载模块。

跨版本兼容

engines.dsh 写的是 >=0.2.0-rc.1。真正让插件跨版本活下来的不是版本号，是按方法存在性探测能力：

function has(target, name) {
return !!target && typeof target[name] === 'function'
}

版本号告诉你发布者想给你什么，缺失的函数告诉你这个进程实际能做什么。

scripts/compat.mjs 为五个契约建模并逐个验证：

| 契约 | 模拟什么 | 结果 |
| 0.2.1-rc.1 | 没有 removeBundle、没有 inspect、没有 skills 服务 | 降级运行，删除按钮禁用 |
| 0.2.1-rc.2 | 加上 removeBundle | 删除可用 |
| 0.2.1-rc.3 | 当前版本，全量服务 | 全部功能 |
| future-additive | 未来版本：只加不改，多出 somethingBrandNew 等未知方法 | 未知方法被忽略，行为不变 |
| future-renamed | 未来版本：删掉 listBundles | 回落到读 profile 文件，清单仍出得来 |

每个契约都断言同一组事：能力探测不抛、路由构建不抛、根路由返回 apiVersion、清单非空且每行有三级分类、无 other、分类有区分度、官方可选包没被判成内核、壁纸判成界面、会话清理判成会话、技能路由不崩、删除不存在的行被拒绝且不产生删除记录。

最后还有一段「空 ctx」：所有服务都拿不到时，capabilityReport() 要报出缺失项而不是抛异常，根路由仍要返回 200——这样 UI 能告诉用户"这个版本缺什么"，而不是白屏。

已知限制：本机只装了 0.2.1-rc.3，rc.1 / rc.2 无法真实安装验证，所以用的是契约级验证（模拟各版本的服务面）。这在工程上等价于"按接口编程"的验证，但不等价于"真的在 rc.1 上跑过"。

HTTP 接口

所有接口在 /api/dsh-plugin-studio 下，先过 connection.admit() 鉴权。

| 方法 | 路径 | 作用 |
| GET | / | 版本与接口清单 |
| GET | /inventory | 插件清单 + 三级树 + 使用时间 |
| GET | /skills | 技能清单 + 三级树 |
| GET | /saved | 已保存的整合包列表 |
| GET | /diag | 能力探测、模型、各根目录 |
| POST | /pack | 打包成整合包 |
| POST | /save | 保存整合包到磁盘 |
| POST | /delete-pack | 删除已保存的整合包 |
| POST | /categories/save | 手动改判分类 |
| POST | /categories/reset | 清空手动改判 |
| POST | /suggest | AI 批量分类 |
| POST | /explain | AI 大白话讲解 |
| POST | /remove | 删除插件 |
| POST | /skills/remove | 删除技能 |
| POST | /skills/enable | 启用/禁用技能 |
| POST | /skills/pack | 打包技能 |
| POST | /plan | 预览应用整合包会做什么 |
| POST | /apply | 应用整合包 |

智能体工具

给模型用的三个工具：

- studio_list —— 列出插件或技能（带三级分类）；
- studio_explain —— 讲解某个插件；
- studio_remove —— 删除插件（支持 dryRun）。

数据存放

<DSH_HOME>/storages/dsh-plugin-studio/
├── plugin.json 安装标记 ├── categories.json 手动改判 + AI 讲解缓存 ├── remote-cache.json GitHub 检索缓存（7 天） └── packs/ 已保存的整合包

整合包格式：

{
"format": "dsh-plugin-studio-pack",
"formatVersion": 1,
"meta": { "name": "...", "description": "...", "createdAt": 0, "kind": "plugin", "count": 0 },
"entries": [
{
"key": "bundle:xxx",
"kind": "bundle",
"name": "xxx",
"version": "1.0.0",
"spec": "xxx@1.0.0",
"category": { "family": "ui", "domain": "ui.theme", "familyLabel": "界面与交互", "domainLabel": "主题与外观" },
"enabled": true,
"official": false,
"description": "..."
}
]
}

许可

MIT

相关文档

- 手动上传到 GitHub 网页版 · 小白超详细教程 —— 如果你想自己把这个插件传到自己的仓库，或者把它改成你的项目发布出去，这份教程从注册账号开始，一步一步点鼠标，不需要命令行。
- 更新日志