前言¶
在 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）：
-
相機 / 配置感知的 DJI LUT 匹配
支持 D-Log、D-Log M、D-Log2；在可用時優先 Vivid / Size 65，也可選用其他已註冊的 look 或尺寸。完整平臺包內置 18 個 DJI LUT。 -
高光與陰影
獨立調節，可選更強的暗部提亮；提供近似時間範圍建議與手動控制。 -
可選空間降噪、人臉引導的膚色亮度/平滑、局部顏色
調整項默認未設置，建議需用戶接受後才生效。 -
預覽與檢視
當前幀預覽、原尺寸檢查、源片播放，以及有邊界的處理後片段播放；可摺疊素材與調整面板以便觀看。 -
導出與 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+。
| 包後綴 | Host 要求 |
|---|---|
| darwin-arm64 | macOS 13+，Apple Silicon |
| darwin-x64 | macOS 13+，Intel |
| win32-x64 | Windows 10 22H2+，x64 |
| linux-x64 | Ubuntu 22.04+ / glibc 2.35+，x86-64 |
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；檢測僅提供人臉候選，導出前務必預覽。
典型用法¶
- 在左側列表選中片段，確認 Log 還原與 LUT 映射。
- 按 明暗 → 膚色 → 局部顏色 → 確認 順序瀏覽；每一步均可選，僅接受需要的建議或手調。
- 拖動時間軸檢查不同位置，指定導出目的地並執行導出（默認
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 側欄「影調工作臺」，適合把調色從外部工具收回到本地插件的一小步閉環。
