前言¶
DSH 插件生態裏,“一切皆插件”會把常用能力拆成可安裝、可替換的模塊。對維護本地技能目錄的人來說,直接翻文件系統容易漏掉某個 workspace,也不好統一查看技能描述和正文。
dsh-skill-panel 把這類目錄接入設置頁,提供一個 Skills 面板,用於查看和管理全局及項目級本地技能目錄。
這是什麼¶
dsh-skill-panel 是一個 DSH 客戶端插件,由 hexbee 維護,許可證爲 MIT,package.json 版本爲 0.1.1。
它解決的是本地技能目錄的集中查看和管理問題:在設置頁增加 Skills 面板,列出技能,並顯示描述、正文和目錄內容。
管理哪些目錄¶
全局目錄¶
插件支持全局目錄:
~/.agents/skills
這個目錄會受 DSH_AGENTS_HOME 影響。
項目級目錄¶
插件支持項目級目錄:
<workspace>/.agents/skills
該目錄面向 harness 中註冊的每個 workspace。
項目作用域僅通過 Host 註冊的 workspace ids 尋址,瀏覽器不提交原始文件系統路徑。
核心功能¶
面板提供以下能力:
- 在設置頁添加 Skills 面板
- 查看和管理本地技能目錄
- 列出每個技能,並顯示描述、正文和目錄內容
- 支持在當前作用域內搜索
- 支持刪除技能
- 支持在系統文件管理器中打開目錄
- 包含中英文文案
安裝與啓用¶
從 GitHub 安裝到 web profile:
dsh plugin --profile web add git+https://github.com/hexbee/dsh-skill-panel.git
如果本地已有源碼目錄,也可以用本地路徑安裝:
dsh plugin --profile web add file:/path/to/dsh-skill-panel
構建與本地驗證¶
從源碼構建時,先安裝依賴,再執行構建和測試:
pnpm install
pnpm run build
node --test tests/catalog.test.mjs
README 將構建過程描述爲 esbuild bundles + tsc declarations,測試入口是 tests/catalog.test.mjs。
實現與安全邊界¶
插件的 dsh.client.platform 爲 web,並注入 DSH client runtime/UI/locale 相關包。
RPC 通道固定到 loopback:
authority: 'loopback'
所有變更限制在以下目錄:
~/.agents/skills
<workspace>/.agents/skills
刪除符號鏈接技能時,只斷開鏈接,不觸碰目標。
適用場景與注意¶
適合維護 DSH 本地技能目錄的人使用,尤其是需要同時查看全局目錄和多個 workspace 下項目級目錄、搜索技能描述、刪除技能或打開目錄的場景。
由於插件會操作本地技能目錄,並且以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證;運行時可訪問的目錄範圍取決於啓動 dsh 的進程環境。
結尾¶
dsh-skill-panel 的價值,是把分散在用戶目錄和 workspace 目錄下的技能文件,變成設置頁裏可搜索、可查看、可刪除、可打開的列表。
相關鏈接: