前言¶
在 DeepSeek Harness(DSH)里做视频类工作流,常见做法是接外部 Studio、网页编辑器或视频生成模型,再把产物搬回宿主。链路长、验收难,很多判断只能停留在「看起来还行」。下面介绍维护者 xiaobaga281 发布在工作流分类下的插件 dsh-mise(社区目录:xiaobaga281/dsh-mise,源码:GitHub)。它的定位是:影片即网页(film.html 与镜头页),构图、排版、动效、配乐、测量、校验、渲染、交付在插件内部完成,不依赖外部 Studio、网页编辑器或视频生成模型。
这是什么¶
插件简介原文:Mise — a film is a mise-en-scène. 即把「影片」写成 HTML 页面,再由插件自带的渲染与计量能力合成 MP4。核心主张在 README 里写得很直接:能测量的都不靠形容词——每个判断要么有像素、要么有数字、要么有标准编号(如 EBU R95、WCAG 1.4.3、ITU-R BS.1770、Netflix TTSG)。
影片与渲染模型¶
影片由 film.html + 一组镜头页 构成:片段用 at / #t=in,out 排到时间轴上,通过 window.film.frame(t) 绘制第 t 秒画面。
渲染不外包:插件使用自带渲染器——临时回环服务、headless Chromium 逐帧驱动时钟、ffmpeg 混流,默认 2× 超采样。配乐为代码合成(拨弦 / 铺底 / 混响),支持卡点重音、段落和声、句子级闪避,并带母带总线。
测量与交付门禁¶
测量环节强调「先看见再交付」:调色板、影调、色度、构图、细节分层、运动曲线、逐行对比度、响度与频段等,都在插件内完成。
交付走门禁驱动流程:结构校验 → 抽帧验收 → 逐镜批准 → 调色 / 响度 / 回执。自检脚本说明挂载成功后约为 37 个工具、12 条路由、11 个 skills(见下文安装自检)。
单页体检工具 mise_probe 会按成文规范断言,例如(节选):
| 规则 | 阈值 | 依据 |
|---|---|---|
| 标题安全区 | 每边 5%(1080p 下 54px) | EBU R 95 / SMPTE ST 2046-1 |
| 正文对比度 | 4.5:1;大字 3:1;低于 2.0:1 报错 | WCAG 2.1 SC 1.4.3 |
| 单行长度 | CJK 40 字 / 拉丁 80 字符;行距 ≥ 1.15 | WCAG 2.1 SC 1.4.8 |
| 阅读速度 | 20 字符/秒(整镜常驻文本) | Netflix Timed Text Style Guide |
| 削白占比 | < 2% 画面 | 广播 QC 惯例 |
每条 finding 带测量值和标准名;README 说明故意破规也可以——审计的意义是让「破」成为一次决定,而不是疏忽。
工具概览¶
插件在 Host 入口注册 37 个工具,并按分组覆盖从新建到交付的全链路。下面按 README 表格归纳用途(名称与分组以仓库文档为准)。
起步: mise_start / mise_new / mise_demo(环境引导、新建可渲染工程、端到端样片自检);mise_manual / mise_run / mise_doctor(格式手册、命令入口、体检)。
规划与写作: mise_plan、mise_timeline;mise_type / mise_graphics / mise_scene / mise_cine;mise_promo / mise_promo_plan;mise_duo / mise_transition / mise_keyframes。
测量与素材: mise_probe、mise_motion;mise_cutout / mise_depth / mise_interpolate;mise_asset / mise_voice / mise_pack。
声音与检查: mise_score / mise_mix;mise_check / mise_verify / mise_review;mise_look / mise_thumbs。
输出: mise_compose(先量截图留白再定构图);mise_render / mise_grade / mise_deliver / mise_signoff。
页面侧基础能力集中在 vendor/motion/mise-kit.mjs(字阶、网格、对比度、reveals、镜头运动、颗粒等),模型写镜头时可复用,避免每次重写同一套粗糙逻辑。
侧栏与路由¶
插件提供原生侧栏面板(分镜 / 预览 / 设置):分镜为真实帧缩略图时间轴,可改时长与顺序并触发渲染;预览为成片画面;设置含帧率、尺寸、响度与检查状态。后端为 /mise/* 路由,包括 status、storyboard、run、file、check、progress、media、queue、library、credential、region-edit、speech 等。
安装与启用¶
DSH 生态里插件以目录或发布包形式接入桌面 profile;不要凭插件名自行拼接未在文档出现的 dsh plugin add 命令。官方 README 给出两种方式。
方式一:从发布包安装(推荐)¶
在已取得 dsh-mise-2.2.0.tgz 的前提下:
npm i -g ./dsh-mise-2.2.0.tgz
# 或解包后 link 进 ~/.dsh/plugins/dsh-mise
方式二:目录 + profile 登记¶
将插件目录放到任意位置(例如 ~/.dsh/plugins/dsh-mise),在 ~/.dsh/profiles/desktop/package.json 的 dependencies 中登记 @local/dsh-mise 的 link: 路径,并在 dsh.profile.bundles 中追加该包;Windows 上可用 junction 链到 profile 的 node_modules。package.json 的 dsh.bundle.patch 指向 cordis.patch.yml,宿主启动时插入 Host 并注册工具与技能。完全退出 DSH 桌面应用再打开后生效。
安装后可在插件目录执行自检(会真实挂载一遍):
node tests/install-check.mjs
# installed plugin: 37 tools, 12 routes, 11 skills
依赖¶
- Node(宿主自带运行时)
ffmpeg/ffprobe在 PATH 上,或通过DSH_FFMPEG/DSH_FFPROBE指定vendor/node_modules/playwright-core与本机 Chromium(PLAYWRIGHT_BROWSERS_PATH)
典型用法¶
新建并走通渲染: 使用起步类工具 mise_new 建工程,或 mise_demo 跑端到端样片(README 标明样片仅供机器自检)。日常入口可用 mise_run(open·look·render·skills·manual)或查阅 mise_manual。
写页面前查动作: mise_motion 检索动作目录。
单页规范审计: 对镜头页调用 mise_probe;需要与参考图对齐时,文档说明可传 { reference },返回五维距离(调色板 / 中位亮度 / 对比 / 色度 / 冷暖)。
整片一致性: mise_verify 做像素验收(含调色板、影调、色度、异常镜头等),成对距离可点名离群镜头。
页面侧最小示例(摘自 README,路径相对于工程内的 vendor/motion/):
import { defineShot, stage, typeScale, grid, inkOn, contrast,
reveal, camera, grain, drawOn, beats, seeded, token } from './mise-kit.mjs';
const type = typeScale({ base: 26, width: stage().width });
const g = grid({ width: stage().width });
const ink = inkOn(card, { light: '#f6f1e7', dark: '#111' });
defineShot((t) => {
reveal(title, t, { at: 0.2, kind: 'mask' });
camera(world, t, { move: 'push-in', amount: 0.06 });
grain(dust, t);
}, { duration: 4 });
测试套件(在插件根目录):
node scripts/run-tests.mjs # 全部套件,逐文件报告(36 个文件)
node tests/kit.test.mjs # mise-kit + 单页体检与规范审计
node tests/vision.test.mjs # 画面描述
node tests/flow.test.mjs # 运动测量
node tests/audio.test.mjs # 响度与 ffmpeg 校准
适用场景与注意¶
适合谁: 希望在 DSH 内用 HTML/CSS/JS 描述时间轴、又需要可重复的测量与 MP4 交付的智能体或工作流作者;重视 WCAG、广播安全区、响度标准等可审计指标的团队。
权限与安全: 插件以当前 DSH 进程权限运行,会启动本地服务、驱动 Chromium、调用 ffmpeg,并可能通过 media-service 轮询外部图片/视频生成任务。安装前应阅读源码与 MIT 许可证,第三方组件见仓库 NOTICE.md;风格文档出处记在 skills/<name>/mise.json 的 repository 字段。
生态说明: DSH 理念是「一切皆插件」;SkillHub 目录页 为社区站点,与 DeepSeek / 幻方无官方从属关系,并非官方应用商店。
结尾¶
dsh-mise 把「影片 = 网页 + 时间轴函数」和「渲染 + 计量 + 门禁交付」收进同一插件,适合在 Harness 里做可验收的视频工作流。进一步了解请查看 目录页 与 GitHub 仓库 的 README。