Skip to content

dsh-linkfox-video

Verified

dsh-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 可读)。

升级

  1. dsh rc.2 不支持插件自动更新:在插件页卸载旧版,再按「安装」重新安装(npm 方式不带版本号即为最新版;tgz 方式请从 Releases 下载新版本)。必要时重启实例。各版本的变化见 Releases。
  2. 从旧包名 dsh-video-studio 迁移:先卸载 dsh-video-studio,再安装 dsh-linkfox-video。API Key 与任务记录不受影响。
  3. 任务记录、结果文件、调用日志都保存在 $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 地址

发布新版本(维护者)

  1. 修改 package.json 的 version。
  2. 编写更新说明:复制 .github/release-notes/TEMPLATE.md 为 .github/release-notes/v<版本>.md,写上本版本的新功能、改进、修复。与第 1 步一起提交并合并到 main。
  3. 打 tag 并推送:git tag v<版本> && git push origin v<版本>。
  4. 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。

发布后如需修改说明,可直接在 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。