dsh-linkfox-video
Verifieddsh-linkfox-video · v0.2.0 · MIT · Web UI
LinkFox AI 视频功能(商品视频、带货视频、视频复刻、视频编辑)的 dsh 插件
Install
dsh plugin add dsh-linkfox-video Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-linkfox-video
LinkFox AI 视频功能(商品视频、带货视频、视频复刻、视频编辑)的 DeepSeek Harness(dsh)插件。
- 左侧栏「AI 视频」面板:4 个与 LinkFox 网页对应的操作页,可上传素材、选择模型、预估算力并提交,任务记录中可以在线播放和下载结果。
- 对话:直接对 dsh 说「用这 3 张图做一个 15 秒的商品展示视频」。缺少信息时会追问,提交前确认算力,完成后自动下载并交付文件。
- 每位员工在插件配置页填写自己的 LinkFox API Key。Key 存在员工自己的 dsh 凭据存储中,不经过对话,也不会发送给模型。
- 调用日志按员工记录在
$DSH_HOME/linkfox/usage/,保留 180 天,并提供汇总命令。 - 视频剪辑(本地工具):在浏览器里完成导入、剪辑、加文字与背景音乐、导出 MP4,不上传文件、不消耗算力;需要最新版 Chrome / Edge。
员工使用说明见 docs/USER-GUIDE.md。设计与调研见 docs/superpowers/specs/ 与 docs/research/。
当前状态
v0.1.0 可部署。
- 全量单测通过;四个功能端到端冒烟通过(见 docs/spike/SMOKE-REPORT.md)。
- 本地 dsh 全流程浏览器回归通过。
兼容性
| 组件 | 版本 |
|---|---|
| dsh | @deepseek-ai/dsh 0.2.0-rc.2(peer 范围 ^0.2.0-rc.2) |
| Node.js | ^22.19.0 或 ≥24 |
| pnpm | 11.7.0(构建与 dsh 安装插件都需要) |
安装
前提:dsh 实例能访问 npm 或 GitHub,且 dsh 进程的 PATH 中能找到 pnpm(dsh 安装插件时会调用 pnpm)。
方式 A:从 npm 安装(推荐)
在 dsh 左侧栏「插件」→「添加插件」输入 dsh-linkfox-video → 安装 → 立即启用;或在终端执行:
dsh plugin --profile web add dsh-linkfox-video
# 固定某个版本
dsh plugin --profile web add [email protected]
npm 包:https://www.npmjs.com/package/dsh-linkfox-video(由 GitHub Actions 发布,带 provenance 来源证明)。
方式 B:从 GitHub Releases 安装(无法访问 npm 时)
在 Releases 页面下载对应版本 Assets 中的 dsh-linkfox-video-<版本>.tgz,然后在「添加插件」中输入该文件的绝对路径,或执行:
dsh plugin --profile web add /path/to/dsh-linkfox-video-<版本>.tgz
每个版本的 Release 页面都附有安装命令和该版本的更新说明。
安装后如果左侧栏没有出现「AI 视频」,刷新页面;仍没有则重启 dsh。
在 dsh-server-deployment 多用户环境中安装
下面标 root 的步骤需要管理员权限,其余由员工在网页上操作。路径以默认前缀 /opt/deepseek-harness 为例。
确认员工实例能找到 pnpm(root,管理员,一次性)
dsh 安装插件时会调用 pnpm。员工实例由 systemd 以 dsh-<name> 用户运行,必须能在 PATH 中找到 pnpm。例如:
sudo corepack enable pnpm # 或:sudo npm i -g [email protected]
sudo -u dsh-<name> bash -lc 'command -v pnpm' # 应输出 pnpm 路径
如果员工实例的 PATH 中找不到 pnpm,改用下面的「管理员代装」。
方式 A:员工自助(无需 root)
按上面的「安装」操作即可。如果左侧栏没有出现「AI 视频」,请管理员重启该员工的实例:sudo systemctl restart dsh-web-<name>(root)。
方式 B:管理员代装(root)
sudo -u dsh-<name> env DSH_HOME=/opt/deepseek-harness/users/<name> \
/opt/deepseek-harness/runtime/bin/node /opt/deepseek-harness/app/node_modules/@deepseek-ai/dsh/lib/bin.js \
plugin --profile web add dsh-linkfox-video
sudo systemctl restart dsh-web-<name>
(实例不能访问 npm 时,按下面「离线安装」准备 tgz,把最后的 dsh-linkfox-video 换成 tgz 的绝对路径。)
离线安装(实例不能访问 npm)
管理员在能联网的机器上下载 tgz(任选其一):
mkdir -p /tmp/dsh-linkfox-video-release && cd /tmp/dsh-linkfox-video-release
# 从 GitHub Releases 下载
curl -fLO https://github.com/keer-L/dsh-linkfox-video/releases/download/v<版本>/dsh-linkfox-video-<版本>.tgz
# 或从 npm 下载
npm pack dsh-linkfox-video@<版本> # 生成 dsh-linkfox-video-<版本>.tgz
把生成的 tgz 复制到只读共享目录:
sudo install -d -o root -g root -m 0755 /opt/deepseek-harness/plugins
sudo install -o root -g root -m 0644 /tmp/dsh-linkfox-video-release/dsh-linkfox-video-*.tgz /opt/deepseek-harness/plugins/
# 部署规范自检:除 users/ 外不得有 group/other 写权限,结果应为 0
sudo find /opt/deepseek-harness -not -path '*/users*' -perm /022 | wc -l
员工在「添加插件」中输入 /opt/deepseek-harness/plugins/dsh-linkfox-video-<版本>.tgz 的绝对路径即可安装(管理员代装时把命令最后的参数换成该路径)。
配置 API Key(员工)
左侧栏「插件」→ dsh-linkfox-video → 填入公司分配给你的 LinkFox API Key → 保存 →「查询余额(验证 Key)」。
Key 保存在 /opt/deepseek-harness/users/<name>/.credentials.yaml(0600,只有本人和 root 可读)。
升级
- dsh rc.2 不支持插件自动更新:在插件页卸载旧版,再按「安装」重新安装(npm 方式不带版本号即为最新版;tgz 方式请从 Releases 下载新版本)。必要时重启实例。各版本的变化见 Releases。
- 从旧包名
dsh-video-studio迁移:先卸载dsh-video-studio,再安装dsh-linkfox-video。API Key 与任务记录不受影响。 - 任务记录、结果文件、调用日志都保存在
$DSH_HOME/linkfox/,升级不会删除。
卸载
员工在插件页卸载即可。$DSH_HOME/linkfox/(结果、日志、任务记录)会保留;如需清除,由管理员删除(root):sudo rm -rf /opt/deepseek-harness/users/<name>/linkfox。
调用统计(root,管理员)
# 一次性:解压某个版本的发布包(升级后换成新版本号重复执行即可,会先删除旧文件)
VER=<版本>
sudo rm -rf /opt/deepseek-harness/tools/dsh-linkfox-video
sudo install -d -o root -g root -m 0755 /opt/deepseek-harness/tools/dsh-linkfox-video
curl -fsSL "https://github.com/keer-L/dsh-linkfox-video/releases/download/v${VER}/dsh-linkfox-video-${VER}.tgz" \
| sudo tar -xz --no-same-owner -C /opt/deepseek-harness/tools/dsh-linkfox-video --strip-components=1
不能访问 GitHub 时,按「离线安装」取得 tgz 后把最后两行换成:
sudo tar -xz --no-same-owner -C /opt/deepseek-harness/tools/dsh-linkfox-video --strip-components=1 \
< /opt/deepseek-harness/plugins/dsh-linkfox-video-${VER}.tgz
然后运行汇总命令:
# 所有员工、自 11 月 1 日起,按员工 / 月份 / 功能汇总次数与点数
sudo /opt/deepseek-harness/runtime/bin/node /opt/deepseek-harness/tools/dsh-linkfox-video/lib/usage-report.js \
--root /opt/deepseek-harness/users --since 2026-11-01
# 导出 CSV
sudo /opt/deepseek-harness/runtime/bin/node /opt/deepseek-harness/tools/dsh-linkfox-video/lib/usage-report.js \
--root /opt/deepseek-harness/users --csv > linkfox-usage.csv
输出为表格(--csv 时为 CSV),列为:员工、月份、功能、次数、成功、失败、预估点数、实际点数。--root 可以是单个 $DSH_HOME 或多用户根目录;省略时使用环境变量 DSH_HOME,再省略则为 ~/.dsh。--since 格式为 YYYY-MM-DD。
日志位置为 $DSH_HOME/linkfox/usage/YYYY-MM.jsonl,每个任务到达终态(成功、失败、超时、结果不确定)时写一行(员工、时间、功能、模型、任务 ID、状态、预估与实际点数、耗时)。超时任务在员工「继续等待」后再次结束会再写一行,汇总时同一任务只取最新一行,不会重复计数。超过 180 天的月份文件会被自动删除。
可调配置
在 profile 或 $DSH_HOME/cordis.patch.yml 中覆盖 video-studio 行的 config(整段替换,必须保留 dataDir):
| 配置项 | 默认 | 说明 |
|---|---|---|
dataDir |
dshHomePath('linkfox') |
任务记录、结果、日志、上传暂存目录 |
pollIntervalMs |
15000 | 轮询间隔,最小 10000 |
timeoutMs / recloneTimeoutMs |
30 分钟 / 60 分钟(均为毫秒,最小 60000) | 等待超时(超时后可「继续等待」),recloneTimeoutMs 仅用于视频复刻 |
maxConcurrentPerFeature |
100 | 每个功能同时进行的任务上限(1–100) |
logRetentionDays |
180 | 调用日志保留天数,最小 1 |
requestTimeoutMs |
60000 | 单次 HTTP 请求超时,最小 5000 |
baseUrl |
https://ai-api.linkfox.com |
LinkFox API 地址 |
发布新版本(维护者)
- 修改
package.json的version。 - 编写更新说明:复制
.github/release-notes/TEMPLATE.md为.github/release-notes/v<版本>.md,写上本版本的新功能、改进、修复。与第 1 步一起提交并合并到main。 - 打 tag 并推送:
git tag v<版本> && git push origin v<版本>。 - GitHub Actions 的 Release 工作流会校验 tag 与版本一致、跑全部检查,然后:
- 发布到 npm(带 provenance)。仓库 Secrets 中未配置
NPM_TOKEN时跳过(运行记录里有一条警告)。 - 创建 GitHub Release:标题为
v<版本>,正文为「安装 / 更新」命令 + 第 2 步的更新说明,并附上dsh-linkfox-video-<版本>.tgz。没有写第 2 步的说明文件时,使用 GitHub 按上个 tag 以来合并的 PR 自动生成的说明。版本号带-(如0.2.0-rc.1)时标记为 Pre-release。
- 发布到 npm(带 provenance)。仓库 Secrets 中未配置
发布后如需修改说明,可直接在 GitHub 的 Release 页面编辑;也可以先在本地预览正文:bash tools/release-notes.sh <版本>。
前提:仓库 Settings → Secrets and variables → Actions 中有 NPM_TOKEN(npm 上可发布 dsh-linkfox-video 的 Granular Access Token)。该 token 有过期时间,过期后 npm 发布步骤会失败,需重新生成并更新 Secret 后对该次运行 Re-run;之后计划改用 npm Trusted Publishing。
补救:工作流任一步失败时,修复原因后在 GitHub Actions 中对该次运行点 Re-run。工作流可安全重跑:该版本已发布到 npm 时跳过发布;Release 已存在时更新说明并覆盖附件。
如果无法使用 Actions,可手动打包并创建 Release(需要已登录的 gh,也可以在 GitHub 网页 Releases → Draft a new release 中上传 tgz、粘贴说明):
git checkout v<版本> && pnpm install --frozen-lockfile && pnpm run pack:tgz
bash tools/release-notes.sh <版本> > /tmp/release-notes.md
gh release create v<版本> ./dsh-linkfox-video-<版本>.tgz --title v<版本> --notes-file /tmp/release-notes.md --verify-tag
git checkout main
本地开发
pnpm install
pnpm test # 单元测试
pnpm test:bundle # 构建并校验产物格式
pnpm typecheck && pnpm lint
tools/local-dsh.sh install # 在 .local-dsh/ 安装 dsh 0.2.0-rc.2
tools/local-dsh.sh add # 打包并安装到本地 web profile(已安装则先卸载旧版)
tools/local-dsh.sh start # 启动 http://127.0.0.1:3080,端口被占用时用 DSH_PORT=3082 tools/local-dsh.sh start
端到端冒烟测试会消耗真实算力点,见 tests/smoke/README.md。
安全约定
- 仓库中不得出现真实 Key、
.env、Playwright 登录态;只提交.example模板。 - 结果文件只通过任务 ID 访问,接口不接受任意文件路径。
许可
本项目许可见 LICENSE。第三方协议声明见 THIRD_PARTY_NOTICES.md。