从装 ffmpeg 到出第一张分镜图，五步走完再谈调参

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}

从装 ffmpeg 到出第一张分镜图，五步走完再谈调参

装 ffmpeg 只是第一步，但八成的问题都出在"以为装完了"。这篇按顺序走五步，每步一条命令配一个能自己验证的判据；走完再谈 strategy 和 budget，否则调的是空气。

插件本身的口径先摆出来：418★、Apache-2.0、vision 类，本站信任档位「已验证 · L5 运行时冒烟」，dsh 0.2.1-rc.5 下真实装过；安全扫描是「含敏感能力、尚无人工评估」——它要调本机 ffmpeg、可能读 cookie 文件，别当无风险。建仓 2026-10-26。

第一步 · 把 ffmpeg 和 ffprobe 装上

winget install Gyan.FFmpeg

插件不打包 ffmpeg，只调用你自己装的那份，找不到时给安装指引而不是静默失败。坑在于 ffmpeg 与 ffprobe 是两个二进制，只装 ffmpeg 的发行版不少，缺 ffprobe 时第一步扫描就崩。

验收点：新开一个终端，两条命令都出版本号。

ffmpeg -version
ffprobe -version

两条都通再往下。装完重启 DSH——用户反馈里过半的"装完不能跑"，是没配 ASR 或者装完没重启。想一次看全，跑 node bin/doctor.mjs，它检查 ffmpeg / yt-dlp / ASR / 缓存目录，每条后面跟一句缺什么、怎么补。

第二步 · 装插件并确认工具挂上了

dsh plugin –profile web add dsh-video-storyboard

dsh plugin 只管 web 这类普通 profile。桌面版的 desktop profile 会被直接拒绝，得走源码：git clone 之后跑 node scripts/install-dev.mjs，它是复制目录，改完要重跑。

验收点：重启后工具列表里出现 video_storyboard，顺手调一次 video_probe——它只读容器头（时长、分辨率、帧率、有无音轨字幕），不花图片 token。

到这一步一分钱没花。继续之前，值得先扫一眼同类插件的中文清单与安装形态：完整插件清单与汉化避坑指南，里面按依赖、权限、安装方式做了横向对照，能省掉一轮试错。

第三步 · 先跑 dryRun，看它打算怎么排

别直接出图。第一次接触一部片子，先问排布器：

video_storyboard({ input: "film.mp4", dryRun: true })
// → cuts="46 (avg 2.0s)" · frames=21
// compact 1 image / standard 1 / full 2 / skim <=1
// recommended: compact

dryRun 只扫描加排布，不出图、不取帧、不转写，所以不花图片 token；扫描结果有缓存，第二次几乎免费。

验收点：输出里同时有三个东西——切点数、帧数、各档位要几张图。如果 cuts 到了三位数、frames 也跟着涨，说明这是快剪素材，这时候别急着出图，先想 maxFrames：默认 0 = 不限，几千个切点就取几千帧，帧数和耗时一起涨。

第四步 · 出第一张图，核对三处数字

video_storyboard({ input: "film.mp4", strategy: "compact" })

命令行等价写法：

node bin/storyboard.mjs film.mp4 –strategy compact –out film.png

得到一张 PNG 加一段文本清单。验收点看三处：grid= 后面的帧数与张数、tokens= 的单图 token、以及每行 cell N = 起止时间 k=档位。k 越大的格子越小，意思是"这一帧只代表很短的一段时间"。

顺手记一下耗时：90 秒片子约 8 秒，5 分钟约 40 秒（含解码、扫描、取帧、拼图）。这是本地 CPU 时间，不产生 token，别和费用混着算。

第五步 · 按需调档位

默认 strategy 是 auto：先按时长定张数预算（≈240 秒一张），再挑"最小格还认得出"的最省那档。想自己定，就从这几档里选：

三个容易踩的参数：

• maxSheets 默认 0，排布器说几张就几张。想封顶填正数，超了会合并段重排，时间覆盖不变。
• budget 默认 360000 像素（800×450，约 233 token），上限 1.69M。低于约 296k 不再便宜——计费按 544² 放大算 192 token，填更小只会更糊，账单照记。
• integralSeconds 默认 6，阈值对着固定参考强度，不是"每 N 秒一帧"：画面动得快就补得密，静止镜头一个点都不补。

验收点：改完先再跑一次 dryRun，对比张数与最小格边长，数字对了再出图。各档位在不同时长下的实际代价，以及更多同类插件的安装形态，这一份里汇总得比较全：完整插件清单与汉化避坑指南。

总结

五步的核心不是命令，而是两个自检动作——先确认 ffprobe 在、再确认 dryRun 的数字合理，后面所有调参才有意义；跳过它们，你调的只是猜测。

适合与不适合

适合：第一次给 DSH 配视觉能力、想要一条能验收的安装路径；手里是本地 mp4/mov，不想碰下载与 cookie；需要"先看全片再决定细看哪段"的工作流；愿意花十分钟换长期的低 token 扫描。

不适合：纯云端、没有 ffmpeg 也装不了的环境；只想逐帧辨字或认脸——1/8 档只有 100×56；贴 B 站 1080P+ 又不愿导出 cookies；不能接受接口在两个月内二次变动。

标签：dsh-video-storyboard、DeepSeek Harness、视觉能力、视频分镜

本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。