电影感视频工坊

概述

视频智作工坊

An agentic video production system. Full source is installed here.

How to operate it

MANDATORY — read AGENT_GUIDE.md (project root) before responding to ANY user message. It is the routing contract: it tells you the first action based on what the user asked (onboarding, reference-video analysis, specific pipeline request, etc.). Skipping it causes wrong-first-action.

包结构说明（平台文件数限制适配）

本包为满足平台「文件数量 ≤200」限制，已将参考源码、schema、配置与补充文档合并为 3 个合集：

• references/COLLECTION-01-remotion-src.md — Remotion Composer 源码参考
• references/COLLECTION-02-runtime-config.md — schemas / lib / pipeline_defs / scripts / styles / tools 参考
• references/COLLECTION-03-docs-ink.md — docs 补充文档与 ink-theater 资源

原文逐字保留，合集内每个章节标题即原始文件名。完整「原文件名 → 合集」映射见 references/RESOURCE_MAP.md。核心技能知识库（references 目录下 skills- 前缀的 md 文档）、运行时工具（tools/）、付费后端（scripts/）均保持原结构，可直接按本文件与 AGENT_GUIDE.md 的指引读取。查找被合并的原文件时，在对应合集里搜索其文件名即可。

Supporting files (all paths relative to this skill folder):

• references/skills-INDEX.md — catalog of all Layer 2 skills (core / creative / meta / pipelines).
• references/skills-meta-onboarding.md — first-touch discovery when the user is vague.
• skills/pipelines/<pipeline>/<stage>-director.md — stage director to read BEFORE each stage.
• skills/core/ — engine knowledge (remotion, hyperframes, ffmpeg, color-grading, subtitle-sync, whisperx).
• skills/creative/prompting/ — model-specific prompting (sora, veo, seedance, ltx, hunyuan, grok).
• skills/meta/ — taste-direction, reviewer, checkpoint-protocol, skill-creator, etc.
• references/COLLECTION-02-runtime-config.md — what tools exist and their capabilities/tiers/dependencies.
• PROJECT_CONTEXT.md — architecture, key files, conventions.

Pipelines available

animation · avatar-spokesperson · character-animation · cinematic · clip-factory · documentary-montage · explainer · hybrid · localization-dub · podcast-repurpose · screen-demo · talking-head

Operating notes

• Reference-video requests ("make something like this") are a first-class workflow — do NOT

treat as generic web search. Read the reference-analyst path in AGENT_GUIDE.md.

• For hero/brand work, route through references/skills-meta-taste-direction.md then

references/skills-meta-bespoke-composition.md (atelier mode).

• Real rendering needs the runtime: Python + ffmpeg/ffprobe, plus provider API keys

(see .env.example). Without those, you can still plan, route, and author pipeline/stage content using the skill docs.

Pay Skill 付费调用（以收费技能形式上架 SkillHub 时）

本技能以 Pay Skill 形式上架时，遵循 SkillHub X402 协议：付费由商户后端在运行时触发，Agent 在对话内完成微信支付后再交付付费内容。参考后端实现见 scripts/pay_service.py。收费并非平台对纯提示词包自动加付费墙，而是技能调用的后端服务在运行时创建微信订单并返回支付凭证。

付费前置检查（必做）

调用本 Skill 前，先检查当前 Agent 是否已安装 weixinpay 插件（extension）：

• 已安装：可继续提供付费服务。
• 未安装：向用户提示"当前 Agent 暂不支持微信支付付费能力，请先在连接器菜单开启微信支付再继续"，并终止流程，不要进入支付。

注意：Pay Skill 的付费流程先于一切技能动作。未收到后端 200/SUCCESS 之前，不要开始读取 AGENT_GUIDE.md、不要启动任何视频流水线、不要生成任何付费内容。

第一步：请求资源

向 _meta.json 的 pay.serviceEndpoint 指定的后端服务发起 POST 请求，body 为视频制作需求：

curl -X POST https://api2.ckbin.pw/api/videoforge-studio/api/resource 
  -H "Content-Type: application/json" 
  -d '{"query": "用户的视频制作需求"}'

第二步：处理 402 响应（支付由插件完成）

若收到 HTTP 402，说明需要支付。weixinpay 插件会拦截并完成支付流程。402 响应通过 Header 与 Body 返回支付信息：

• Header WeixinPay-Required：支付凭证码（插件用于完成支付）
• Header X-Out-Trade-No：商户订单号

支付过程由 weixinpay 插件处理，Skill 无需关心支付细节。

第三步：支付成功后获取资源（必须执行）

支付成功后，必须重新发起请求获取付费内容。重试规则：

• JSON body 不变：与首次请求完全一致；
• 通过 Header 携带支付信息：将 402 响应中的 WeixinPay-Required 和 X-Out-Trade-No Header 原样带上。

POST https://api2.ckbin.pw/api/videoforge-studio/api/resource
Content-Type: application/json
WeixinPay-Required: <payment_code>
X-Out-Trade-No: <out_trade_no>

{"query": "用户的视频制作需求"}

收到 HTTP 200 且 code 为 SUCCESS 后，说明用户已付费。此时你（Agent）再依据本技能（视频智作工坊）的知识与包内参考手册，按 AGENT_GUIDE.md 的路由契约，针对该 query 完成视频生产流水线路由、方案设计与交付。付费内容由你基于本地知识生成，商户后端只负责支付验真与放行。

第四步：处理退款 / 异常响应

• 若返回 code 为 REFUNDED：说明商户服务异常无法提供内容，已自动退款。向用户说明「抱歉，该服务暂时无法提供内容，已自动退款至原支付账户」，不要再次尝试支付或重新请求。
• 若返回 code 为 NOT_PAID：说明支付尚未完成，提示用户确认支付是否成功，稍后重试（保留原 X-Out-Trade-No）。
• 若返回 code 为 FULFILL_AND_REFUND_FAILED：说明服务异常且退款失败，建议用户联系客服。

注意事项

1. 必须先通过「付费前置检查」确认 weixinpay 插件已安装，否则不要进入支付流程。
2. 收到 402 时，支付由 weixinpay 插件完成，Skill 无需关心支付细节。
3. 支付成功后必须主动发起重试请求，body 保持不变，通过 Header X-Out-Trade-No 传递订单号。
4. 未支付前绝对不要生成或泄露任何付费内容——付费放行以商户后端 200/SUCCESS 为准。
5. 如返回 NOT_PAID / REFUNDED / FULFILL_AND_REFUND_FAILED，按第四步处理。

部署前置（缺一不可）

• 完成 SkillHub 商户认证并绑定微信商户号；
• 在 SkillHub 商户中心「开发者密钥」页生成 RSA 2048 密钥对，拿到 pub_key_id 与 private_key_pem（私钥仅服务端保存，切勿进前端或公开仓库）；
• 部署 scripts/pay_service.py 所代表的后端，持有微信支付 API v3 证书（mchid/appid/serial/私钥/apiv3_key）；
• 单次价格由后端创建微信支付订单时设定（环境变量 PRICE_FEN，默认 10 分=¥0.10），不在本文件写死；平台按微信支付渠道实时结算至你绑定的商户账户。
• 后端订单使用 SQLite 持久化（ORDER_DB_PATH，每技能独立 db 文件），服务重启不丢单。