dsh-skill-panel:在 DSH 設置頁查看和管理本地技能目錄

前言

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 目錄下的技能文件,變成設置頁裏可搜索、可查看、可刪除、可打開的列表。

相關鏈接:

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜