前言¶
在 DSH 中使用本地 skill 時,經常需要先確認文件名稱、描述和適用場景,再決定如何把 skill 交給模型。asakumizy/dsh-local-skills 是一個 DeepSeek Harness(DSH)插件,爲 Web UI 提供一個本地 SKILL 瀏覽頁,把本地目錄中的 skill 文件整理到設置頁中,並給出調用方式。
這是什麼¶
它由 asakumizy 維護,許可證爲 MIT。插件的定位是:在 DSH Web UI 中瀏覽本地 SKILL,查看名稱、描述和適用場景,並通過“使用”按鈕獲取調用提示。
核心功能¶
本地 SKILL 瀏覽器¶
插件掃描本地目錄,識別兩種 skill 文件形式:
- 目錄形式:
<name>/SKILL.md - 扁平形式:
<name>.md
這些文件需要帶 YAML frontmatter,且 name 必須是 kebab-case,例如 code-review。
即時刷新¶
新增、修改、刪除 skill 後,模型目錄和網頁 UI 會即時刷新。該行爲由 watch 配置控制,默認 true。
網頁查看¶
插件在 Settings 中提供 Skills 頁面,列出可用 skill 的名稱、描述和適用場景。
使用按鈕¶
頁面中的 skill 條目提供“使用”按鈕。點擊後會說明如何調用該 skill:輸入 /name 或直接點名 skill,並可一鍵複製示例提示。
安裝與啓用¶
README 給出的安裝命令使用佔位符 <path-to-this-package>,執行前需要替換爲本包路徑。
1、安裝到 web profile:
dsh plugin --profile web add <path-to-this-package>
2、重啓 Web:
dsh web
如果要安裝到任意 profile,可以使用:
dsh plugin --profile <name> add <path>
README 提到這種方式下 pnpm 需要可用。也可以手動把包放進:
$DSH_HOME/profiles/node_modules
並把包名加入該 profile 的 dsh.profile.bundles。
配置¶
安裝到 web profile 後,可以在 web 的 Plugins 設置頁或 cordis.patch.yml 中配置 local-skills。
常用配置項:
skillDirs:要掃描的額外目錄,使用絕對路徑或~開頭的路徑;留空則默認掃描~/.dsh/local-skillswatch:是否即時監聽文件變化,默認true
在 ~/.dsh/profiles/web/cordis.patch.yml 中可以這樣覆蓋:
- id: local-skills
config:
skillDirs:
- ~/my-skills
- D:/work/skills
平臺兼容¶
Host 半依賴 ctx.skills / dsh-skill,可適配 web、desktop、tui、headless 等 profile;如果該 profile 缺少 skills 服務,插件不激活,不會崩。
Client 半聲明 dsh.client.platform 爲 web,只在 web 瀏覽器中顯示設置頁;純終端(tui)沒有瀏覽器 UI,不加載 client 半。
適用場景與注意¶
適合本地維護 SKILL 文件、希望在 DSH Web UI 中查看並複製調用提示的用戶。插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證。