DeepSeek Harness (DSH) 采用插件化架构，允许用户安装各类智能体技能。随着技能库的积累，开发者常面临“技能太多，不知道哪个命令来自哪个来源”的困扰。dsh-catalog 插件旨在解决这一问题，它扫描 DSH 能够加载的所有技能，将其合并为一个可浏览的目录，并通过侧边栏面板展示。
插件定位¶
dsh-catalog 是一个由 GoJo22 维护的 DSH 客户端插件。它的核心功能是对本地技能目录进行扫描与归档，生成一个包含 collection、category 和 command 三级结构的列表。该插件不注册任何斜杠命令，仅提供目录浏览、命令插入和自定义配置管理能力。
核心功能¶
- 侧边栏集成：在 DSH 左侧边栏底部提供一个按钮，点击后展开右侧窄面板，展示技能目录。
- 精确扫描：扫描
~/.dsh/skills和~/.agents/skills下的直接子目录。包括单技能目录、技能包目录或独立的.md文件。扫描规则与 DSH 自身的加载规则保持一致。 - 刷新机制：面板提供刷新按钮，可重新从磁盘读取
SKILL.md。 - 命令插入：点击命令卡片，会将命令（如
/command）直接写入当前对话输入框。 - 信息卡片：右键点击命令卡片可查看详情。支持自定义备注，且自定义备注优先于技能自带描述。
- 原生查询：支持在聊天中通过
dsh_catalog工具查询，例如询问 “what is /estimate” 或 “which skills do I have”。 - 持久化配置：支持保存自定义分类和命令备注，数据存储在本地磁盘。
安装与启用¶
由于该插件未提供官方统一的安装命令，请通过以下方式获取：
https://github.com/GoJo22/dsh-catalog
安装后，按钮会出现在 DSH 左侧边栏的底部（设置按钮旁边）。
典型用法¶
- 浏览与插入：打开侧边栏面板，浏览技能列表。点击任意命令卡片，即可将其插入到当前对话的输入框中。
- 自定义分类：在面板右上角点击“Categories”编辑器。选择对应的 Collection，然后粘贴分类规则（例如
Game Design /brainstorm /map-systems）。点击保存，分类将持久化存储在~/.dsh-catalog/categories.json中。 - 自定义备注：在面板右上角点击“Notes”编辑器。选择 Collection，粘贴 Markdown 表格（例如
| Command | Note |）。点击保存。之后右键点击命令卡片时，会优先显示你的备注内容。 - 查询：在聊天窗口中输入
what is /estimate或which skills do I have，插件会通过dsh_catalog工具返回目录信息。
注意事项¶
- 仅目录功能：该插件仅负责目录的扫描、浏览和命令注入，不注册自己的斜杠命令。
- 本地存储：自定义分类和备注存储在
~/.dsh-catalog/目录下，与插件进程解耦，重启或更新插件不会丢失。 - 配置备份：如果配置文件损坏，插件会自动备份为
*.corrupt-<timestamp>.json并继续运行。
总结¶
dsh-catalog 通过侧边栏为 DSH 技能库提供了一个集中的管理入口，解决了技能分散导致的使用困难。它结合了可视化的浏览和持久化的自定义配置，适合需要维护大量技能目录的开发者使用。项目地址：https://github.com/GoJo22/dsh-catalog
