dsh-skill-categories

DSH 技能中心 · 分类增强

English · 验证记录 · 第三方声明

技能装多了，记得名字和记得用途是两回事。这个插件把分类、标签和批量整理放进 DeepSeek Harness 的技能中心，让你在管理、导入和引用技能时都能按用途查找。

技能管理、分类与引用的功能示意

上图为功能示意，不是真实界面截图。

预览版 · 0.4.0

当前已完成构建、自动测试和独立浏览器示例验证，但尚未完成完整的已登录宿主验收。请先用测试技能试用，并备份重要数据。支持范围与已知限制见下文。

在一个技能页里完成整理

不再分别维护「技能」和「分类整理」两份列表。统一的「技能」页左侧选择分类，右侧保留原有的文件与提供者目录，以及启用、编辑、删除、复制模板等操作；「创建」「导入」仍是独立页签，编辑时显示编辑页签。

自定义分类与标签：新建、重命名、排序、删除分类；删除分类只取消归类，技能文件和标签保留。
批量整理：勾选后一起归类，标签默认保留，明确选择替换后才覆盖。当前筛选或折叠组中隐藏的勾选项不会被批量处理。
联合筛选：按分类、工作区、来源、启用状态和文件标记缩小范围；搜索同时匹配技能名称、描述、标签与分类名。
导入后归类：目录或 ZIP 导入成功后，为本次成功导入的技能选择分类。跳过归类不会撤销导入，已跳过的导入项目不加入本次提示。
在会话里按分类引用：输入框新增独立的「分类引用」按钮，选中技能后只插入引用，不自动发送消息。

统一技能管理界面

0.4 独立示例界面（Sample / not host），使用示例数据，不是已登录宿主的验收截图。

分类整理

在技能中心新建分类，勾选技能后点击「批量分类」，或使用技能行中的「分类与标签」。选择左侧分类即可查看相应技能，不需要离开当前管理页。

分类与标签管理

用户提供的早期版本截图，已裁剪并脱敏；0.4 已将「技能」与「分类整理」合并。此处仅展示操作特写，不代表当前完整布局。

分类以技能逻辑名称为键。同名技能即使位于不同工作区或路径，也共用一份分类和标签；管理列表仍保留各自的文件行与操作。非标准命名的技能可以继续浏览和管理，但暂不支持分类。

「工作区」是列表筛选器，不会切换正在使用的工作区，也不是 Agent 预设选择器。全局共享技能在所选工作区中仍然可见。

导入时顺手归类

在本插件的「导入」页选择本地目录或 ZIP。导入成功后，插件根据本次响应中实际成功的项目合并提示归类，不需要等待后台轮询。分类保存失败不会把成功导入改成失败，也不会回滚技能文件。

导入技能与归类提示

用户提供的早期版本截图，已裁剪并脱敏；0.4 已将「技能」与「分类整理」合并。此处仅展示操作特写，不代表当前完整布局。

还可以开启或关闭「发现新增技能后提示分类」。通过其他插件、手工复制或预设变化出现的新名称，采用约 10 秒一轮的完整目录检测；后台页面或其他模态窗口可能延迟提示。首次读取只建立已有目录基线，不会把全部旧技能集中弹出。

检测不会因为已知名称被删除后重新出现而重复提示；本页明确导入的名称在当前客户端运行期间去重。不完整扫描保留上次完整结果，不会据此清空分类。

输入框里的「分类引用」

打开「分类引用」，可选择全部分类、未分类或自定义分类，也可以直接输入分类名、标签、技能名称或描述中的词。原技能市场插件的「＋技能」按钮不会被替换。

按分类搜索并引用技能

用户提供的早期版本截图，已裁剪并脱敏；0.4 已将「技能」与「分类整理」合并。此处仅展示操作特写，不代表当前完整布局。

这里的候选技能来自当前会话的可引用目录，遵守该会话的预设和工作区范围。它与管理页的文件／提供者视图不是同一个目录，数量不同不一定是错误。

选中后，插件通过宿主的安全插入接口，在当前插入位置写入 /技能名称 ，不提交消息，也不替换整份草稿。若宿主拒绝插入，会显示错误，不改用覆盖草稿的方式兜底。Esc 关闭弹窗并恢复按钮焦点。

仅限制模型自主调用、但允许用户调用的技能仍可引用。子代理会话暂不显示这个按钮；缺少可选会话服务时不挂载，缺少安全输入接口时禁用。搜索结果超过 200 条时，请继续输入关键词缩小范围。

安装

兼容要求

DeepSeek Harness：>=0.2.1-rc.3 <0.3.0
Node.js：>=22.13.0
从源码构建需要 pnpm，并使用仓库中的锁文件。

这些是当前声明的兼容范围，不代表其中每一个宿主版本和第三方插件组合都已验收。

不要同时启用原技能中心与本插件。

安装本整合版前，请在官方插件管理器中停用 @linxin666/dsh-client-ui-skill-explorer，避免重复入口与管理路由。原插件可以保留安装，以便回退。其他技能市场插件不由本插件接管。

从源码安装

本项目尚未发布到 npm，不提供未经验证的 npm 远程安装命令。

下载或克隆本仓库，在项目根目录执行：

git clone https://github.com/wuzeno/dsh-skill-categories.git
cd dsh-skill-categories
pnpm install --frozen-lockfile --ignore-scripts
npm run build
npm run check
npm test

随后通过 DSH 官方插件管理器安装本地 dsh-skill-categories 项目目录。不要手工编辑用户 profile，也不要单独启动一个 Web 服务。安装完成后刷新现有 DSH 页面；如果宿主要求重启，按其提示操作。

本地目录安装通常采用链接方式，因此源码目录也必须先安装依赖，否则宿主可能无法解析 zod。安装器校验结果和激活结果应分别确认。

升级与回退

如果管理器提示 already-installed，使用官方管理器移除旧 bundle，再安装更新后的本地目录。分类域名和 schema 不变，但卸载后的数据保留策略由宿主决定，重要数据请先备份。

回退时先停用本插件，再启用原技能中心并刷新页面。不要同时启用两者。本插件升级不迁移技能文件；停用后分类功能暂停。

数据与行为边界

操作	会发生什么
分类、标签与批量归类	写入本插件的 `skill_categories` 存储域，不移动技能目录、不改技能正文。
删除分类	技能回到未分类，文件和标签保留。
原技能管理操作	创建、导入、编辑、删除和文件技能开关仍按原技能中心规则执行，可能修改技能文件或面板设置。
提供者技能的开关	原面板可能只记录面板本地状态，不保证真正关闭该 provider 的模型调用。
分类引用	只从当前会话可引用目录选择，插入引用但不自动发送。

分类不会限制 Agent 能调用哪些技能，也不会自动替你选择或加载一整类技能。当前没有 AI 自动分类、多级分类、跨设备同步或分类导入导出。

统一管理列表直接使用原面板的文件／提供者目录，保留禁用技能和不同路径的同名副本。分类元数据附加在这份目录上，不用默认预设目录覆盖它。外部新增检测则使用默认预设的完整目录快照，不能保证发现所有提供者或磁盘副本；未能确认完整的预设会保守返回不完整，未知第三方私有隔离仍有兼容边界。

验证状态

0.4.0 的开发验证记录包括：

构建与 Host、生产客户端语法检查通过。
自动测试 80 项通过，0 失败、0 跳过，覆盖分类、持久化、冲突、目录完整性、会话引用和统一列表等行为。
独立浏览器示例验证了分类创建、批量归类、联合列表、紧凑控件，以及之前版本的导入提示和安全引用流程。

独立示例不执行真实宿主文件操作。开发期间自动化浏览器未完成宿主登录，因此上述结果不等同于真实宿主的完整验收；真实导入、编辑、删除和升级后既有分类保留仍需在已登录环境测试。详见验证记录。

本页分别标注了功能示意、0.4 独立示例，以及用户提供的早期版本操作特写。早期截图中的页签和布局可能与 0.4 不同；这些图片均不能代替完整的真实宿主验收。

开发

npm run build
npm run check
npm test

生成独立的本地示例：

node scripts/preview.mjs

打开生成的 preview/index.html 即可查看示例数据。不要把它当作已登录的 DSH 页面。

构建安装包：

pnpm pack

源码中的主要位置：

路径	内容
`src/service.js`	分类存储、校验与共享操作逻辑
`src/unified.js`	统一技能页与筛选
`src/picker.js`	当前会话分类引用的查询与插入
`scripts/adapt-explorer.mjs`	固定版本上游客户端的构建期适配
`vendor/skill-explorer`	上游固定副本、来源说明与许可证
`test`	自动测试

构建只使用本地代码和样式，不从 CDN 加载客户端。生产界面使用宿主提供的 React；卸载时清理请求、轮询和插槽。分类写操作串行执行，持久化成功后再更新内存；发生版本冲突时刷新状态，不盲目重放写入。

分类 API 仅接受当前已认证浏览器用户的规定格式请求，工作区路径必须属于宿主登记的目录。原技能管理的路由访问校验与文件操作规则保留自上游，本项目没有重写其安全模型。上游客户端遥测和独立挂载入口不运行；本插件不上传技能内容，也不依赖第三方在线服务。

反馈与发布

反馈问题时，请说明 DSH 版本、插件版本、复现步骤、预期与实际结果，并附上必要截图。不要提交登录链接、令牌、个人附件或敏感技能正文。

公开分发应保留源码、构建脚本、测试、锁文件和全部许可证。不要上传 node_modules、用户 profile 或独立预览生成物；默认忽略项见 .gitignore。正式使用前，建议在自己的已登录 DSH 环境完成导入、编辑、分类持久化和会话引用验收。

来源与许可证

本项目原创的分类、统一视图、引用、适配与测试代码采用 MIT；上游代码继续适用其 BSD-3-Clause 许可证。MIT 许可不替代上游许可。本项目不代表上游作者或 DeepSeek 官方，也不声称获得其背书。

详见第三方声明与上游集成说明。

dsh-skill-categories

Установка

README