Capsule Cinema 是一个基于配方驱动的本地视频工作室，旨在把规划、生成、定向返修、装配、质检以及可复用的制作知识统一在一个可审计的工作区中。它可以在 Codex、Claude Code 或 OpenClaw 环境中作为独立安装、插件或源码检出方式运行。
使用前需要先解析运行时（runtime）：检查 {baseDir}/scripts/capsule.py 是否存在，若存在则以其上级目录为 CAPSULE_CINEMA_ROOT；否则检查 {baseDir}/../../scripts/capsule.py；若都不存在，则运行 bash {baseDir}/scripts/bootstrap-runtime.sh，该脚本会把公开运行时克隆到已安装的技能中，而不读取或移动凭据。切换至 CAPSULE_CINEMA_ROOT 后再使用相对路径。若刚克隆运行时，需验证 Python 3.12 并安装依赖：python3.12 -m pip install -r lib/requirements.txt，然后运行 PYTHONPATH=lib python3.12 scripts/capsule.py list 确认。FFmpeg 对于配方浏览和仅故事板工作是可选的，但在渲染、音频混合、字幕烧录或最终装配前是必需的。
在规划或生成媒体之前，应先阅读 references/production-guide.md，并据此路由到更细的故事板技巧、生产模式、渠道策略、工具配方、胶囊包、装配注意事项、评审关卡和工作流产物等参考文档。请求需要先分类：新 AI 视频或故事板、基于本地媒体的后期或装配、参考视频分析或重制、已有胶囊生产、定向场景/配音/字幕/BGM/装配返修、动作迁移/数字人/唇形同步/音乐视频工作流、胶囊创建更新验证打包安装、发布质检或阻塞诊断。只能使用运行时中注册的工作流和提供方，不得凭空发明不支持的路线或悄悄替换承诺的制作方式。
生产契约要求：在选定胶囊后，规划前先加载 capsules/<name>.capsule/；在付费或批量生成前，阅读 lib/config/tool_capabilities.yaml 和 lib/config/tool_registry.yaml，确认最终图像、视频或运动、TTS 或配音、BGM 或音乐、SFX、字幕、合成以及本地脚本工具链，并解释相关替代方案、缺失能力和任何降级。在生成前定义交付承诺（动作主导、素材主导、TTS 主导讲解、参考重制、胶囊预设或专业路线）。对于新的 AI 视频方向，应先生成一个代表性的难场景并检查，然后再批量生成。提供方或工具失败后不得悄悄降级；应在批准策略内重试，若替换会改变承诺结果则停止并等待批准。创建或更新胶囊前应阅读 contracts/content_scope.yaml，确保剧集特定的事实、人物、项目、账号、指标、价格、旁白和临时资产不进入可复用胶囊默认值，只保留可重复的结构、身份、方法和质检知识。更新现有胶囊前应审查语义冲突，每次创建或更新后运行 scripts/capsule_package_validate.py，该脚本包含一致性检查，漂移的胶囊会验证失败。除非有成熟确定性本地渲染器的成功运行证据、跨主题验证、参数化输入和明确确定性步骤，否则胶囊应保持预设模式。生命周期中 blocked 视为阻塞，review_required 视为待处理，不得将任一状态报告为完成。最终交付物应放在 output/ 下，发布必须包含产物清单、适用的质检报告、需要时的修复计划以及 release/release_checkpoint.json。
凭据与本地状态保护：只从代理管理的密钥、系统环境变量或用户创建的根 .env 中读取凭据用于独立本地执行；绝不要要求用户把完整密钥粘贴到聊天中，也不得打印、提交、迁移或把密钥放入提示词、胶囊、清单、日志或生成的文案中；不得创建 lib/.env，保持 lib/.env.example 不含密钥；升级期间保留用户拥有的 .env、local-channels/、capsules、生成的输出和私有提供方适配器。
命令入口包括：列出和检查胶囊（python3.12 scripts/capsule.py list）、生成完整视频（PYTHONPATH=lib python3.12 scripts/run_video.py）、仅生成故事板（--storyboard_only）、重新生成选定场景（scripts/run_scene.py）、重新装配工作区（scripts/run_concat.py）、将视频分析为胶囊草稿（scripts/analyze_video_to_capsule.py）、验证故事板（scripts/validate_storyboard.py）、检查视觉一致性（scripts/run_consistency_qa.py）、运行本地技术质检（scripts/local_video_qa.py）、评分视频质量（scripts/score_video_quality.py）、构建并验证编辑计划（scripts/build_edit_plan.py 然后 scripts/validate_edit_plan.py）、规划修复（scripts/plan_repairs.py）、创建发布检查点（scripts/release_checkpoint.py）、调用注册的低级工具（scripts/run_tool.py）、管理胶囊包（capsule_package_create.py、capsule_package_update.py、capsule_package_pack.py、capsule_package_install.py）。在构造不熟悉的调用前，应查看各命令的 --help；优先使用高级运行器而不是直接调用提供方类。
建议按可审查阶段工作：总结观看体验、路线、工具链、预期限制、代表性场景关卡和发布质检标准；生成并验证故事板；在付费或批量媒体生成前等待方向批准；生成一个代表性难场景并检查；样本通过后生成其余媒体；构建并验证 work/edit_plan.json；装配旁白、视频、字幕、BGM 和 SFX；运行技术质检、视觉检查、质量评分和路线要求的可见文案检查；修复阻塞或如实报告；创建发布检查点并只返回已验证的交付物。对于定向反馈，只重新生成受影响的场景或图层，然后重建依赖产物；除非变更使整个计划失效，否则不要重新启动整个生产。
胶囊管理：活动胶囊位于 capsules/<name>.capsule/，创建或更改结构前阅读 references/capsule-package-format.md。打包和安装命令为：python3.12 scripts/capsule_package_pack.py capsules/<name>.capsule --out /path/to/packages 和 python3.12 scripts/capsule_package_install.py /path/to/packages/<name>.video-capsule.zip --out capsules。在写入可复用经验前，区分稳定的生产知识与单集字面内容；晋升是移动而非复制，一旦经验进入配方或质检规则，应在同一次更新中从 learning/promoted_lessons.yaml 删除。覆盖已建立的胶囊规则前，应向用户展示冲突点。
诊断：当工作流无法继续时，应明确层：缺少前置条件或依赖、缺少提供方凭据或授权、不支持的能力或未注册的提供方、无效的故事板/胶囊/媒体路径/编辑计划、代表性场景或质量关卡失败、仍需用户批准、发布检查点阻塞。返回最小安全下一步；不得把部分媒体、未验证的时间线或阻塞的生命周期描述为完成的视频。
适用场景：需要可追溯、可复用本地 AI 短视频生产流程的创作；基于参考视频的重制；定向修复场景、配音、字幕、BGM 或装配；胶囊包的创建、更新、打包和安装。限制：需要 Python 3.12；渲染、混音、字幕烧录和最终装配需要 FFmpeg；只能使用运行时注册的工作流和提供方；付费或批量生成前需要批准；具体提供方功能、收费、价格、平台支持等细节暂未提供。