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
