前言¶
在 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 暴露搜索、安装、卸载工具,减少手工维护技能目录的成本。