Skip to content
Back to search

vidu-skill

SkillWorks with Claude CodeGitHub

从剧本到成片一条龙,三个入口。①剧本创作:手上没本子,按「无限轮回宇宙」写——世界篇→全剧大纲→逐集剧本→Word,17+12 道质量门脚本硬校验;②漫剧创作:手上有本子,直接盘资产、出角色设定板(固定版式)、出分镜组表、站位预演+六项审核、写提示词、Vidu 出片;③符创作:把运镜、动作这类本事压成一张 16:9 能力卡。另有商业线(卖货 / 门店 / 企业宣传)走同一套干法。单组时长按渠道(Vidu 16 / H3·即梦2.0 15 / 即梦2.5 固定 30 / Wan3 4–30)、镜数按节奏、单镜不低于 1.2 秒;分镜表只写「这一组用谁」,pn 由脚本绑定并四方对账;设定图整张直接当参考图,不截图不裁切;用户提供的剧本台词一字不改。符和立谱不做也能出片,用户不提就不主动推销。初始化缺 Token 时用宿主网页预览打开登录页、代码块发链接,发取 Token 步骤与参考图(默认已购会员,不推销)。当用户说「写剧本」「写短剧」「无限轮回」「世界篇」「做一集」「做漫剧」「做视频」「做短剧」「做带货片」「门店宣传」「盘资产」「人物设定板」「角色设定板」「分镜组表」「站位预演」「资产绑定」「绑定表」「出场资产」「做个符」「用我的符做」「立个谱」「统一画风」「Vidu」「vidu cli」「剪辑」「剪映」「剪映草稿」「字幕」「素材台账」「vidu-skill」时使用。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zeno-zhu--vidu-cli-skill/badge.svg)](/listings/zeno-zhu--vidu-cli-skill)

HTML

<a href="/listings/zeno-zhu--vidu-cli-skill"><img src="/api/listings/zeno-zhu--vidu-cli-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 1,049 lines
  1. ---
  2. name: vidu-skill
  3. display_name: 一句话做视频(Vidu 剧本到成片)
  4. display_name_en: Vidu Studio — Script to Final Cut
  5. description: 从剧本到成片一条龙,三个入口。①剧本创作:手上没本子,按「无限轮回宇宙」写——世界篇→全剧大纲→逐集剧本→Word,17+12 道质量门脚本硬校验;②漫剧创作:手上有本子,直接盘资产、出角色设定板(固定版式)、出分镜组表、站位预演+六项审核、写提示词、Vidu 出片;③符创作:把运镜、动作这类本事压成一张 16:9 能力卡。另有商业线(卖货 / 门店 / 企业宣传)走同一套干法。单组时长按渠道(Vidu 16 / H3·即梦2.0 15 / 即梦2.5 固定 30 / Wan3 4–30)、镜数按节奏、单镜不低于 1.2 秒;分镜表只写「这一组用谁」,pn 由脚本绑定并四方对账;设定图整张直接当参考图,不截图不裁切;用户提供的剧本台词一字不改。符和立谱不做也能出片,用户不提就不主动推销。初始化缺 Token 时用宿主网页预览打开登录页、代码块发链接,发取 Token 步骤与参考图(默认已购会员,不推销)。当用户说「写剧本」「写短剧」「无限轮回」「世界篇」「做一集」「做漫剧」「做视频」「做短剧」「做带货片」「门店宣传」「盘资产」「人物设定板」「角色设定板」「分镜组表」「站位预演」「资产绑定」「绑定表」「出场资产」「做个符」「用我的符做」「立个谱」「统一画风」「Vidu」「vidu cli」「剪辑」「剪映」「剪映草稿」「字幕」「素材台账」「vidu-skill」时使用。
  6. description_zh: 三个入口 + 剪辑收尾,打通剧本、漫剧与商业短片——没本子先按无限轮回宇宙写本子,有本子直接盘资产、出角色设定板、排分镜组、站位预演、六项审核、写提示词,最后提交 Vidu 出片;另有符创作与立谱两个旁支。全程脚本硬校验,用户台词一字不改。
  7. description_en: End-to-end Vidu video pipeline with three entry points — AI script writing for the infinite-reincarnation universe, storyboard-to-final-cut production, and reusable capability cards. Deterministic quality gates on every stage and strict fidelity to the user's dialogue.
  8. examples_zh:
  9. - 我没本子,帮我写一集都市轮回短剧,写完直接出片
  10. - 这是我写好的剧本,帮我做成漫剧,先盘资产出设定板
  11. - 把推拉摇移这套运镜做成一张符,我以后直接用
  12. examples_en:
  13. - Write a one-episode urban reincarnation short and produce the video
  14. - Here's my script — storyboard it and generate the shots
  15. - Turn camera-movement techniques into a reusable capability card
  16. version: 2.6.0
  17. author: 老朱
  18. license: 免费使用(禁止转售、禁止二次分发获利)
  19. ---
  20. # 一句话做视频
  21. > ★ **本包自包含**:流程、规范、工具、提示词都在本目录内。⛔ 不要引用本目录以外的任何路径。
  22. >
  23. > **固定标识 `vidu-skill`** —— 安装后的文件夹名、本文件 `name`、发布包名都是它,不随版本变。
  24. >
  25. > **`{skillDir}` = 本文件(`SKILL.md`)所在目录的绝对路径。** 下面所有命令都写成了 `"{skillDir}/scripts/…"` 这种绝对形式,**直接照抄就能跑,不必先 `cd`,也不受当前工作目录影响**。
  26. > ⛔ 别假设当前工作目录就是本包——装好之后,那是用户的项目目录。
  27. > 片子也不在本包里:`asset_init.py` 会自己在非 C 盘挑位置建项目。
  28. >
  29. > **路径口径统一**:正文里出现的 `references/…`、`scripts/…`、`script/…`、`assets/…`,**一律以 `{skillDir}` 为根**,不是相对当前文件。
  30. > **目录分工**:`references/` 是干活时查的规范(`references/prompts/` 是三条入口的提示词正文)、`scripts/` 是工具、`script/` 是 ① 剧本模块、`assets/` 是图片资源。
  31. 用户说一句话,你帮他做成一条片子。
  32. 他要是手上没本子,你先帮他把本子写出来。
  33. 他要是想把一套本事存下来,你帮他做成一张符。
  34. **默认把用户当小白。** 他不知道什么叫分镜、什么叫提示词、什么叫闲时额度。
  35. 一次只问一件事,问完再问下一个。别一次性丢五个问题给他。
  36. ---
  37. ## ★ 四条铁律(比流程优先,先记这四条)
  38. | # | 铁律 | 一句话 |
  39. |---|---|---|
  40. | **1** | ★★ **台词零容错** | **用户提供的剧本/脚本,台词一个字都不许改**:不改字、不加词、不删句、不改标点、不调顺序、不换归属。只能 **拆句 / 换行**。装不下就**拆组**,不许"顺一下"删台词;真要改(错别字/敏感词/砍句)**先问用户** |
  41. | **2** | **设定图整张就是参考图** | 不截图、不裁切、不再照板出单图;每条提示词写死「不得出现多视角拼贴、画中画、分格线、文字标注与色卡」 |
  42. | **3** | **视频闲时、生图积分** | 出视频一律 `nopeak`(0 积分);生图走 `normal`(6 积分/张),别蹭闲时额度 |
  43. | **4** | **生图一张一交** | 出完自查就发用户,不抽卡、不自己重跑第二版 |
  44. > 违反第 1 条 = **事故级**:观众听到的台词跟本子不一样,等于改了他的作品,后期补不回来。
  45. > 第 2–4 条违反 = 白烧钱、白返工。
  46. ---
  47. ## 这个包长什么样(先看这一张)
  48. **三个入口 + 一个收尾,一条主干。**
  49. ```
  50. ① 剧本创作(script/) 没本子,先写
  51. 世界篇 → 大纲 → 逐集剧本 → 剧本.docx + script.json
  52. │
  53. │ 交接:references/剧本到分镜的交接.md
  54. ▼
  55. ② 漫剧创作(主干) 有本子,直接做
  56. 读剧本 → 盘资产 → 出设定板 → 分镜组表 → 站位预演 → 六项审核 → 写提示词 → 提交出片
  57. ▲
  58. │ 造完回到「写提示词」那一步挂上去
  59. ③ 符创作(主线之外) 把一类本事压成一张 16:9 的图
  60. ④ 剪辑交付(收尾,可选) 成片 → 素材台账 → 剪映草稿 / 字幕
  61. ```
  62. - **主干只有一条**:做片子的顺序永远不变——先有图,再排镜头,**把人站好**,最后写词。
  63. - **① 插在主干最前面**:本来「读剧本」那一步,换成「写剧本」。
  64. - **② 就是主干本身**:手上有本子,从「读剧本」进。
  65. - **③ 挂在主干旁边**:离开主线造一张图,造完回来,在「写提示词」那一步当参考图挂上去。
  66. - **商业线是第二条主干**(没剧情那条,卖货 / 到店 / 企业),跟漫剧线走同一套干法。
  67. - **④ 挂在最后**:成片出来要剪映草稿 / 二次剪辑时才走;不剪就直接交付。
  68. **别把这三样 + 剪辑讲成并行流程。** 它们是同一个流程的位置。
  69. ---
  70. ## 零、开工前自检(你自己做,别让用户动手)
  71. **不要让用户点任何文件、敲任何命令。** 你自己查、自己装、自己配。
  72. **顺序固定,不许跳:① 查 Python → ② 跑 `init_env.py --check` 查 Token → ③ 认档位。**
  73. **返回 2(没 Token):由你用宿主的「网页预览 / 打开链接」能力把登录页展示给用户**,再请他登录、发取 Token 三步和参考图(见第 3 步)。脚本只会尽力拉起系统浏览器,别指望它一定弹得出来。Token 没配好,后面一步都不做。
  74. ### 第 1 步:查 Python
  75. ```bash
  76. python --version
  77. ```
  78. 不行就依次试 `py --version`、`python3 --version`。
  79. **一个都没有,你自己装。** winget、静默安装包、PATH 没刷新时的绝对路径、node 的装法,全在 `references/环境自检.md`——照着做,别让用户动手。
  80. > node ≥18 **只有走剧本线才要**,做片子不用;装完当前窗口可能还找不到,用绝对路径跑。
  81. 没有就 `winget install -e --id OpenJS.NodeJS.LTS`。装完和 Python 一样,当前窗口可能还找不到,用绝对路径跑。
  82. ### 第 2 步:跑自检
  83. ```bash
  84. python "{skillDir}/scripts/init_env.py" --check
  85. ```
  86. | 返回 | 意思 | 你该做什么 |
  87. |---|---|---|
  88. | `0` | 环境齐了 | **直接开工,别再问用户任何环境问题** |
  89. | `2` | 缺 Token | 你用宿主网页预览打开登录页 + 请他登录 + 发取 Token 三步 + 发参考图,别的一概不问 |
  90. ### 第 3 步:配 Token(只在返回 2 时做)
  91. **★ 返回 2 = 本机还没有 Token。登录页:**
  92. `https://www.vidu.cn/my-subscription?bonus-code=LAOZHU`
  93. (会自动跳到 `login?redirect=/subscription`,登录后回订阅页 —— 这里只当**登录入口**用。)
  94. **★ 固定操作路径:不管谁用、哪个账号、哪个宿主,缺 Token 就按下面这套走,不临场发挥。**
  95. > **默认他已经买过会员。一个字都不要提「购买 / 开通 / 升级 / 要不要开会员」,也不要问「有没有账号」「额度够不够」。**
  96. > 档位由第 4 步 `vidu.py check` 自己读,不用问他。
  97. **① 打开登录页,同时把链接用代码块再发一遍(两件都做,不能只做一件):**
  98. - 宿主有「网页预览 / 打开链接」能力(WorkBuddy 内置预览面板)→ 直接把页面打开给用户看,
  99. 登录后他可以继续在这个窗口里操作。
  100. - **无论页面有没有打开成功,都把下面这段原样发给他**,方便复制到自己的浏览器:
  101. ```text
  102. https://www.vidu.cn/my-subscription?bonus-code=LAOZHU
  103. ```
  104. - `init_env.py --check` 只会**尽力**拉起系统浏览器:https 默认关联失效、远程/无头桌面、
  105. 命令结束就回收子进程的沙箱宿主里,可能一个窗口都不弹。**它的 `[OK]` 只是启动请求成功,不等于用户看得见**;
  106. 用户说没看到就立刻把地址发给他,别坚持说已经打开了。
  107. **② 请他本人登录**:「页面打开了,用你的账号登录」。手机号 / 验证码由本人操作,
  108. AI 不代登录、不代取 Token、不碰账号凭证 —— 这一步不绑定任何具体账号,谁用都一样。
  109. **③ 一次性把「取 Token 三步」+参考图发给他:**
  110. > ① 登录后点**左下角头像** → 菜单里的「**<> Vidu Token**」
  111. > ② 复制那一串(`vda_` 开头)
  112. > ③ 贴回来给我;只贴给我,别发群里、别截图给别人
  113. **把参考图作为图片直接发出去**:`assets/vidu-token.png`
  114. —— 发**图片本身**,不是发路径字符串;**不要等他说「找不到」才发**。
  115. 图里红框圈的就是:左下角头像 → 菜单里的 `<> Vidu Token`。
  116. 脚本输出里会打印这张图的**绝对路径**,直接拿去发;支持附件就发文件,只支持 Markdown 就写
  117. `![Vidu Token 位置](assets/vidu-token.png)`。别用「左边第三个菜单」这种文字形容位置。
  118. ⚠ 只发链接、发不了图片的宿主:图片退化为上面那行 Markdown 或绝对路径,其余不变。
  119. ⚠ 脚本弹窗只是尽力而为,**别拿它当主路径**;想再试一次:`python "{skillDir}/scripts/init_env.py" --open-login`。
  120. ⚠ `--check` 拉起浏览器有 10 分钟去重;无人值守用 `--check --no-browser`。
  121. 拿到 Token 后:
  122. ```bash
  123. python "{skillDir}/scripts/init_env.py" --token <他给的那串>
  124. ```
  125. 跑完会打印额度和积分,让他看一眼,确认通了再往下。
  126. ⚠ 配好之后,登录页链接和这张图都别再提;正常出片过程中也不提。
  127. ### 第 4 步:认账号档位(决定一天能跑多少)
  128. ```bash
  129. python "{skillDir}/scripts/vidu.py" check
  130. ```
  131. 第一行就是「账号版本」,按它排片:
  132. | 档位 | 闲时额度 | 一集 6 组,一天能跑 |
  133. |---|---|---|
  134. | **专业版** | **20 条/天** | 3 集 |
  135. | **旗舰版** | **200 条/天** | 30 集左右 |
  136. **按档位排,别按「想要多少」排。** 专业版一天 20 条,一集 6 组,三集封顶;超了平台直接失败,白等。
  137. **积分一律不动,除非用户明确说要。** 走闲时是不花钱的,慢点没关系;扣积分就是扣他的钱,不能替他决定。
  138. **Token 存在 `~/.vidu-cli-skill/token.txt`**,不在 skill 目录里——skill 目录会被 `git pull` 覆盖,那边存不住。
  139. ---
  140. ## 一、先分清:走哪条路
  141. 用户开口第一句,通常能看出方向:
  142. | 他说的话 | 走哪条 | 读哪个文件 |
  143. |---|---|---|
  144. | 「写个剧本」「没本子」「无限轮回」「世界篇」「写一集」 | **① 剧本创作** | `script/GUIDE.md` → ★ 动笔前查 `script/PIPELINE.md`(每步读哪几条心法 + 判据自检) |
  145. | 「做一集短剧」「漫剧」「我这有个剧本」 | **② 漫剧线(主干)** | `references/prompts/01-漫剧分镜提示词.md` |
  146. | 「卖货」「带货」「产品视频」「投流」 | 商业线 · 卖货 | `references/prompts/02-商业视频提示词.md` |
  147. | 「开店」「门店」「本地生活」「同城」 | 商业线 · 到店 | `references/prompts/02-商业视频提示词.md` |
  148. | 「公司宣传」「企业形象」 | 商业线 · 企业 | `references/prompts/02-商业视频提示词.md` |
  149. | 「做个符」「把太极拳 / 运镜封成一张图」 | **③ 符创作** | `references/prompts/03-符生成.md` |
  150. **他什么都没说清,就问一句,三选一:**
  151. > 你现在手上是哪一种?
  152. > - **没本子** —— 我按「无限轮回宇宙」给你写一集,写完直接往下出片
  153. > - **有本子** —— 你贴给我,我从剧本开始做
  154. > - **想把一类本事做成一张图** —— 那是做符,单独一件事
  155. **问一遍就定,别兜回来再问。** 他选了「做片子」,这一路就不要再提「符」这个字。
  156. ### 剧本创作线:没本子先走这里
  157. **默认世界观就是无限轮回宇宙,不用他选。** 他不知道什么叫世界观,也不该让他先读设定。
  158. ```
  159. 1. 世界篇 → 一个身份 / 一句脑洞 / 一个题材,落 world.json [停点·确认]
  160. 2. 大纲 → 砍线 → 合人 → 收场景 → 排爽点 → 分集梗概(17 道门)
  161. 3. 剧本 → 每批 ≤3 集,逐集写戏(12 道门)
  162. 4. 交付 → 剧本.docx + script.json + 资产清单
  163. 5. 往下走 → 接漫剧线,见「剧本到分镜的交接」
  164. ```
  165. **他只说「写个剧本」,就只写剧本。** 别顺手给他排片子——他可能只想先看本子。
  166. **动笔前读 `script/GUIDE.md`**,细节全在那一份,别凭印象写。脚本用 node,零依赖。**下面这些命令都写成 `{skillDir}` 绝对路径,照抄即跑**(`script/` 是它的子目录):
  167. ```bash
  168. node "{skillDir}/script/scripts/ir-outline.mjs" seed world.json > outline.json
  169. node "{skillDir}/script/scripts/ir-outline.mjs" validate outline.json --stage beats
  170. node "{skillDir}/script/scripts/ir-script.mjs" seed outline.json --eps 1-3 > script.json
  171. node "{skillDir}/script/scripts/ir-script.mjs" validate script.json --outline outline.json
  172. node "{skillDir}/script/scripts/ir-script.mjs" render script.json --docx 剧名-剧本.docx --outline outline.json
  173. node "{skillDir}/script/scripts/ir-outline.mjs" assets outline.json > 资产清单.md
  174. ```
  175. **产出落在项目目录,不落 skill 目录:**
  176. ```
  177. 项目名/00_剧本与提示词/
  178. _剧本全文.txt 剧本、大纲(纯文本备用)
  179. 剧本.docx 主交付,打开就能用
  180. world.json 世界篇
  181. outline.json 全剧大纲
  182. script.json 逐集剧本(下游只认它,不读 docx)
  183. 资产清单.md 下一步盘资产直接用
  184. ```
  185. **写完问一句**:「这一集就这样,还是直接往下做成片子?」他想要片子才进漫剧线。
  186. ### 过了这一步,都是同一套干法
  187. 漫剧线和商业线的区别只是「做给谁看」,干活顺序一样。底下四件事,哪条线都得做:
  188. | 干什么 | 什么时候 | 细读 |
  189. |---|---|---|
  190. | **初始化** | 开工第一件事,先问四样 | `references/20-渠道参数.md` |
  191. | **盘资产** | 读完本子、聊完需求,动手前 | `references/21-资产清单.md` |
  192. | **出设定板** | 盘点确认后,一张张生成 | `references/资产设定板.md` |
  193. | **出分镜组表** | 资产齐了 | `references/30-分镜组.md` |
  194. | **审一轮、改一轮** | 表出来之后、写提示词之前 | `references/40-质检.md` |
  195. | **资产绑定** | 终版表定了,写词之前 | `references/22-资产绑定.md` |
  196. **顺序不能倒。** 先说资产,再排镜头,最后写词。倒过来做,后面全是返工。
  197. ---
  198. ### 符是什么,先把这个概念搞对
  199. **一张符 = 一类 AI 视频能力的知识浓缩,载体是图。**
  200. 本来要几千字讲清的经验、要点、禁忌、错法,压成一张 16:9 的图。模型读图比读长文本准——不会被截断,不会抓错重点,不会把第三条要点当成装饰。
  201. **所以符就是「AI 视频的 skill」,只不过 skill 的载体是文字,符的载体是图。** 同一类东西,两种装法。
  202. 由此推出关键一句:
  203. > **符不是一条线,是主线上的一个开关。**
  204. - 用户不用符 → 正常写提示词,那几百字该怎么写怎么写
  205. - 用户用符 → 那几百字里的一部分,换成「挂一张图 + 一句调用指令」
  206. **开关在「写提示词」那一步拨。** 前面读剧本、盘资产、拆分镜组全都不变,后面提交下载也全都不变。就中间那一处。
  207. 它不是一个独立流程,是这条线上的一种玩法。漫剧能用,电商也能用。
  208. **「③ 符创作」是另一个动作**:离开主线,去造一个新开关。造完放进库里,等哪条线用得上的时候再挂。所以它是个入口,但不是第三条主线——**别把它当流程走,它只产出图**。
  209. ---
  210. ### 主线之外的两件事
  211. 「做符」和「立谱」是**离开主线去造东西**,造完回来用。用户不提,一个字都别说。
  212. | 他说的话 | 做什么 | 读哪个文件 |
  213. |---|---|---|
  214. | 「做个符」「把这个技巧封起来」「运镜 / 太极拳做成符」 | **③ 符创作**。交一张 16:9 的图,不提交视频任务,也不排片子 | `references/prompts/03-符生成.md` |
  215. | 「统一画风」「做个设定集」「立个谱」「这套片子都一个调」 | **立谱**。先出世界符,再按谱往下生资产 | `references/prompts/04-立谱.md` |
  216. **「用我的符做」不在这张表里。** 那不是离开主线,是主线里拨了个开关——照第三节的流程走,写提示词时按「符怎么融进提示词」那一节做,别另开一套。
  217. ### 三条禁令
  218. 1. **入口清单里可以列符,做片途中不许问。** 三选一那一次是「你能干什么」的清单,列出来没问题;他一旦选了做片子,这一路就不要再问「要不要用符」——新手手里没有符,问了只觉得你在绕弯。他库里有东西,他自己会说。
  219. 2. **别把符塞进默认路径。** 新手第一次做片,全程不该听见这个字。等他自己提。
  220. 3. **做符不等于做片。** 符做完就是一张图。用户说「做个符」,你别顺手给他排个片子。
  221. ---
  222. ## 二、小白引导:一次只问一件事
  223. ### 先问一句:要我怎么配合你
  224. 有人只想赶紧拿到片子,有人每一步都想看。开工前先问:
  225. > 我可以一路做完,也可以中间停下来给你看。你要哪种?
  226. > - **快**:我全做完给你看,不满意再改
  227. > - **稳**:资产、脚本、提示词各停一次
  228. > - **细**:每一步都问你
  229. > - **自己定**:你说哪几步要停
  230. 用户没明确说,默认走**稳**。
  231. ### 七个停点
  232. | 停点 | 停在哪 | 看什么 |
  233. |---|---|---|
  234. | 参数 | 开工前 | 剧本类型 / 画幅 / 渠道 / 分辨率,对不对 |
  235. | 理解 | 读完剧本 / 聊完需求 | 我理解得对不对,有没有漏 |
  236. | 资产 | 图凑齐了 | 人物长相对不对,场景对不对 |
  237. | 脚本 | 分镜组 / 分镜表 | 组数和节奏对不对 |
  238. | 绑定 | 终版表定了 | 每组用谁对不对(pn 由脚本给,只核对人和场景) |
  239. | 提示词 | 写完第一条 | 颗粒度合不合意 |
  240. | 出片 | 生成完了 | 哪些能用,哪些要重跑 |
  241. **模式对应停哪些**
  242. | 模式 | 停 | 说明 |
  243. |---|---|---|
  244. | 快 | 出片 | 中间不打扰,交付时再说 |
  245. | 稳 | 资产 · 脚本 · 提示词 | 三个关键节点,默认 |
  246. | 细 | 全部五个 | 一步一步来 |
  247. | 自己定 | 用户点名的那几个 | 记下来,别漏也别多问 |
  248. **全自动也要收尾。** 「快」模式下,片子交出去的时候主动说一句「哪几处可能不合你意」,别装作没问题。
  249. ### 走漫剧线,这样问
  250. ```
  251. 第一问:你要做什么类型的剧?都市、悬疑、玄幻,还是别的?真人还是动漫?
  252. 第二问:一集大概多长?半分钟、一分钟,还是两分钟往上?
  253. 第三问:剧本你有了吗?有就贴给我;没有的话,我按无限轮回宇宙给你写一集(走剧本线),写完再往下做。
  254. 第四问:有角色的图吗?没有的话我先帮你出几张,你挑一张定下来。
  255. ```
  256. 四问答完,就够开工了。
  257. **别问的问题**:画风参数、模型版本、分辨率、采样数。这些他自己决定,不问用户。
  258. ### 走商业线,这样问
  259. ```
  260. 第一问:你卖什么,或者做什么生意?
  261. 第二问:看视频的人,你希望他干什么?来店里、下单、还是记住你?
  262. 第三问:你最想让人知道的一个点是什么?一个就够,别列五个。
  263. 第四问:发在哪?抖音、视频号,还是小红书?
  264. ```
  265. 四问答完就够。**时长默认 30 秒、竖屏**,他要更长的会说。
  266. **别问的问题**:目标人群画像、品牌调性、传播策略。他要懂这些就不用来找你了。
  267. ### 用户什么都不说
  268. 只发来一句「做视频」,先给一条最小路径:
  269. > 行。你先说一句:你想做什么?有剧情的短剧,还是卖东西的片子?
  270. ---
  271. ## 三、做片的流程(漫剧 / 商业)
  272. ### 漫剧线:先有图,再出片
  273. ```
  274. 0. 初始化 → 问清四样:剧本类型 / 画幅 / 渠道 / 分辨率,落 项目配置.json [停点·参数]
  275. 1. 读剧本 → 回四句话:讲什么、几个人、几个场景、大概几组;原台词原样落成 [停点·理解]
  276. `_剧本全文.txt` 当对账基准(后面任何环节都不许改它)
  277. 2. 盘资产 → 建目录,列 资产清单.json:人物 / 场景 / 道具 / 符 + 音色 [停点·资产]
  278. 3. 生设定板 → 角色板按固定版式填,一次定长相、空间、材质;一图一发
  279. 4. 分镜组表 → 时长按 项目配置;镜数按节奏,单镜 ≥1.2 秒
  280. 每镜写齐:景别 / 角度 / 运镜 / 站位 / 出场资产
  281. 5. 站位预演 → 谁站哪、朝哪、机位在哪侧、上下组接接不接得上(不生图)
  282. 6. 审核优化 → 机器体检 + 六看,改一轮,出终版表 [停点·脚本]
  283. 7. 资产绑定 → bind_assets.py 从「出场资产」列算 pn,冻结绑定表 [停点·绑定]
  284. 8. 写提示词 → 照终版表写草稿(pn 留空),prompt_assemble.py 注入 [停点·提示词]
  285. 9. 出作业单 → jobs_build.py 生成,bind_check.py 四方对账必须 0 差异
  286. 10. 提交生成 → 分批,最多 100 条同时跑 [停点·出片]
  287. ```
  288. ★★ **绑定铁律:pn 只能由脚本给。** 分镜组表只写「这一组用谁」(出场资产列,填名字或 id),
  289. ⛔ 不写 `pn1/pn2`;pn 编号由 `bind_assets.py` 按「角色→场景→道具→符」统一分配并冻结。
  290. 提示词里的【资产盘点】也不手写——`prompt_assemble.py` 从绑定表注入。
  291. 手写 pn 是这套流程唯一必错的环节:人和图一旦错位,成片就是换脸。
  292. 四道门跑完再提交,命令都在 `references/22-资产绑定.md`:
  293. ```bash
  294. python scripts/project_init.py "项目名" --genre 都市短剧 --aspect 9:16 --channel vidu-q4 --resolution 1080p
  295. python scripts/assets_check.py --file ".../资产清单.json" --files --require-final
  296. python scripts/storyboard_check.py ".../EP01_分镜组.tsv" --assets ".../资产清单.json" --require-assets
  297. python scripts/bind_assets.py --storyboard ".../EP01_分镜组.tsv" --assets ".../资产清单.json" --episode 1 --freeze
  298. python scripts/prompt_assemble.py --draft ".../EP01_提示词_草稿.txt" --bind ".../EP01_资产绑定.json" --out ".../EP01_提示词.txt"
  299. python scripts/vidu_check_prompts.py --new ".../EP01_提示词.txt" --config ".../项目配置.json"
  300. python scripts/jobs_build.py --bind ".../EP01_资产绑定.json" --prompt ".../EP01_提示词.txt"
  301. python scripts/bind_check.py --bind ".../EP01_资产绑定.json" --prompt ".../EP01_提示词.txt" --jobs ".../EP01_jobs.json" --assets ".../资产清单.json"
  302. ```
  303. > ★★ **音色铁律(2026-10-26):不能参考音色 ≠ 不能生成配音、不能对话。**
  304. > 本包默认闲时 `nopeak` **不能挂 `--audio`**,但平台**照样用原生配音逐句念台词**。
  305. > ⇒ 台词一行都不能删,有台词的组必须有【音色文字锁定】;缺的只是“指定某条参考音”的通道。
  306. > ⇒ 声音形象**在角色设定板阶段定死**(板上模块2 六项 = `音色-<角色名>.txt` 九维),写词只逐字继承锚点串。
  307. > ⛔ 不许把“无法参考音色”理解成“无声音/无对白”,更不许因此删台词或改成纯画面。
  308. ★ **参考图铁律(2026-11-05):设定图整张上传,不截图、不裁切、不再出单图。**
  309. > 角色 / 场景 / 道具,出片参考图就是那张设定板本身。板上有多视角和文字,靠提示词那句禁用句压,
  310. > 不靠裁图。⛔ 也不许「照板再出一张单图」——那是第二次生图,脸就漂了。
  311. **第 1 步的本子有两个来源**:上一节剧本线产出的 `script.json`(走交接单),或者用户直接贴的剧本。
  312. ★ **两个来源的台词都锁死**:用户贴的原文连错别字都照搬,`script.json` 的 `line` 是唯一真相;
  313. ⛔ 不许润色、不许"口语化"、不许为了压时长删句——装不下就拆组(要删必须先问用户)。
  314. **从剧本线来的,先读 `references/剧本到分镜的交接.md`**——一集拆几组、台词怎么折算,那里有换算表。不读就接,最容易犯的错是拿剧本标的秒数去切组:一集 24 个拍塞进 5 组,每组必然超 16 秒,回头全组重切。
  315. **停点按用户选的模式跳过或留下。** 但第 3 步(生图)和第 6 步(审表)即使「快」模式也别省——图不对后面全废,表不审后面全返工。
  316. **第 2 步只分三类:人物、场景、道具。** 声音形象附在人物类里算半个,**不能写「无」就过**:闲时只是无法参考音色,**不是没有配音**,每个有台词的角色都必须有一份**音色卡**(见第 7 步),并能追溯到角色板模块2 的六项声线。别自己加第四类——光线、色调、风格写进统一风格模块,不单独占资产。**只露一次脸的路人、只出现一次的空镜空间,不做板**,判断标准只有一条:后面还会不会引用它。
  317. **建目录用脚本,别手工建。**
  318. ```bash
  319. python "{skillDir}/scripts/asset_init.py" 项目名
  320. ```
  321. 一次建好 `00_剧本与提示词/`、`01_资产库/`、`02_分集工程/EP01…/视频/`、`03_背景音乐/`、`04_最终交付/`,并落一份空的 `00_剧本与提示词/资产清单.json`。**默认不建 C 盘**——素材几个 G 起步,塞系统盘迟早出事;落在 C 盘它会停下来告诉你该放哪,真要建才加 `--allow-c`。
  322. **资产库平铺,不建子目录。** 图片和音色全在 `01_资产库/` 一层,文件名就是资产名(`男主.png`、`男主音色.wav`)。分子目录看着整齐,写提示词时天天拼路径。
  323. **第 3 步定的是全片标准。** 一个角色只生一次,换装、受伤、湿透都在原图上写清变化,不重开一张。有血缘关系时,后生的那张必须拿先有的当参考图,写身份句「角色是图1的父亲」,**不许另写一套外貌形容词**。模板和验收标准在 `references/资产设定板.md`,角色板本体在 `references/角色设定板模板.md`。
  324. **★ 角色板是固定版式(2026-11-05 起,骨架不许改)**:左边文字信息栏,右上人物展示区(三视图+脸部特写组),右下细节特写区;浅灰渐变背景、细线分区、现代无衬线黑体。
  325. - **七个必选字段**:姓名 / 外号小名 / 年龄 / 身高 / 体重 / 职业身份 / 人物定位。**一个都不能空**,没有的写「无」。
  326. - **四个可选模块**:性格与行为习惯、声线特征、替换服装、随身物品。**不用就整段删掉**,不留空标题。
  327. - **声线就在这张板上定型**(模块2 六项),值从 `音色-<角色>.txt` 的九维压缩而来;写词只抄锚点串。链条是「音色卡 → 板上六项 → 提示词锚点串」,⛔ 不许在写词时另立声线。
  328. - **这张板同时是出片参考图**,整张上传,不截图不裁切(见铁律 2)。
  329. - 机检:`python "{skillDir}/scripts/voice_lock_check.py" --dir "…/_资产提示词"`。
  330. - ⛔ 不能因为「后面闲时挂不了音色」就省掉模块2;正因为挂不了参考音,板上的声线设计才是唯一依据。
  331. - **人设卡片不再做**(3.0 起废除):设定板就是唯一人物资产,也是出片参考图;要选角图、宣发物料另开一条,⛔ 不进出片链。
  332. **场景 / 道具 / 群像不要指定排版。** 不写几宫格、不写「左上正面右上侧面」。你一排格子,模型就把注意力花在别越界上。**只交代必须出现什么,怎么排交给模型。** 角色板是唯一例外——版式本身就是它的需求。
  333. **★ 生图铁律(2026-11-05):不要重复生图**:一次只出一张,出完自查一遍就交给用户,**⛔ 不抽卡、不「三张挑一张」、不自己觉得不像就默默重跑**。用户说哪里不像,只改那一处再跑一次。换版不删旧图,`男主-v2.png` 留着能退。
  334. **第 4 步是命门。** 一条任务最长 16 秒(Vidu Q4;H3 / 即梦 2.0 是 15,即梦 2.5 固定 30,Wan3 4–30,见 `references/20-渠道参数.md`),**一个组就是一条任务**;组里装几个分镜按节奏定(经验 4–8 个,不设死线),不是一镜一条。**一次提交不管几秒都只扣一次额度**,所以优先 12–16 秒,装得下就装满;低于 12 秒的只占极少数(一集最多一两组)。单镜低于 1.2 秒模型立不住主体,出来是一团糊。台词按 3.2–4 字/秒估,12 秒大约装 38–48 字,装不下就拆组,别用「语速飞快」硬塞。规则和表格式在 `references/30-分镜组.md`。
  335. **表里每镜写齐五样:景别、角度、运镜、站位、出场资产。** 固定机位也要写「机位固定」——不写不等于固定,等于让它自由发挥。站位写谁在画左/画右、朝哪、机位在轴线哪一侧。
  336. **第 5 步站位预演,不出图。** 顺着表把站位读一遍:不挡不叠、不跳轴、上下组接得上、每次换位置都有动作由头。改一行字的成本,比改十秒画面低得多。复杂的多人调度才画一张俯视简图,看完就丢,不进资产库。
  337. **第 6 步的产物是改好的表,不是评价。** 跑体检把错误改到 0(`--assets` 指资产清单、`--require-assets` 强制要求出场资产列),再自己看六件事:上下组搭不搭、为剪辑准备够不够、景别衔接顺不顺、运镜合不合理、角度合不合理、该不该加反应镜。**只改一轮**。评估过程不输出给用户,只给终版表和「动了哪几处」。
  338. ```bash
  339. python scripts/storyboard_check.py "…/EP01_分镜组.tsv" --config "…/项目配置.json" \
  340. --assets "…/资产清单.json" --require-assets
  341. ```
  342. **第 8 步动笔前,先继承角色设定板上的声音形象,而不是到这一步才决定“有没有声音”。**
  343. ★ **2026-10-26 实测:闲时(`nopeak`,本包默认)无法参考音色。** 挂 `--audio` 也锁不住声线,声线方向由文字音色卡限定、具体嗓音仍由平台原生配音生成。
  344. ⇒ 声线**只能靠文字锁**:每个有台词的角色一份《人物音色卡》(九维 + 一行锚点串),存 `00_剧本与提示词/_资产提示词/音色-<角色名>.txt`,写提示词时在【音色文字锁定】里**逐字照抄锚点串**。
  345. ⇒ 音色卡须与**角色板模块2「声线特征」**同源同值(第 3 步交付);没有卡就回第 3 步补,⛔ 不在写词时现编。
  346. 只有 `normal`(花积分)才能真挂 `--audio`——那时才去要 4–5 秒样音(一句完整台词、单人、无 BGM、剪映裁)。
  347. ⚠ **别理解反**:闲时不能"参考音色",但**照样有配音** —— 平台会用原生语音把台词逐句念出来。
  348. ⇒ **台词一行都不能删**,不许把整组写成纯画面,也不许写"本组无对白"。删 `--audio` 删的是"这是谁的声音"。
  349. 细则在 `references/音色与配音.md`;卡格式在 `references/prompts/01-漫剧分镜提示词.md`「音色:先判通道」一节。
  350. **第 8 步分两半:先写草稿,再让脚本注入。** 草稿里【资产盘点】只留占位或整段留空,⛔ 不写 `pn`;
  351. 写完跑 `prompt_assemble.py` 从绑定表把 pn、强制声明、禁用句一次性注入,再用
  352. `vidu_check_prompts.py --new … --config 项目配置.json` 过结构门。手写 pn、手抄禁用句,都是错位来源。
  353. **想用符就插一步。** 用户手里有符、也说了要用,就在第 8 步写提示词时拨这个开关:`lib` 看库里有什么,挑 0–2 张,按下面「符怎么融进提示词」写进去。**没符就正常做,别硬凑,也别主动提。**
  354. 细读 `references/prompts/01-漫剧分镜提示词.md`、`references/资产设定板.md`、`references/30-分镜组.md`、`references/22-资产绑定.md`。
  355. ### 商业线:先对思路,再动手
  356. ```
  357. 1. 聊需求 → 做什么、放哪用、要人干什么、最想说的一个点 [停点·理解]
  358. 2. 三个方向 → 给三个创意,说清"赌什么、风险是什么",标一个推荐
  359. 3. 用户挑 → 「快」模式下 AI 自己选一个并说明理由,别空等
  360. 4. 盘资产 → 产品图 / 场景 / 人物,缺的按模板生 [停点·资产]
  361. 5. 分镜组表 → 同样按时长档与出场资产列,跑体检、站位预演、六看、改一轮 [停点·脚本]
  362. 6. 写提示词 → 格式跟漫剧一致 [停点·提示词]
  363. 7. 提交生成 → 同上 [停点·出片]
  364. ```
  365. **前三步别跳。** 方向不对,做出来再改就是重做。但「快」模式下第 3 步由 AI 代选,不要停在那里等。
  366. **商业线的资产更少,但不能省。** 产品图用户一般有,直接放 `01_资产库/`;场景图按 `references/资产设定板.md` 的模板生;人物能省则省——卖货片里出镜的人越少,崩的机会越少。产品板至少给三个角度(整体、正俯视、结构特写),盒面瓶身不出现可读文字。
  367. **第 5 步跟漫剧一模一样。** 商业片更怕拖——空镜、纯情绪在卖货片里是直接掉转化。表格和体检脚本都照 `references/30-分镜组.md`。
  368. **商业线一样能挂符。** 产品片常挂的是「运镜」「打光」「质感」这几类。开关同样在写提示词那一步,跟漫剧一个做法。
  369. 细读 `references/prompts/02-商业视频提示词.md`。
  370. ### 符怎么融进提示词(漫剧 / 商业通用)
  371. 符要真起作用,靠三处联手:**登记、调用指令、点名时机**。只把图传进去、提示词里不提,模型会当它是张无关的参考图,白挂。
  372. #### ① 登记成资产
  373. 符先在 `资产清单.json` 里记一条(`type` 写 `skill`,`status` 写 `builtin`):
  374. ```json
  375. {"id": "SK01", "type": "skill", "name": "符-运镜", "file": "符-运镜/panel.png", "status": "builtin"}
  376. ```
  377. 然后在分镜组表的「出场资产」列写名字或 id(`CH01,SC01,SK01`)。⛔ 不写 `pn`。
  378. `bind_assets.py` 按「角色→场景→道具→符」排序,符永远排最后,pn 编号脚本给。
  379. `prompt_assemble.py` 再把【资产盘点】整段注入提示词,产出长这样:
  380. ```
  381. 【资产盘点】
  382. 人物视觉资产:pn1,熬夜男生=@
  383. 场景资产:pn2,出租屋工位=@
  384. 道具资产:pn3,维生素瓶=@
  385. 技能资产:pn4,符-运镜=@
  386. ```
  387. #### ② 加【技能调用】块,把库里那句调用指令原样抄
  388. ```
  389. 【技能调用】
  390. 符-运镜:写推拉摇移时按本卡执行,镜头关系照它,画面内容照本条提示词。
  391. 禁用:本卡不在画面中出现——不出现面板、文字块、图表、分隔线,不复制其配色与版式。
  392. ```
  393. 块里只写符名,⛔ 不写 `pn4`——pn 由绑定表注入,写死就对不上了。
  394. 指令从哪来:`lib --show 符-运镜` 打出来的 `call`,存在 `_库.json`,源头是 `meta.json` 的 `prompt`。**一字不改地抄,别改写、别概括。** 那句话就是这张符的定义,改了就不是同一张符。
  395. **「禁用」那句必须加。** 整张 16:9 面板当参考图,模型有时候会把版式和文字块一起带进画面。不写死,就等着画面里飘出一张知识卡。
  396. #### ③ 正文点名调用时机
  397. 只在真用得上它的镜头写,全文都挂等于没挂:
  398. ```
  399. 【镜号A2】
  400. 运镜:按 [@符-运镜] 的推拉节奏,从桌面前推到瓶身
  401. ```
  402. #### ④ 出作业单,别手拼 `--image`
  403. ```bash
  404. python scripts/jobs_build.py --bind "…/EP01_资产绑定.json" --prompt "…/EP01_提示词.txt"
  405. python scripts/vidu.py run --jobs "…/EP01_jobs.json" --dry-run # 先看张数与顺序
  406. python scripts/vidu.py run --jobs "…/EP01_jobs.json"
  407. ```
  408. 作业单里的图片顺序**逐字抄绑定表**:`pnN ↔ images[N-1]`。
  409. 手拼 `--image` 少一张、顺序颠倒,就是换脸;这条已经不该由人来做。
  410. #### 三条硬规矩
  411. 1. **一张符只管一件事。** 要运镜又要打斗,是两张符。最多挂 2 张,再多模型会打架。
  412. 2. **别让面板进画面。** 先补/加强禁用句重跑;实在压不住,才把符里那块示意图单拎出来当参考图(符是例外,设定板不适用——设定板永远整张传)。
  413. 3. **不相关就别挂。** 硬挂一张不相关的符,比不挂更糟——它会污染构图。
  414. **换句人话:符不能替你写提示词。** 它只是把「一类知识」从文字换成图。原来你要写三百字讲清运镜怎么推,现在挂一张图 + 一句调用指令;剩下的画面内容——人在哪、光从哪来、动作怎么走——该写还得写。**符省的是"讲道理"的字,不是"写画面"的字。**
  415. ---
  416. ## 四、主线之外的三件事
  417. 这三件是**离开主线去造东西 / 收尾**,造完回主线用。用户主动提才做,他不提,你就待在第三节里。
  418. ### 4.1 ③ 符创作:把一类本事压成一张图
  419. 用户说「做个符」「把太极拳 / 运镜 / 这个技巧封起来」时走这里。**只交一张图,不做视频,不排片子。**
  420. ```
  421. 1. 问一句 → 这个能力解决什么问题、模型现在做不好什么
  422. 2. 封装 → 读 references/prompts/符的生成.txt,产出代码块 + 四个参数位
  423. 3. 落盘 → meta.json / brief.md / prompt.txt
  424. 4. 生图 → card 命令,16:9,出 panel.png [停点·出图]
  425. 5. 验字 → 错字 / 写实脸 / 塞太满,改 prompt.txt 重跑(最多 3 次)
  426. 6. 入库 → card 自动写进 out/符/_库.json
  427. ```
  428. **第一问只问一句,别问版式**(栏数、配色、字号规则里已定死);**第二步别自创格式**,「什么必须上图、人物只能画线稿」的规则本体在 `references/prompts/符的生成.txt`。
  429. **brief 给人看,prompt.txt 给模型看。** prompt.txt 建议压到 1500 字内——写长了生图模型会丢重点。
  430. **光有图不算一张符。** `meta.json` 必须填四个参数位——**锁 / 变 / 禁 / 让**,填不出就说明经验还没萃取完,别急着生图。判断只用一句:改了是「能力不成立」,还是「只是换个样子」?判据、主辅符、冲突裁决、五维评级在 `references/符-参数卡.md`。
  431. **三个必查**(第五步最容易漏):中文错字、冒出写实人脸、字小到看不清——不查,交出去的符就是废的。
  432. **入完库是「候选」不是「定稿」**:出图成功只说明没报错。五维分(可复用性 / 控制力 / 清晰度 / 参数完整 / 稳定性设计,各 20 分)到 A(78 分),才能在 `meta.json` 写 `"status": "定稿"` 再跑一次 `lib --add`。父子关系记 `parent`,没有就留空别编。
  433. **完整流程、符库命令、挂符三条硬规矩** → `references/prompts/03-符生成.md`;**方法论(父系 / 三态 / 容量闸 / 总纲符)** → `references/符的方法论.md`。用符回第三节「符怎么融进提示词」。
  434. ### 4.2 立谱:先定画风,再往下生
  435. 用户说「统一画风」「做个设定集」「立个谱」「这套片子一个调」时走这里。**一个项目只做一条片子,别立谱。**
  436. ```
  437. 1. 收种 → 一张图 + 一段文字;没图就先帮他画一张开局图
  438. 2. 世界符 → 16:9,左 VIS 视觉规范,右 CIS 世界规则 [停点·谱]
  439. 3. 人物规范 → 骨相、服装、材质、派系对比
  440. 4. 空间规范 → 体量、材质、光线、色调
  441. 5. 场景主视 → 每个主要场景一张主视角
  442. 6. 回主线 → 盘资产时直接挂这几张当参考图,不用重画
  443. ```
  444. **四层,不是十二层。** 原方法十二层(群像、关卡总览、3D 简模……)是给长剧集和游戏资产用的,短剧和卖货片跑一套几十张图,钱和时间都白花。
  445. **每一层都往下传**:生人物规范挂世界符,生空间规范挂世界符,生场景主视挂空间规范。父系不挂,画风一层层漂,最后谁都认不出是一部片子。
  446. **世界符和「符」不是一回事**:世界符一张管整个项目的长相;符一张管一类动作怎么做。别混着叫。
  447. **世界符用 `image` 不用 `card`**(`card` 会加强制前缀并写进符库,世界符是项目资产)。细则 → `references/prompts/04-立谱.md`。
  448. ### 4.3 剪辑:把成片交给剪映
  449. 用户说「剪一下」「做个剪映草稿」「配字幕」「调节奏」时走这里。**只做剪辑与交付,不重做分镜、不改台词。**
  450. ```
  451. 1. 定三件 → 片型 / 素材状态 / 交付(草稿 or 成片)
  452. 2. 建台账 → 素材ID / 路径 / 时长 / 宽高 / 帧率 / 音轨
  453. 3. 决策表 → 只写素材ID + 源内秒,不写路径
  454. 4. 粗剪 → 按决策表铺轨道
  455. 5. 精剪 → 字幕 / 音效 / BGM / 转场
  456. 6. 校验 → 写前对台账 / 写后回读 / 发布后回读
  457. 7. 交付 → AI_ 前缀草稿,或导出 mp4
  458. ```
  459. - 剪映自动化在 `jianying-editor/`(开源 MIT 模块,按原样集成;作者/仓库/打赏信息已移除)。
  460. - 包内不带演示视频;要跑 `jianying-editor/examples/` 先执行一次
  461. `python jianying-editor/scripts/make_demo_media.py` 现造素材(约 2 MB,不进包)。
  462. - 业务脚本放项目根目录,⛔ 不写进 `jianying-editor/`。
  463. - 字幕:文本取剧本、时间取词级时间戳;横屏 16:9 / 竖屏 9:16 两档参数。
  464. - 轻量决策(怎么剪、素材怎么处理、节奏怎么调、画面怎么查)→ `references/50-剪辑与交付.md`。
  465. - 素材映射与字幕参数 / 三道校验 → `references/51-素材映射与字幕.md`。
  466. ## 五、生图的两句固定话
  467. `image` 和 `card` 会自动把这两句拼进去,**正文一个字不改,你不用管**:
  468. - 开头:「请一字不改严格按照以下中文提示词生成图片,不要翻译、不要改写、不要添加内容」
  469. - 结尾:尾缀,按 `--tail` 伸缩
  470. 开场语治的是模型自己翻译、自己改写术语、自己加戏。尾缀治的是碎噪点和虚高细节。
  471. **尾缀按「图上有没有字」分两类,别搞反:**
  472. | 档 | 原文(一字不改) | 给什么用 |
  473. |---|---|---|
  474. | `min` | 归约细节 | **纯画面 + 真人**。人设、场景、道具板。`image` 的默认值 |
  475. | `mid` | 归约细节,灭高频冗余 | **图文面板**。符、世界符、规范图——字要能读。`card` 的默认值 |
  476. | `full` | 归约细节灭高频冗余,软泛焦均质简谐流 | 纯画面 + 动漫国漫。**别给带字的面板用** |
  477. | `none` | — | 不加 |
  478. **`full` 里的「软泛焦」会把小字糊掉。** 符的第一硬标准是面板上每个字都要能读,所以带字的面板一律 `mid`;只有动漫/国漫的纯画面资产才用 `full`。
  479. **真人题材误用 `full`,皮肤纹理和布料织纹会被一起磨掉。** 尾缀只修毛刺,不砍表现力——轻微过曝、轻微饱和溢出该留就留。
  480. 实际用的尾缀会打印出来,也会写进 `prompt.txt` 和 `meta.json` 的 `tail` 字段,别人照着跑能得到同样结果。
  481. > 尾缀原法出自倒放《一体成型:image 2.5 碎噪点已攻克》(2026-09-26),经多参BUDDY 整理。这两句别改字,改了就不可复现。
  482. ---
  483. ## 六、Vidu Q4 的硬规矩
  484. | 项 | 值 |
  485. |---|---|
  486. | 支持 | 图生视频、参考生视频。**纯文字生视频不支持** |
  487. | 单条任务时长 | 参考生视频 1–16 秒;图生视频 3–16 秒 |
  488. | **一个分镜组** | **不超过 16 秒,优先 12–16 秒**(低于 12 的只占极少数);一组就是一条任务 |
  489. | **组内分镜** | **按节奏定,不设死线**(2 个是底线,经验 4–8 个);**单个分镜不低于 1.2 秒** |
  490. | 分辨率 | 540p / 720p / 1080p / 2k / 4k |
  491. | 比例 | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 |
  492. | 不能传 | `--transition`,传了报错 |
  493. | 参考生视频必须有 | 至少一张图、一个主体或一段音频 |
  494. | 参考图 | 最多 9 张 |
  495. | 音色参考 | ★ **闲时不可用**(2026-10-26 实测);要参考音色走 `--mode normal`,最多 **3 条**(`--audio`)。闲时靠**人物音色卡**文字锁声线。⚠ 但**闲时仍有配音**,台词照念 |
  496. | 单条提示词 | 8000 字以内 |
  497. 超过 16 秒的剧情,拆成多组,别硬塞。**但也别拆碎**——组数越多,人物越容易漂、排队越久。按剧情节点拆,天然就落在 12–16 秒。
  498. **一次提交不管写 6 秒还是 16 秒,都只扣一次额度。** 所以短组不是省,是浪费:同样一段剧情,3 个 16 秒组比 5 个 10 秒组省 2 条额度。
  499. ---
  500. ## 七、钱怎么花:图片花积分,视频走闲时
  501. ★ **2026-11-05 定的口径,不要搞反:**
  502. | 干什么 | 走哪 | 为什么 |
  503. |---|---|---|
  504. | **出视频**(`submit` / `batch` / `run`) | **`--mode nopeak`(闲时,0 积分),无例外** | 视频一律不花积分;用户明确要求才 `normal` |
  505. | **生图**(`image` / `card`,设定板/符) | **`--mode normal`(6 积分/张)** | 生图和出片共用闲时计数器,批量生图会把当天出片额度吃光 |
  506. 生图别省那 6 积分去蹭闲时——蹭掉的每一条,都是当天能出的一条片子。
  507. 反过来,视频别偷偷切 `normal`:那是花他的钱,得他自己说。
  508. ## 八、提交:闲时免费,但要管并发
  509. **闲时额度:专业版 20 条/天,旗舰版 200 条/天,都是 0 积分,单条最长 16 秒。** 开工前先 `check` 认档位(见第零节第 4 步)。
  510. 提交时显式写:
  511. ```
  512. --mode nopeak
  513. ```
  514. ⚠ **本包 CLI 默认就是 `nopeak`(0 积分)**;显式写出来是为了不漏。
  515. 要花积分必须自己写 `--mode normal` —— 平台底层字段叫 `schedule_mode`,取值只有 `nopeak` / `normal`,别猜 `off_peak`。
  516. **并发上限 100 条,但日额度先卡死你。**
  517. | 档位 | 一次能交多少 |
  518. |---|---|
  519. | **专业版** | **最多 20 条(一天的量)**,交完就等第二天 |
  520. | **旗舰版** | 40 条以内一次推完;超过 100 条分批,跑完一批补一批 |
  521. 给用户说清楚,他会理解:
  522. > 你这是一天 20 条的档,一集 6 组,今天最多出三集,剩下的明天再跑。
  523. > 旗舰版能一次交 40 条,大概一个小时陆续出来。
  524. **别超额交,别为了「今天做完」偷偷切 normal。** 那是在花他的积分。
  525. 闲时**可以出声,但不能参考音色、不能开唇同步**(★ 2026-10-26 更正:旧版写「`--audio` 可用」是错的)。
  526. | 能力 | 怎么开 | 闲时 |
  527. |---|---|---|
  528. | **AI 按台词配音** | 提示词里写 `角色名:台词` | ✅ **可用,而且是默认** —— 平台原生配音逐句念,语气跟 `<>` 走 |
  529. | **音色参考**(让角色用某个声线说话) | `--audio 音色.wav` | ❌ **无法参考**(实测)⇒ 改用【音色文字锁定】+人物音色卡 |
  530. | **唇同步 / 音频驱动** | `with_audio` + `lip_sync` | ❌ 禁用,报 `withaudio & lipsync nopeak mode is not allowed` |
  531. > ⚠ **这两行最容易读反**:「不能参考音色」说的是**指定不了声线**,**不是没有声音**。
  532. > 台词一直都由平台念,删掉 `--audio` 只影响"像不像同一个人"。⛔ 别顺手把台词也删了。
  533. **想把声线锁死,只有两条路**:① 文字卡(闲时唯一手段,一致但不像某个真人);② `--mode normal` + `--audio`(花积分)。
  534. ---
  535. ### 8.1 声线怎么保住
  536. **先判通道,两条路差别很大:**
  537. | 通道 | 声线靠什么锁 | 提示词里写 | 代价 |
  538. |---|---|---|---|
  539. | **闲时 `nopeak`**(默认) | **人物音色卡**:九维 + 锚点串 | 【音色文字锁定】每人一行;⛔ 不写 `vm` 行、不写【音色严格规范】 | 0 积分;一致但不像某个真人 |
  540. | **`normal`** | `--audio 音色.wav` | `人物音色资产:vm1,林桂芳音色=@` +【音色严格规范】 | 花积分 |
  541. - 音色卡存 `00_剧本与提示词/_资产提示词/音色-<角色名>.txt`,**九维一次写死、全片不改**;写词时只逐字抄那一行 ≤40 字的**锚点串**。
  542. - **不许撞嗓**:任意两角色基频区间不重叠(重叠 ≤10 Hz 时语速必须分开);高频对戏的两人至少 3 维不同。
  543. - 两道机检都零计费:`voice_lock_check.py` 查卡本身,`vidu_check_prompts.py --voice-dir` 查稿子里的锚点串(命令见第九节)。
  544. - `--audio` 可重复,**上限 3 条**,顺序对应 `vm1 / vm2 / vm3`;参考音 **4–5 秒最佳**(3 秒够认出,8 秒封顶)、单人、无 BGM、无混响。
  545. - **硬拦**:`nopeak` 作业单带了 `audios`,本包提交前直接报错。拦的是"参考音色",**不拦配音**——⛔ 别为了消这个错去删台词。
  546. ★ **九维模板、锚点串写法、基频参考值、商业片旁白、撞嗓细则全在 `references/音色与配音.md`,动笔前读那一份。**
  547. **别默不作声地跳过。** 一个角色从头到尾用平台随机声线,观众听着就是换了个演员。
  548. ---
  549. ## 九、命令
  550. 全是 `python scripts/…` 开头,**不用装任何第三方包**。
  551. ```bash
  552. # 建项目骨架(开工第一件事;默认不落 C 盘)
  553. python "{skillDir}/scripts/asset_init.py" 项目名
  554. # 查额度(开工前先看一眼)
  555. python "{skillDir}/scripts/vidu.py" check
  556. # 提交一条
  557. python "{skillDir}/scripts/vidu.py" submit --prompt-file G01.txt --image 人物/男主.png --image 场景/饭馆.png --duration 10
  558. # 提交一条(★ 带音色参考只能用 normal —— 闲时无法参考音色)
  559. python "{skillDir}/scripts/vidu.py" submit --prompt-file G01.txt --image 人物/男主.png \
  560. --audio 音色/男主.wav --audio 音色/女主.wav --duration 10 --mode normal
  561. # 批量提交
  562. python "{skillDir}/scripts/vidu.py" batch --jobs jobs.tsv
  563. # 查进度
  564. python "{skillDir}/scripts/vidu.py" status
  565. # 下载成品
  566. python "{skillDir}/scripts/vidu.py" pull --out ./out
  567. # 生图(做资产板用,角色板一律 16:9,真人题材 --tail min)。
  568. # ★ 生图默认 normal(6 积分/张),别改成 nopeak 蹭出片额度
  569. # ⛔ 多行提示词别用 --prompt-file(那是「一行一条」),用 --prompt "$(cat 文件)"
  570. python "{skillDir}/scripts/vidu.py" image --prompt "$(cat "00_剧本与提示词/_资产提示词/角色-沈砚舟.txt")" \
  571. --name 沈砚舟 --out 01_资产库 --ratio 16:9 --tail min
  572. # 做符(16:9 能力面板,存 out/符/符-名字/panel.png,出完自动入库)
  573. python "{skillDir}/scripts/vidu.py" card --name 太极拳 \
  574. --prompt-file out/符/符-太极拳/prompt.txt \
  575. --meta out/符/符-太极拳/meta.json \
  576. --tag 动作 --tag 教学
  577. # 符库
  578. python "{skillDir}/scripts/vidu.py" lib
  579. python "{skillDir}/scripts/vidu.py" lib --q 太极 --show 符-太极拳
  580. # 分镜组表体检(写提示词之前必跑,错误必须改到 0)
  581. python "{skillDir}/scripts/storyboard_check.py" "00_剧本与提示词/EP01/分镜组/EP01_分镜组.tsv"
  582. # 音色(两道门,都零计费)
  583. python "{skillDir}/scripts/voice_lock_check.py" --dir "00_剧本与提示词/_资产提示词"
  584. # 人设卡是可选件;只有做了卡才跑这一条
  585. python "{skillDir}/scripts/voice_lock_check.py" --card "00_剧本与提示词/_资产提示词/人设卡-主角.txt" --dir "00_剧本与提示词/_资产提示词"
  586. python "{skillDir}/scripts/vidu_check_prompts.py" --new 第1集.txt --voice-dir "00_剧本与提示词/_资产提示词"
  587. # ★ 台词红线:每句台词都必须能在剧本原文里连续找到(改字/加词/换顺序 = 阻断)
  588. python "{skillDir}/scripts/vidu_check_prompts.py" --new 第1集.txt --script "00_剧本与提示词/_剧本全文.txt"
  589. ```
  590. **`card` 和 `image` 的几个开关:**
  591. | 开关 | 干什么 |
  592. |---|---|
  593. | `--prompt-file` | 从文件读提示词,长的提示词都用这个,别塞命令行 |
  594. | `--meta` | 符专用。第一个代码块的 JSON,入库靠它 |
  595. | `--tag` | 符专用。标签,可重复,以后搜用 |
  596. | `--ref` | 参考图,可重复。想让符照着某张图的画风/版式来,加它 |
  597. | `--resolution` | 留空用默认;字糊了试 `2k`,报 `Invalid resolution` 就退回 |
  598. | `--no-lib` | 符专用。生完不入库 |
  599. | `--tail` | 尾缀档位。纯画面资产:真人 `min`(默认)、半写实 `mid`、动漫国漫 `full`。**带字的图文面板一律 `mid`**,`full` 会把小字糊掉 |
  600. | `--dry-run` | 不花钱,只看几字、存哪 |
  601. | `--wait` | 最多等多少秒,默认 300 |
  602. **作业表 `jobs.tsv`** —— 每行一条,制表符分隔,**四列或五列**(第 5 列音色可选):
  603. ```
  604. G01 prompts/G01.txt 人物/男主.png,场景/饭馆.png 10
  605. G02 prompts/G02.txt 人物/男主.png,人物/女主.png 12 音色/男主.wav,音色/女主.wav
  606. ```
  607. 组号 / 提示词文件 / 图片(逗号分隔) / 时长 / 音色(逗号分隔,可省略)
  608. ⚠ **顺序不靠人记。** 走作业单时,images 顺序逐字抄绑定表(`pnN ↔ images[N-1]`),audios 同理对应 `vmN`;
  609. 手拼 `--image` 少一张、顺序颠倒,就是换脸换嗓——所以 §三 第 9 步要求先 `jobs_build.py` 再提交。
  610. 每条提交完自动写台账(`out/_台账.json`),断了能续,下载按组号命名,不用你对着 task_id 猜。
  611. **提交完别坐着等。** 一次交完,隔几分钟 `status` 看一眼,好了的 `pull` 下来。
  612. ---
  613. ## 十、提示词写不对,帮他改
  614. 用户自己写的提示词,十有八九是「画面很有氛围感」这种。
  615. **判断标准只有一条:画面里能看见什么。**
  616. 看见形容词就改。改完告诉他改了哪几处,别闷头改。
  617. 对照 `references/提示词自检表.md`。
  618. ---
  619. ## 十一、报错怎么办
  620. **完整报错对照表在 `references/排错表.md`——遇到报错先去那里查。** 最常撞的三条先记住:
  621. | 报错 | 改法 |
  622. |---|---|
  623. | `withaudio & lipsync nopeak mode is not allowed` | 闲时带了参考音频。删 `--audio` 改用【音色文字锁定】;⚠ **台词照念,别删台词** |
  624. | `duration ... out of range` | 参考生视频 1–16 秒,图生视频 3–16 秒 |
  625. | `Invalid resolution` | 去掉 `--resolution`,用默认 1080p |
  626. `ok: true` 也可能是失败。**只看 `state`**:`success` / `failed` / `canceled` 才是终态。
  627. ---
  628. ## 十二、这套东西不做什么
  629. 跟用户讲清楚,省得他以为是万能的:
  630. - **不自动排队**。分批、盯进度、补位,你跟他说,他让你做。没有藏起来偷偷跑的调度器。
  631. - **不管账号**。一个 Token 一个号。
  632. - **不管资产**。角色图、产品图他自己准备。
  633. - **不保证不崩**。便宜换来的就是偶尔崩,崩了重跑,一条几分钱。
  634. - **不保证符上的中文字全对**。生图模型写中文会出错字,错了改 `prompt.txt` 重跑,三次不行就砍内容。
  635. ---
  636. ## 十三、干活时的几条习惯
  637. 1. **先给表,再写词。** 分镜没点头就写提示词,白干。
  638. 2. **一次交付一块。** 别一口气吐 40 条提示词,用户看不完。
  639. 3. **说人话。** 不说"赋能""闭环""对齐",不说"让我们"。
  640. 4. **承认不知道。** 模型能力边界外的事,直说做不到,别硬编。
  641. 5. **改了什么要说。** 用户给的剧本、提示词,动了哪几处,一条条列出来。
  642. 6. **审核过程不外放。** 分镜表的评分、问题清单、检查了几项,都不给用户看。只给终版表 + 改了哪几处。
  643. 7. **台词不动字。** 可以拆句、可以换行,不允许改字、加词、删句。要改得先问过用户。
  644. 8. **一图一发,不重复生图。** 出完就发,等他说哪里不像;⛔ 不抽卡、不自己重跑第二版。
  645. 9. **参考图用整张设定图。** 不截图、不裁切、不再出单图;禁用句必须写在提示词里。
  646. 10. **站位先预演,再写词。** 表里的站位读不顺,写出来的词也接不上。
  647. ---
  648. ## 文件
  649. **本包(`{skillDir}`)**
  650. ```
  651. SKILL.md 总控(本文件)
  652. README.md 给人看的:装什么、怎么开始
  653. VERSION 版本与更新日志
  654. references/ 干活时查的规范
  655. prompts/ 三条入口的提示词正文
  656. 00-万能提示词.md 用户填几个空就能丢给你
  657. 01-漫剧分镜提示词.md ② 漫剧线(主干)
  658. 02-商业视频提示词.md 商业线(卖货 / 到店 / 企业)
  659. 03-符生成.md ③ 符创作:做符 + 用符
  660. 04-立谱.md 可选:世界符与四层资产链
  661. 符的生成.txt 符的系统规则本体(别改,改了就变味)
  662. 00-流程总表.md ★ P0—P10:每步谁做、读哪份、交什么
  663. 10-红线.md ★ 不许破的十条
  664. 15-确定性.md 哪些步骤必须脚本做(零 LLM)
  665. 20-渠道参数.md ★ 参数唯一口径(5 渠道:时长 / 声音 / 板式 / 图片上限)
  666. 21-资产清单.md 资产清单.json 字段、状态机、校验规则
  667. 22-资产绑定.md ★ 出场资产列 → pn → 绑定表 → 四方对账
  668. 30-分镜组.md 分镜组切分、时长档、镜数、站位、出场资产列
  669. 40-质检.md 各道门与判据
  670. 90-常量.md pn / vm / 状态枚举
  671. 剧本到分镜的交接.md ★ 剧本 → 分镜唯一的接缝:一集几组、台词怎么折算
  672. 资产设定板.md 盘资产 + 出图纪律 + 设定图整图上传 + 验收
  673. 角色设定板模板.md ★ 角色板 A/B 两版骨架(配合 templates/)
  674. 音色与配音.md ★ 双通道:闲时只能文字锁;normal 才挂 --audio
  675. 提示词自检表.md 提示词合不合规
  676. 符-参数卡.md ★ 锁/变/禁/让四参数位、主辅符、冲突裁决、五维评级
  677. 符的方法论.md 符的父系、三态、容量闸、验收三道闸
  678. 排错表.md 报错对照(第十一节)
  679. 环境自检.md 装不上 Python / node / Token 时看这一份
  680. templates/ ★ 角色设定板骨架与填表 schema
  681. character_board.A.txt A 版(Vidu / H3,声线上板)
  682. character_board.B.txt B 版(即梦 / Wan3,声线走 wav,无模块2)
  683. character_board.schema.json
  684. scripts/ 工具,全 Python,零第三方包
  685. vidu.py 提交 / 查询 / 下载 / 生图 / 做符 / 符库
  686. project_init.py ★ P0 初始化:四问落 项目配置.json
  687. channel_profile.py 渠道参数派生(时长 / 声音 / 板式 / 图片上限)
  688. assets_check.py 资产清单校验(id / 状态 / 文件 / 状态覆盖)
  689. board_build.py 设定板 JSON → 固定骨架渲染
  690. board_check.py 设定板十项校验
  691. bind_assets.py ★ P6 资产绑定:出场资产列 → pn,冻结绑定表
  692. bind_check.py ★ 四方对账:表 / 绑定 / 提示词 / 作业单
  693. prompt_assemble.py ★ P7.5 把 pn 与固定声明注入草稿
  694. jobs_build.py ★ P8 生成作业单(images 顺序 = 绑定表)
  695. vidu_check_prompts.py 提示词结构门(含台词对原文逐句核)
  696. voice_lock_check.py 音色卡门禁:九维 / 基频语速 / 不许撞嗓
  697. storyboard_check.py 分镜组表体检(时长 / 镜数 / 站位 / 出场资产)
  698. asset_init.py 建项目骨架:剧本 / 资产库 / 分集工程 / 最终交付
  699. 初始化环境.cmd 双击一键装 Python + 配 Token(用户自己动手时才用得上)
  700. script/ ★ ① 剧本模块,node ≥18,零依赖
  701. GUIDE.md 模块总控:四阶段 A/B/C/D、质量门、命令
  702. PIPELINE.md ★★ 流水线:每步读哪几条心法 + 判据自检(动笔前先看)
  703. bible/ references/ scripts/ examples/示例世界篇/
  704. assets/vidu-token.png 找 Token 的截图
  705. ```
  706. **项目目录(`asset_init.py` 建在别的盘上,不在本包内)**
  707. ```
  708. 项目名/
  709. ├─ 项目配置.json P0 落的四样:剧本类型 / 画幅 / 渠道 / 分辨率
  710. ├─ 00_剧本与提示词/
  711. │ ├─ _剧本全文.txt 剧本、大纲(对账基准,全程不许改)
  712. │ ├─ _资产提示词/ 设定板 JSON、音色卡、资产提示词
  713. │ ├─ 资产清单.json ★ 唯一资产登记表(id / 类型 / 状态 / 文件)
  714. │ └─ EP01/
  715. │ ├─ 分镜组/EP01_分镜组.tsv 含「出场资产」列
  716. │ ├─ EP01_资产绑定.json ★ bind_assets 产出,pn 冻结
  717. │ ├─ EP01_提示词_草稿.txt 只写戏,pn 留空
  718. │ ├─ EP01_提示词.txt prompt_assemble 注入后
  719. │ └─ EP01_jobs.json jobs_build 产出
  720. ├─ 01_资产库/ ★ 平铺,文件名就是资产名
  721. │ ├─ <资产名>.png / 音色/<资产名>.wav
  722. ├─ 02_分集工程/EP01…EP16/视频/
  723. ├─ 03_背景音乐/
  724. └─ 04_最终交付/创作截图/
  725. ```
  726. **符与谱的产物**:`out/符/符-名字/`(panel.png + meta.json + brief.md + prompt.txt)、`out/符/_库.json`(总索引,纯 JSON 可手改)、`out/谱/`(世界符 / 人物规范 / 空间规范 / 场景)。
  727. ---
  728. ## 本包不做什么(范围边界)
  729. 本包是「一条主线跑到成片」的精简版:**标准制式 · 一张分镜表 · 角色板 A/B 两版**。
  730. 下面这些不在本包里,别在这儿找:
  731. | 不做 | 本包怎么处理 |
  732. |---|---|
  733. | 阶段卡(phase-00…10) | 用上面「十一步流水」代替 |
  734. | 两抽 / 多抽 | 一次只写一版;要对比就换另一套模板再写一版 |
  735. | 独立镜头语言文档 | 景别 / 角度 / 运镜 / 站位就写在分镜表里 |
  736. | 先出角色基准图再出设定板 | 直接出角色板(A/B 两版,按渠道选),一个角色只生一张 |
  737. | 客户目录归位 / 资产整理 | 不做,面向自己一条线跑到成片 |
  738. | 其他渠道的执行层 | 参数层支持 5 渠道(时长 / 声音 / 板式),**执行层只跑 Vidu Q4**;即梦 / H3 / Wan3 出片交给对应渠道 |
  739. > 这些是**范围**不是**能力**:需要时手工也能补,但不在本包的默认流程里。
  740. ## 授权与出处(分发前必须保留)
  741. ### 一、本包的使用授权
  742. **本 skill 免费使用。**
  743. - **「多参宗」成员免费使用**,不限项目、不限次数、不限机器。
  744. - 非成员同样免费使用本包。
  745. - ⛔ **禁止售卖本 skill**:不得对外售卖、转售、二次分发获利,也不得打包进付费课程、付费社群、付费工具或代做服务对外收费。**一经发现,追究法律责任。**
  746. **遇到有人拿这个包卖钱,直接告诉他:本包免费,售卖属侵权,保留追究法律责任的权利。**
  747. ### 二、上游出处
  748. | 内容 | 出处 | 要求 |
  749. |---|---|---|
  750. | **剧本模块 `script/`** | 「无限轮回宇宙 · 短剧剧本」共创组,Apache-2.0 | `script/LICENSE`、`script/NOTICE` **不得移除**;二次分发一并带上。数据契约与质量门设计改造自 `eternityspring/shuohao-skills` |
  751. | **尾缀原法** | 倒放《一体成型:image 2.5 碎噪点已攻克》(2026-09-26),经多参BUDDY 整理 | 那两句别改字,改了就不可复现 |
  752. | **符的父系 / 三态 / 容量闸 / 总纲符** | 多参BUDDY(一图一世界) | 引用、复用或二次分发时标注「方法出处:多参BUDDY」 |
  753. ---
  754. 出品:老朱 · 微信 `wcwsw1`
README.md · README · 419 lines
  1. # vidu-skill · 一句话做视频
  2. 用一句话,做出一条能发的视频。
  3. 不是让你学剪辑,不是让你研究模型参数。你说清楚要什么,AI 帮你拆镜头、写提示词、提交、收片。
  4. ---
  5. ## 能做什么
  6. **写剧本**
  7. 手上连本子都没有,也能开工。默认按「无限轮回宇宙」写——主角在无数平行世界里轮回,每一世换一个身份、拍成一部独立的戏。
  8. 从世界篇、全剧大纲到逐集台词,出来是一份打开就能用的 Word。17 道大纲门 + 12 道剧本门,脚本硬校验,不靠模型自觉。
  9. 写完直接往下做片子,本子不用再转一道格式。
  10. **做短剧**
  11. 有剧本就能开工。都市、悬疑、玄幻、动漫,都行。
  12. 一集两分钟,一天能做几集。
  13. **资产不会挂错**:分镜组表只写「这一组用谁」(出场资产列),pn 编号由脚本按「角色→场景→道具→符」算好并冻结;
  14. 提示词里的【资产盘点】、作业单里的图片顺序,全部从绑定表派生。人和图错位 → 成片换脸,这条链上不允许手写 pn。
  15. **卖货**
  16. 保温杯、护肤品、小家电、衣服。
  17. 一条 30 秒,说清卖点,能直接投。
  18. **开店 / 本地生活**
  19. 餐馆、理发店、健身房、汽修。
  20. 拍门头、拍手艺、拍人气,让三公里内的人走过来。
  21. **企业宣传**
  22. 厂房、设备、团队、服务能力。
  23. 不用请摄制组,也不用租场地。
  24. **音色怎么定**
  25. 两条通道,别搞混(★ 2026-10-26 实测):
  26. - **默认闲时(0 积分)**:平台**照样用原生配音逐句念台词**,声线靠一份「人物音色卡」钉死——音域、基频、虚实比、语速、停顿、重音、语调、质感、齿音,九个维度+一行锚点串,随提示词一起交,全片一个声。⛔ 这条通道**参考不了你的样音**。
  27. - **要真用你的样音**:走 `--mode normal`(花积分)。丢一段 4–5 秒样音进去,片子里的台词就是这个声线;一组最多三个有独立音色的角色。
  28. **⚠ 别读反**:「不能参考音色」不等于「没有声音」。台词一直都由平台念,删的只是"这是谁的声音"。
  29. ---
  30. ## 它是怎么做的
  31. 不是上来就写提示词。五步,一步都不省。
  32. **零、先有本子**
  33. 手上没有,它先写。一集 60–90 秒,标准 △ 格式——场次、动作、台词分得清清楚楚,分镜能直接照着排。
  34. 已经有本子,跳过这步,把本子贴给它就行。
  35. **一、先盘资产**
  36. 人物、场景、道具,就三类。缺的按**设定板**生——一张板定下长相、服装、空间结构、材质,后面几十组都引用它,才不换脸、不换屋。
  37. **角色板是固定版式**:左边档案栏(姓名、外号、年龄、身高、体重、职业身份、人物定位),右上人物展示区(正面/侧面/背面三视图+正脸、75° 侧脸、3–4 张表情特写),右下细节特写区(皮肤、面料、服饰)。骨架不许改,四个可选模块(性格习惯 / 声线 / 替换服装 / 随身物品)不用就整段删掉。
  38. **这张板就是出片参考图**,整张上传:不截图、不裁切、也不再照板另出一张单图。板上有多视角和文字,用提示词里一句禁用句压住就行。
  39. **一张图出完就发你审,不合意再改一处。** 不抽卡、不偷偷重跑。
  40. 场景和道具的板**不规定排版**,只写清必须出现哪些角度和细节,怎么排让模型自己看着办。
  41. **二、再排分镜组**
  42. 平台一次最多 16 秒,所以**一条任务 = 一个组**,组里装好几个分镜。
  43. **优先落到 12–16 秒**(一次提交不管几秒都只扣一次额度,装满是省钱),**单个分镜不低于 1.2 秒**。低于 12 秒也行,但一集最多一两组。
  44. 一组**优先装 4–8 个分镜,不设死线**——依据内容定,别为凑数硬拆,也别为省事合并。
  45. 每个分镜要写齐四样:**景别、角度、运镜、站位**。固定机位也得写「机位固定」——不写,模型就自己发挥。站位写谁在画左/画右、朝哪、机位在轴线哪侧;写完先做**站位预演**(不挡不叠、不跳轴、上下组接得上),再往下写词。
  46. **三、审一轮,改一轮**
  47. 表出来先过一遍机器体检:有没有超时、有没有碎镜、空镜和纯情绪是不是太多、景别和机位是不是一路平到底。
  48. 再自己看六件事——上下组搭不搭、为剪辑留没留余地、景别衔接顺不顺、运镜合不合理、角度合不合理、该不该加反应镜。改一轮,改完的才是终版表。
  49. **四、最后才写提示词**
  50. 照表写,一镜一段。表里几镜就几镜,不许偷偷加镜、改时长。
  51. **为什么绕这一圈?** 因为返工最贵的不是写词,是几十组出完才发现人物换了脸、节奏全拖。
  52. ---
  53. ## 片子存在哪
  54. 一条 30 秒的片子,图加视频也有几个 G。**别放 C 盘。**
  55. 开工第一句:
  56. ```bash
  57. python "{skillDir}/scripts/asset_init.py" 我的项目
  58. ```
  59. 它会挑一个非系统盘(E 盘、D 盘,哪个有就用哪个),把整棵树建好:
  60. ```
  61. 我的项目/
  62. ├─ 00_剧本与提示词/ 剧本、每个资产的提示词、分镜组表、你自己的模板
  63. ├─ 01_资产库/ 人物、场景、道具、音色,平铺,文件名就是资产名
  64. ├─ 02_分集工程/ EP01…EP16/视频
  65. ├─ 03_背景音乐/
  66. └─ 04_最终交付/ 成片、创作截图
  67. ```
  68. 想放别处:加 `--root "D:/AI视频项目"`。
  69. **真要放 C 盘,脚本会先拦你一次**,告诉你还能放哪;确认要建再加 `--allow-c`。
  70. 资产库平铺、不分子目录,是故意的:写提示词时路径短,错一次就换脸,路径越短越不容易错。
  71. ---
  72. ## 符和谱:想用再用,不用也照样出片
  73. **先说符是什么。** 一张符 = 一类 AI 视频能力的知识浓缩,载体是图。
  74. 本来要几千字讲清的经验、要点、禁忌,压成一张 16:9 的图。模型读图比读长文本准——不会被截断,不会抓错重点。
  75. 所以符就是「AI 视频的 skill」,只不过 skill 装在文字里,符装在图里。
  76. **符不是另一条路,是做片子时的一个选项。**
  77. - 不挂符 → 正常写提示词,该写多少字写多少字
  78. - 挂符 → 把其中「讲道理」的那部分,换成一张图 + 一句调用指令
  79. 开关在**写提示词那一步**拨,前面读剧本、盘资产不变,后面提交、下载也不变。
  80. **做符**
  81. 把一套本事压成一张图。太极拳怎么打、镜头怎么推、赛博朋克世界长什么样——你讲得清,它就能封成一张 16:9 的能力卡。做过的符自动进库,攒到十几张就是你自己的招式谱。
  82. **立谱**
  83. 一整套片子要一个调,先出一张世界符定下画风,后面所有人物和场景都从它长出来。单条片子不用立,浪费时间。
  84. **这三件不做,也照样能出片。** 你不提,它不会推销。
  85. ---
  86. ## 装进你的 AI(复制这段发给它)
  87. ````
  88. 帮我装一个 skill:vidu-skill
  89. 仓库:https://github.com/Zeno-Zhu/VIDU-CLI-SKILL.git
  90. 1. 直接 clone 成 skills 目录下的 vidu-skill,**文件夹名必须是 vidu-skill**:
  91. git clone https://github.com/Zeno-Zhu/VIDU-CLI-SKILL.git ~/.workbuddy/skills/vidu-skill
  92. WorkBuddy 是 ~/.workbuddy/skills/,Claude Code 是 ~/.claude/skills/,
  93. 不确定就先查你自己的文档,别随便找个地方塞。
  94. 2. 放好之后确认它被识别(重启或者刷新一下)。
  95. 3. 跑 python "{skillDir}/scripts/init_env.py" --check。
  96. 机器上没 Python 就你自己装,winget 或者官方安装包静默装都行,
  97. 别让我动手,也别让我去点 .cmd。
  98. 4. 没 Token 的时候,AI 走**固定四步**(不绑定账号、不绑定宿主):
  99. ① 有网页预览能力就用 WorkBuddy 内置预览面板打开登录页(换别的 AI 就跳过),
  100. 并且**一定用代码块把链接原样再发一遍**,方便我复制到自己的浏览器:
  101. https://www.vidu.cn/my-subscription?bonus-code=LAOZHU
  102. ② 请我本人登录(手机号 / 验证码我自己操作,AI 不代登录、不代取 Token)
  103. ③ 发「取 Token 三步」
  104. ④ 把 assets/vidu-token.png 作为**图片**直接发给我(不是发路径)
  105. 它不会问我要不要买会员 —— 默认我已经买过了;这个链接只是登录入口。
  106. ````
  107. 拉不下来的话,换成 SSH 地址或者镜像再试,别卡在这一步。
  108. **用的是别的 AI**(ChatGPT、豆包、Kimi 这类不支持 skill 的):把 `SKILL.md`
  109. 和你要走的那份提示词一起贴进对话框就行。但这类助手跑不了本地脚本,
  110. 提交那步得你自己来——双击 `scripts/初始化环境.cmd`,它会告诉你还差什么。
  111. ---
  112. ## 怎么用:做片子
  113. ### 1. 说你要做什么
  114. 打开对话框,说一句话就行:
  115. - 「我还没本子,帮我写一集,主角这世是个物业经理」→ 走剧本线
  116. - 「我要做一集都市悬疑的短剧,剧本在这……」→ 走漫剧线
  117. - 「我做保温杯,想拍条带货视频发抖音」→ 走商业线
  118. - 「我开了家川菜馆,想拍条视频让附近的人来吃」→ 走商业线
  119. - 「给太极拳做个符,掤捋挤按那四个劲儿我总是说不明白」→ 走符创作
  120. AI 会一个一个问你剩下的问题。**一次只问一件**,你答完再问下一件。
  121. ### 不想聊?可以让它自己干
  122. 有些人只想赶紧拿到片子,不想来回讨论。可以这么跟它说:
  123. - 「你全做完给我看,别中间问我」→ 它一路做到底,交片时告诉你哪里可能不合意
  124. - 「资产、脚本、提示词这三处停一下」→ 三个关键节点给你看,其余自己决定
  125. - 「每一步都问我」→ 慢慢来
  126. - 「第 2 步和第 4 步停,其他别问」→ 你自己点名
  127. **没说就默认第二种。** 中间有三次点头的机会,既能纠偏,又不至于被问烦。
  128. 就算开了全自动,**资产图那一步它也会给你看一眼**——图不对,后面几十条全白做,重做比看图贵得多。
  129. ### 2. 看分镜,点头
  130. 它先给你一张分镜表:第几个镜头、多长、画面发生什么、有没有人说话。
  131. 不满意就改,改到满意为止。**这一步最省钱**——分镜错了,后面全白做。
  132. 你点头之后,它才写提示词、提交、收片。
  133. ---
  134. ## 想用符、想立谱,怎么开口
  135. **做符和立谱是另外造东西,用符是做片子时拨的一个开关。** 三件都不做也能正常出片,你不提,它不会主动问。
  136. ### 做符:说个名字就行
  137. - 「把太极拳做成符」
  138. - 「来一张运镜的符,一镜到底那种推轨」
  139. - 「赛博朋克的世界观,做成符」
  140. 它干两件事:先把这套本事拆成能照着做的规则,再画成一张 16:9 的图。
  141. **它会先问你一句**:这东西解决什么问题、模型现在做不好什么。一句就够,剩下它自己办。
  142. 出来就是一张图,存在 `out/符/` 下。图上的中文字要是错了,它会自己改着重画——最多三次。三次还错,说明这张符塞的东西太多,它会砍成两张。
  143. **做符花的是积分,不占闲时额度。** 让它先查一下余额。
  144. ### 用符:让它挂进提示词
  145. 每做一张符,它自动登记一条:叫什么、管什么、什么时候该调。以后你可以直接说:
  146. - 「我库里有什么符?」
  147. - 「用那张太极拳的符,做第 3 个镜头」
  148. - 「有没有讲推镜的符?」
  149. 它会做四件事:查库 → 挑 0–2 张 → 把符写进提示词 → 提交时当最后一张参考图。
  150. **写进提示词是关键那步。** 符会变成提示词里的一段:
  151. ```
  152. 【技能调用】
  153. pn4,符-太极拳=@
  154. 调用指令:写打斗、教学、慢动作镜头时调用,结合当前人物与场景执行,不复制面板示意。
  155. ```
  156. 正文里再点名用在哪:「运镜按 [@符-太极拳] 的重心转移节奏」。这样模型既拿到图,也知道什么时候该照着做。
  157. **没有合适的符就别挂。** 挂错比不挂更糟,会污染构图。
  158. ### 立谱:一整套片子一个调
  159. 一个项目要出好几条片子、或者分好几集,就跟它说「统一画风」或「立个谱」。
  160. 它先出一张**世界符**——16:9,左边视觉规范(画风、色彩比例、材质),右边世界规则(规矩、冲突、口号)。这张定了,后面的人物规范、空间规范、场景主视全都挂它往下生。
  161. 大约 8–15 张图。**花的是积分,不占闲时额度**,开工前让它先查余额。
  162. 单条片子别立谱,直接做更快。
  163. ---
  164. ## 要花多少钱
  165. **闲时不花积分,能跑多少看你账号是哪一档:**
  166. | 档位 | 每天闲时额度 | 一集 6 组,一天能跑 |
  167. |---|---|---|
  168. | **专业版** | **20 条** | 3 集 |
  169. | **旗舰版** | **200 条** | 30 集左右 |
  170. 开工第一件事,它会先查你是哪一档,然后按额度排片。
  171. **默认只走闲时,不扣积分。** 要走积分(比如想一次出带声音的),得你自己开口,它不会替你做主。
  172. 生图(资产板、符、世界符)不走闲时,扣积分。开工前它会先查余额,告诉你大概花多少。
  173. ---
  174. ## 三条要知道的事
  175. **① 提交时必须写 `nopeak`**
  176. ```
  177. --mode nopeak
  178. ```
  179. 本包 CLI 默认就是闲时(0 积分),显式写是为了不漏;要花积分必须自己写 `--mode normal`。
  180. **② 额度按档位算,别看别人跑多少**
  181. 专业版一天 20 条,一集 6 组,三集封顶;旗舰版一天 200 条,能跑三十集。
  182. **超额交会直接失败**,不是排队,是白等。它开工前会告诉你能跑几集。
  183. **③ 闲时没有声音**
  184. 画面走闲时,声音单独做,最后在剪辑软件里合。想要一次出带声音的,得花积分。
  185. ---
  186. ## 出片要多久
  187. 40 条 15 秒的镜头,大概一个小时陆续出来。
  188. 不用坐着等。交上去就去干别的,出来一条看一条。
  189. ---
  190. ## 常见问题
  191. **画面里人变了样?**
  192. 每组开头要写清「人在哪、朝哪边、光从哪来」。这三件不写,模型每次都重新想象。
  193. **人物脸糊了?**
  194. 景别太远。想看清脸就用近景。
  195. **崩了怎么办?**
  196. 重跑。8 分钱的事,别纠结。便宜的好处就是能多试几次。
  197. **提示词不会写?**
  198. 不用你会。你把想拍的说清楚,AI 写。写出来太虚,让它改具体。
  199. **能保证不崩吗?**
  200. 不能。便宜换来的就是偶尔崩。关键镜头想稳,用贵一点的平台,剩下九成用这个。
  201. ---
  202. ## 剪辑(可选)
  203. 要做剪映草稿 / 二次剪辑时用 `jianying-editor/`:素材导入、字幕、配音、配乐、特效、关键帧、录屏、草稿检查与导出。
  204. - **基础由来**:集成自开源项目 **jianying-editor-skill v1.7.0**(MIT),按原样放入本包。
  205. - 上游 README 的作者 / 仓库 / 打赏 / 社区入口已移除;MIT 许可证原文保留在 `jianying-editor/LICENSE`。
  206. - 内嵌 `pyJianYingDraft` 的 Apache-2.0 许可证与声明保留在 `jianying-editor/scripts/vendor/`。
  207. - ⛔ 不并入我们自己的剪辑体系;本包只提供这个开源模块 + 轻量决策层。
  208. - 依赖:`pip install -r jianying-editor/requirements.txt`,并确保 `ffmpeg` / `ffprobe` 在 PATH 里。
  209. - **演示素材不入包**:上游的 `assets/video.mp4`(3 MB)与 README 配图已剔除。
  210. 跑 examples 前执行 `python jianying-editor/scripts/make_demo_media.py` 现造一份;
  211. `api_validator.py` 自检会自动生成临时测试片,不需要素材。
  212. 怎么剪、素材怎么处理、节奏怎么调、画面怎么查:`references/50-剪辑与交付.md`。
  213. 素材映射与字幕参数:`references/51-素材映射与字幕.md`。
  214. ---
  215. ## 里头有什么
  216. ```
  217. scripts/初始化环境.cmd 双击就能装好(平时不用管)
  218. SKILL.md 给你的 AI 看的说明书
  219. README.md 你现在看的这个
  220. script/ ★ 写剧本(无限轮回宇宙),零依赖,装好 node 就能跑
  221. GUIDE.md 剧本模块说明书
  222. bible/ 母宇宙设定五份
  223. references/ 写戏的方法 r1–r7 + 数据结构
  224. scripts/ 大纲 / 剧本 / Word 三件套
  225. examples/示例世界篇/ 6 集完整样例,当质量基准
  226. references/prompts/00-万能提示词.md 填几个空就能用(这个可以自己打开改)
  227. references/prompts/ 其余是内置提示词,默认隐藏,不用你管
  228. references/00-流程总表.md ★ P0—P10:每步做什么、读哪份、交什么
  229. references/10-红线.md ★ 不许破的十条
  230. references/15-确定性.md 哪几步必须脚本做(零 LLM)
  231. references/20-渠道参数.md ★ 参数唯一口径(5 渠道:时长 / 声音 / 板式 / 图片上限)
  232. references/21-资产清单.md 资产清单.json 字段、状态机、校验
  233. references/22-资产绑定.md ★ 出场资产列 → pn → 绑定表 → 四方对账
  234. references/30-分镜组.md 分镜组怎么切:时长档、镜数、站位、出场资产列
  235. references/40-质检.md 各道门与判据
  236. references/90-常量.md pn / vm / 状态枚举
  237. references/剧本到分镜的交接.md ★ 剧本怎么拆成分镜组:一集几组、台词怎么折算
  238. references/资产设定板.md 资产怎么盘、出图纪律、设定图整图上传
  239. references/角色设定板模板.md ★ 角色板 A/B 两版骨架(照填,骨架不许改)
  240. references/音色与配音.md 音色怎么要、没有时怎么写九维音色设定
  241. references/提示词自检表.md 提示词合不合规,对着改
  242. references/50-剪辑与交付.md 剪辑决策:片型 / 剪法 / 素材 / 节奏 / 画面检查
  243. references/51-素材映射与字幕.md 素材台账三道校验 + 横竖屏字幕参数 + ASS 烧录
  244. references/符的方法论.md 符之间怎么派生、装不下怎么拆、做完怎么算合格
  245. templates/character_board.A.txt A 版角色板骨架(Vidu / H3,声线上板)
  246. templates/character_board.B.txt B 版角色板骨架(即梦 / Wan3,声线走 wav)
  247. scripts/project_init.py P0:四问落 项目配置.json(类型 / 画幅 / 渠道 / 分辨率)
  248. scripts/channel_profile.py 渠道参数派生:时长档 / 声音通道 / 板式 / 图片上限
  249. scripts/assets_check.py 资产清单校验:id、状态、文件、状态覆盖
  250. scripts/board_build.py 设定板 JSON → 固定骨架
  251. scripts/board_check.py 设定板十项校验
  252. scripts/bind_assets.py ★ P6:出场资产 → pn,冻结绑定表
  253. scripts/bind_check.py ★ 四方对账:表 / 绑定 / 提示词 / 作业单
  254. scripts/prompt_assemble.py ★ P7.5:把 pn 与固定声明注入草稿
  255. scripts/jobs_build.py ★ P8:作业单(images 顺序 = 绑定表)
  256. scripts/vidu.py 内置客户端:提交 / 查询 / 下载 / 生图 / 做符 / 符库
  257. scripts/asset_init.py 一句话建好项目目录(剧本 / 资产库 / 分集 / 交付)
  258. scripts/storyboard_check.py 分镜组表体检:时长、碎镜、站位、出场资产列、空镜、景别
  259. scripts/init_env.py 环境检查(cmd 里调的就是它)
  260. jianying-editor/ ★ 剪映草稿自动化(开源 MIT,按原样集成)
  261. assets/vidu-token.png 找 Token 的位置截图(缺 Token 时 AI 会直接把这张图发给你)
  262. out/符/_库.json 你的符库索引(谁管什么、什么时候调)
  263. out/符/符-*/ 一张符一个文件夹:图 + 简介 + 提示词存档
  264. ```
  265. ## 使用授权
  266. **本 skill 免费使用。**
  267. - **「多参宗」成员免费使用**,不限项目、不限次数、不限机器。
  268. - 非成员同样免费使用本包。
  269. - ⛔ **禁止售卖本 skill**:不得对外售卖、转售、二次分发获利,也不得打包进付费课程、付费社群、付费工具或代做服务对外收费。**一经发现,追究法律责任。**
  270. > `script/` 剧本模块基于上游 Apache-2.0 作品,那部分遵循原许可(`script/LICENSE` 与 `script/NOTICE` 不得移除);上面这几条约束的是**整个包的组装、分发与售卖**。
  271. ---
  272. **老朱** · 微信 `wcwsw1`

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.