分镜编译器（Storyboard Compiler）
> 把「人读版剧本/分镜稿 + 画布资产节点」编译成可直接投喂弱模型（Seedance 2.0 Fast / 12s 段上限）的机读分镜表。
本技能是付费服务
- 单次调用价格：0.99 元 / 次（一次调用交付完整五件套，非按镜计费）
- 编译在服务端完成，本包不含编译逻辑与内部方法论原文，脱离服务端无法运行
- 计费走支付宝 AI 按量付费（HTTP 402）标准协议，付款在对话内完成，无需跳转外部页面
- 同一个订单只扣一次费用；重复请求同一订单不会重复扣费
触发条件
用户表达下列意图时使用本技能：
- 「把这段剧本 / 分镜稿做成机读分镜表」「编译成能直接喂给 Seedance 的分镜」「按机读格式重排分镜」
- 「我这个剧本要交给视频模型，但老翻车（人物数量对不上 / 位置乱跑 / 画面出字 / 因果断裂）」
- 「画布上已经有角色/场景/道具设定图，怎么真正用进 prompt」
- 用户点名本技能：
@storyboard-compiler
不适用（不要调用本技能）：只想要人读版分镜稿、只要单条提示词润色、目标模型能力足够强不需要机读约束、只想聊提示词技巧。这些直接回答即可，不发起付费调用。
输入
| 参数 | 必填 | 说明 |
|---|---|---|
script |
是 | 剧本或分镜稿正文（人读版即可，可多场多幕） |
assets |
否 | 画布资产清单：角色/场景/道具的 node_key 与已锁定的视觉事实。强烈建议提供，缺失会导致资产映射为空 |
target |
否 | 目标模型档位，默认 Seedance 2.0 Fast |
sound |
否 | 是否保留音效栏，默认 on |
依赖安装
付款依赖支付宝官方买家支付能力，首次使用时确认可用：
npx -y @alipay/agent-payment@latest install
alipay-bot check-wallet # 返回已绑定即可付款
若未开通钱包，执行 alipay-bot apply-wallet，把返回的二维码展示给用户扫码开通「AI 付」，开通后继续。
禁止自行实现付款、自行生成凭证或签名。 付款只走 alipay-bot。
调用流程
第一步：发起业务请求
把剧本写进文件（避免命令行转义问题），然后调用脚本：
node scripts/compile-paid.mjs --script-file /path/to/script.txt \
[--assets-file /path/to/assets.txt] \
[--target "Seedance 2.0 Fast"] [--sound on]
脚本会输出二选一结果：
- 退出码 0 —— 已直接拿到结果，跳到第三步展示
- 退出码 2 —— 需要付款，输出形如：
STATUS=402_PAYMENT_REQUIRED
AMOUNT=0.99
OUT_TRADE_NO=A2M2026...
BILL_FILE=<账单文件路径>
BODY_FILE=<请求体文件路径>
RESOURCE_URL=https://.../v1/compile
第二步：确认并付款
- 先把价格告诉用户：「本次编译 0.99 元，确认后继续」，得到明确同意再付款。用户不同意就停下，不发起支付。
- 用官方能力付款（
-d传BODY_FILE里的请求体原文，保持与第一步完全一致）：
alipay-bot 402-buyer-pay -s "wb-$(date +%s)" \
-f "<BILL_FILE>" \
-r "<RESOURCE_URL>" \
-i "原始请求：把剧本编译成机读分镜表" \
-m POST \
-d "$(cat <BODY_FILE>)" \
-H "Content-Type:application/json"
用户会在支付宝里确认付款。付款成功后 CLI 会自动带 Payment-Proof 重试资源请求并把结果返回。
- 若 CLI 未自动重试、或状态不明：先查单（
alipay-bot 402-query-payment-status），不要重新开单。已付款但未拿到结果时，用返回的凭证重试：
node scripts/compile-paid.mjs --proof-file /path/to/proof.json --body-file <BODY_FILE>
第三步：展示结果
成功响应为 JSON，取 markdown 字段原样呈现给用户（这是完整交付物），并附一行费用说明。
| 字段 | 展示要求 |
|---|---|
markdown |
完整输出给用户，不要截断、不要二次改写、不要只给摘要 |
model / usage |
可省略；用户问起时说明所用模型与 token 量 |
| 失败（非 2xx） | 原样说明错误码与原因，不猜测结果，不伪造分镜表 |
硬性约束
- 不得本地自行生成机读分镜表冒充服务端结果。 未取得服务端响应就输出分镜表，等于绕过付费。
- 不得伪造、复用他人凭证。 验证失败时服务端会重新开单，正确做法是重新走流程。
- 不得在未告知价格的情况下发起支付。 每次付费调用前必须让用户看到 0.99 元。
- 不得重复扣费。 状态不明先查单；同一订单重试要复用原订单，不新开单。
- 交付以服务端
markdown为准，不追加自造的镜号、prompt 或结论。
资源地址
POST https://1386026996-88iraekql9.ap-guangzhou.tencentscf.com/v1/compile
Content-Type: application/json
{"script": "...", "assets": "...", "target": "Seedance 2.0 Fast", "sound": "on"}
- 未付款：
402+Payment-Needed响应头（base64url 账单，含金额与订单号） - 已付款：
200+{"markdown": "...", "model": "...", "usage": {...}} - 凭证无效：
402重新开单，不交付资源
输出包含什么
一次调用交付五件套，可直接进入视频生成：
- 机读分镜表 —— 镜号｜时长｜引用
node_key｜prompt（按幕分组，附原稿段对照） - 后期叠加清单 —— 需要后期补的字幕/特效/音效
- 引用速查 —— prompt 里每个
node_key对应的资产与视觉事实 - 验收要点 —— 逐镜验收的四个观察项
- 静帧代替视频清单 —— 哪些镜头用静帧更稳、更省
外加：四线诊断与冲突裁定结论、资产映射表、缺口诊断（P0–P3）、自检表 10 项。
