前言¶
在 Claude Code 或 DSH 裏做 agentic 視頻工作流時,技能往往散落在 GitHub 各倉庫的 SKILL.md 目錄中。awesome-claude-video-skills 把這類條目整理成目錄,但手工查倉庫、下載歸檔、拷貝到 ~/.claude/skills 或 ~/.dsh/skills 仍然繁瑣。下面介紹維護者 1368546410qq 發佈的 DSH 客戶端插件 dsh-video-skills:在 DSH 設置頁集中展示該目錄(資料中約 373 條),並支持一鍵安裝;安裝過程只下載 GitHub 歸檔並複製文件,不會執行被安裝倉庫裏的任何代碼。
這是什麼¶
dsh-video-skills 是 DSH 的 Web 插件(package.json 中 dsh.client.platform 爲 web)。它在設置 UI 中佔一頁(key: video-skills,order: 900),同時註冊三個模型工具與一個 HTTP 前綴路由 /video-skills/api/v1。CLI、TUI 在無 Web 服務時仍可使用這三個工具;瀏覽與圖形化安裝依賴 Web UI。
- 目錄頁:https://www.skillhub.cn/plugins/1368546410qq/dsh-video-skills
- 源碼:https://github.com/1368546410qq/dsh-video-skills
- 當前版本:0.1.4(MIT)
- 社區分類:客戶端
核心功能¶
設置頁¶
設置頁提供:
- Install to 欄:
Claude/DSH複選框(默認僅勾選 DSH,選擇會寫入localStorage)。 - installed only 過濾器,以及 kind、最低 star、grade、license、搜索等篩選。
- 列表最多先展示 100 行,可 load more;每行鏈到 GitHub 倉庫與倉庫內 skill 路徑,顯示近似倉庫體積徽章(未知時爲
—)。 - 安裝時展示進度(下載 MB、歸檔文件數、複製文件數)並可取消;已安裝目標有勾選標記,支持兩次點擊卸載。
- 文案默認 zh-CN,可切 en-US,字符串在
locale/*.json。
三個模型工具¶
| 工具 | 作用 |
|---|---|
video_skill_search |
按 query、kind、grade、license、minStars 等篩選目錄,返回 { count, items },默認 limit 20(1–100)。 |
video_skill_install |
必填 repo(owner/name);可選 path、name、targets(claude / dsh,默認 ["dsh"])。成功返回 { ok: true, name, installed, warnings }。 |
video_skill_uninstall |
必填 name 與 target;僅刪除帶本插件 .dsh-video-skills.json 標記的目錄,手工拷貝的 skill 會返回 not-owned。 |
工具與設置頁共用同一 catalog 加載器;video_skill_search 返回的 sizeBytes 與 GET /catalog 一致。
HTTP API(Web 頁使用)¶
基路徑 /video-skills/api/v1,同源、無鑑權,響應 cache-control: no-store。常用端點包括:
GET /catalog— 目錄;上游不可達時使用內置快照並標stale: true。GET /installed— 已安裝列表。POST /install— 後臺安裝,返回202與job;最多 8 個併發任務。GET /install/<id>、POST /install/<id>/cancel— 查詢或取消任務。POST /uninstall、POST /refresh— 卸載與刷新目錄。
運行要求¶
- Node.js 20+(
engines.node)。 - 任意 DSH composition;入口
inject = [],在存在tools服務時註冊工具,存在webServer時掛載 HTTP。 - 運行時依賴
tar(流式解壓 GitHub 歸檔),無其他運行時安裝項。
安裝與啓用¶
從 registry 安裝到指定 profile:
dsh plugin --profile <name> add dsh-video-skills
dsh plugin 會把後續參數交給 profile 目錄內的 pnpm,包會作爲 profile 依賴固定版本。還須在 profile 的 package.json 裏把插件名寫進 dsh.profile.bundles:
{
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-video-skills"]
}
}
}
本地開發可從倉庫 checkout 使用 link 安裝(編輯後無需重裝):
dsh plugin --profile <name> add link:/absolute/path/to/dsh-plugin-video-skills
若 bundles 中尚未包含 "dsh-video-skills",需自行追加。
典型用法¶
在對話裏搜索並安裝¶
智能體可調用 video_skill_search,例如限定種類與最低 star:
kind可選:general、promo、explainer、editing、shorts、avatar、story、motion、craft、music。grade可選:safe或caution(目錄記錄的安全分級)。
選定條目後調用 video_skill_install,傳入 repo,必要時指定倉庫內的 path 或安裝目錄 name,以及 targets: ["claude"] 或 ["dsh"]。工具會等待安裝引擎結束並返回最終結果(無 job 對象;Web 頁通過 POST /install 輪詢進度)。
在設置頁一鍵安裝¶
啓用含 Web 的 profile 後打開 DSH 設置中的 video-skills 頁,篩選條目,勾選 Install to 目標,對單行執行安裝;完成後 skill 出現在對應根目錄,卸載需通過頁內操作或 video_skill_uninstall。
適用場景與注意¶
適合需要在 DSH 或 Claude 技能目錄中快速試用 awesome-claude-video-skills 條目的開發者。目錄 star 等元數據來自 catalog;安裝前仍應自行查看目標倉庫源碼與 license。
權限與安全: 插件以當前 DSH 進程權限 運行,會向 GitHub 下載歸檔並寫入本機 ~/.claude/skills 或 ~/.dsh/skills。雖然設計上不執行被安裝倉庫代碼,但第三方 skill 內容仍可能包含提示詞或腳本說明;安裝前請確認信任來源。卸載僅作用於本插件標記的安裝,避免誤刪手工放置的目錄。
上游 catalog 刷新失敗時,API 可能返回帶 stale: true 的內置快照,使用前可通過設置頁或 POST /refresh 嘗試更新。
結尾¶
dsh-video-skills 把視頻製作 skill 目錄收進 DSH 設置頁,並用同一套 catalog 暴露搜索、安裝、卸載工具,減少手工維護技能目錄的成本。