在 DeepSeek Harness（DSH）桌面端開發智能體時，技能庫通常以文件形式分散在本地，難以快速瀏覽、檢索，且技能調用後的生效狀態難以追蹤。dsh-skill-browser 插件將本地技能庫轉化爲可視化的懸浮球面板，提供兩級分類、實時搜索與失效臺賬自動登記功能。
插件簡介¶
dsh-skill-browser 是 DSH 客戶端插件，由 loyalchiiina 維護，採用 MIT 許可證。它解決的核心問題是：如何在一個統一的 UI 入口下，高效瀏覽本地技能庫，並自動記錄技能調用的執行結果。插件不內置預設路徑，確保展示的是用戶本地技能庫的真實內容。
核心功能¶
1. 懸浮球
固定在屏幕角落，點擊開關面板；可拖拽換位置（位置記憶），Alt+點擊收起成小圓點。
2. 技能庫位置可配置
首次使用在面板 ⚙ 設置裏選擇技能庫文件夾（彈系統目錄選擇框），或手動粘貼路徑；未配置時自動探測官方默認根 ~/.dsh/skills。插件不含任何預設路徑。
3. 兩級分類
按技能目錄名模式自動歸類（16 個一級分類與 Fluent/DSH 域二級分類）。
4. 中文簡介與搜索
技能簡介直接取自各技能 SKILL.md frontmatter 的 description。支持按技能名 / 中文簡介 / 原始描述實時過濾。
5. 詳情查看
點擊卡片查看 SKILL.md 全文，可一鍵複製。
6. 失效臺賬
監聽 DSH 官方 tools/result 事件，自動記錄每次 skill 工具調用結果（成功記「生效 ✅」，加載失敗記「未生效 ❌」並帶上錯誤信息）。人工臺賬與自動登記分開顯示，人工維護區插件永不改動。
7. 臺賬智能發現
初始化時全庫搜索臺賬文件，文件名含「失效臺賬 / 失敗臺賬 / 生效-失效」等關鍵詞，約定路徑 skill-master/references/ 優先；搜到就複用，沒搜到才創建默認臺賬。
安裝與啓用¶
1、把本目錄完整複製到 ~/.dsh/profiles/desktop/node_modules/dsh-skill-browser（真實目錄，不要 junction/link）。
2、在 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 數組加 "dsh-skill-browser"（不要加進 dependencies，本插件零 npm 依賴）。
3、重啓 DSH，右下角出現 🧩 懸浮球；打開 ⚙ 設置選擇你的技能庫文件夾即可。
典型用法¶
- 瀏覽技能：點擊懸浮球打開面板瀏覽技能庫。
- 配置路徑：在面板 ⚙ 設置裏選擇你的技能庫文件夾。
- 上報失敗：在對話中使用「觸發失敗，登記」或「登記失敗：技能名 原因」口令上報失敗。
- 控制顯隱：在 DSH 設置頁分區「懸浮球導航」中控制懸浮球顯示與隱藏。
- 復位位置：點擊懸浮球的一鍵恢復默認位置按鈕復位（清位置記憶/收起狀態）。
注意事項¶
- 發佈 24 小時內安裝報錯？這是供應鏈安全策略（minimumReleaseAge）導致的，不是插件問題，需等一天再裝。
- 路徑配置：插件不含任何預設路徑。
- 臺賬獨立性：人工臺賬與自動登記分開顯示，插件永不改動人工臺賬。
- 數據準確性：插件不內置任何技能名清單/字典，保證看到的是自己技能庫的準確描述。
適用場景¶
適合需要在 DSH 桌面端集中管理本地技能庫，並希望自動化追蹤技能生效狀態的開發者。
