前言¶

在智能體輔助開發裏，功能驗收往往停在「能跑」或一段隨手錄屏。常見做法是拼靜態截圖、假頁面或過期的錄屏，交付物很難證明當前版本真實可用。DeepSeek Harness（DSH）支持通過插件把技能掛進 Host 與各 Agent 作用域；社區目錄 skillhub.cn 上維護者 Lumos-789 發佈的 delivery-video（倉庫 Lumos-789/delivery-video-plugin）走另一條路：先要有運行證據，再用真實錄屏、edge-tts 旁白、字級字幕和確定性質量門禁，產出可綁定 SHA256 的演示視頻；也可走 intent: "feedback" 產出缺陷反饋視頻。下面介紹它是什麼、能做什麼，以及如何在 DSH 裏安裝與跑通流水線。

這是什麼¶

delivery-video 是 DSH 技能插件（同時面向 ZCode + DSH 的雙形態 bundle），分類爲工作流。它把「功能確實在跑」轉成可信的交付 demo 視頻：真實屏幕錄製、合成旁白、詞同步字幕，以及拒絕假 demo 或壞片的硬門禁。在 DSH 中技能會在 Host 與各 live Agent 作用域註冊，以便已安裝插件覆蓋 ~/.agents/skills 裏同名舊副本。當前 package 版本爲 1.1.1，許可證 MIT，維護者 Lumos-789。

核心功能¶

先驗證、再錄製¶

工作流要求：在錄製前先證明當前版本真的能跑（例如 git SHA、工單、request ID 等證據）。多案例交付時，技能建議先列驗收案例，每個案例錄一次真實運行，再按執行順序組段，每案以結果鏡頭收尾（推薦結構，非強制門禁）。

episode.json 配方¶

每個片段綁定：一次真實 take + 時間區間 + 一行旁白 + 可選 crop/案例 chip。設置 intent: "feedback" 並填寫 issue 塊時，產出缺陷報告式視頻（嚴重度/階段 chip、復現步驟 overlay），並生成 feedback.json 與可進工單的 feedback.generated.md，同樣綁定產物 SHA256，且走同一質量門禁。

自包含渲染器 render.py¶

通過 edge-tts（詞邊界時鐘）合成旁白，按旁白時長調速各段（0.3x–3x clamp），繪製 label chip 與詞同步字幕，拼接後響度歸一到 −14 LUFS，再跑內置質量門禁。輸出包括 screen_demo.mp4（1920×1080、30fps、h264+AAC）、timeline.json、封面/預覽幀、quality_gate/report.json。

前置檢查與交付覈驗¶

• preflight.py：渲染前校驗配方（結構、區間、crop、瀏覽器錄製證據、TTS 緩存契約、旁白紅線等）。
• verify_delivery.py：覈驗成片、門禁綁定及可選的獨立視覺複覈。
• render.py gate：對任意 mp4 在進工單、聊天或客戶渠道前跑同一套硬檢查（分辨率/FPS/codec、音頻、響度、黑幀、凍幀等；碼率密度爲信息提示，文字仍須 1:1 目視檢查）。

上傳文件始終是過門禁的文件，由 SHA256 綁定。

環境與依賴¶

• python3 3.9+
• PATH 上的 ffmpeg、ffprobe
• pip install "edge-tts>=7.3.1" Pillow（edge-tts 7.2.8 及更早可能對上游返回 HTTP 403，渲染器會在版本過舊時提前失敗並提示升級命令）
• 渲染中文標籤與字幕需要 CJK 字體；極簡 Linux 鏡像常缺，preflight 會在缺字體時提前報錯

Linux 示例：用包管理器安裝 ffmpeg 與如 fonts-noto-cjk 的 CJK 字體，再安裝上述 Python 包。preflight.py、render.py、verify_delivery.py 須用同一 Python 解釋器執行。

副作用（README 披露）：旁白合成會訪問 edge-tts 公網端點；文件僅寫入你指定的 build 目錄；本地調用 ffmpeg/ffprobe，技能本身不上傳、不發佈、不刪除遠端內容。

安裝與啓用¶

安裝命令以 README 爲準（需指向本地已獲取的插件目錄，勿憑倉庫名臆造 github: 形式）：

dsh plugin add /path/to/delivery-video-plugin

安裝後技能位於 skills/delivery-video/。若 ZCode 0.17.x 仍存在舊的 ~/.agents/skills/delivery-video，無限定名的 /skill delivery-video 可能選中舊副本；可在 composer 選 delivery-video:delivery-video，或使用：

/skill delivery-video:delivery-video <任務>

典型用法¶

1. 用慣用工具錄製真實操作（macOS Cmd+Shift+5、OBS 或腳本化瀏覽器錄屏等；多案例可參考 examples/cases.example.md）。
2. 創建 build/screen_demo-<slug>/episode.json（可複製 examples/episode.example.json）。
3. 依次執行三腳本（Windows 無 python3 時統一用 py -3）：

python3 <skill>/scripts/preflight.py build/screen_demo-myfeature
python3 <skill>/scripts/render.py render build/screen_demo-myfeature
python3 <skill>/scripts/verify_delivery.py build/screen_demo-myfeature

單元測試：

python3 -m unittest discover -s tests -v

安裝後可試提示（README 建議）：用 delivery-video 把這個項目剛完成的功能錄成一段 90 秒交付演示視頻 — 技能會引導驗證、分鏡、錄製、配方組裝、渲染與門禁。

適用場景與注意¶

適合：需要向同事、客戶或工單提交可證明當前構建能跑的演示或缺陷反饋視頻的團隊；希望統一分辨率、編碼、響度與黑幀/凍幀檢查的交付流程。

注意：插件以當前 DSH 進程權限在本地執行 Python 與 ffmpeg；安裝前應閱讀倉庫源碼與 MIT 許可證，確認網絡（edge-tts）與磁盤寫入範圍可接受。社區目錄 skillhub.cn 插件頁 與 GitHub 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

delivery-video 用「真實錄屏 + 配方 + 三門禁腳本」把交付 demo 從拼貼頁拉回到可覈驗產物；在 DSH 裏以本地路徑 dsh plugin add 安裝後即可通過 skill 或上述 bash 流水線使用。詳情與示例見 GitHub 倉庫 與 skillhub.cn 目錄頁。