前言¶
在 DeepSeek Harness 里做音视频返修，常见做法是：在外部播放器里记时间码，把意见贴进聊天，制作会话改完后再手工对照新旧文件。时间轴和画面框难以和意见一一绑定，一轮固定意见发出去之后，新版回来也很难按条定位核对。
Media Review DSH 是面向本地媒体审片的工作流插件：在 Harness 里直接看片、在波形和画面上标注、把固定一轮意见交给绑定的制作会话，新版登记回来后按意见对照，由人逐条判断是否通过。它与早期的 Media Review Skill 分开安装、分开存记录，由社区维护者 Ww-Cooooo 独立发布，并非 DeepSeek 官方插件。
这是什么¶
插件包名为 media-review-dsh，归类为工作流。当前预发布版本为 0.1.0-rc.6，package.json 中声明适配 DeepSeek Harness 0.2.2-rc.1，且 dsh.bundle.platforms 目前为 win32（Windows 桌面客户端）。应用代码许可证为 MIT；安装包内第三方组件授权见仓库中的 THIRD_PARTY_NOTICES.md。
插件负责审片与返修交接，不内置剪辑引擎、语音模型、云端媒体库或自动发布。波形依赖本机 FFmpeg（如 ffprobe），台词识别可选用本地 Whisper 或导入 SRT／VTT。
核心功能¶
标注与审片台¶
- 在波形上拖选时间段，松开后即可写意见；拖动两端可调整范围。暂停后在画面上直接拖框，每个编号框都能写说明，也可对同一选段继续加框。参考帧自动保存，点中已有意见可改文字。
- 时间轴支持缩放、移动、选段回放、前后上下文和循环；播放中按 I 标起点、按 O 标终点。空格播放／暂停，方向键细移，底部提供撤销与重做。本版恢复鼠标位置锚定的滚轮时间缩放；波形区域保持紧凑。
- 台词可调用已有本地 Whisper，或导入 SRT／VTT；点句子定位，点加号写对应时间段意见。识别结果需人工核对。
- 播放器「更多播放操作」包含只听声音、声音 A/B 对照、精细定位、挂起／恢复等。
一轮意见与新版复核¶
- 点 发送修改意见，核对制作会话和允许改动范围。发送内容单独固定保存；之后再改的文字留在草稿中。
- 制作会话读取固定意见、确认接手，实际制作新文件并登记为第 2 版。界面会显示等待或处理进度；收到消息不等于已经改好。
- 点 查看修改结果，对照修改前后的作品，选择 已改好 或 还要修改。缺少对应时间时，先定位并保存位置。下一条意见只跳转位置，不代表通过。
- 全部意见通过后，本次审片显示 已完成。仍有问题时点 整理修改意见 再发送；已通过的意见不会再次发送。可点 补充新意见 登记新问题。
查找、作品管理与导出¶
- 画面索引按视频生成缩略图；意见可搜索，并按修改／保留／讨论及类别、进度筛选。作品管理支持搜索、重命名、归档与恢复。
- 底部导出可生成离线资料包：HTML 清单、JSON 意见和带编号框的参考画面；不附带原媒体。没有意见时可点 无需修改，结束。
- 版本与轮次支持添加新版、本版检查、草稿与恢复、资料位置、本机分析，以及原文件移动后 重新选择同版。
模型沿用所绑定制作会话的连接与配置，插件不另设模型登录。提交时元数据（意见、时间范围、框选、媒体路径、参考帧文件名等）会交给制作会话，并可能发往其配置的模型服务；插件不自动把音视频或参考帧二进制放进模型请求。
安装与启用¶
本插件不提供 dsh plugin add github:... 式的一行安装命令；请按 README 从发布页下载安装包（tgz），在 Harness 客户端里添加本地路径。
当前步骤如下：
- 下载插件安装包（勿选 GitHub 自动生成的 Source code 压缩包）：
https://github.com/Ww-Cooooo/media-review-dsh/releases/download/v0.1.0-rc.6/media-review-dsh-0.1.0-rc.6.tgz
发布页与验证资料 ZIP：
https://github.com/Ww-Cooooo/media-review-dsh/releases/tag/v0.1.0-rc.6
-
在 Harness 客户端打开 插件 → 添加插件，粘贴该
.tgz文件的完整路径，点 安装；成功后点 立即启用。若提示需要重启，先保存当前工作，再完整退出并重新打开客户端。 -
侧栏出现 Media Review DSH 后打开。在 Harness 创建或选定工作区和制作会话，将音视频放在工作区目录里。
-
点 新建审片，选择文件与制作会话（也可先仅人工审片）；在波形上拖出一段时间，或暂停后直接在画面上拖框，随后输入意见并保存。
媒体工具与数据目录¶
通常用 ffprobe 识别媒体。缺少工具时，可在新建审片的「媒体工具不可用？」中选择同一份文件，核对内容后人工审片（512 MB 以内）。若本机原 Media Review 校对台已配置工具路径，插件可复用；也可在审片台顶部 设置与存储 中填写 ffprobe 完整路径。在工具状态页点 检查并补齐缺失项 时，会先复用有效工具，只补缺失项；全部缺失时约需下载 580 MB。已有配置不会重复安装，媒体不会上传。
意见与轮次等数据保存在插件配置的 dataDirectory。默认在 Harness 数据根目录下的 eh3-media-review；未设置 DSH_HOME 时，Windows 为 %USERPROFILE%\.dsh\eh3-media-review。实际路径可在 设置与存储 中查看。桌面客户端播放大文件时会分块写入本机临时缓存（总量最多 2 GiB），离开审片面板时清理。
典型用法：完成一轮返修¶
下面步骤与 README「一轮审片怎样完成」一致，可在本地按界面复现。
- 在波形上拖选时间段写意见；暂停后在画面上拖框并保存说明。
- 点 发送修改意见，确认制作会话与改动范围；发送结果不明确时，在本轮详情重试，继续使用原操作编号。
- 等待制作会话登记新版（如第 2 版），勿把「收到消息」当作已改好。
- 点 查看修改结果，逐条选择 已改好 或 还要修改；全部通过后审片状态为 已完成。
- 需要第二轮时，仅仍未通过的意见进入下一轮；已通过的不重复发送。
仓库 VALIDATION.md 记载：rc.6 测试包曾在本地桌面完成两轮真实返修（第一轮三条意见，一项进入第二轮后全部通过）。该记录用于技术验证，不代表对成片效果的最终评价。
适用场景与注意¶
适合谁： 在 Harness 内用制作会话改音视频、又需要把时间码、画面框和固定一轮意见绑在一起交接的桌面用户（当前包明确面向 Windows + DSH 0.2.2-rc.1）。
权限与安全： 插件以当前 DSH 进程权限运行，通过本机已认证通道读取工作区媒体。安装前应自行查看源码与 LICENSE、THIRD_PARTY_NOTICES.md，确认第三方条款（例如 GSAP 相关条款）可接受。
文件与版本： 原文件不被改写；新版须是工作区内另一个实际变化的媒体文件。文件被移动或替换时，意见保留但播放与提交不可用，需从 版本与轮次 → 原文件移动了？重新选择同版 选回同内容路径。不同内容会被拒绝，须作为新版登记。
备份： 备份前先保存意见；可在客户端禁用插件后复制完整 dataDirectory 及引用的媒体。禁用、卸载不会主动删除这些资料。
与其他工具： 若想在其他 Agent 里先澄清模糊需求，可另行安装同维护者的 Easy Ask AI Skill；它不是本插件的前置依赖。
结尾¶
Media Review DSH 把「边看边标 → 固定发送 → 新版对照 → 逐条通过」收进 Harness 侧栏，减少在外部工具与聊天之间来回对时间码。社区目录页与源码仓库如下，安装包版本与验证说明以发布页为准。
- 目录页：https://www.skillhub.cn/plugins/Ww-Cooooo/media-review-dsh
- GitHub：https://github.com/Ww-Cooooo/media-review-dsh
