稳妥起点是 2 vCPU / 4 GiB、Ubuntu 22.04 LTS、系统盘 ESSD 40 GiB 起;按码率而不是并发数挑规格,高码率长视频会先把 CPU 打满。
二、装 Node 20+ 与 ffmpeg
ffmpeg -version 首行会打印版本号,确认主版本 ≥ 6.0——场景切换检测用的是 scdet 滤镜,低版本会静默退化成均匀采样。which ffprobe 必须能打印出路径,媒体处理完全依赖 PATH 上的 ffmpeg / ffprobe,插件内部不做原生解码。Node 需要 ≥ 20,推荐 22 LTS。
安装形态和版本号可对照 DeepSeek Harness Hub 插件清单 核对。
三、安全组只放出方向 443
视觉与 ASR 端点默认都是 https://api.siliconflow.cn/v1,属公网 HTTPS 服务,不走 VPC 内网。所以要做出方向放行 443,而不是配内网打通。
入方向保持最小,只留 SSH 并限制来源 IP;出方向默认「全部放行」也能跑,但收窄成只允许 443 更稳妥,同时给实例配好公网出口。
四、把两个密钥注入进程
VIDEO_LENS_API_KEY 用于视觉,VIDEO_LENS_ASR_KEY 可选、用于语音转写。ASR 是纯增量的——密钥未设置或服务商调用失败,视觉分析照样跑完,只是 transcript 记为 null。
长期运行建议写进启动脚本,或用 systemd 的 Environment= / EnvironmentFile= 注入,不要硬编码进配置档。
五、装插件并注册 bundle
随后在配置档 package.json 的 dsh.profile.bundles 数组里显式登记 dsh-video-lens,与 @deepseek-ai/dsh-base、@deepseek-ai/dsh-web-app 并列,改完重启配置档。
六、云上最容易撞的四个坑
坑一 · Node 版本低于 20,进程直接起不来
现象。 启动配置档时报错退出,日志指向运行时不兼容。原因。 engines.node 声明为 >=20,代码用到 AbortSignal.any、内置 fetch 与 FormData,Node 18 上要么缺失要么行为不同。解决。 升到 Node 20 以上(推荐 22 LTS),并确认 systemd 服务的 PATH 与登录 shell 一致。
坑二 · ffprobe 不在 PATH,video_probe 一调就失败
现象。 只装了 ffmpeg 或没做软链,video_probe 直接失败。原因。 媒体处理全交给 PATH 上的 ffmpeg / ffprobe,插件不做原生解码。解决。 用 apt install ffmpeg 一次装齐两者,再 which ffprobe 确认有输出。
坑三 · 密钥被发到了不信任的端点
现象。 装完就能跑,但没留意默认端点是什么,密钥就这么发出去了。原因。 visionBaseUrl 与 asrBaseUrl 默认都是 https://api.siliconflow.cn/v1,README 写明「密钥的安全性取决于它被发往的端点」。解决。 只配你信任的端点,改成任意 OpenAI 兼容端点即可,插件不绑定服务商。
坑四 · 依赖装上了,但 bundles 漏注册
现象。 pnpm add 成功,重启后插件却不加载,工具列表里看不到。原因。 两种安装方式都必须在 dsh.profile.bundles 里显式登记 dsh-video-lens,依赖存在不等于被加载。解决。 补进 bundles 数组后重启配置档。
七、验证顺序与档位核对
建议按序验:node -v → ffmpeg -version → which ffprobe → 安全组出方向 443 → 密钥可见 → 工具列表出现视频工具;跑通后先用 1 分钟以内的短视频试,再上长素材。
档位如实披露:信任档位是已验证(L4 · 真实安装),本站已于 3 天前在 dsh 0.2.0-rc.2 下真实安装成功;安全扫描为 🔵 含敏感能力 · 8 处证据 · 尚无人工评估,能力项包括读写/递归删除本地文件、发起外部网络请求;站点另挂 ⚠️「需要额外安装运行时依赖」 提示,落到 ECS 上就是 ffmpeg / ffprobe 前置;维护活跃度是最近一次提交在 26 天前。
总结
ECS 上跑通的难点几乎都在插件之外——解码工具、出网路径、密钥注入对齐之后,剩下的就是四个坑来回犯;想对照同类插件的中文清单与安装形态,见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合:在云主机上做批量视频资产的理解与打标;把长视频压成可检索的时间点证据;对可疑片段按时间追问并拿置信度;已有 OpenAI 兼容端点、想在 ECS 上复用密钥的团队。不适合:必须先装 ffmpeg ≥ 6.0 与 ffprobe 并放进 PATH,不装完全不可用;最近提交停在 26 天前,等新功能会失望;默认端点绑定硅基流动、密钥会发往该端点;长视频载荷与费用会明显上升;它只做理解与问答,不做剪辑、转码、字幕烧录。
标签:视频理解插件、DeepSeek Harness、阿里云 ECS、ffmpeg 前置、部署教程
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。