前言¶
做 DSH 智能體時,經常會遇到一個基礎但頻繁的問題:本機到底裝了哪些 skills?這些 skills 分別放在哪個目錄?如果要在編輯器裏打開某個 skill 的文件夾,通常還需要手動切換到終端,再逐個輸入路徑。
dsh-skill-browser 是 DSH web 插件,把這類操作放到「設置」裏:新增一個 Skills 頁面,列出本機已安裝的 skills,並允許打開每個 skill 所在文件夾。
這是什麼¶
dsh-skill-browser 由 charleswin7 維護,倉庫地址爲 https://github.com/charleswin7/dsh-skill-browser,許可證爲 MIT。
它解決的是 DSH skills 的“查看 + 定位文件夾”問題:在 DSH web 設置頁中看到本機已安裝 skills 的列表,並一鍵打開對應目錄。
核心功能¶
下面介紹已覈實的能力。
- 在「設置」中新增一個 Skills 頁面。
- 列出本機已安裝的所有 skills。
- 支持全局 Skills,包括:
~/.dsh/skills~/.agents/skills- 各 preset 自帶的 skills
- 內置/運行時 skills
- 支持工作區 Skills:按工作區分組,列出每個工作區
.dsh/skills、.agents/skills下的 skills。 - 點擊某條 skill 的目錄路徑或「打開目錄」按鈕,用系統默認程序打開對應文件夾;Windows 下爲資源管理器。
- 數據來自 DSH 的 skills 服務。
- host 側註冊
/skill-browser/browseHTTP 路由。 - client 側提供設置裏的 Skills 頁面。
安裝與啓用¶
dsh.client.platform 爲 web,表示它面向 DSH web 客戶端。
本地路徑安裝¶
適合先在本地源碼目錄試用,不需要發佈到遠程倉庫:
npx @deepseek-ai/dsh plugin --profile web add "C:\路徑\dsh-skill-browser" --config.minimumReleaseAge=0
其中 C:\路徑\dsh-skill-browser 是佔位路徑,需要替換成該目錄在本機上的真實絕對路徑。
安裝完成後,重啓 dsh web 使其生效。
從 GitHub 安裝¶
如果是發佈後的倉庫,可使用下面的命令:
dsh plugin --profile web add "github:<你的用戶名>/dsh-skill-browser"
命令中的 <你的用戶名> 是佔位符,需要替換爲實際 GitHub 用戶名。安裝完成後同樣重啓 dsh web。
典型用法¶
安裝並重啓 dsh web 後,進入設置中的 Skills 頁面。
可以按以下方式操作:
- 查看全局 Skills,例如
~/.dsh/skills、~/.agents/skills、preset 自帶 skills 和內置/運行時 skills。 - 查看工作區 Skills,按工作區分組定位
.dsh/skills或.agents/skills下的 skill。 - 點擊某條 skill 的目錄路徑,或點擊「打開目錄」按鈕。
- 系統默認程序打開對應文件夾;Windows 下會調用資源管理器。
如果只需要臨時瀏覽某個本地插件源碼,本地路徑安裝更直接;如果插件已經發布到 GitHub,可以使用 GitHub 安裝命令。
卸載¶
npx @deepseek-ai/dsh plugin --profile web remove dsh-skill-browser
卸載後同樣需要重啓 dsh web。
依賴與適配¶
peerDependencies 聲明瞭:
{
"react": "^18.2.0",
"@deepseek-ai/cordis": "^4.0.1"
}
適用場景與注意¶
適合這些場景:
- 本地開發 skills,需要快速打開某個 skill 的目錄。
- 維護多個工作區,需要按工作區查看
.dsh/skills和.agents/skills。 - 查看全局、preset、內置/運行時 skills 的位置。
- 在 DSH web 設置中集中查看 skills 的可見列表。
注意:
- 插件會在當前
dsh進程權限下運行,安裝前建議檢查源碼、依賴和許可證。 - 本地路徑安裝命令中的路徑必須替換爲真實絕對路徑。
- GitHub 安裝命令中的
<你的用戶名>是佔位符,具體以倉庫發佈後的實際命令爲準。 - 社區目錄入口 URL 未在已覈實資料中確認,不要憑名稱拼接未提供的 URL。
- 安裝或卸載後都需要重啓
dsh web。
結尾¶
dsh-skill-browser 的作用比較直接:把 DSH 本機 skills 的列表和目錄打開操作放進 web 設置頁,減少手動查找路徑的成本。倉庫地址:https://github.com/charleswin7/dsh-skill-browser。如果你在社區目錄中安裝,建議以目錄頁實際展示的安裝命令和路徑爲準。