前言¶

在智能体辅助开发里，功能验收往往停在「能跑」或一段随手录屏。常见做法是拼静态截图、假页面或过期的录屏，交付物很难证明当前版本真实可用。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 目录页。