@ninkch/dsh-infinite-canvas 0.19.2 → 0.19.3

package/README.md

@@ -96,6 +96,56 @@ Assets are shared with the canvas: the characters, trees, furniture and building
 
 Full walkthrough — asset tabs, gizmo, keyboard map, shots and export: **[User guide → 3D Director Stage](./docs/guide.en.md#8-3d-director-stage)**.
 
+## Craft page: director / genre / delivery form / look
+
+The third tab of the right sidebar decides **how the whole piece is shot**. It is not a prompt template — it is a binding constraint that gets composed into every script, storyboard, image and video generation. **There are no dropdowns on the page**: every option is an icon tile; click to select, click again to clear.
+
+### What each layer owns
+
+| Layer | Count | Decides | Why it needs its own layer |
+|---|---|---|---|
+| **Director** | 24 | Camera language, lighting, cutting rhythm, style parameters | It constrains the shot's camera fields, the keyframe, and the video's camera move at once — the least replaceable decision in the whole piece |
+| **Genre** | 21 narrative / 10 sector | Pressure mechanics, audience payoff, scene granules, episode hooks | The same "revenge" premise is fragmented neon under Wong Kar-wai and hard-lit slow motion under Tsui Hark; folding them together poisons both |
+| **Delivery form** | 8 | Structure blocks, ASL floor, rhythm, quality bar | It decides "short drama vs cinematic texture vs commercial", which is orthogonal to genre |
+| **Look** | 9 | Imaging base, material, render texture | 2D thick paint / guoman 3D / game CG are imaging domains, not directors; mixing them into the director layer makes "how to cut" fight "what it looks like" |
+
+**Directors (24)**: Chinese 8 (Wong Kar-wai, Zhang Yimou, Hou Hsiao-hsien, Bi Gan, Tsui Hark, Lu Yang, Yuen Woo-ping, Wu Ershan) · Japan/Korea 2 (Kurosawa, Park Chan-wook) · Western 14 (Spielberg, Hitchcock, Kubrick, Scorsese, Fellini, Bergman, Tarkovsky, Nolan, Villeneuve, Fincher, Refn, Malick, Michael Mann, Coen Brothers).
+
+**Delivery forms (8)**: Short drama · Cinematic texture · Commercial · Documentary · Music video · Trailer · Explainer · Interview.
+
+- A **short drama** is a self-contained 60–180 s unit and **covers both single episodes and multi-episode series** — a series is just episode after episode, so there is no separate "series" form.
+- **Cinematic texture** is a *texture* spec, not a feature-length one: it constrains how each shot must be made to read as cinema (ASL floor 1.5 s, 24 fps, motivated light, real materials), and its duration tiers stop at 30–300 s. The reason is practical — **a video model emits only 3–8 s per clip** (5 s by default here), so "a 120-minute film" can only be hundreds of clips stitched together.
+- **Commercial** merges 宣传片 / 广告片 / 产品片 — near-identical needs, split internally by block ratios instead of three separate cards.
+
+### Aspect ratio is not decided here
+
+Vertical, horizontal, square or widescreen all work with any delivery form — **aspect and resolution are chosen on the video node at generation time**. Vertical delivery is common for short drama, but that is a distribution choice, not a craft spec; **a short drama can equally be shot horizontal and to a cinematic standard**.
+
+### Where it is injected
+
+| Node / capability | What it receives |
+|---|---|
+| Script node | Genre cards + the lens's narrative/rhythm/performance sections + the form's structure blocks |
+| Storyboard node | The lens's camera language, lighting, style parameters and shot checklist + the form + the camera-move dictionary |
+| Image node | A style lock: style parameters + look imaging/material + genre granules + three negative lists |
+| Video node | Same (also appended when an upstream storyboard feeds it, without breaking the structured format) |
+| Character/scene/prop sheets | The lens's lighting and colour + the look card |
+| Bible AI draft | Same as script |
+
+**With all four layers empty nothing is injected** — existing projects behave exactly as before.
+
+### Three buttons
+
+- **Preview** — shows the assembled slice and its byte size
+- **To bible** — writes the style summary into the bible's style field, so the chat side reads it too
+- **Clear** — resets all four layers
+
+### It works from the chat too
+
+The configuration is stored on the project document (same sync mechanism as the series bible), so **the chat side reads the same selection the panel shows**. Say "shoot this in Wong Kar-wai's style" in chat and the agent calls `canvas_list_skills` to see what craft exists, then `canvas_skill_pack` to pull the matching slice — **the same slice the canvas itself uses**.
+
+Full walkthrough — **[User guide → Craft page](./docs/guide.en.md#9-craft-page-four-layer-console)**.
+
 ## How it works
 
 ```mermaid

package/README.zh-CN.md

@@ -96,6 +96,56 @@
 
 完整操作（资产页签、操作轴、快捷键表、分镜、导出）：**[操作手册 → 3D 导演台](./docs/guide.zh-CN.md#8-3d-导演台)**。
 
+## 技能页：导演 / 题材 / 类型规格 / 影调
+
+右栏第三个页签「技能」决定**整部片怎么拍**。它不是提示词模板，而是会被自动拼进每一次剧本、分镜、图片、视频生成的硬约束。**页面里没有任何下拉框**，全部是图标瓦片，点一下选中、再点一下取消。
+
+### 四层各管什么
+
+| 层 | 数量 | 决定 | 为什么单独一层 |
+|---|---|---|---|
+| **导演** | 24 | 镜头语言、灯光色彩、剪辑节奏、风格参数 | 它同时约束分镜的机位字段、图片关键帧、视频运镜——整部片最不可替换的决策 |
+| **题材** | 叙事 21 / 行业 10 | 压力机制、观众回报、场面颗粒、集尾钩子 | 同一个「复仇打脸」，王家卫拍是抽帧暧昧，徐克拍是凌厉升格；混进导演层会互相污染 |
+| **类型规格** | 8 | 结构块、平均镜长下限、节奏、质量档 | 它决定「这是短剧、电影质感还是商业片」，与题材正交 |
+| **影调** | 9 | 成像底层、材质、渲染质感 | 2D 厚涂 / 国漫 3D / 游戏 CG 是成像域，不是导演；塞进导演会让「怎么剪」和「长什么样」打架 |
+
+**导演（24 位）**：华语 8（王家卫、张艺谋、侯孝贤、毕赣、徐克、路阳、袁和平、乌尔善）· 日韩 2（黑泽明、朴赞郁）· 欧美 14（斯皮尔伯格、希区柯克、库布里克、斯科塞斯、费里尼、伯格曼、塔可夫斯基、诺兰、维伦纽瓦、芬奇、雷弗恩、马力克、迈克尔·曼、科恩兄弟）。
+
+**类型规格（8 种）**：短剧 · 电影质感 · 商业片 · 纪实 · 音乐视频 · 预告 · 解说 · 访谈。
+
+- **短剧**是单集 60–180 秒的自足单元，**同时覆盖单集与连续多集**——一部剧就是一集一集往下做，不需要单独的「连续剧」规格。
+- **电影质感**是**质感规格，不是长片规格**：它约束每一镜怎么做才像电影（ASL 1.5 秒以上、24 帧、动机光、真材质），成片长度档只到 30–300 秒。原因很实际——**AI 视频模型单次只出 3–8 秒**（本插件默认 5 秒），所谓「一部 120 分钟的电影」只能是几百上千个片段接起来。
+- **商业片**把「宣传片 / 广告片 / 产品片」合成一张卡——它们是相近需求，靠段位配比内部分流。
+
+### 画幅不在技能里决定
+
+横屏、竖屏、方屏、宽银幕都能用任何类型规格——**画幅与分辨率是视频节点生成时的选项**。短剧竖屏投放很常见，但那是发行选择，不是创作规格；**短剧同样可以横屏、可以按电影标准拍**。
+
+### 注入到哪
+
+| 节点 / 能力 | 拿到的内容 |
+|---|---|
+| 剧本节点 | 题材卡 + 导演的叙事/节奏/表演节 + 类型规格的结构块 |
+| 分镜表节点 | 导演的镜头语言/灯光/风格参数/拍摄清单 + 类型规格 + 运镜词典 |
+| 图片节点 | 「风格增强锁」：风格参数 + 影调成像材质 + 题材颗粒 + 三份负向词 |
+| 视频节点 | 同上（有上游分镜表时也追加，不打断结构化字段） |
+| 角色/场景/道具设定图 | 导演的灯光色彩 + 影调卡 |
+| 设定集 AI 草稿 | 同剧本 |
+
+**四层全空时什么都不注入**——老项目行为完全不变。
+
+### 三个按钮
+
+- **预览**：显示当前配置注入到剧本的切片全文与字节数
+- **写设定集**：把风格摘要写进设定集的「风格基调」，对话侧也能读到
+- **清空**：四层归零，生成行为回到默认
+
+### 对话侧同样生效
+
+配置存在项目文档里（与设定集同一套同步机制），所以**对话侧读得到、面板上也看得到**。在对话里说「用王家卫的风格拍这段」，Agent 会调 `canvas_list_skills` 看有哪些技能、再调 `canvas_skill_pack` 取对应切片——**和画布自生成用的是同一套口径**。
+
+完整说明见 **[操作手册 → 技能页](./docs/guide.zh-CN.md#9-技能页四层创作控制台)**。
+
 ## 工作方式
 
 ```mermaid

package/assets/canvas-director/SKILL.md

@@ -0,0 +1,235 @@
+---
+name: canvas-director
+description: 画布导演套件：24 位导演透镜（管镜头语言）、21 个叙事题材 + 10 个行业题材（管压力机制与观众回报）、8 种类型规格（管结构块/ASL/节奏/质量档；画幅不归它管）、9 种影调质感（管成像与材质）、运镜词典与打斗节奏。在无限画布里写任何剧本、分镜、图片提示词、视频提示词之前加载本技能，用 canvas_skill_pack 取对应切片。Load before writing any script, storyboard, image or video prompt on the canvas.
+---
+
+# 画布导演套件
+
+本技能是**创作控制层**，管「怎么拍 / 讲什么 / 按什么规格交付 / 长什么样」。
+
+和其他三份的关系：
+
+| 技能 | 管什么 | 什么时候读 |
+|---|---|---|
+| `canvas-studio` | 画布操作：建项目、写节点、触发生成 | 任何时候先读 |
+| `canvas-craft` | 创作方法论：剧本四要素、分镜六要素、提示词规范 | 写剧本 / 拆分镜前 |
+| `canvas-layout` | 节点布局纪律 | 批量建节点前 |
+| **`canvas-director`（本技能）** | **导演透镜 / 题材 / 类型规格 / 影调 / 运镜** | **写任何提示词前** |
+
+**优先级（冲突时按此裁决）**：`用户显式指令 > 导演透镜 > 类型规格（仅单镜时长与结构上它压过透镜）> 题材 > 影调 > 技能默认`
+
+---
+
+## 一、四层结构
+
+```
+L1 导演透镜   单选 24   → 镜头语言 / 灯光色彩 / 剪辑节奏 / 风格参数      「怎么拍」
+L2 题材标签   多选      → 压力机制 / 观众回报 / 场面颗粒 / 集尾钩子      「讲什么」
+   叙事题材 21（叙事类类型规格时用）
+   行业题材 10（宣传/广告/产品类时用）
+L3 类型规格   单选 8    → 结构块 / ASL 下限 / 节奏 / 质量档            「按什么规格交付」
+L4 影调质感   单选 9    → 成像底层 / 材质 / 渲染质感（默认跟随导演）       「长什么样」
+```
+
+**八种类型规格**：短剧 · 电影质感 · 商业片 · 纪实 · 音乐视频 · 预告 · 解说 · 访谈。
+
+- **短剧**＝单集 60–180 秒的自足单元，**同时覆盖单集与连续多集**（一部剧就是一集一集往下做，不需要单独的「连续剧」规格）。质量要求按电影标准，不按短视频标准。
+- **电影质感**＝**质感规格，不是长片规格**。它约束每一镜怎么做才像电影（动机光、真材质、成立景深、24 帧），成片长度档只到 30–300 秒——因为 AI 单次只出 3–8 秒，写一个 120 分钟的档是假的。要长片就按集按段推进，本规格负责每段都过电影线。
+- **商业片**＝宣传片 / 广告片 / 产品片合并（相近需求，靠段位配比内部分流，不再拆三张）。
+- **画幅不归任何一层。** 横屏、竖屏、方屏、宽银幕都能配任何类型规格；**画幅与分辨率在视频节点生成时选**。短剧竖屏投放是发行选择，不是创作规格——短剧同样可以横屏、可以按电影标准拍。
+
+为什么这样分：
+
+- **导演独占第一层**：它同时约束分镜的 camera 字段、图片关键帧、视频运镜——是整部片最不可替换的决策。
+- **题材与导演分开**：同一个「复仇打脸」，王家卫拍是抽帧暧昧，徐克拍是凌厉升格。混一层会互相污染。
+- **类型规格独立**：它决定结构块、ASL 下限与质量档，和题材是正交的两个轴。**画幅不属于任何一层**——横竖屏是视频节点生成时的选项，不是创作规格。短剧可以竖屏也可以横屏，都要按电影标准拍。
+- **影调独立**：2D 厚涂 / 国漫 3D / 游戏 CG 是**成像域**，不是导演。塞进导演会让「怎么剪」和「长什么样」打架。
+- **运镜不独立成层**：运镜是导演的语言，独立成层会出现「王家卫 + 摇镜」的自相矛盾。它作为卡内数据存在（`moves/`），只被透镜与类型规格引用。
+
+---
+
+## 二、数据在哪
+
+```
+assets/canvas-director/
+├── manifest.json    五层索引：lenses / genres / industries / forms / looks
+├── pack.js          切片纯函数（Host 与 Client 同源）
+├── lenses/          24 份导演透镜（每份 14 小节 + 风格参数 YAML）
+├── genres/          21 份叙事题材卡
+├── industries/      10 份行业题材卡
+├── forms/           8 份类型规格卡（含 spec 数值块：durations / asl_floor_s / asl_target_s / platforms）
+├── looks/           9 份影调质感卡
+└── moves/           camera-moves.md 运镜词典 / fight-rhythm.md 打斗节奏
+```
+
+每张小节前有 `<!-- slice:story shot prompt assets -->` 标记，声明它属于哪类生成。
+
+---
+
+## 三、先用工具取切片（不要自己读整份文件）
+
+**`canvas_list_skills`** —— 开始画布工作前先调它。它会告诉你：
+- 本插件提供的 4 份技能及各自什么时候用；
+- 四层技能包的完整清单（每层有多少张、都有哪些 id 与名称、各自一句话定位）；
+- 当前项目已经选定的配置（导演 / 题材 / 类型规格 / 影调）。
+
+**`canvas_skill_pack`** —— 真正取切片：
+
+```
+canvas_skill_pack({ projectId, kind: 'script' })
+canvas_skill_pack({ projectId, kind: 'storyboard' })
+canvas_skill_pack({ projectId, kind: 'prompt' })
+canvas_skill_pack({ projectId, kind: 'assets' })
+```
+
+返回该生成能力下的**已拼装文本 + 字节数 + 生效配置**，可直接拼进你的 system / 提示词。
+
+也可以临时覆盖某一层而不改项目配置：
+
+```
+canvas_skill_pack({ projectId, kind: 'prompt', lens: 'fincher', look: 'dark-myth-cg' })
+```
+
+或直接把配置写进项目（与画布 UI 的选择同源）：
+
+```
+canvas_skill_pack({ projectId, kind: 'prompt', lens: 'wong_kar_wai', genres: ['revenge-face-slap'], form: 'short-drama', set: true })
+```
+
+### 切片口径（按能力切，绝不整份注入）
+
+| kind | 内容 | 典型字节 |
+|---|---|---|
+| `script` | 题材卡全部 + 透镜的叙事/节奏/表演节 + 类型规格的结构块 | ~9–12KB |
+| `storyboard` | 透镜的镜头语言/灯光/风格参数/拍摄清单 + 类型规格卡 + 运镜词典 | ~12–16KB |
+| `prompt` | 透镜的风格参数/灯光/提示词模板 + 影调卡 + 该类型的 ASL 与负向词 | ~8–12KB |
+| `assets` | 透镜的风格参数/灯光 + 影调卡 | ~4–6KB |
+
+一份透镜全文 12–22KB，整份注入会吃掉几千 token，而且稀释真正相关的判据。**永远用工具取切片。**
+
+---
+
+## 四、13 步流水线
+
+只在需要时跑对应步骤。每步说清「读什么」。
+
+### 1. 立项与限制
+定交付物、片长、平台、题材、约束（**画幅在视频生成那一步再定，这里不锁**）。**先调 `canvas_list_skills` 看清单，再定。**
+
+### 2. 剧本与潜文本拆解
+按顺序给出：表层事件 → 戏剧问题 → 冲突（外部/内部）→ 潜文本 → 情绪走向 → **视觉命题**。
+
+视觉命题必须具体可测："男孩随着房间变得更审判而变小"，不是"孤独与命运"。写不成可拍摄的变化，就还不是命题。
+
+非叙事片（选「商业片」类型规格：宣传片/广告片/产品片）**跳过本步**：用类型规格卡里的「观众契约」替代，等价物是"主张 + 那一个可见的证明"。不要为一只口红推导潜文本。
+
+### 3. 节拍表
+按**压力变化**分节拍，不按机位分。每拍写：叙事功能、进出状态、视觉动作、压力差、可能的镜头族（建立/关系/特写/插入/反应/过渡/余波/主观/揭示）。
+
+### 4. 导演透镜
+`canvas_skill_pack({kind:'script'})` 已按配置带入。若用户点名某位导演，用覆盖参数取那一份。
+
+**一次只挂一个透镜。** 两个导演会互相抵消。用户同时点名两位时，选更服务本场戏核的那位，一句话说明选择，并提一句另一位会带来什么不同。
+
+用户点名的导演不在 24 位里时：**不要静默替换**。一句话说明没有对应透镜，给出最接近的一位及其差异轴，然后按用户给的参考图或描述临时搭一个，并标记为臨時。
+
+### 5. 导演本 / 视觉处理
+可复用的规则集，用来稳定后续所有提示词：调性、镜头与构图政策、运镜语法与允许的运动集合、灯光逻辑与主光方向、色板与色彩脚本、美术锚点与年代锁、表演基调、剪辑节奏与目标 ASL、声音方向、以及**不变项条款**（逐字粘进每一条提示词的身份串与光线不变项）。
+
+一份导演本合格的判据：**两个人照着填分镜，能填出兼容的东西。**
+
+### 6. 调度
+每一个有人的镜头：起始位置、运动、与空间和道具的关系、与机位的关系、结束位置、视线。调度不是"演员站哪儿"，是身体位置+运动+道具+机位共同揭示权力、恐惧、吸引、秘密、孤立、反讽。
+
+**先定调度再定机位。** 调度对了，机位平都能读；调度错了，运镜再花也救不回来。
+
+### 7. 分镜表
+节拍与调度清楚之后才建行。每镜写：编号、时长、场/景、叙事功能、景别、焦段、角度、运镜、调度（起点→运动→终点）、光向与气氛、连续性锚点、转场、风险、AI 生成备注。
+
+运镜从 `moves/camera-moves.md` 里选，**一镜一个**。
+
+### 8. 关键帧策略
+按连续性风险选：
+
+- **单首帧** —— 一个稳定构图里的简单动作。
+- **首帧 + 末帧** —— 受控转变、有明确结束点的动作、两个构图之间的设计转场。
+- **逐镜关键帧** —— 身份、服装、地点、调度必须守住的场合。
+- **分镜图版** —— 模型把静帧当幻灯片时。
+
+**关键帧是控制点。** 视频模型基本只是把静帧重新动起来。先修图，再花视频生成的钱。
+
+### 9. 工具适配
+先认控制面再写一个字：文生视频 / 图生视频（首帧） / 末帧槽 / 参考绑定 / 机位控制 / 运动强度 / 原生音频 / 时长范围 / 续写 / 多镜时间戳 / 种子 / 负向提示词 / 视频转视频。
+
+认不出就不要猜它的能力——问它暴露了哪几项，或者按能力路由。
+
+### 10. 提示词构建
+形状由控制面决定：
+
+**S1 纯运动**（图生视频）：图已经承载身份、构图、光线、场景、服装、风格。文字只写运动、机位、时间、结束状态、约束。
+
+```
+[机位行为]. [主体起始可见状态], then [一个主动作，含速度与方向].
+[环境做一处细微反应]. End with [明确的最终姿态/构图].
+Maintain [身份/服装/地点/光向]. Avoid [与本镜真实风险匹配的失败项].
+```
+
+**S2 完整描述**（文生视频）：文字承载全部。
+
+**S3 关键帧对**（首帧+末帧）：写两张已批准静帧之间的**桥**，不是写静帧本身。
+
+**S4 多镜时间戳**：`Overall:` 块放身份/服装/色板/光线事实，**段内一律不重述**——重述一次，模型就换一次人。
+
+**动作必须分层**：把"一个动作"拆成 **起势 → 发力 → 落点** 三拍，每拍写可见的身体/道具状态。只写一拍 = 模型只演一个姿势。
+
+### 11. 声音与对白
+每镜五层：room tone、氛围、拟音、点效、配乐。对白守一镜一人，说话人必须在画内开口、口型同步。生成不了的（方言、特殊音色）改成画外音、反应镜或后期配音。
+
+**一条连续的环境底噪能盖住大量视觉漂移**——这是最便宜的连续性胶水。
+
+### 12. 剪辑与组接
+生成出来的片段是原料不是成片。指定：片段顺序、入点出点、修剪余量、每段的进入转场、下面的音频层。
+
+匹配剪辑要靠**把 A 的末帧和 B 的首帧一起设计**。能用切、修剪、叠化解决的，不要多生成一次。
+
+### 13. 质检与修复
+诊断按这个顺序查：素材不一致 → 提示词超载 → 动作太弱（是姿势不是动作）→ 缺结束状态 → 机位逻辑错 → 跨镜断裂 → 工具不匹配。
+
+**成本阶梯**：改提示词 → 调参数 → 重生成 → 重建关键帧 → 视频转视频 → 重规划镜头 → 剪辑里修 → 删掉这个镜。停在第一个有效的层级。
+
+**同一镜三次生成都失败，就改镜头不要改提示词**：更短、更近、更简单、拆成两个、换首末帧、移出画外只给结果、换成反应或插入镜。
+
+---
+
+## 五、硬规则
+
+1. **叙事功能优先。** 没有叙事功能的镜头删掉，不是改进。
+2. **调度先于构图。** 先决定身体在空间里做什么，再放机位。
+3. **一条 clip 只能有一个主运镜 + 一个主动作。** 完全不动是正当选择，而且常常更好。
+4. **每个动作都有结束状态。** "他转身"不是镜头；"他转到侧脸压住窗户，停住"才是。
+5. **写行为不写情绪。** 永远不要写"他很害怕"，写害怕在身体上是什么样。
+6. **连续性靠工程。** 点名不变项（身份、服装、光向、年代、地理），并在每一镜里逐字重复。
+7. **关键帧是控制点。** 先用图把身份和构图定死，再花视频的钱。
+8. **匹配工具的控制面。** 不要向模型要它没暴露的功能。
+9. **负向词要指名实例。** "不要现代物件"是模型无法解析的类别；写"不要塑料、不要杠杆把手、不要橡胶鞋底、不要手表、不要印刷 logo"。
+10. **一次只挂一个风格透镜。**
+11. **回答要匹配问题的体量。** 一句提示词的需求就给一句提示词，不要扩成整包制作方案。
+12. **正文与判据优先于一句话人设。** 人设给方向，切片给可核对的判据。
+
+---
+
+## 六、与其他技能的衔接
+
+- 写**剧本**前：`canvas-craft` 的剧本方法论（四要素、因果钩子、分场格式）+ 本技能的 `kind:'script'` 切片。
+- 拆**分镜**前：`canvas-craft` 的分镜六要素（景别/机位/主体位置朝向/前后景层次/光线方向质感/关键道具位置）+ 本技能的 `kind:'storyboard'` 切片。
+- 写**图片提示词**前：本技能的 `kind:'prompt'` 切片（含风格参数与负向词）+ 设定集里的角色/场景/道具外观描述。
+- 写**视频提示词**前：同 `kind:'prompt'` 切片；若上游是分镜表，结构化格式照 `canvas-craft` 的规定，本技能的切片只作为风格锁追加在尾部。
+- 建**节点**前：`canvas-layout` 的布局纪律。
+
+---
+
+## 七、诚实边界
+
+- 本套件的方法论是**通用手法**，不复制任何具体作品的镜头、台词、角色或情节。透镜名只作为内部选择标签，交付物里**绝不出现导演名**——一律翻译成可执行参数（焦段、光比、ASL、色板、负向词）。
+- **不承诺逐帧还原参考视频的动作**。具体武打招式要靠 3D 导演台骨骼动画或实拍参考，文字提示词硬凑招式必然出糊动作。详见 `moves/fight-rhythm.md` 的「生成时的明确边界」。
+- 题材卡的置信度标注的是「该卡的机制在本套件内被多处交叉印证的程度」，**不代表市场表现、测量结果或任何统计结论**。

package/assets/canvas-director/forms/cinematic.md

@@ -0,0 +1,56 @@
+---
+form_id: cinematic
+title: 电影质感
+kind: form
+spec:
+  durations: [30, 60, 120, 300]
+  asl_floor_s: 1.5
+  asl_target_s: "3.0-8.0"
+  platforms: ["bilibili", "youtube", "douyin"]
+---
+<!-- slice:story shot prompt -->
+## 交付规格
+
+- **这不是「长片规格」，是「质感规格」。** 它约束的是**每一镜怎么做才像电影**，不承诺一次做出一部 120 分钟成片——AI 视频模型单次只出 3–8 秒，任何「一部长片」都只能是大量片段接起来的结果，写一个 120 分钟的时长档是假的。要长片就按集/按段推进，本规格负责每一段都过电影线。
+- **画幅不在本规格里决定。** 2.39:1、1.85:1、16:9、甚至竖构图都能拍出电影感——**画幅与分辨率在视频节点生成时选**。电影感来自光、镜头、调度、节奏，不来自比例。
+- **质量基线（本规格的全部意义所在）**：动机光 + 真实材质 + 成立的景深 + 经得起大银幕的构图与美术。每一镜都要能回答三个问题：光从哪来、镜头为什么选这个焦段、观众的视线被引导到哪。答不出来就是没达到本规格。
+- **可用的成片长度档**：30 / 60 / 120 / 300 秒（短片、样片、先导片、单集）。按 **单片段 3–8 秒**换算：60 秒 ≈ 8–20 个片段，300 秒 ≈ 40–100 个片段。这个数量级是现实可做的；再往上是工程排期问题，不是规格问题。
+- ASL 下限 1.5 秒（比短剧宽，因为电影允许停留）；ASL 目标 3.0–8.0 秒。允许 8 秒以上的长镜，但**单片段上限就是模型的一次生成长度**（3–8 秒，插件默认 5 秒）——想要更长的连续镜头，用**尾帧续接**把两段接成一镜，接点在动作转折处，不在静止处。
+- 帧率 24 拍（电影感的核心之一是 24 的不连续感）；需要升格时 48/96 拍再回落到 24。
+
+<!-- slice:story -->
+## 结构块
+
+即使只有 60 秒，也要有完整的情绪弧。段位配比按实际长度缩放。
+
+| 段位 | 时长占比 | 能量 | 职责 | 典型镜头 |
+|---|---|---|---|---|
+| 建置 | 15–25% | 低→中 | 建立空间的规则、人物的日常与缺口 | 环境建立、人物独处、第一次失衡 |
+| 转折 | 20–25% | 中→高 | 主角做出不可撤回的选择 | 决定性的动作、签字、出门 |
+| 对抗 | 30–40% | 高低交替 | 条件恶化，代价逐层落地 | 对峙、失败、失去 |
+| 收束 | 10–15% | 落定 | 给出代价，不给出解释 | 空镜、背影、门关上 |
+
+60 秒档只保留**一次转折 + 一次代价**。300 秒档可以套两轮「转折—对抗」，但第二轮必须让代价升级，不能重复第一轮。
+
+<!-- slice:story shot -->
+## 这个类型的观众契约
+
+- 观众愿意**等待**，但等待必须被支付——每一段慢，后面都要有一处只有慢才给得出的东西（一个眼神、一次呼吸、一个没说的话）。
+- **不给解释，给证据**：观众要的是自己看出来，不是被台词告知。
+- 关掉的原因：**节奏没有依据的慢**（纯空镜堆时长）、**情绪没有落地的人物**（人只是事件的载体）、**画面压不住屏幕**（平光、假材质、构图散）。
+
+<!-- slice:story shot -->
+## 与导演透镜冲突时的改写
+
+本规格是**透镜最舒服的容器**——它本来就是要「像电影」，而透镜就是电影语法。少数要处理的：
+
+- **库布里克式绝对对称 + 匀速推进**：天然合拍。唯一要防的是全长对称导致视觉疲劳——每 3–4 个对称镜插一个不对称镜（哪怕是同场景的反打），让对称重新变成选择。
+- **王家卫式手持晃动**：要降幅——把「手持」改成「肩扛」，幅度收到画幅 3% 以内且不做连续 reframe，否则大屏幕上会变成晕船。
+- **黑泽明式天气即戏剧**：全片只允许一场戏让天气主导（雨/风/尘），其余天气作为背景。天气每次全开，第三次就不成立了。
+- **芬奇式精确控制 + 低照度**：允许，但暗部必须留结构——按「投影后仍能看清」而不是「监视器上好看」来配光。
+- **长镜类透镜（塔可夫斯基/侯孝贤）**：他们的长镜在 AI 生成里只能做到「一次生成的长度 + 尾帧续接」。做法是把一个长镜拆成 2–3 段，每段之间**保持同一机位、同一光向、同一动作方向**，接点落在动作中途。伪装成一条长镜，而不是真的拍了一条。
+
+<!-- slice:prompt -->
+## 类型级负向词
+
+television look, sitcom flat lighting, soap opera coverage, over-lit interior, flat fill everywhere, digital sharpness without texture, plastic skin, no grain at all, commercial gloss, stock footage look, drone shot for no reason, 60fps soap opera motion, shaky amateur handheld, zoom instead of dolly, visible set wall, cheap practical, watermark, subtitle burned in, over-saturated grade, crushed blacks with no detail, clipping highlights, dutch angle cliché, whip pan cliché, speed ramp, freeze frame ending, shot change mid-generation, morphing face, warping background

package/assets/canvas-director/forms/commercial.md

@@ -0,0 +1,63 @@
+---
+form_id: commercial
+title: 商业片
+kind: form
+spec:
+  durations: [15, 30, 60]
+  asl_floor_s: 0.5
+  asl_target_s: "1.2-2.8"
+  platforms: ["bilibili", "youtube", "douyin", "wechat", "reels"]
+  variants: ["宣传片", "广告片", "产品片"]
+---
+<!-- slice:story shot prompt -->
+## 交付规格
+
+- **画幅不在本规格里决定。** 广告可以竖屏投放，宣传片通常横屏，产品片横竖都有——**画幅与分辨率在视频节点生成时选**。本规格只约束「怎么说清主张」和「怎么把产品拍高级」。
+- **本规格合并三种相近需求**，靠下面的段位表内部分流，不再拆成三张卡：
+  - **宣传片**（品牌/公司/项目，30–90 秒）：说清「我们是谁、凭什么」。
+  - **广告片**（15/30 秒投放）：说清「这个东西解决你什么问题」。
+  - **产品片**（30–60 秒）：说清「这个东西本身有多好」。
+- **质量基线：产品是主角，光是主角的台词。** 材质必须真实（金属的反射形状、织物的绒感、玻璃的通透、液体的表面张力），光源必须有形状与方向。产品片最大的失败是「打得很亮但看不出是什么材质」。
+- 片长 15 / 30 / 60 / 90 秒，容差 ±1 秒（15s 档容差 ±0.5s）。**结尾必须留 ≥1 秒的静止落版**，字标或产品单独在画面里，不要卡着最后一帧切。
+- ASL 下限 0.5 秒（只给冲击镜/快切段）；ASL 目标 1.2–2.8 秒。
+- 平台默认按投放面：横屏 bilibili/youtube，竖屏 douyin/reels/shorts。同一支片要投多面时，**生成时就按各自画幅各出一版**，不要裁切。
+- 帧率 25/30 拍；产品微距升格用 60/120 拍再回落。
+
+- **生成次数换算**：AI 视频模型单次出 3–8 秒（插件默认 5 秒）。15 秒 ≈ 3–5 个片段，30 秒 ≈ 6–10 个，60 秒 ≈ 12–20 个。广告的单镜常在 0.5–2 秒，所以多数片段只用得上前半段——这是正常的，切点比片段长度更重要。
+<!-- slice:story -->
+## 结构块
+
+三种变体共用同一个骨架，只是段位配比不同。
+
+| 段位 | 宣传片 | 广告片 | 产品片 | 职责 |
+|---|---|---|---|---|
+| 开场 / 钩子 | 8–12% | 8–12% | 12–18% | 立问题或立品牌；第一秒必须有一个让人不退的动作或画面 |
+| 主张 / 立传 | 15–20% | 12–15% | 20–25% | 一句话说清「凭什么」；用一个主角（人/产品/场景）把它演出来 |
+| 证明 / 爬升 | 50–60% | 55–65% | 45–55% | 逐条把承诺兑现成**看得见的证据**；一条证据一个镜头，不要塞 |
+| 收束 / 落版 | 12–16% | 13–18% | 12–16% | 峰值 + 字标；留 ≥1 秒静止 |
+
+**呼吸字卡**（宣传片可选）：每 1–2 个功能镜头后插一张单行字卡，全片 2–3 张，每张 50–75 帧（约 1.8 秒）。字卡不是必需的，塞三张以上会让片子碎。
+
+<!-- slice:story shot -->
+## 这个类型的观众契约
+
+- 观众**不是主动来看的**，所以要更早给理由：第一秒就要有一个让他不退的画面或问题。
+- **只承诺一件事。** 一条片只讲一个主张；讲三个的片子，观众一个都记不住。
+- **证据必须可看，不能靠说。** 「更快」不成立，「三秒出水」成立；「更高级」不成立，「拉丝纹在逆光下泛出细密金线」成立。
+- 关掉的原因：**像 PPT**（影像只是配图）、**像广告**（可预期的推销节奏）、**像演示片**（功能堆砌没有主次）。
+
+<!-- slice:story shot -->
+## 与导演透镜冲突时的改写
+
+商业片是最容易被透镜带偏的类型——透镜管「怎么拍」，不管「卖什么」。冲突时：
+
+- **塔可夫斯基/马力克式慢与留白**：允许，但**只能用在「主张」那一段**（15–20%），后面必须回到可读的节奏。全片慢，观众在 8 秒后就走了。
+- **王家卫式碎片与旁白**：可以做，但旁白必须承担**主张**的职能（一句话说清凭什么），不能是情绪自述。碎片跳接最多连续三镜。
+- **库布里克式冷峻对称**：产品片很好用（对称强调产品的秩序感）。宣传片要慎用——人在对称里会变成装置，观众共情不到。
+- **芬奇式低照度精密**：产品片可用，但**产品必须亮过环境**至少 2 档，否则观众看不清卖点。
+- **任何透镜都不许做的事**：让产品在画面里变成背景、让字标压在产品上、让落版时长不足 1 秒。
+
+<!-- slice:prompt -->
+## 类型级负向词
+
+unsolicited text, garbled logo, warped product shape, wrong reflection, plastic fake material, flat white studio background with no shadow, cheap gradient background, lens flare for no reason, generic stock footage, model with no product, floating product with no ground contact, impossible physics, clipping highlights on product edge, mushy texture detail, fake liquid, cartoon shadow, watermark, subtitles burned in, cluttered frame, five or more focal points, cheap 3D render look, over-saturated brand color, jitter on text, awkward letterbox, product cropped by frame edge

package/assets/canvas-director/forms/documentary.md

@@ -0,0 +1,57 @@
+---
+form_id: documentary
+title: 纪实
+kind: form
+spec:
+  durations: [60, 300, 900]
+  asl_floor_s: 3.0
+  asl_target_s: "6.0-15.0"
+  platforms: ["bilibili", "youtube", "broadcast"]
+---
+<!-- slice:story shot prompt -->
+## 交付规格
+
+- **画幅不在本规格里决定。** 纪实横屏为主，竖屏口播与竖屏观察式同样成立；**画幅与分辨率在视频节点生成时选**。
+- **质量基线：可信优先于好看。** 环境音必须真实、光线必须成立（现场什么光就什么光）、人物必须自然（不要让人对着镜头念稿）。宁可粗糙但真，也不要精致但假——纪实片的观众对「补拍感」极其敏感。
+- 片长 5 / 15 / 30 / 60 分钟，容差 ±5%。
+- ASL 下限 3.0 秒（这是**下限**，允许更长的镜头）；ASL 目标 6–15 秒。允许 60 秒以上的观察式长镜，条件是镜头里有真实事件在发展。
+- 平台默认 bilibili / youtube / 广播级（广播按 -23 LUFS）。
+- 帧率 25 拍为主（PAL 传统），需要升格时 50 拍回落。
+
+- **生成次数换算**：单次 3–8 秒。60 秒 ≈ 8–20 个片段，5 分钟 ≈ 40–100 个，15 分钟 ≈ 120–300 个。纪实的观察式长镜在 AI 生成里只能做到一次生成长度，超过要靠**尾帧续接**（同机位、同光向、动作中途接），不要指望一次出 30 秒不动的一个镜头。
+<!-- slice:story -->
+## 结构块
+
+| 段位 | 时长占比 | 能量 | 职责 | 典型镜头 |
+|---|---|---|---|---|
+| 设问 | 5–10% | 中 | 抛出一个具体问题或一个反常事实 | 现场细节、一句当事人的话 |
+| 展开 | 30–40% | 低→中 | 让人和现场自己说话，给出第一层证据 | 观察式长镜、访谈、环境建立 |
+| 深挖 | 30–35% | 中 | 出现矛盾、代价、或者不成立的说法 | 对峙、证据核对、第三方视角 |
+| 收束 | 15–20% | 中 | 给出结论或明确承认给不出结论 | 回到开场的那个现场 |
+| 引申（可选） | 5% | 低 | 把个案推到更大的问题，不喊口号 | 空镜、背影、字幕 |
+
+**叙事推进靠信息，不靠剪辑花招**：每一个新的段位都必须给观众一条此前不知道的事实或一个此前没见过的现场。
+
+<!-- slice:story shot -->
+## 这个类型的观众契约
+
+- 观众来看的是**真的**。任何一处「明显是补拍/摆拍」都会让整片的可信度崩掉。
+- **每个论点必须有现场支撑**：不能只有访谈的说法，要有画面对得上。
+- **允许承认不知道。** 「这一点我们没能确认」比硬给一个结论更可信。
+- 关掉的原因：**信息空转**（说了很久没有新事实）、**画面与旁白各说各的**（旁白在讲 A，画面在演 B）、**过度煽情**（配乐逼着观众感动）。
+
+<!-- slice:story shot -->
+## 与导演透镜冲突时的改写
+
+纪实与大多数透镜有**根本冲突**：透镜管「设计画面」，纪实要求「不设计」。处理原则是**只借透镜的观察方式，不借它的造型手段**。
+
+- **可借**：构图习惯（侯孝贤的门框纵深、怀斯曼式的观察位置）、机位高度、是否用长镜、焦段偏好。这些让纪实更有观点而不失真。
+- **慎借**：库布里克/张艺谋式的对称与色块——用在**空镜与建筑**上成立，用在人身上立刻变成摆拍。
+- **不可借**：王家卫式的抽帧、慢动作、主观旁白；芬奇式的精密控制光；雷弗恩式的仪式化构图配正面人物。这些会让纪实变成「伪纪录剧情片」，观众一旦察觉就不再相信任何一条信息。
+- **光线一律按现场来。** 透镜若要求高光比，就用现场真实的高光比（窗、灯、夜），不要补光去凑。
+- **需要重演时明确标记**：如果某个关键事件没能拍到、必须重演，字幕或旁白必须说明「以下为情景重现」。这条是硬线，借任何透镜都不改变。
+
+<!-- slice:prompt -->
+## 类型级负向词
+
+staged reenactment without label, actor looking at camera script, teleprompter eyes, over-lit interview, beauty lighting on subject, artificial rim light, studio backdrop, fake documentary style, dramatic score swell, slow motion for emotion, teal and orange grade, over-saturated, drone shot for no reason, stock footage look, generic b-roll, watermark, subtitle burned in, corporate video style, news anchor framing, cluttered frame, impossible physics, duplicate person

package/assets/canvas-director/forms/explainer.md

@@ -0,0 +1,57 @@
+---
+form_id: explainer
+title: 解说
+kind: form
+spec:
+  durations: [60, 180, 300]
+  asl_floor_s: 3.0
+  asl_target_s: "5.0-10.0"
+  platforms: ["bilibili", "youtube", "wechat"]
+---
+<!-- slice:story shot prompt -->
+## 交付规格
+
+- **画幅不在本规格里决定。** 横屏知识类、竖屏口播类、方屏信息流都成立；**画幅与分辨率在视频节点生成时选**。
+- **质量基线：信息密度优先于画面华丽。** 解说片的画面是**证据与示意**，不是装饰。每个镜头都要让「说的那件事」更清楚一点；不承担这个功能的画面删掉。
+- 语速是硬指标：中文 4.5–6.5 字/秒（约 270–390 字/分钟）；英文 150–170 词/分钟。**超过这个区间观众跟不上，低于则显得拖。**
+- 片长 1 / 3 / 5 / 10 分钟，容差 ±5%。
+- ASL 下限 3.0 秒（这是下限）；目标 5–10 秒。**因为观众一边看一边听，画面切太快会抢走理解力。**
+- 平台默认 bilibili / youtube / wechat。
+
+- **生成次数换算**：单次 3–8 秒。1 分钟 ≈ 8–20 个片段。解说片大量使用**图示/示意/定格**，这些不一定要用视频模型——静态图加动效（推、移、高亮）往往比生成一段视频更准也更省。
+<!-- slice:story -->
+## 结构块
+
+| 段位 | 时长占比 | 能量 | 职责 | 画面策略 |
+|---|---|---|---|---|
+| 设问 | 5–8% | 中 | 抛一个观众真的想知道答案的问题 | 结果先行：先给最惊人的那一幕 |
+| 铺垫 | 20–25% | 低 | 给必要的背景，**只给后面会用到的那部分** | 图示、地图、时间线 |
+| 展开 | 40–50% | 中 | 逐条推进论证，一条一层 | 示意动画、实拍证据、对比 |
+| 转折 | 10–15% | 高 | 出现反例、或者推翻前面的一半 | 数据、现场、专家说法 |
+| 结论 | 10–15% | 中 | 给出答案，并说清它适用的边界 | 回到设问的画面 |
+
+**「只给后面会用到的那部分」是解说片的纪律**：背景段里每一个被提到的事实，后面都必须被用到；用不到的删掉，否则观众会觉得「听了但没用」。
+
+<!-- slice:story shot -->
+## 这个类型的观众契约
+
+- 观众是来**获得一个明确的答案或一套明确的解释**，不是来看风景的。
+- **每一分钟必须给一条新的信息**。连续 60 秒没有新信息，观众就走了。
+- **说清边界**：「在什么条件下成立、在什么条件下不成立」。只讲成立的那一半，观众会觉得被忽悠。
+- 关掉的原因：**信息空转**（说了很多但不推进）、**画面不承载信息**（只有素材堆砌）、**语速与画面不同步**（旁白在讲 A，画面还在 B）。
+
+<!-- slice:story shot -->
+## 与导演透镜冲突时的改写
+
+解说片**只借透镜的视觉语法，不借它的叙事节奏**。因为观众的主要注意力在听，画面的第一职责是**清楚**。
+
+- **所有慢节奏透镜（塔可夫斯基、侯孝贤、阿巴斯）**：他们喜欢「让画面自己走」。在解说片里，一个镜头停留超过 10 秒而不给新信息，就是在消耗观众。做法：**保留他们的构图与光线，压缩他们的时长**——用他们的画面，走解说的节奏。
+- **王家卫/毕赣式碎片跳接**：可以用于「转折」段（对比前后认知），但全片用会让信息散架。最多连续三镜。
+- **库布里克/芬奇式精密构图**：非常适合示意画面与图示。但不要让精密变成「好看但看不懂」——解说片的画面必须一眼可读。
+- **张艺谋式色块**：可以用来标记「不同的类别」（一个类别一个颜色），这反而是解说的好工具。但色块数量不超过 4 个，超过就分不清。
+- **所有透镜共享的硬线**：**画面必须与旁白同步**。旁白说到 X，画面就得是 X；任何「先放着好看的画面等旁白跟上」的做法都会让观众分心。这一点压过任何风格偏好。
+
+<!-- slice:prompt -->
+## 类型级负向词
+
+text too small to read, garbled text overlay, unreadable diagram, cluttered infographic, five colors competing, stock footage look, generic b-roll, irrelevant footage, footage not matching narration, over-saturated, cheap motion graphics, spinning logo, watermark, subtitle burned in, flicker, moire pattern, low resolution upscale, impossible physics, duplicate person, text clipped by frame edge, busy background behind text, low contrast text on busy background