前言¶

在 DeepSeek Harness（DSH）里做智能体或工具链时，视频素材往往还停留在 Log 或厂商自定义曲线上，导出前仍要借助桌面 NLE 或单独脚本做 LUT、明暗和肤色。DSH Video Studio 把「选文件夹 → 选片段 → 还原相机色彩 → 可选微调 → 导出」收进一个插件界面，处理在 Host 本地完成，不另存 API Key。下面介绍它是什么、能做什么，以及如何安装与配置。

这是什么¶

DSH Video Studio（npm 包名 dsh-video-studio，当前发行版 0.1.0-beta.3）由 PengJunchen 维护，采用 MIT 许可证。定位是：面向 DeepSeek Harness 的本地视频调色工作台——打开素材目录、选定片段、按相机/Log 配置做 LUT 还原，预览可选调整，再导出新的视频文件。

社区目录 SkillHub 条目 将其归类为「趣味换装」；功能本身集中在影调、LUT 与导出，与 Harness「一切皆插件」的扩展方式一致。SkillHub 为独立社区站点，与 DeepSeek / 幻方无官方从属关系。

插件处于早期版本，界面目前为中文；本地图像统计可提供可选建议，但不替代创作意图。

核心功能¶

五个能力共用一套处理运行时（README 表述为 five features over one shared processing runtime）：

1. 相机 / 配置感知的 DJI LUT 匹配
   支持 D-Log、D-Log M、D-Log2；在可用时优先 Vivid / Size 65，也可选用其他已注册的 look 或尺寸。完整平台包内置 18 个 DJI LUT。

2. 高光与阴影
   独立调节，可选更强的暗部提亮；提供近似时间范围建议与手动控制。

3. 可选空间降噪、人脸引导的肤色亮度/平滑、局部颜色
   调整项默认未设置，建议需用户接受后才生效。

4. 预览与检视
   当前帧预览、原尺寸检查、源片播放，以及有边界的处理后片段播放；可折叠素材与调整面板以便观看。

5. 导出与 AI 建议（可选）
   以细节优先的 10-bit HEVC 导出，输出路径可显式指定，支持结果播放、系统播放器打开与在文件夹中Reveal。默认输出目录为源文件夹下的 Output/，原文件只读。
   可通过 Harness 已配置的模型获得分页面的 AI 建议；图像分析需用户 opt-in，插件不单独存储 API Key。

工作域为显示 referred 的 SDR Rec.709；不支持 HDR HLG/PQ 与 RAW 母版流程。

环境与依赖¶

• DeepSeek Harness：0.2.1-rc.2 / rc.3（package.json 中 dsh 为 >=0.2.1-rc.2 <0.3.0）。
• Node.js：22.19+。
• 完整平台包（带 -darwin-arm64、-darwin-x64、-win32-x64、-linux-x64 等后缀）已捆绑固定 Python、FFmpeg/ffprobe、NumPy、OpenCV 与 LUT，用户无需再装这些组件。
• 通用小包含 LUT，首次启动可通过「配置独立环境」，或使用自有的 Python 3.10+ 与 FFmpeg/ffprobe 8+。

Desktop 可用原生文件夹选择器；Web Host 需显式授予源目录。GitHub 自动生成的源码 ZIP/tarball 不包含 LUT 载荷，应使用 Releases 中的 prepared .tgz。

安装与启用¶

从 GitHub Releases 下载与 Harness Host 架构匹配的 .tgz，在 Harness 插件安装器中选择该文件。npm 包名不是已发布的安装通道。

Apple Silicon Mac 上可用 CLI 直接安装完整发行包：

dsh plugin --profile desktop add 'https://github.com/PengJunchen/dsh-video-studio/releases/download/v0.1.0-beta.3/dsh-video-studio-0.1.0-beta.3-darwin-arm64.tgz'

若已下载到本地，按实际使用的 profile 安装（Web 用 web）：

dsh plugin --profile desktop add /absolute/path/to/dsh-video-studio-0.1.0-beta.3.tgz
# For a Web Host, use --profile web instead.

安装后在方便时重启 Harness，在侧栏打开 影调工作台。Desktop 上选择源文件夹；默认无源目录授权。

配置¶

在活跃 profile 的 cordis.patch.yml 中追加覆盖；修改已有的 hvp-runtime 行，不要插入第二条 runtime。路径均指 Host 文件系统（浏览器在另一台机器上时亦然）。

Web 下手动路径扫描需要 allowedRoots：

- id: hvp-runtime
  config:
    allowedRoots:
      - /absolute/path/to/videos
    # Optional explicit override; normally use the bundled runtime.
    # python: /absolute/path/to/python
    # Optional Python containing NumPy/OpenCV:
    # assets:
    #   vision_python: /absolute/path/to/venv/bin/python

Desktop 文件夹选择器仅授予用户选中的目录；不要为单个文件夹把整个磁盘加入 allowedRoots。

草稿与任务保存在 Harness 主目录下的 video-studio/（dshHomePath('video-studio')），不在插件安装目录内。若要迁移，在同一 runtime 行设置 dataDir，升级时保留该目录可延续草稿与导出记录。

自带 LUT 目录：默认资源见 assets/catalog.json。自定义目录可配置：

- id: hvp-runtime
  config:
    assets:
      catalog_path: /absolute/path/to/video-luts/catalog.json
      lut_root: /absolute/path/to/video-luts

从源码 checkout 注册 3D CUBE → Rec.709 LUT 示例：

npm run catalog -- --file /path/to/vivid.cube \
  --camera pocket4p --profile dlog2 --look vivid \
  --directory /path/to/video-luts

配置 catalog_path 与 lut_root 后重载插件。可选人脸引导处理需自建 venv 并安装 requirements-vision.txt，将 assets.vision_python 指向该 Python；检测仅提供人脸候选，导出前务必预览。

典型用法¶

1. 在左侧列表选中片段，确认 Log 还原与 LUT 映射。
2. 按 明暗 → 肤色 → 局部颜色 → 确认 顺序浏览；每一步均可选，仅接受需要的建议或手调。
3. 拖动时间轴检查不同位置，指定导出目的地并执行导出（默认 Output/）。

README 还说明：影调建议基于稀疏 RGB16 采样，非精确镜头检测；暗部提亮会放大噪声；空间降噪无时间域模型；快速预览与原尺寸处理可能不一致；4K 原尺寸处理非实时；细节优先导出会校验 YUV420p10 帧是否被编码保留，但 LUT 与色度转换不可逆；显式选择的快速模式为有损，文件可能远大于源片。

适用场景与注意¶

适合：已在 DSH 工作流中处理 DJI（及 catalog 已注册机型）Log 素材、希望在 Host 本地完成 Rec.709 还原与轻度调色、并需要 10-bit HEVC 成片的路径；需要可选 AI 建议且愿意在 Harness 里统一配置模型时。

注意：

• 插件以当前 DSH 进程权限读写 Host 路径；安装前应阅读 GitHub 仓库 源码与 MIT 许可证，确认 allowedRoots 与输出目录范围可接受。
• AI 建议可能错误，且仅在用户接受后改动当前页控件；启用图像分析会向 Harness 所选提供商共享采样帧。
• 未知 Log 需用户确认与有效变换；不要指望插件替代专业 HDR/RAW 流程。

结尾¶

DSH Video Studio 把 DJI Log LUT 还原、明暗与肤色/局部色、以及 10-bit HEVC 导出集中在 Harness 侧栏「影调工作台」，适合把调色从外部工具收回到本地插件的一小步闭环。

• 社区目录：https://www.skillhub.cn/plugins/PengJunchen/dsh-video-studio
• 源码与 Releases：https://github.com/PengJunchen/dsh-video-studio