yellowworkshops

创作者购买了 yellowworkshops 并添加了这个插件。此技能会在第一次使用时准备好他们自己的计算机（大约 10 分钟，一次性），保持其最新，打开指南，然后将每次编辑任务交给完整的编辑器技能（ugc-reels-editor）。创作者是非技术性的：永远不要让他们输入命令；自己执行所有操作并用平实的语言交流。

在他们的计算机上运行

所有操作都在创作者自己的 Windows PC 或 Mac 上，通过 Claude 桌面应用的“代码”选项卡（或 Claude Code）运行。如果状态检查显示 SANDBOX，说明你处于一个小的云沙箱中，而非在他们的计算机上：用一两行文字告诉他们打开 Claude 桌面应用，选择代码，在他们的计算机上选择一个文件夹，然后再次询问。切勿为了绕过此限制而复制他们的任何素材。

设置命令

脚本位于此文件（此技能的基础目录）旁边的 scripts 文件夹中。根据计算机选择合适的脚本：

Windows (PowerShell): powershell -NoProfile -ExecutionPolicy Bypass -File "<skill dir>\scripts\start.ps1" <command>
Mac (bash): bash "<skill dir>/scripts/start.sh" <command>

命令: status · all --key YWS-XXXX-XXXX-XXXX · update --daily · diag。首次运行会将 Python 的私有副本（校验和锁定）下载到 ~/yellowworkshops/runner；不会在系统范围内安装任何内容，也不需要管理员密码。

每当创作者要求制作视频（或任何与 yellowworkshops 相关的内容）时

运行 status。它会输出 JSON，然后输出 READY、NOT_SET_UP 或 SANDBOX: … 之一。
NOT_SET_UP: 先进行设置（如下所示），然后继续处理他们的请求。
READY: 运行 update --daily（快速；每天最多执行一次真正检查）。如果它输出 UPDATED to …，用一行文字告诉他们有什么新内容（冒号后的文本）。然后交给编辑器：如果 ugc-reels-editor 技能已列出，则使用该技能；否则读取 ~/.claude/skills/ugc-reels-editor/SKILL.md 并按照其说明操作。使用 ~/yellowworkshops/ugc-reels-home.json 中的 Python (python_cmd) 运行编辑器的脚本——引擎只能与该 Python 一起运行。新项目放在 ~/yellowworkshops/projects/<视频名称>/。

首次设置

你需要他们的许可证密钥（YWS-XXXX-XXXX-XXXX，在他们的购买邮件中）。如果他们还没有提供，请向他们索取——这是你唯一需要问的问题。用一行文字告诉他们：“正在设置你的计算机：大约 10 分钟，仅此一次。你的视频永远不会离开这台电脑。”
运行 all --key <KEY>。它会下载大约 1 GB 的内容，所以请在后台运行它并等待其完成（不要循环轮询）。它会打印一个带编号的步骤列表（[3/7] 正在激活你的许可证…），并附有下载百分比；简要告知他们步骤标题，而不是每一行。如果某个命令因时间限制而被终止，请重新运行相同的命令：已完成的步骤会跳过，下载会断点续传。
通过最后一行和退出代码读取结果：
- READY: …（退出代码 0）→ 告诉他们设置已完成，提及 “随时输入 guide 获取创意”，然后继续处理他们的请求（上面部分的步骤 3）。编辑器技能刚刚被添加到 ~/.claude/skills/ugc-reels-editor；如果在此会话中尚未列出，请直接读取其 SKILL.md。
- NEEDS_KEY（退出代码 11）→ 索要密钥，使用 --key 重新运行。
- SANDBOX: …（退出代码 10）→ 参见“在他们的计算机上运行”。
- SETUP_ERROR: <原因>（退出代码 1）→ 使用下面的故障排除手册修复问题，然后重新运行 all。详细信息在 ~/yellowworkshops/install-log.txt 中。

故障排除手册 (SETUP_ERROR)

自行修复你能处理的问题，用一两句平实的文字解释其余问题，然后重试。

无法连接到 / 无法下载 → 检查互联网连接（curl -I https://yellowworkshops.com）。公司网络、VPN 或防火墙可能会阻止下载：请他们尝试其他网络（手机热点），然后重试。
仅剩 N GB 可用空间 → 告诉他们需要释放多少空间以及在哪里释放（回收站/废纸篓、下载文件夹）；你可以显示他们下载文件夹中最大的文件夹，但未经他们明确同意，不要自行删除任何内容。
密钥已在另一台计算机上使用 → 每个许可证对应一台计算机。提供选项：在旧计算机上说“移动我的 yellowworkshops 许可证”（它会运行 reels deactivate），或者如果那台计算机已经没了，请写信至 [email protected]。
密钥未找到 / 已退款 → 要求他们再次从邮件中复制密钥（注意字母 O 与数字 0 的区别）；否则联系技术支持。
防病毒 / 无法解包 / 程序仍在使用中 → 关闭正在编辑视频的其他 Claude 会话和编辑器窗口；如果防病毒软件隔离了文件，请他们允许主文件夹中的 yellowworkshops 文件夹。
Windows “路径过长” → 主文件夹路径很长；为设置命令设置 YWS_HOME 为短路径，例如 C:\yellowworkshops，然后重试。
FFmpeg/引擎无法在此 Mac 上启动 → 注意 status 中的 macOS 版本；需要 macOS 12 或更新版本。不支持较旧的 Mac：礼貌地说明情况，并让他们联系 [email protected] 退款。
下载列表未签名 / 设置助手过旧 → 更新此插件（/plugin update yellowworkshops——如果可以的话，替他们运行该命令，否则用一行文字告诉他们），然后重试。
其他任何问题 → 运行 diag，解释你所看到的内容，并主动提出为他们撰写一封支持邮件，发送至 [email protected]，并附上诊断输出（其中不包含任何素材或名称）。

指南

当创作者输入 guide、“我可以问什么？”或“给我看看例子”时：打开 yellowworkshops 指南，这是一个包含可直接复制的提示的页面。如果 ~/yellowworkshops/ugc-reels-home.json 中有 guide_url，则打开该工件。否则，将编辑器技能中的 assets/guide.html（~/.claude/skills/ugc-reels-editor/assets/guide.html）作为工件发布一次，将其 URL 保存为该 JSON 中的 guide_url，然后打开它。它不包含任何视频数据。如果该页面尚不存在，请在聊天中向他们提供八个好的示例提示。

其他请求

更新 / 获取新样式 → update（不带 --daily），然后运行 ~/yellowworkshops/bin/reels styles update（Windows 中为 %USERPROFILE%\yellowworkshops\bin\reels.cmd styles update）；报告更改的内容，并命名任何新样式（它们在编辑器的图库中会显示 New 标记）。
将许可证移动到新计算机 → 在此计算机上运行 ~/yellowworkshops/bin/reels deactivate（Windows 中为 %USERPROFILE%\yellowworkshops\bin\reels.cmd deactivate），然后在新计算机上添加插件并使用相同的密钥进行设置。
出现故障 → 运行 status，然后运行 diag；使用故障排除手册修复。

隐私（对创作者的承诺）

他们的素材、音频、帧、转录文本和渲染结果永远不会离开他们的计算机。设置过程仅从 yellowworkshops.com 下载公共程序文件（每个文件都根据我们签名的列表进行检查）；激活过程仅发送许可证密钥和计算机的哈希 ID。

yellowworkshops 插件