三剪客 · 短剧剧组
## ⚠️ 先申请你自己的 API Key
本 Skill 不内嵌任何密钥,也不代付费用。 请到
算力集市 api.a7w.cn 注册并创建你自己的 API Key
(新用户有赠送点数,可以先免费试跑几条)。
拿到后填进环境变量A7W_API_KEY,或直接传给--key参数。
请勿使用他人提供的 Key —— 用量与费用都记在 Key 所属账号上。
这个包是干什么的(L1 / L2 / L3 的分界)
| 层 | 形态 | 例子 |
|---|---|---|
| L1 单点生成型 | 一个输入 → 一个产出 | 「给我一个标题」 |
| L2 智能体型 | 单循环:抽档 → 写 → 自检 → 迭代(一个声音自我迭代) | 长了再改、改完再自检 |
| L3 多智能体协作型 | 多角色分工互审,一条命令出成品 | 本包 |
L3 的关键不是「调多次模型」,而是:每个角色有自己独立的目标与立场,且会互相否掉对方。
所以本包的核心不是"一次写完",而是「剧本要过会」:
编剧写 → 导演说"这场写不了" → 打回编剧
→ 美术说"这场拍不出来" → 要求改
→ 场记说"第 2 集第 4 场和第 1 集第 3 场对不上" → 行使否决
→ 编剧按意见返修 → 再会审 → 全部通过才收工
本包不出图、不出片。 产物是剧本 + 分镜包:
剧本(场景 / 台词 / 情绪) + 分镜表(景别 / 机位 / 时长 / 转场)
+ 美术设定卡(文本,供出图用) + 矛盾清单(每条引用剧本原文) + 全过程记录
出图交给既有包(sanjianke-storyboard-art 按设定卡出图),出片交给既有短剧包。
视频生成是它们的活,本包只把剧本与分镜做到能过会。
四个角色与职权
| 角色 | 代号 | 目标 | 产出物 | 否决权 |
|---|---|---|---|---|
| 编剧 | writer | 故事好不好看、钩子够不够 | 分集大纲 + 剧本(场景/台词/情绪) | 无 |
| 导演 | director | 节奏与可视化:这场戏能不能拍出来 | 分镜表(景别/机位/时长/转场) | 能打回编剧(「这场写不了」) |
| 美术 | art | 场景/服化道是否可产出、一致性 | 场景与角色视觉设定卡(文本,供出图用) | 能说「这场拍不出来」并要求改 |
| 场记 | scripty | 前后一致:人物/时间线/道具/服装 | 矛盾清单(必须引用原文) | 能否决(连续性错误必须修) |
python3 scripts/run.py crew 会把这张表和每个角色的"不做清单"完整打出来,零成本。
关键机制(这四条是 L3 与"假协作"的分界)
一、信息不对称(机制核心,不是 bug)
四个角色的立场差异来自输入差异,不是来自"请你严格一点"这种话术:
| 角色 | 看得到 | 看不到 |
|---|---|---|
| 编剧 | 题材、集数、受众、额外要求、上一轮被打回的意见 | 导演的镜头偏好;美术的产能约束;场记的历史台账 |
| 导演 | 剧本全文 + 自己上一轮的打回记录 | 题材的创意意图;美术的产能结论;场记的矛盾台账 |
| 美术 | 场次清单 + 出场人物(只有这些) | 剧本全文与台词;故事评价的邀请(提示词里明确禁止) |
| 场记 | 剧本全文 + 分镜表 | 创作过程与修改痕迹;改戏建议的授权 |
run 每一轮都会把各角色的输入摘要打到 stderr(--show-inputs,默认开),
用来证明不对称真实存在,而不是只在文档里声明。实测原文(片段):
---- 第 1 轮:各角色看到的信息 ----
[编剧] 看到:题材 / 集数 / 目标受众 / 额外要求
看不到:导演的镜头偏好;美术的产能约束;场记的历史台账
[导演] 看到:剧本全文(2610 字,sha d889afef)
看不到:题材的创意意图与原始需求;美术的产能结论;场记的矛盾台账
[美术] 看到:场次清单 6 场 + 出场人物 5 人(**只有这些**)
看不到:剧本全文;台词;**故事评价的邀请**
[场记] 看到:剧本全文(sha d889afef)
看不到:创作过程与修改痕迹;改戏建议的授权
二、真实打回
- 导演
verdict=reject必须同时给reasons(可读理由)和unshootable(哪一场写不了)。
只给结论不给理由 → 闸门七拦。
- 美术
verdict=not_producible必须给reasons和scenes(哪一场拍不出来)。
判断依据只能是可产出性(要大规模实景/群演/特效、同场景空间自相矛盾、角色特征说不清)。
- 场记的中高等级矛盾 = 否决。每条矛盾必须引用剧本原文,引文本地逐字校验。
还会拦"空转评审":一份 reject 的意见里若既没有具体问题词、又没指到具体场次,
判为"说了话但等于没说话"。
三、闸门命中回流(不是只在最后拦一下)
本地闸门一旦命中,会按角色派回下一轮的返修指令:
| 命中类型 | 派给谁 |
|---|---|
| 剧本/大纲里的合规、占位符、照抄示例 | 编剧 |
| 分镜结构缺项、分镜里的合规 | 导演(带出的合规同时告诉编剧) |
| 设定卡缺角色、性别/年龄冲突 | 美术 |
| 矛盾清单的引文锚点问题 | 场记(同时让编剧给出可被逐字引用的台词) |
少了这一步就会出现"角色全过、报告一路红"的半成品状态——那不是协作,是空转。
四、终止与出口:不许假装谈拢
| 情形 | 行为 |
|---|---|
| 四个角色同一轮全部通过,且该轮闸门无命中 | exit=0,收工 |
| 轮次用完仍有裁决未决项 | exit=6,显式列未决项(谁否了什么、为什么) |
| 轮次用完但闸门仍有命中 | exit=6,同样算未收敛,不写成"已通过" |
| 编剧返修后正文一字未变(内容指纹相同) | 报"空转",不算收敛 |
报告里那节标题就叫「是不是真的在互相否」——没人互否时它会直接写:
没有。本次运行里没有任何一处打回或否决——如果没有出现真实的互否,
那就是假协作,本包不把它算成 L3 成功。
八道硬闸门
命中即标红 + stderr 汇总 + 退出码非 0,可以直接进 CI。
| # | 闸门 | 判定 | 退出码 |
|---|---|---|---|
| 1 | 合规 | 广告法违禁词 + 短剧常见风险(血腥/软色情/赌博/迷信的表述边界);「最X」按可枚举语境豁免、句首不豁免 | 3 |
| 2 | 占位符残留 | {}、[待填]、XXX、此处省略、TODO | 3 |
| 3 | prompt_echo | 去标点相等 / Jaccard ≥ 0.75 / 覆盖度 ≥ 0.60;含相对长度守卫与 contain 适用窗口 | 3 |
| 4 | 矛盾清单锚点 | 每条矛盾必须引用剧本原文;本地逐字校验,编造引文剔出并拦 | 3 |
| 5 | 分镜结构 | 每镜必须有景别 + 画面描述 + 时长(另查机位/转场/场次锚点);镜数为 0 → 拦 | 3 |
| 6 | 角色一致性 | 剧本里每个有名字的角色在设定卡里必须有卡;性别/年龄硬项两边一致 | 3 |
| 7 | 裁决完整性 | 打回/否决必须留可读理由;空转评审拦;有否决却拿不出中高等级矛盾也拦 | 3 |
| 8 | 成本上限 + 产出位置 | --outdir 指到包内 → 2;没报价就开跑 → 2;超预算 → 5 | 2 / 5 |
第 4 道闸门为什么是本包最值钱的那道
场记的任务是报"前后矛盾"。矛盾清单读起来永远很像真的——所以造假成本极低:
模型完全可能编一句"第 2 场说伞是黑色的,第 5 场变成红色",而剧本里根本没写过伞。
这道闸门不采信模型自报的结构字段,而是拿 quote 去剧本归一化全文里逐字找:
引文「他手里那把黑色的折叠伞后来变成了红伞」在剧本原文里找不到
(去标点后逐字比对不上)——判为**编造引文**,剔出
被剔出的条目不是悄悄删掉,而是登记进 dropped 并报错拦下:
"剔出"本身就是要报的错,否则"编造引文"这个行为被奖励了(顺便报一条真的就能过关)。
短剧的「表述边界」是怎么划的
短剧是剧情向内容,"冲突"是它的燃料——不能把"打/杀/死"一律拦下(那样任何一部剧都过不了)。
所以短剧风险表只拦表述边界,不拦剧情设定:
| 类型 | 拦什么 | 放过什么 |
|---|---|---|
| 血腥 | 开膛剖腹、碎尸、血浆四溅(细节化展示) | 剧情里的死亡与冲突 |
| 软色情 | 床戏描写、裸露;「胸前」等部位词与暴露类词同现时 | 正常感情戏;"雨水顺着胸前流进衣领" |
| 赌博 | 具体玩法与下注动作(百家乐、押注、一把梭) | 剧情里的赌局设定本身 |
| 迷信 | 「照着做能改命」这类可操作方案 | 剧情里的封建设定本身 |
同类收紧也用在广告法上:裸的「唯一」「震惊」「喘息」在剧情对白里是常用词,
一律拦会把整篇剧本判红。所以只在商业宣称后缀(唯一正品 / 全网独家)或
标题党固定搭配(震惊体)时命中。闸门的假命中比漏判更有害——
一个正确写法的稿子被判违规,使用者就会开始无视闸门。
九个子命令
| 子命令 | 做什么 | 花钱吗 |
|---|---|---|
crew | 列出四个角色、职权、表决规则、退出码表 | 零成本(一次调用都不发) |
outline | 编剧出分集大纲(钩子 / 卡点 / 集尾悬念) | 只花文本钱 |
script | 编剧出剧本(场景 / 台词 / 情绪) | 只花文本钱 |
board | 导演出分镜表 —— 可以打回编剧 | 只花文本钱 |
art | 美术出场景与角色设定卡(文本)—— 可否决 | 只花文本钱 |
continuity | 场记出矛盾清单(每条必须引用原文) | 只花文本钱 |
run | 一条命令跑完剧组协作(多轮,含打回重写与未决项) | 文本钱 × 轮次 |
log | 读全过程记录(每轮产出、打回、否决、未决项、token) | 免费 |
cost | 只算钱,一次调用都不发 | 免费 |
models | 现查 api.a7w.cn 在架模型 | 免费 |
30 秒上手
# 1) 拿 Key(新用户有赠送点数)→ https://api.a7w.cn/ 注册,创建 API Key
# 2) 配 Key
export A7W_API_KEY="<你的Key>" # Windows: $env:A7W_API_KEY="<你的Key>"
# 3) 先看剧组配置(零成本)
python3 scripts/run.py crew
# 4) 先算钱(本地计算,一次调用都不发;**只出 token,不报金额**)
python3 scripts/run.py cost --episodes 2 --max-rounds 2
# 5) 一条命令跑完剧组协作
python3 scripts/run.py run \
--topic "外卖骑手暴雨夜被逼停,车主递来一份遗嘱说他是财阀私生子" \
--episodes 2 --max-rounds 2 --outdir D:/drama-crew/ep01 --yes
# 6) 看全过程记录(谁在第几轮否了谁、理由是什么)
python3 scripts/run.py log --outdir D:/drama-crew/ep01
# 想先看看不花钱:加 --dry-run 只打印将发送的提示词与各角色输入摘要
python3 scripts/run.py outline --topic "..." --dry-run
零成本验证闸门(--from-file)
闸门的行为必须能零成本复现,否则没人有动力去测它。所以 outline / script /board / art / continuity 五个子命令都支持 --from-file <json>:
不调模型,直接拿一份 JSON 过闸门。
# 拿一份手写的分镜表过闸门(0 次调用、0 token)
python3 scripts/run.py board --outdir D:/drama-crew/ep01 --from-file my-board.json
# 每条闸门都会给出非 0 退出码,可直接进 CI:
# 3 = 闸门命中(合规/占位符/照抄示例/锚点/结构/一致性/裁决)
# 2 = 参数与环境(--outdir 在包内、没报价就开跑)
run.py里另有一个只认环境变量的测试桩(DCP_MODEL_STUB=<目录>):
设了它就会去该目录读<角色>.<阶段>.json当作模型返回,用来离线复现整条
互审流程与"未决项"分支。它不设就永不生效,不是一个可以绕开真实调用的产品开关
——一个能绕过真实调用的产品开关,会让人拿假产出当真产出。
零依赖:只要 Python 3.7+,不用 pip install 任何东西。scripts/a7w.py 是所有 Skill 包共用的零依赖客户端(我们靠 SHA256 校验各包副本一致),
本包逐字节没有改它;本包的业务逻辑全在 scripts/run.py 里。
产出目录长这样
D:/drama-crew/ep01/
├── outline.md / outline.json 分集大纲(编剧)
├── script.md / script.json 剧本(编剧)—— 闸门读的就是它
├── board.md / board.json 分镜表 + **导演裁决**(含打回理由与写不了的场次)
├── art.md / art.json 美术设定卡 + **美术裁决**(含拍不出来的场次)
├── continuity.md / continuity.json 矛盾清单 + **场记裁决** + 被剔出的编造引文
├── crew-log.md **全过程记录**(逐轮:输入摘要 / 裁决 / 理由 / 引文)
├── run-report.md / run-report.json 剧组报告(含「是不是真的在互相否」一节)
└── crew-state.json 断点文件(重跑不重复扣费)
产出一律落在包外的 --outdir 里;--outdir 指到包内直接 exit=2
(包内只允许 .md .py .txt .json .sh .js .yaml .yml .csv)。
断点续跑:key 含全部影响产出的维度
role 角色 writer / director / art / scripty
stage 阶段 outline / script / board / cards / continuity
topic_sha 上游全文摘要 **剧本/大纲全文的 sha**(改了上游就必须重出)
round 轮次 第几轮返修(同一输入在不同轮次产出不同)
prompt_ver 提示词版本 改了提示词必须失效
model 模型
temperature 温度
verdict_sha 上一轮裁决摘要 打回理由变了,返修方向就变了
命中缓存时会打印命中的 key 与八维摘要,免得出现"改了东西却静默复用旧产出"。
# 同一份输入重跑 → 全部命中,0 次调用、0 token
python3 scripts/run.py run --topic "..." --outdir D:/drama-crew/ep01 --yes
# 改了题材 / 轮次 / 提示词版本 / 模型 / 温度 / 上一轮裁决 → 对应那一步重出
# 想强制重跑某一步:加 --force(**会重复花钱**)
计费:只出 token,不编价
文本网关的单价平台不公开(/api/v1/pricing 不覆盖 chat/completions),
所以本包:
- 每次都把
usage原文打出来(prompt_tokens/completion_tokens/total_tokens) cost报的是调用次数与实测 token 区间(单次调用实测 1.5k ~ 6k token),
不给 --points-per-ktok 就不报金额
- 给了
--points-per-ktok才按你给的口径折算点数,并在输出里标明那是外部口径
一次性成本口径:每轮 5 次调用(编剧 2 次:大纲 + 剧本;导演 / 美术 / 场记各 1 次)。
--budget 的语义要说清:给了 --points-per-ktok 就按点数守;
没给口径时不编换算率,把 --budget 当作调用次数上限守。
两种情况都是每次调用后立刻查(不是跑完一轮才查)——预算闸门的意义是止损。
两条实测确认的接口事实
POST /api/v1/chat/completions的成功响应不带code。
所以本包只判 choices 在不在,不判 code。code == 1 那套信封是生成应用的,不适用于文本端点。
- 异步任务的状态在任务
data顶层(data.status),不在data.result.status——
平台文档写错了。本包不用生成应用,但 a7w.py 里按实测取值。
另外:平台的 pricing_matrix / tenant_* 字段半数与结算价不一致,
所以本包不拿它们算钱;结算只认 usage.total_tokens。
文档
| 文件 | 内容 |
|---|---|
SKILL.md | 本文件:定位、角色与职权、四条关键机制、八道闸门、子命令、排错 |
references/剧组角色与职权.md | 四个角色的目标/产出/否决权、立场边界、表决与终止规则、信息不对称的输入矩阵 |
references/剧本与分镜规则.md | 剧本与分镜表的结构要求、景别/机位/转场枚举、矛盾清单的引文锚点规则、角色一致性硬项 |
references/成本与排错.md | 调用次数与 token 口径、断点 key 八维、退出码表、常见报错与处置 |
权限与边界
| 能力 | 是否申请 | 用途 |
|---|---|---|
| 网络访问 | 申请 | 调用 api.a7w.cn 的文本端点(本 Skill 唯一的联网行为) |
| 读取文件 | 仅读取你 --from-file / --outdir 指定的文件 | 子命令之间传递产出、闸门复检 |
| 写入文件 | 仅在 --outdir / --out 时 | 保存剧本、分镜表、设定卡、矛盾清单、记录 |
| 凭证 | 读取你自己提供的 API Key | 从环境变量 A7W_API_KEY 或 ~/.a7w/config.json 读取 |
| 子进程 / 后台常驻 | 不申请 | 脚本执行完即退出 |
不内嵌任何密钥。 请求只发往 api.a7w.cn,不发送到其他任何地址。
- 不提供 Key、不代付费用:Key 必须你自己在 api.a7w.cn 申请
- 本包不出图、不出片:视频生成与出图是既有包的活,本包只做剧本与分镜
- 不替代内容合规的最终审查:本地闸门是粗筛,最终判断要人工复核
- 本地闸门不等于任何平台的官方审核标准:官方标准不公开且会变
常见坑
| 坑 | 表现 | 怎么避 |
|---|---|---|
| 没确认报价就开跑 | exit=2,一分钱不花 | 加 --yes,或 --budget 封顶 |
--outdir 指到包内 | exit=2 拒绝执行 | 用包外目录,例如 %TEMP%\drama-crew |
以为 --out 是 --outdir 的缩写 | 拼错就报 unrecognized arguments | 本包关掉了前缀缩写(allow_abbrev=False),不会静默写错地方 |
| 故事写得太"内部" | 导演打回"整场只有内心独白,无法切分镜头" | 这是正常行为:让编剧返修,或加 --max-rounds |
| 场记报了一堆矛盾但引文编造 | exit=3,剔出条数与理由都打出来 | 让场记重跑(引文必须能逐字找到) |
| 两个角色点了头就以为收工 | 报告里"闸门命中"仍非空 → exit=6 | 闸门命中算未决项,加轮次返修 |
| 跑满轮次还谈不拢 | exit=6 + 未决项清单 | 这是设计:不许假装谈拢;改题材或不一致的场次 |
关于这个 Skill
作者亲测实操后发布,下载后可直接使用,自用商用都可以。
所有 AI 能力都走 算力集市 api.a7w.cn —— 一把 API Key 打通
大模型、语音、图像、视频、数字人等全部算力,注册即送点数,按量计费、没有月费。
| 你可能想问 | 答案 |
|---|---|
| 要不要额外部署 | 不用。下载本包即可使用,不必去别处找源码 |
| 怎么开始 | 到 api.a7w.cn 注册领 Key → 填进 A7W_API_KEY → run.py crew 先看配置 |
| 能不能商用 | 可以 |
| 遇到问题找谁 | 见文末「联系我们」,作者本人答疑 |
使用中碰到任何问题 —— 报错、剧本质感不理想、想省钱、想批量 —— 都欢迎联系我们。
加好友时说一下是从哪个 Skill 找过来的,直接给你配套的示例。
联系我们
- 技术微信:9872659 —— 加好友时说一下是从哪个 Skill 找过来的,直接给你配套的 API Key 与能跑的示例。
- 要算力 / 要 API Key:算力集市 · 注册领 API Key —— 一个 Key 调用全部 AI 算力,注册、充值、创建 Key 都在这里。
- 更多 AI 插件与接口:AI 插件市场。