前言¶
在 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。