dsh-mise:把「影片」写成 HTML,在 DSH 内测量、渲染并交付 MP4

前言

在 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。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜