预设分类器 anonamerjaxon-dev/dsh-preset-categorizer

dsh-preset-categorizer

把插件、MCP 服务器和技能归类到 DeepSeek Harness 智能体预设里。

DSH 自带一组手写的智能体预设。这个插件读取实际安装的内容，把能力分组，再按类别向宿主的预设注册表注册每个类别一个预设——这样类别就成了 GUI 预设选择器里的一等条目。

它识别全部三种能力，不只是技能：

| 类型 | 能看到什么 | 如何划进预设 |
| 插件 | 由包支撑的加载器条目（dsh-ffmpeg、dsh-image-gen） | 一行插件 |
| MCP | 由 @deepseek-ai/dsh-mcp-client 支撑的加载器条目 | 一行 MCP，带服务器自己的配置 |
| 技能 | ~/.agents/skills 下的技能目录 | 一行技能服务商，对应一个技能根目录* |

为什么

配置档 bundles 里的能力会挂载进每个会话、每个预设。这对 harness 自身的机制合适，对其他一切都不合适：一个插件加了六个工具，每个会话就要为这六个工具付出 schema 开销，不管会话会不会用到它们。

内置预设靠手写解决这件事——Creative 带 drawio、Blender 和 FigCraft；Office 带 GenOffice；Media 带 ffmpeg 和 Remotion。只要安装的能力集合不变，这样就行；一旦变了，手写清单就开始漂移。

这个插件从机器上推导出同样的东西。

安装

dsh plugin --profile web add dsh-preset-categorizer

或者从本地检出安装：

dsh plugin --profile web add "link:/path/to/dsh-preset-categorizer"

把它挂载在预设里，不要放进 bundles。 它不加任何工具，但确实会在启动时运行，还会往选择器里加预设，所以只应出现在需要它的会话里：

~/.dsh/profiles/web/cordis.patch.yml, inside the Creative preset
- id: preset-categorizer
name: dsh-preset-categorizer
config: {}
The loader reads inject from the ENTRY ROW, not from the module's
exports. Without it, ctx.agentPresets throws "cannot get property
agentPresets without inject".
inject:
- loader
- agentPresets

行为方式

三条规则，按重要程度排序：

1. 只增不改。 它创建的每个预设 id 都以 cat- 开头。宿主已有同 id 预设时，跳过并报告。它绝不编辑、替换或删除已有预设，也绝不碰配置档的 package.json。
2. 绝不搬动。 插件只报告什么该放哪里，不会把能力从宿主组合里卸载。搬动是有代价的决定——bundles 里的插件同时也是加载 Web UI 的那个——所以留给人类。
3. 不加任何工具。 一个自带 schema 的分类器，会花掉它本要保护的预算。

包缺失时丢掉那一行，而不是整个预设

预设里写了一个包，但配置档里没有这个包，挂载就会失败，在选择器里显示为红色。所以分类器先读配置档的 package.json，把这类行丢掉：

cat-media → [ffmpeg, remotion-skills] 配置档里两者都有 cat-media → [remotion-skills] 配置档里没有 dsh-ffmpeg

技能按根目录划分，不按单个技能划分

技能服务商挂载的是目录，一台机器上的技能通常放在共享根目录里。所以「要 genoffice 但不要 mineru」没法写成预设——分类只能声明「挂载这个根目录」。两个分类声明同一个根目录，就会把同一个服务商挂载两次，因此先匹配到的生效，后一个会被报告出来。

验证

插件会自己写一份报告，其中包含宿主自己的清单，每个预设带一个 broken 标记：

cat ~/.dsh/preset-categorizer-report.json

{
"report": {
"registered": 5,
"capabilities": 209,
"plugins": 194,
"mcps": 5,
"skills": 15
},
"roster": [
{ "id": "cat-docs", "name": "Documents (office / pdf)" },
{ "id": "cat-web", "name": "Browser (playwright)" }
]
}

分类规则有单元测试：

node test.mjs

配置

分类以纯数据形式放在 lib/categories.js 里。每个分类声明自己匹配什么、预设带什么：

{
id: 'cat-web',
kind: 'mcp',
preset: {
id: 'cat-web',
name: 'Browser (playwright)',
order: 42,
mcpRows: [{ id: 'mcp-playwright', name: MCP_CLIENT, config: { /* ... / } }],
skillRoot: null,
},
include: ['mcp-playwright'],
exclude: [],
}

include / exclude —— glob 模式（、?），匹配能力的 id、name 和 package。exclude 优先。
mcpRows —— 字面量的加载器行。MCP 服务器靠配置挂载（serverName、transport、command/url），这些没法从包名推导出来。
* skillRoot —— 要挂载的技能目录的绝对路径。

先匹配到的分类生效，所以列表顺序有意义。

安全

* 不联网。 插件不发任何形式的对外请求。
* 不起子进程。 没有 exec，没有 spawn，没有 eval。
* 只读：~/.agents/skills 下的技能目录，以及配置档的 package.json。
只写一个文件：~/.dsh/preset-categorizer-report.json，只含名称和计数——没有绝对路径，没有凭据。
* 不碰其他东西。 不改配置档清单，不改补丁文件，不动已有预设。

许可证

MIT —— 见 LICENSE。