前言¶
克隆一份 OpenMontage 之后，环境往往比代码本身更难对付。Windows 上有三个高频卡点：git 缺 https 助手导致 clone 失败，机器上没有 make 导致依赖装不上，ffmpeg 的 PATH 不被子进程继承导致渲染阶段直接被拦。每一步单独搜都能搜到零散解法，但串起来的顺序、验证方式和回退点很少有人写清楚。
下面介绍的这个 Skill 就是把「从零到能渲染」的完整链路固化成一套可复用的流程。
这是什么¶
OpenMontage从零部署（坐标 @user_7e6f1fc8/openmontage-workbuddy）是一个社区来源的 Skill，发布者 user_7e6f1fc8，版本 1.0.0，SkillHub 分类为 it-ops-security。
它解决的问题是：把 OpenMontage（开源 agentic 视频制作系统）在一台全新的 WorkBuddy 环境里从零配好，直到完成一次端到端渲染验证。
核心能力¶
1、覆盖从零部署的完整流程，而不是只贴一段安装命令。
2、针对 Windows 环境的三大绕行方案：git 缺 https 助手改用 tarball；没有 make 时手工翻译构建步骤；ffmpeg PATH 不继承时用 sitecustomize 补丁注入。
3、依赖安装的顺序与校验方式。
4、部署后的健康检查，用来区分「环境没装好」和「渲染本身有问题」。
5、端到端渲染验证，确认整套链路真的可用。
Windows 三大绕行方案¶
这三个方案对应 Windows 上最常见的三类失败，逐个说明。
1、git 缺 https 助手，改用 tarball
症状是 clone 时报错，根因通常是本机 git 没有可用的 https 传输助手。绕行办法是绕开 git 协议，直接从仓库页面下载压缩包（tarball / zip）后解压到目标目录。
操作顺序：
1、确认目标目录和仓库地址。
2、下载压缩包到本地。
3、解压到工作目录，得到与 clone 后一致的目录结构。
4、后续步骤按解压后的目录执行，不再依赖 git。
2、没有 make，手工翻译构建步骤
症状是依赖构建阶段提示找不到 make 或命令失败。绕行办法是把原本由 Makefile 驱动的步骤逐条翻译成等价的直接命令，手工执行。
操作顺序：
1、打开构建文件，逐条读出需要执行的步骤。
2、把每条 make 目标替换为对应的直接命令。
3、按依赖顺序手工执行，一次一条，失败就停。
4、执行完确认产物存在，再进入下一步。
3、ffmpeg PATH 不继承，用 sitecustomize 补丁
症状是健康检查报 ffmpeg 检测失败，但单独在终端里执行 ffmpeg 是正常的。根因是 Python 进程没有继承到当前会话的 PATH。绕行办法是用 sitecustomize 补丁，在解释器启动早期把所需路径写回 os.environ["PATH"]。
思路如下，具体路径按实际安装位置填：
# sitecustomize.py
import os
os.environ["PATH"] = r"<ffmpeg所在目录>;" + os.environ.get("PATH", "")
放置位置应保证解释器启动时会加载它，然后用健康检查脚本验证 ffmpeg 能否被检测到。
依赖安装与健康检查¶
先装依赖，再做健康检查。健康检查的作用是把「环境没配好」和「渲染逻辑有问题」区分开，避免在错误的方向上排查。
1、按项目声明安装依赖，顺序按官方文档为准。
2、运行健康检查脚本，确认关键外部命令（ffmpeg 等）可被检测到。
3、若健康检查失败，先回到上面三个绕行方案排查，再继续。
端到端渲染验证¶
健康检查通过后，跑一次最小渲染任务，验证从素材到成片的链路是否完整。这一步通过，才算部署真正完成。
安装与启用¶
该 Skill 发布在 SkillHub，坐标与页面如下，标签 requires_api_key=false，即不需要额外密钥。
坐标: @user_7e6f1fc8/openmontage-workbuddy
页面: https://www.skillhub.cn/skills/user_7e6f1fc8/openmontage-workbuddy
接口: https://api.skillhub.cn/user_7e6f1fc8/openmontage-workbuddy
版本: 1.0.0
抓取到的资料中没有给出具体的 CLI 安装命令，也没有区分 Cursor / Codex CLI / Claude Code 的差异，因此安装入口以上述 SkillHub 页面为准，本文不臆造命令。
何时使用¶
适合在下面这些说法出现时启用：
- 「部署 OpenMontage」「安装 OpenMontage」
- 「在另一台机器 / 新环境装 OpenMontage」
- 「修复 OpenMontage 的 ffmpeg 检测失败」
- 「OpenMontage 渲染 blocked」
- 已经克隆了一份 OpenMontage，需要从零配好环境
也适用于同类场景：Node + Python 混合项目在 WorkBuddy 上部署时遇到 PATH 继承问题。
适用场景与注意¶
适合的人：需要在 Windows 新机器上部署 OpenMontage，或正在排查渲染被拦、依赖装不上这类环境问题的人。
需要注意的几点：
1、三大绕行方案针对 Windows 环境，Linux / macOS 上不一定需要，不要照搬。
2、make 缺失时的「手工翻译」需要能读懂构建文件，不是一条万能命令。
3、sitecustomize 补丁会改动解释器启动行为，路径写死会污染其他项目，建议限定在本项目环境内。
4、本文的数据来自 SkillHub 页面抓取时点：评分 100000、下载 1562、安装 0，后续会变化。
5、核心能力来自 Skill 简介，完整的命令级细节需在使用页面时核对。
结尾¶
这个 Skill 的价值在于把 Windows 上部署 OpenMontage 的三道坎和验证链路整理成了一套顺序明确、可复现的流程，省掉反复试错的时间。
官方地址：https://www.skillhub.cn/skills/user_7e6f1fc8/openmontage-workbuddy
