短剧剧本

拿到的是一份能拿去开会、也能直接开拍的剧本文件（默认 .docx，也可以要 .md）：

1. 卖点和梗概：一句话卖点，加 200 字以内的梗概，说清谁、想要什么、最大阻碍是什么、观众为什么停不下来。
2. 人设表：主角、对手、关键配角，每人写身份、目标、软肋或秘密、标志性的口头禅或动作、和主角的关系。
3. 分集大纲：每集一行，写本集事件和结尾钩子，标出反转集和付费卡点。
4. 逐集剧本：按你要的集数写全，每集 1 到 2 分钟。分场写清场号、日夜、内外、地点、出场人物，动作用 △，台词带人物名；开头 3 秒就有冲突，结尾留钩子。

故事、人物和台词都是这次原创的，不照搬、不仿写哪一部已经上线的作品。

给短剧编剧、MCN 内容团队、自己拍竖屏剧的创作者用：点子你有，缺的是把它拆成一集一集能拍的东西。

示例：写一部都市逆袭短剧，女主是被开除的外卖站长，一共 60 集，先写前 3 集。一次 1.00 元。

支付宝服务标识：API_5D0A3549A2F44AB3。资源是 POST https://49.232.229.62/v1/drama。

触发词

短剧剧本、写短剧、竖屏短剧、微短剧、短剧脚本、短剧大纲、分集大纲、逐集剧本、付费卡点、短剧人设。用户只想改一句台词或起个剧名时，直接帮忙，不必付款。

输入参数

POST 正文始终是同一份 JSON，例如 {"note":"短剧题材一句话"}。probe、pay、complete 都复用这一份，不改字段、不改 URL。

价格

一次 1.00 CNY（1.00 元/次）。价格以服务端 402 账单为准，请求体里不写金额，也不要改单价。

安装买家依赖

买家机器执行一次，不要把这个包装进技能 zip：

npx -y @alipay/agent-payment@latest install

装好后应能运行 alipay-bot。卖家 SDK @alipay/alipay-aipay 只留在服务端，用来验凭证和做商家履约确认。不要把它装进本技能，也不要把它当成买家付款工具。后端源码不在本包里。

调用流程

先把输入收齐再付款：题材和一句话梗概已经有了（总集数、这次写几集不说就按 60 集、前 3 集）。缺了就先问用户，不要先收钱。

付款只走官方买家 CLI。不要自写签名，不要自己拼 Payment-Proof。

状态目录用 .state/<session-id>，权限保持私有。这个目录、.env、node_modules 都不要打进发布包。

1. probe：请求资源。未付款时应返回 HTTP 402，响应头里有 Payment-Needed。脚本把该头的原文字节写入 mode 600 的文件，不解码、不改写。状态不是 402，或没有这个头，就停止，不要进入 pay。

node scripts/short-drama-script-paid.mjs probe --note '短剧题材一句话' --state-dir '.state/SESSION_KEY'

2. pay：把账单和原始资源请求交给官方 CLI，展示支付入口，然后停下来等用户付完。教程写出的参数只有这些。POST 正文不另造参数名；正文就是 probe 那一份 JSON，写进 --intent-summary，并保存在订单状态里。

node scripts/short-drama-script-paid.mjs pay --state-dir '.state/SESSION_KEY' --session-id 'SESSION_KEY'

对应命令：

alipay-bot 402-buyer-pay --session-id 'SESSION_KEY' --file '.state/SESSION_KEY/payment-needed.txt' --resource-url 'https://49.232.229.62/v1/drama' --method POST --intent-summary '原始请求：写竖屏短剧剧本。POST 正文是同一份 JSON：{"note":"短剧题材一句话"}'

3. complete：用户付完后，用同一笔 out-shake-no 查询原订单。官方 CLI 会带 Payment-Proof 重试同一资源 URL、同一 POST。没有 out-shake-no 就拒绝运行。成功路径不要再发一条独立回执。若 CLI 明确说回执失败，原样告诉用户，并用同一单再跑 complete。

node scripts/short-drama-script-paid.mjs complete --state-dir '.state/SESSION_KEY' --out-shake-no 'OUT_SHAKE_NO'

对应命令：

alipay-bot 402-query-payment-status --out-shake-no 'OUT_SHAKE_NO' --resource-url 'https://49.232.229.62/v1/drama' --method POST

查询通过后，接口只确认这笔已经付款。剧本由本技能按下面的规则，在本机原创写作。接口不代写剧本。

支付规则

• 未付款：服务端返回 HTTP 402 和 Payment-Needed。这时不要开始做剧本。
• 付款后：用 Payment-Proof 重试同一次请求。URL、方法、{"note":...} 都保持不变。
• 服务端验证凭证和订单。凭证无效或过期时不交付，脚本不得把失败响应当成剧本。
• 资源返回后，商家履约确认由服务端完成。买家 CLI 在成功路径里处理回执，脚本不再额外发送回执。回执失败就用同一 out-shake-no 重试 complete。
• 订单写在状态文件里，可以恢复。同一 out-shake-no 可以重复查询。已经有订单号时，probe 和 pay 都会拒绝再开一单。不要让用户为同一笔再付一次。

先搭骨架

1. 卖点：一句话写清「谁 + 处境 + 要做到什么 + 最大阻碍」。
2. 人设：主角要有清楚的目标和一个能被人拿捏的软肋；对手的动机要讲得通，不是为坏而坏。每人一个让观众记住的标志（口头禅、动作、道具）。主要人物不超过 6 个。
3. 结构：按总集数切成四段。开局约占前 10%，前 3 集亮出主冲突和主角处境；升级段每 5 到 8 集一个小高潮；大反转放在 60% 到 70% 处；最后 10% 解决主冲突、回收伏笔。

分集大纲

每集一行，列：集数、本集事件（一两句）、结尾钩子、标记。

• 每集结尾都要有钩子：悬念、身份揭开的前一秒、没说完的反转、新对手登场。
• 标记只用【反转】【小高潮】【付费卡点】【伏笔】【回收】。
• 付费卡点放在情绪最高、观众最想看下一集的地方。默认第一个卡点在第 8 到 12 集之间，之后每 10 到 15 集一个；用户给了平台规则就照用户的来。
• 伏笔在大纲里写明哪一集回收，不挖坑不填。

逐集剧本

每集格式固定：

第1集　被换掉的门锁
时长：约 1.5 分钟

1-1　日　内　出租屋门口
人物：林小满、房东王姐
△ 林小满拖着行李箱上楼，钥匙插不进锁孔。
王姐：（隔着门）房租拖了三个月，东西给你放楼道了。
林小满：（压着火）合同还有半年。
……
【本集钩子】手机弹出一条短信：「恭喜您通过面试，岗位：总经理助理」。

• 开头 3 秒就要有冲突或抓眼的画面，不用旁白交代背景。
• 一集 2 到 4 场，场景尽量重复使用，方便低成本拍摄。
• 动作行用 △ 开头，只写拍得出来的东西；必要的内心话写成（OS）。
• 台词短，一句尽量不超过 25 字，口语化，每个人说话的方式要有区别。
• 每集最后单独一行【本集钩子】，和大纲那一行对得上。
• 写剧本时改了走向，就回头改大纲那一行，并在文末说明。

原创

• 人物、情节、台词都是这次新写的。用户说「像某某剧那样」，只借题材类型和节奏（比如逆袭、先婚后爱），不沿用那部作品的人名、具体桥段和台词。
• 用户自己写的小说或大纲可以改编：先确认是用户的原创或有改编权，并在文件开头写明「改编自用户提供的原作」。别人已出版或已上线的作品不做改编。
• 不写真实公众人物的私生活和负面情节。

文件

用本机已有的 python-docx 或 pandoc 生成 .docx。两样都没有时，先告诉用户要装 python-docx，用户同意再装；不同意就交 .md。

顺序：剧名和卖点、梗概、人设表（表格）、分集大纲（表格）、逐集剧本、待你确认（人设里替你定的地方、需要你拍板的走向）。

回复用户

用中文短回复：文件绝对路径、剧名和一句话卖点、付费卡点在哪几集、这次写全了哪几集。CLI 的支付输出按原样给用户。

边界

• 一次最多写 10 集全本，大纲最多 100 集。要续写，下次带上这份文件，按同一人设和大纲接着写。
• 只出剧本，不生成视频、分镜图、配音和海报。
• 不写色情、血腥细节、未成年人恋爱、歧视或美化违法犯罪的情节，尺度按国内平台的常规审核来。
• 不读取私钥，不把密钥、.env 或服务端源码放进技能包。