@ninkch/dsh-infinite-canvas 0.19.20 → 0.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -0
- package/README.zh-CN.md +23 -0
- package/assets/canvas-layout/SKILL.md +19 -2
- package/assets/canvas-studio/SKILL.md +156 -378
- package/client.js +847 -61
- package/cordis.patch.yml +13 -0
- package/docs/UI-RULES.md +4 -0
- package/docs/auto-creation-design.md +68 -0
- package/docs/guide.en.md +13 -1
- package/docs/guide.zh-CN.md +14 -0
- package/index.js +1547 -30
- package/package.json +2 -1
- package/production.js +427 -0
|
@@ -3,399 +3,177 @@ name: canvas-studio
|
|
|
3
3
|
description: 用无限画布(Infinite Canvas)做短剧/视频创作时使用:创建或复用项目、写剧本与分镜、触发生成、查看结果、命名与清理。用户提到画布、无限画布、短剧项目、剧本节点、分镜、生成视频,或要求"建个画布项目/把内容写进画布"时,先加载本技能再动手。Load this skill before operating the infinite canvas.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# 无限画布操作规程(流程手册)
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
画布 = 按项目组织的节点工作台:剧本 → 分镜 → 图片 → 视频 → 成片。你(对话模型)是操作者:
|
|
9
9
|
**所有画布操作只能通过 canvas_* 工具完成**,不要臆造节点或项目状态。
|
|
10
|
+
本篇是**流程与纪律**;"怎么写好"看 `canvas-craft`,风格口径看 `canvas-director`,节点摆放看 `canvas-layout`。
|
|
10
11
|
|
|
11
|
-
##
|
|
12
|
+
## 〇、阶段机与闸门(先读这一节)
|
|
12
13
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
| 技能 | 管什么 | 什么时候加载 |
|
|
16
|
-
|---|---|---|
|
|
17
|
-
| `canvas-studio` | 画布操作流程:建项目 / 写节点 / 触发生成 / 查状态 | 任何时候先读(本文件) |
|
|
18
|
-
| `canvas-craft` | 创作方法论:剧本四要素、分镜六要素、提示词规范 | 写剧本或拆分镜前 |
|
|
19
|
-
| `canvas-layout` | 节点布局纪律:一类型一列、绝不重叠 | 批量建节点前 |
|
|
20
|
-
| `canvas-director` | **导演透镜 45 / 叙事题材 36 + 行业题材 10 / 规格 8 / 影调 9 / 运镜词典** | **写任何提示词前** |
|
|
21
|
-
|
|
22
|
-
### 怎么知道有哪些可用
|
|
23
|
-
|
|
24
|
-
调 `canvas_list_skills`:它一次返回 4 份技能及各自何时用、技能包四层完整清单(每层的 id 与名称)、以及当前项目的已选配置。
|
|
25
|
-
|
|
26
|
-
### 怎么按口径写提示词
|
|
27
|
-
|
|
28
|
-
调 `canvas_skill_pack({ projectId, kind })` 取切片,**不要整份读技能包文件**:
|
|
29
|
-
|
|
30
|
-
- `kind: 'script'` —— 写剧本前
|
|
31
|
-
- `kind: 'storyboard'` —— 拆分镜前
|
|
32
|
-
- `kind: 'prompt'` —— 写图片或视频提示词前
|
|
33
|
-
- `kind: 'assets'` —— 写角色/场景/道具设定图提示词前
|
|
34
|
-
|
|
35
|
-
返回的文本可直接拼进你的系统提示。也可临时覆盖:`{ lens:'fincher', genres:['crime-police'], form:'trailer', look:'dark-myth-cg' }`;
|
|
36
|
-
传 `set:true` 会把配置写进项目(此后画布自生成也用同一套)。
|
|
37
|
-
|
|
38
|
-
**这是让对话写出的内容与画布自生成保持同一口径的唯一入口。** 跳过它直接写提示词,等于放弃用户已经选好的导演与题材。
|
|
39
|
-
|
|
40
|
-
## 一、硬约束(违反即视为操作失败)
|
|
41
|
-
|
|
42
|
-
0. **设定集先行。** 写剧本、写分镜、生成任何画面之前,**必须先 `canvas_get_bible` 读设定集**:
|
|
43
|
-
- 世界观/核心设定、风格基调、角色/场景/道具为空或不完整时,**先补全设定集**
|
|
44
|
-
(`canvas_update_bible`),再开始生成;用户已给出创意时按其创意补全,不要凭空另起一套。
|
|
45
|
-
- **创作意图、世界观、核心设定、风格基调 → 全部写进设定集;
|
|
46
|
-
【禁止】为"创作意图/世界观/设定"单独建任何节点**——那是设定集的职责,不是节点。
|
|
47
|
-
- 角色/场景/道具的参考图也应**先从设定集条目生成**(为每个条目建 `image` 图片节点 → `canvas_run_node`),
|
|
48
|
-
再进入分镜与镜头生成,这样才能跨镜跨集一致。
|
|
49
|
-
- 唯一例外:用户明确说"先随便写个剧本/不用管设定"。
|
|
50
|
-
1. **同一个请求最多创建一个项目。** 调用 `canvas_create_project` 之前**必须先** `canvas_list_projects` 查重:
|
|
51
|
-
已存在同名或同主题项目 → **直接复用它的 projectId**,绝不重复创建。重复建项目会留下空壳项目,用户非常反感。
|
|
52
|
-
2. **绝不为单个节点新建项目。** 往已有项目加内容一律用 `canvas_write_node(projectId=…)`;
|
|
53
|
-
只有用户**明确要求"另开一个项目"**时才调用 `canvas_create_project`。
|
|
54
|
-
3. **失败重试不要重建资源。** 工具报错时先 `canvas_list_projects` 看是否已经创建成功(可能只是返回值校验问题),
|
|
55
|
-
已存在就复用,绝不靠"再建一个"来重试。
|
|
56
|
-
4. **每个节点都要有可识别的名字。** 新建节点时传 `name`(如「第一节剧本」「第一节分镜表」「第2集剧本」);
|
|
57
|
-
同名节点必须加区分后缀。**不存在"创作意图/设定"类节点**——那些内容在设定集里。
|
|
58
|
-
5. **一个剧本节点必须同时有 `idea` 与 `output`——绝不把一个剧本拆成两个节点。**
|
|
59
|
-
- `idea`=本节创作提示词(**对话侧负责填写**);`output`=完整剧本正文
|
|
60
|
-
- **正常情况:output 由节点自己生成**(写好 idea → `canvas_run_node`),对话侧不要代替节点写成稿;
|
|
61
|
-
仅当用户明确要求"直接写稿"时才用 `target:'output'` / `scriptOutput` 由对话填写
|
|
62
|
-
- **禁止**:一个只有 `idea` 的剧本节点 + 另一个只有 `output` 的剧本节点;**禁止**只写提纲、计划或"待生成"占位
|
|
63
|
-
- **分镜内容只能放分镜表节点(storyboard)**,绝不要写进剧本节点
|
|
64
|
-
6. **删除是破坏性操作。** 先 `canvas_list_projects` 确认 id,且仅在用户明确要求时执行
|
|
65
|
-
(`canvas_delete_node` / `canvas_delete_project`)。
|
|
66
|
-
7. **完成后让用户看到结果**:调用 `canvas_open({ projectId })`,画布会在数秒内自动跳转。
|
|
67
|
-
8. **一致性告警必须闭环。** 分镜节点生成/更新后,`canvas_node_status` 会返回 `warnings`——
|
|
68
|
-
分镜中出现但**未在设定集登记**或**已登记但描述为空**的实体清单(含画面/动作文本里的 `@资产名@` 提及)。
|
|
69
|
-
只要 `warnings` 非空:**逐条** `canvas_update_bible` 补全(名称与告警**逐字一致**、描述写实可生成),
|
|
70
|
-
再生成参考图;**绝不忽略、绝不跳过、绝不只补一部分**。设定集更新后告警会自动重算
|
|
71
|
-
(几秒内随文档同步刷新),以最新一次 `canvas_node_status` 为准。
|
|
72
|
-
9. **分镜粒度规则:一个分镜节点 = 一个完整场景视频(时长按内容需要,不设硬上限)。**
|
|
73
|
-
- 一个分镜节点只吃**一个场景**的剧本:**各镜按节奏谱系取值、支持一位小数、拒绝均匀分布**
|
|
74
|
-
(普通叙事 2–4s / 快切冲突 0.3–0.8s / 关键反转 1–2s / 情绪长镜 ≥5s;谱系与情绪景别表见 `canvas-craft`);
|
|
75
|
-
- **时长不设硬上限、系统也绝不自动压缩镜头**:各视频厂商单次上限不同且会变化
|
|
76
|
-
(如万相 3.0 支持 30s,可灵只支持 5/10s)——按内容写足,**超限时视频接口会明确报错**,
|
|
77
|
-
依据报错再决定拆分或调整,不要预先为某个猜的上限砍戏;
|
|
78
|
-
- **长剧本仍必须按场景拆分**为多个场景剧本节点(命名「第X节-场Y剧本」…),
|
|
79
|
-
每个场景剧本作为**各自分镜表**的源端——**绝不把长剧本整根连线给一个分镜表**;
|
|
80
|
-
- 全集剧本(若有)只作总纲存档,**不作为分镜源端**;
|
|
81
|
-
- 体量感:一个 10–30s 场景 ≈ 剧本 150–400 字(含该场全部对白);分镜表 `shots` 上限 24 镜,
|
|
82
|
-
超长剧本会被截断且触发生成告警(warnings 会出现"剧本较长…请按场景拆分");
|
|
83
|
-
- **镜头数量不固定**:分镜表镜头数默认「自动(按内容节拍)」——一个连续动作段落 = 一镜,
|
|
84
|
-
3–10 镜都正常,绝不凑数、绝不用固定数量;
|
|
85
|
-
- 拆分操作:全集剧本已生成后,按场景把对应片段 `canvas_write_node(target:'output')`
|
|
86
|
-
写入各场景剧本节点(这是**分配已有内容**,不是代写)。
|
|
87
|
-
10. **汇报固定要素**:项目名 + 项目 id + 节点名/id + 成稿摘要(若已生成);有错误如实说明。
|
|
88
|
-
11. **生成节点前置检查单(创建任何 image / video 节点前逐条确认,任一不过 = 停止创建)**:
|
|
89
|
-
① **镜头清单来源**:这一段的镜头序列已经从分镜表节点的 `shots` 读到了吗?(`canvas_node_status`)
|
|
90
|
-
没读到 → 停止创建,先读分镜表节点;仍读不到 → **问用户要分镜内容**。绝不自己按剧本推导/编造镜头表。
|
|
91
|
-
② **视频节点数量 = 1**:一个分镜表对应一个完整视频(多镜头一次生成)。
|
|
92
|
-
准备为不同镜头建第 2 个视频节点 → 立即停止,走错路了。
|
|
93
|
-
③ **先建 1 个、验证、再继续**:批量预建生成节点会放大错误——先建第 1 个,
|
|
94
|
-
用 `canvas_node_status` 验证连线与产物正确,再继续下一个。
|
|
95
|
-
12. **读不到就问**:必需的项目状态(分镜内容/镜头清单/设定集条目)读不到时,那是**应当向用户确认的缺口**,
|
|
96
|
-
不是可以自行绕过的障碍——绝不把"编一份"当作替代方案。
|
|
97
|
-
13. **分镜连贯靠连线,绝不靠名字/序号推断。** 分镜表节点**顶部**有「衔接上一镜」输入口(`prev`)、
|
|
98
|
-
**底部**有「尾镜」输出口(`tail`)。需要与上一场连贯时:
|
|
99
|
-
`canvas_connect({ projectId, fromNode: 上一分镜表id, toNode: 本分镜表id, fromPort: 'tail', toPort: 'prev' })`。
|
|
100
|
-
连上后,本场分镜**生成时**会自动把上一场尾镜的「画面 / 最后一个动作 / 台词 / 音效」作为**硬性承接约束**
|
|
101
|
-
写进提示词:第 1 镜必须从上一镜的**最后一个动作**继续、画面重叠 **≤ 0.2 秒**、**背景声连续**、
|
|
102
|
-
不得重新建立场景或跳回远景交代。**禁止**用节点名("场1/场2")、节点位置或剧本序号去猜衔接关系——
|
|
103
|
-
名字会改,只有连线是可靠依据。修复已有项目时:先补连 `tail → prev`,再重新生成对应分镜表。
|
|
104
|
-
14. **音话同步(口型)是硬要求。** 分镜里带 `dialogue` 的镜头,必须让说话角色**在画面内开口说话**:
|
|
105
|
-
近景/中近景、脸部朝向可见(正面或 3/4 侧脸),**禁止**背对镜头、脸部被遮挡、人物出画;
|
|
106
|
-
`visual` 或 `motion` 里要写明「开口说话、口型清晰可见」。
|
|
107
|
-
台词**绝不能**处理成画外音/旁白——成片里人嘴闭着、声音飘在背景,就是这个错误。
|
|
108
|
-
视频提示词会自动带上该约束(画面内开口、口型与台词同步);发现分镜把有台词的镜头写成背影/空镜,
|
|
109
|
-
必须重新生成该分镜。
|
|
110
|
-
15. **分段接戏的四个字段必须写(`tail`/`cam`/`start`/`seg`)。** 一集切成多段生成时,每段是独立采样的、
|
|
111
|
-
看不到上一段——接不上的根因是分镜没写接点,不是模型笨。AI 拆镜默认会写(`cont` 开关默认开);
|
|
112
|
-
用 `canvas_update_node` 改 `shots` 时**必须保留/补齐这四个字段**:
|
|
113
|
-
`tail` 是"动作进行中"的尾态(不要写"已完成/站定")、`cam` 可被下一镜延续(相邻镜不反向)、
|
|
114
|
-
`start` 只在非续帧镜头写、`seg` 取值**只能是** `opening` / `continuation` / `scene_change` /
|
|
115
|
-
`new_character` / `closeup`(写 `cut`/`insert` 会被归一化为 `closeup`)。
|
|
116
|
-
**只有 `continuation` 才接力尾帧**:`scene_change` 换场、`new_character` 新角色入场都不接上段画面,
|
|
117
|
-
`closeup` 特写插入允许跳切(接缝阈值 0.15)。续帧段由画布自动做尾帧接力
|
|
118
|
-
(`tailpick` → 下段 `frame`,或沿 `tail→prev` 链自动取上一段尾帧)并做接缝校验;
|
|
119
|
-
**不要**为了"接上"去复制上一段的画面描述(重演 = 白花钱且更跳)。
|
|
120
|
-
16. **分镜质量闸门(生成视频前必过)。** 读到 `shots` 之后、建视频节点之前,按 `canvas-craft`
|
|
121
|
-
「分镜自检」六条逐条核对:**每场冲突点 / 每场 1 个大特写 / 连续三镜不同运动 / 景别具体 /
|
|
122
|
-
场间因果钩子 / 六要素齐全**。任一不过:先 `canvas_run_node` **重生成该分镜表**(不花钱),
|
|
123
|
-
或用 `canvas_update_node` 改 `shots`(**整表替换**——改一镜也要把全部 shots 读回再整体写回,
|
|
124
|
-
别冲掉其它镜的 `tail`/`cam`/`seg`);**绝不带着粗分镜去生成视频**(视频按秒计费、无法局部重来)。
|
|
125
|
-
判定只看分镜文本,不看画面好不好看。
|
|
126
|
-
- **术语统一**:汇报与改写一律用「**大特写**」「**调度**」;景别必须具体(大特写/特写/近景/中景/
|
|
127
|
-
全景/远景),不写"镜头""画面";`motion` 不写"平移/推近/拉远"这类空模板。完整勘误表见
|
|
128
|
-
`canvas-craft`「术语勘误」。
|
|
129
|
-
17. **多画布:一个项目可以有多个画布(右侧「项目」页签里项目为根、子画布为子目录)。**
|
|
130
|
-
- `canvas_list_projects` 会在每个项目下列出 `canvasId=…` 的画布清单;**缺省 `canvasId` = 项目默认画布**,
|
|
131
|
-
旧项目只有默认画布,照旧只传 `projectId` 即可。
|
|
132
|
-
- 用户指明"在某某画布/第二个画布"里操作时,读和写都必须**显式带 `canvasId`**:
|
|
133
|
-
`canvas_list_projects` → 找到目标 `canvasId` 后,`canvas_create_node` / `canvas_write_node` /
|
|
134
|
-
`canvas_run_node` / `canvas_node_status` / `canvas_update_node` / `canvas_connect` /
|
|
135
|
-
`canvas_relayout` / `canvas_delete_node` / `canvas_open` 全部支持该参数;
|
|
136
|
-
**不带 = 默认画布**,会"报节点不存在"或写错画布。
|
|
137
|
-
- 画布之间节点/连线互相隔离;**资产与设定集按项目共享**(所有画布同一份设定集、同一资产库),
|
|
138
|
-
不要为不同画布重建设定集或重复上传资产。
|
|
139
|
-
- **创作硬规则只有一份:`canvas-craft` 技能正文**(六要素 / 每场 1 个大特写 /
|
|
140
|
-
motion「起点→方式→终点」/ 同场连续三镜不同运动 / 每场冲撞点 / 因果钩子 / 术语勘误,全在里面)。
|
|
141
|
-
原先另有一份「专家人设」复述同一批规则,已移除——两条并存会给出互相矛盾的指令。
|
|
142
|
-
风格与题材侧(导演 / 题材 / 规格 / 影调)由 `canvas-director` 技能包的切片提供,
|
|
143
|
-
用 `canvas_skill_pack` 取,见本节开头的技能清单。
|
|
144
|
-
|
|
145
|
-
## 二、标准工作流(对话填提示词+连线+触发,生成由节点完成)
|
|
146
|
-
|
|
147
|
-
0. **读/补设定集**:`canvas_get_bible` → 缺什么用 `canvas_update_bible` 补。
|
|
148
|
-
创作意图、世界观、风格 → 写进设定集的 worldview/style 字段。
|
|
149
|
-
1. `canvas_list_projects` —— 查重 + 拿到 projectId 与节点 id
|
|
150
|
-
2. **剧本节点(一集 = 成片 60–120 秒,按【场N】分场)**:只写提示词,让节点自己生成剧本——
|
|
151
|
-
- 新项目:`canvas_create_project({ name, scriptText: 本集创作提示词, nodeName: '第X节剧本' })`
|
|
152
|
-
- 已有项目:`canvas_write_node({ projectId, text: 提示词, target: 'idea', name: '第X节剧本' })`
|
|
153
|
-
- 触发生成:`canvas_run_node({ projectId, nodeId })` → `canvas_node_status` 轮询直到 done/error
|
|
154
|
-
- 生成契约(自动注入,无需复述):整集 **4–10 场、每场 10–30 秒成片(按内容写足,时长不设硬上限)**;**每场以「【场N】场景名(地点·时间)」单独一行开头**
|
|
155
|
-
——这是"铺开到场景"自动拆分的解析标记,格式不可变;对白逐行「角色:台词」;结尾附人物/场景/道具清单;
|
|
156
|
-
- **提示词里必须点名两条叙事硬约束**(不写,节点生成的剧本大概率是场景流水账):
|
|
157
|
-
① **每场结尾留因果钩子**——一个可拍摄的动作或可见物件,直接推动下一场(禁止"他决定了/危机靠近"
|
|
158
|
-
这类总结句);② **每场至少一个冲突点**(人物之间,或人物与环境/物件之间),并写清
|
|
159
|
-
目标—阻碍—转折—代价四要素。判定口径见 `canvas-craft` 第一节「场景间因果钩子」。
|
|
160
|
-
- **【铁律】不要把成稿直接填进 output**——生成是节点的工作(用户在画布上看得到过程与结果)。
|
|
161
|
-
仅当用户明确说"你直接把剧本写出来、不用节点生成"时,才允许 `target:'output'` 直接写成稿。
|
|
162
|
-
3. **铺开到场景(每场 = 场景文本节点 + 分镜表节点,连线一次生成场景分镜)**:
|
|
163
|
-
- 画布:剧本节点的**「铺开到场景」按钮**一键完成(按【场N】自动分段);
|
|
164
|
-
- Agent 等价操作:`canvas_node_status` 读成稿 → 按【场N】分段 → **逐场**:
|
|
165
|
-
`canvas_create_node({ type: 'text', name: '第X节-场Y文本' })` +
|
|
166
|
-
`canvas_write_node({ projectId, nodeId: 文本节点id, target: 'output', text: 该场原文 })` +
|
|
167
|
-
`canvas_create_node({ projectId, type: 'storyboard', name: '第X节-场Y分镜表', connectFrom: 该场文本节点id })`;
|
|
168
|
-
- **【铁律】每个分镜表的源端 = 对应场景文本(连线取)**;整集剧本节点**绝不**直接连分镜表(体量超限,见硬约束 9)。
|
|
169
|
-
- **连贯连线(要连贯就必须连,见硬约束 13)**:把**上一场分镜表的 `tail` 输出口**连到**本场分镜表的 `prev` 输入口**:
|
|
170
|
-
`canvas_connect({ projectId, fromNode: 上一场分镜表id, toNode: 本场分镜表id, fromPort: 'tail', toPort: 'prev' })`。
|
|
171
|
-
逐场依次串联(场1→场2→场3…),**连好之后再生成该场分镜**——连上后生成的分镜第 1 镜会承接上一场尾镜
|
|
172
|
-
(从上一镜最后一个动作续、重叠 ≤0.2s、背景声连续)。已有分镜是"旧约束"产物时,补连后
|
|
173
|
-
**重新 `canvas_run_node` 该分镜表**即可修正(重生成分镜不花钱,只有视频花钱)。
|
|
174
|
-
4. **逐场生成视频(多镜头一次生成)**:
|
|
175
|
-
- `canvas_run_node({ 分镜表 })` → `canvas_node_status` 读 `shots`(镜头清单以此为准,绝不编造镜头表);
|
|
176
|
-
- **【质量闸门 · 先自检再建节点】** 用这组 `shots` 过一遍硬约束 16 的六条自检(冲突点/大特写/
|
|
177
|
-
三镜同运动/景别具体/因果钩子/六要素)。不过关 → `canvas_run_node` 重生成该分镜表,
|
|
178
|
-
或 `canvas_update_node` 改 `shots`(整表替换);**过闸门之前不要建视频节点**——
|
|
179
|
-
分镜重生成不花钱,视频生成按秒计费且无法局部重来。
|
|
180
|
-
- `canvas_create_node({ projectId, type: 'video', name: '第X节-场Y视频', connectFrom: 分镜表节点id, duration: 各镜时长之和 })`
|
|
181
|
-
(不传 connectFrom 且项目里有已拆解镜头的分镜表时会自动连线;prompt 留空);
|
|
182
|
-
- **【禁止逐镜建节点】**一段 10–30 秒的场景视频**不需要逐镜的图片节点或"镜头图→镜头视频"链路**:
|
|
183
|
-
多镜头一致性靠角色/场景/道具**参考图资产**(`@资产名@` 引用自动挂载)保证,视频模型在一次调用里完成全部镜头。
|
|
184
|
-
最多为**开场首帧或 1–2 个关键镜头**补定帧图(接同一视频节点的 frame/ref 端口)。
|
|
185
|
-
一旦发现自己在批量创建"第X节-场Y-镜Z"这类镜头图片/视频节点 = 走错路,**立即停止**并回到本条。
|
|
186
|
-
- 参考图:把角色/场景/道具参考图资产连到视频节点的 `ref` 端口(`canvas_connect`);
|
|
187
|
-
提示词里的 `@资产名@` 命中的资产也会自动挂上
|
|
188
|
-
- **【跨段连贯:分镜承接 + 尾帧 → 首帧】**连贯分两层,先文本后画面:
|
|
189
|
-
**①分镜承接(文本层,先做)**:上一分镜表 `tail` → 本分镜表 `prev`(见硬约束 13 / 工作流第 3 步),
|
|
190
|
-
让分镜第 1 镜从上一场尾镜的最后一个动作继续、重叠 ≤0.2s、背景声连续;
|
|
191
|
-
**②画面承接(视频层,后做)**:每个视频节点生成完成后会**自动提取尾帧**,挂两个输出口:
|
|
192
|
-
`last`=真·最后一帧(画面结尾原样),`tailpick`=片尾若干帧里选出的**最佳选帧**
|
|
193
|
-
(动作进行中、清晰、不抖——机械取最后一帧常落在动作顶点/运动模糊/抖动上,接缝必跳)。
|
|
194
|
-
两者都是 **image 类型**,只能连到 `frame`(或 `ref`)输入口。
|
|
195
|
-
多场视频按顺序串联时优先用 `tailpick`:
|
|
196
|
-
`canvas_connect({ projectId, fromNode: 上一段, toNode: 下一段, fromPort: 'tailpick', toPort: 'frame' })`;
|
|
197
|
-
该视频还没生成过(没有选帧)时才退到 `fromPort: 'last'`。
|
|
198
|
-
第一段的 `frame` 用开场定帧图(若生成了首帧关键图)或留空。
|
|
199
|
-
**自动续帧(标准用法通常不需要手动连线)**:视频节点连着分镜表、且分镜第 1 镜的 `seg` 是
|
|
200
|
-
`continuation`(默认)时,即使没连 frame,画布也会**自动取上一段视频的尾帧作为本段首帧**
|
|
201
|
-
(节点上显示「🔗 自动取上一段尾帧作首帧」)。它按三条路找「上一段」:frame 连线 →
|
|
202
|
-
同一分镜表的其它视频段 → **沿分镜表 `tail→prev` 承接链向上游找那一场所连的视频**
|
|
203
|
-
(所以「一场一个分镜表 + 一场一个视频」的标准布局下,**只要按第 3 步连好 `tail→prev`,
|
|
204
|
-
自动续帧就可用**)。不想要时把视频节点「衔接」设为「忽略首帧」,或把该镜 `seg` 改成 `scene_change`,
|
|
205
|
-
或关掉分镜表的「分镜衔接」开关(`cont: false`)。
|
|
206
|
-
**【衔接模式】**视频节点上的「衔接」下拉三选一(**始终可见**,不是有连线才出现):
|
|
207
|
-
**参考图融合**(默认:尾帧降级为第 1 张参考图,保留实体参考图,衔接为软约束——提示词会用
|
|
208
|
-
`frameAnchorText` 写明"第 1 帧必须与 [图1] 一致,只允许往后运动")、
|
|
209
|
-
**硬首帧(弃参考图)**(用真首帧参数,画面绝对承接——网关禁止首帧与参考图混用)、
|
|
210
|
-
**忽略首帧**。需要画面严格承接且不需要实体参考图时选「硬首帧」;要保住角色/场景参考图选「参考图融合」。
|
|
211
|
-
**接缝校验**:续帧段生成后自动比对「本段首帧 vs 上段尾帧」相似度,节点上显示
|
|
212
|
-
「✓ 接缝通过 / ⚠ 接缝偏跳 N」;偏跳时建议调低运动幅度重生成或改「硬首帧」。
|
|
213
|
-
阈值随段落类型放宽:同场续帧(`continuation`)0.55 / 跨场换景(`scene_change`)与新角色入场
|
|
214
|
-
(`new_character`)0.35 / 特写插入(`closeup`)0.15。
|
|
215
|
-
**按顺序触发**:上一段 `canvas_node_status` 为 done 后再触发下一段(自动续帧要读上一段成片)。
|
|
216
|
-
分镜表节点上的「铺开到画布」按钮会**自动把上一段的 `tailpick`/`last` 接到本段 `frame`**
|
|
217
|
-
(按上面同一条「找上一段」规则),所以铺开 → 逐段按顺序生成即可,通常不必手工连 frame。
|
|
218
|
-
**资产参考图按需就地补齐**(图片与资产已合并成同一种「图片节点」:**有图就是资产、空节点点开面板生成**):
|
|
219
|
-
已有图 → 直接挂 `image` 图片节点并接到视频的 `参考图` 口;
|
|
220
|
-
**没有图 → 建「图片节点」**,标签按命名规范(`角色-<名> 设定图` / `场景-<名> 设定图` /
|
|
221
|
-
`道具-<名> 设定图`),提示词已按 canvas-craft「资产设定图版式」写好(角色六段式 / 场景主图+环绕小图 /
|
|
222
|
-
道具 45° 主图+细节+色卡,2K 横版),设定集的「外观:…」自动注入,**不留空壳占位节点**。
|
|
223
|
-
所以铺开后先按拓扑顺序把资产图生成掉(或直接跑工作流),再生成视频;同一分镜表重复铺开不会叠加重复资产节点。
|
|
224
|
-
- **【声音一致(可选)】**视频接口配置里的「生成同步音频」勾选后才发送 `generate_audio:true`——
|
|
225
|
-
模型生成**自带音轨**的视频(对白/环境声与画面同步);不勾 = 无声视频(声音另行 TTS 配音)。
|
|
226
|
-
要让同一角色**跨视频保持音色**:用视频/成片节点的「提取声音参考」按钮——
|
|
227
|
-
**输入角色名即可**:系统自动按分镜 `dialogue` 台词标注定位该角色的全部时间窗,
|
|
228
|
-
逐窗取音轨**拼接为一个声音参考文件**(`角色-<名> 声音`,自动绑定实体),
|
|
229
|
-
之后该角色的视频提示词里 `@<名称>@`(双 @ 包裹)会自动把这条声音参考放进 `audios[]`,
|
|
230
|
-
模型生成的对白将向参考音色对齐(携带声音参考时会自动强制开启同步音频)。
|
|
231
|
-
时间窗归属靠分镜的 `dialogue` 标注(对白逐字来自剧本、按镜头分配,一镜尽量单说话人);
|
|
232
|
-
分镜缺少台词标注时按钮会降级为手动模式并提示重新生成分镜。
|
|
233
|
-
- 触发:`canvas_generate_node({ projectId, nodeId, waitSeconds })` 一次等到终态(画布需打开);
|
|
234
|
-
多镜头视频**整段一次生成**完成。
|
|
235
|
-
- **【提示词是自动结构化的,不要手写机械拼装】**视频节点连着分镜表时,画布会把
|
|
236
|
-
分镜 + 参考图 + 设定集自动组装成厂商「参考生成」格式(`subject_definitions` /
|
|
237
|
-
`summary` / `retention_analysis` / `detailed_description`(含 `<Subject N>`、(S1) 说话人、
|
|
238
|
-
`<d>[Chinese] 台词</d>`、绝对时间轴)/ `overall_soundscape` / 非叙事音乐)——
|
|
239
|
-
这是音画同步与台词不错配的关键。你只需保证三件事:
|
|
240
|
-
① 分镜每镜的 `dialogue` 有「角色名 + 逐字台词」(台词只从这里来);
|
|
241
|
-
② 设定集条目描述里带「**外观:**…」与「**声音:**…」(前者进主体定义、后者进台词音色);
|
|
242
|
-
③ 参考图已连到视频节点(无参考图时会回退成普通提示词)。细节见 `canvas-craft` 第四节。
|
|
243
|
-
需要手工覆盖时,在节点提示词里写含 `subject_definitions` 的完整结构,画布会原样发送。
|
|
244
|
-
**分镜衔接字段会自动进提示词**:每镜 `tail`(接点尾态)→「承接上镜结尾:…」、
|
|
245
|
-
`cam`(运镜延续)→「运镜延续:…(方向与速度保持)」、`seg` → 段落类型行;
|
|
246
|
-
首帧接力则追加首帧锚定行与 `continuity:` 段。**你不必(也不要)把这些手工拼进提示词**,
|
|
247
|
-
只需在分镜 `shots` 里把字段写对;分镜表节点「分镜衔接」开关(`cont`)默认开,
|
|
248
|
-
关掉后 AI 拆镜不再产出这四个字段(留给人工写)。
|
|
249
|
-
5. **生成角色/场景/道具参考图**:为设定集里的每个条目创建 image 图片节点
|
|
250
|
-
(命名规范「角色-<名> 设定图」/「场景-<名> 设定图」/「道具-<名> 设定图」),
|
|
251
|
-
**prompt 必须按 `canvas-craft`「资产设定图版式」一节的排版模板写详细版式提示词,
|
|
252
|
-
禁止只写一句三视图/外观关键词**——信息量不足,撑不起后续视频的角色一致性。要点(完整模板见 canvas-craft):
|
|
253
|
-
- **角色设定图**(16:9 横版):按 canvas-craft 的「六段式」结构写——【总起】(版式/背景/风格/
|
|
254
|
-
全格一致)→【身份锚】(参考图=唯一形象事实,忽略照片配饰)→【主体】(量化体型+反例排除+
|
|
255
|
-
**声明空手自然站立:不抱/不拿/不叼/不踩/不坐任何外物**)→【三视图·必须项】→
|
|
256
|
-
【右侧窄栏:脸部特写 / 配饰格 / 表情两行×3,每格只标两字标签,每块内容全图只出现一次】→
|
|
257
|
-
【文字规则 + 画面白名单(**逐类点名排除外物**:纸箱/包裹/玩具/食物/乐器/器材/道具/家具一律不出现)】
|
|
258
|
-
- **道具设定图**(横竖皆可,按道具特性选):顶部道具名大标题(≤6 字);中央主图(斜 45° 悬浮+氛围光);
|
|
259
|
-
细节特写 2–3 格(格内无文字);侧栏侧视图;底部圆形色卡 3–5 枚(色名 ≤3 字)
|
|
260
|
-
- **场景设定图**(主图+环绕小图):一张主场景大图占主体,周边环绕补充小图(多角度 / 其他时间段 / 细节格,3–6 张各配 ≤6 字短标注)——大致参考不强约束
|
|
261
|
-
- **面板内绝不渲染成段文字**(长文本必乱码):只允许 ≤4 字短标签;已连接参考图时参考图形象是唯一事实,逐格严格复制
|
|
262
|
-
- 需要补连任意两节点时用 `canvas_connect({ projectId, fromNode, toNode })`(端口类型必须匹配;
|
|
263
|
-
连分镜表时系统按语义自动选口:剧本/文本 → `script`,分镜表 → `prev`,不用手写端口)
|
|
264
|
-
- **布局乱了/节点重叠**:`canvas_relayout({ projectId })` 一键重排——横向数据流决定列
|
|
265
|
-
(文本→分镜表→视频),竖向关系(承接 `prev` / 首帧 `frame`)留在同列,同行 = 一个横向连通组
|
|
266
|
-
(如「场N文本 ↔ 场N分镜表」对齐),行间保留间距、绝不重叠。新建节点已做碰撞检测;
|
|
267
|
-
存量节点乱了一律用这个工具重排,不要手工挪。
|
|
268
|
-
6. `canvas_open({ projectId })` —— 让用户看到画布结果
|
|
269
|
-
|
|
270
|
-
## 三、@引用与资产命名(跨集一致性的核心手法)
|
|
271
|
-
|
|
272
|
-
**写图片/视频提示词时必须用 `@资产名@` 引用设定集条目(前后各一个 @ 精确包裹,缺一不可)**,
|
|
273
|
-
不要只写名字,更不要写单个 @:
|
|
14
|
+
每个画布(= 一集)有宿主强制的**制作阶段**:
|
|
274
15
|
|
|
275
16
|
```
|
|
276
|
-
|
|
17
|
+
brief → bible → assets → script → storyboard → shots_ready → generating → qc → post → delivered
|
|
277
18
|
```
|
|
278
19
|
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
-
|
|
282
|
-
-
|
|
283
|
-
- `@资产名@` 在输入框里会**蓝色显示、两个 @ 自动隐藏**(人类可读),送给模型前会自动转成带 `[图N]`
|
|
284
|
-
与设定描述的标准提示词
|
|
285
|
-
- **句末引用也必须闭合**:正确「……举起 @火漆信@。」;错误「……举起 @火漆信。」——漏写闭合 @ 的引用
|
|
286
|
-
不会生效(生成时会按设定集名称自动补全修复,但不要依赖)
|
|
287
|
-
- 未命中设定集的名字不会报错,但会失去一致性保障——所以先补设定集再加 `@资产名@`
|
|
20
|
+
- **随时可查**:`canvas_production_status` → 当前阶段、闸门通过情况、缺失清单、证据计数、下一步。
|
|
21
|
+
- **完成语义**:宣称"完成/可交付"前必须调它;只有 `ready:true` 或用户明确验收才允许说完成。
|
|
22
|
+
- **阶段不是内容模板**:只规定"现在该做哪类操作";剧情、人物、风格永远由你和用户决定。
|
|
23
|
+
- **六道代码闸门**(宿主直接拒绝,不是建议):
|
|
288
24
|
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
|
292
|
-
|
|
|
293
|
-
|
|
|
294
|
-
|
|
|
295
|
-
|
|
|
296
|
-
|
|
|
297
|
-
|
|
298
|
-
生成角色/场景/道具参考图时,**用 `canvas_create_node` 的 `name` 直接写这个规范名**;
|
|
299
|
-
插件会把资产记录绑定到对应实体(`entity` 字段),之后任何 `@资产名@` 都能精确取到它。
|
|
300
|
-
|
|
301
|
-
**每集/后续工作的一致性纪律**:
|
|
302
|
-
|
|
303
|
-
1. 每集开工前先 `canvas_get_bible`,**只沿用已有名称**;新元素先 `canvas_update_bible` 补卡再使用。
|
|
304
|
-
2. **绝不改名**:一个角色的名字一旦写进设定集,后续所有集数、所有提示词都用同一个名字。
|
|
305
|
-
3. 已生成的参考图资产**持续复用**:`@资产名@` 会自动带上它们,不需要重复生成。
|
|
306
|
-
4. 若某实体还没有参考图,先为它建一个 `image` 图片节点生成(用规范命名),再进入镜头生成。
|
|
307
|
-
## 四、节点类型与字段
|
|
308
|
-
|
|
309
|
-
| 类型 | 用途 | 主要字段 |
|
|
310
|
-
| --- | --- | --- |
|
|
311
|
-
| `script` | 剧本 | `idea`=创作意图/提示词,`output`=剧本成稿 |
|
|
312
|
-
| `storyboard` | 分镜表(多镜头脚本) | 由剧本拆镜头(画布内生成);一个分镜表对应一次视频生成 |
|
|
313
|
-
| `image` | 图片节点(合并类型:有 `assetId` 就是资产图,有 `prompt` 就是待生成) | `prompt`=画面提示词;`size`/`ratio`;有结果即资产 |
|
|
314
|
-
| `video` | 视频节点(合并类型:生成与结果同属一个节点,多镜头一次性生成) | 多镜头提示词来自上游分镜表连线;`duration`=各镜时长之和;有 `assetId` 即资产 |
|
|
315
|
-
| `text` | 自由文本 | `text` |
|
|
316
|
-
|
|
317
|
-
## 四、生成能力(必须真的产出内容)
|
|
318
|
-
|
|
319
|
-
1. **文本类(剧本 / 分镜)**:可由你直接生成完整正文,用
|
|
320
|
-
`canvas_write_node({ projectId, nodeId, text: 完整正文, target: 'output' })` 写入;
|
|
321
|
-
也可让画布用它自己配置的模型生成:`canvas_generate_node({ projectId, nodeId, waitSeconds })`。
|
|
322
|
-
2. **图片 / 视频**:只能由画布生成(使用用户在画布设置里配置的图片/视频接口):
|
|
323
|
-
`canvas_generate_node({ projectId, nodeId, waitSeconds })` 触发并等待(等价于点节点上的生成按钮;
|
|
324
|
-
图片约 30–120s、视频数分钟),或只触发不等待:`waitSeconds: 0` → 再用 `canvas_node_status` 轮询。
|
|
325
|
-
**执行前提:画布页面处于打开状态**(运行请求由画布轮询消费);等待超时≠失败,继续查状态即可。
|
|
326
|
-
3. **改节点内容用 `canvas_update_node`,绝不删节点重建**:读现状用 `canvas_node_status`
|
|
327
|
-
(它会返回生成节点的对话框提示词 `prompt`、比例/清晰度/时长/分辨率、衔接模式、历史产物 id 等),
|
|
328
|
-
改内容用 `canvas_update_node({ projectId, nodeId, patch: { prompt: '……', ratio: '9:16', duration: 5 } })`——
|
|
329
|
-
可改字段:prompt / idea / output / text / script / requirement / shots / label / ratio / size /
|
|
330
|
-
duration / resolution / frameMode / count / imageModel / videoModel / model。
|
|
331
|
-
节点 id、类型、坐标、尺寸等结构字段不可改。**用户改提示词、换参数、重生成,全程不需要删节点。**
|
|
332
|
-
4. **模型为空/报错时**:`canvas_node_status` 会给出错误文本(例如"模型未返回文本")——
|
|
333
|
-
如实转达,并建议用户在画布设置里更换文本/图片/视频模型;**不要谎报已生成**。
|
|
334
|
-
5. **生成需要时间**:图片/视频可能几十秒到数分钟。用 `canvas_generate_node` 的 `waitSeconds`
|
|
335
|
-
一次等到终态(推荐),或触发后间隔轮询 `canvas_node_status`(建议 ≥10 秒一次),不要反复触发同一节点。
|
|
336
|
-
6. **节点上的 `genWarn` 字段必须转达**:参考素材超出厂商上限被截断、厂商忽略参数等事实都会写在这里——
|
|
337
|
-
如实告诉用户,绝不忽略(例如"参考图 12 张超过该厂商上限 9 张,本次只用了前 9 张")。
|
|
338
|
-
视频节点的 `genWarn` 还会带**衔接相关事实**:「已自动取上一段尾帧作为本段首帧」「接缝校验未通过:…」——
|
|
339
|
-
接缝告警要明确建议"调低运动幅度重生成 或 改硬首帧",不要轻描淡写。
|
|
340
|
-
7. **衔接状态也在节点上**:`chainFrom`(`'wired'`=首帧来自 frame 连线 / 节点 id=自动取上一段尾帧)、
|
|
341
|
-
`seam`(`{ ok, sim, thr, note }` 接缝校验结果)、`tailPickMeta`(`{ t, score }` 最佳选帧的时间点与得分)。
|
|
342
|
-
`canvas_node_status` 会带出这些字段;汇报成片质量时一并说明。
|
|
343
|
-
|
|
344
|
-
## 五、生成参数来源(不要臆造参数)
|
|
345
|
-
|
|
346
|
-
- **文本模型**:走 Harness 里已配置的 provider/model 与其默认参数。画布设置里可填「输出上限」「温度」,
|
|
347
|
-
**留空即不下发该字段**(用 Harness/模型的默认值)。
|
|
348
|
-
- **图片 / 视频 / 配音**:走用户在画布设置里配置的 API 与其参数;仅当用户填写了覆盖项
|
|
349
|
-
(如图片 `size`、`response_format`、Seedance 的音频/水印)才发送,否则用 API 默认。
|
|
350
|
-
- **不要**向用户断言某个模型的上下文/输出上限数值——以 Harness 配置与厂商文档为准
|
|
351
|
-
(例:GLM-5.3 / GLM-5.3-Flash 为 1M 上下文、最大输出 128K)。
|
|
352
|
-
- 生成失败时,插件会回传真实原因(含 chunk 类型统计);如实转达,不要猜测。
|
|
353
|
-
|
|
354
|
-
## 六、ArtCraft 后期全流程(PhotoCraft / FilmCraft / EffectCraft)
|
|
355
|
-
|
|
356
|
-
前置:用户需安装 `dsh-artcraft` 插件并配置三个 CLI 路径(画布设置 → Craft 后期 卡片会显示
|
|
357
|
-
就绪/缺失状态与数据目录)。资产会同步到 Craft 工作区按项目分目录存放。
|
|
358
|
-
|
|
359
|
-
流程顺序(每一步的输出是下一步的输入):
|
|
25
|
+
| 闸门 | 触发 | 要求 |
|
|
26
|
+
|---|---|---|
|
|
27
|
+
| G1 设定集先行 | 生成剧本/分镜前 | 世界观 + 风格 + ≥1 角色 |
|
|
28
|
+
| G2 分镜质量 | 建/跑视频节点前 | 时长/画面/景别/大特写/三镜不同运动/seg 合法 |
|
|
29
|
+
| G3 一表一视频 | 建视频节点 | 该分镜表下不能有第二个视频(改参数用 `canvas_update_node`) |
|
|
30
|
+
| G4 禁逐镜节点 | 建图片/视频 | 名字不得含「镜N」(一致性靠参考图资产) |
|
|
31
|
+
| G5 破坏性确认 | 删节点/项目 | 必须带 `confirm`(用户确认原话) |
|
|
32
|
+
| G6 阶段越序 | 触发视频 | 阶段 ≥ shots_ready |
|
|
360
33
|
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
3. **PhotoCraft(调色/修图)**:对单张或批量图片做无头调色,产物为调色后的图片资产。
|
|
365
|
-
4. **EffectCraft(片头/特效)**:生成片头动画(Lottie/序列),作为成片开场。
|
|
366
|
-
5. **FilmCraft(成片渲染)**:把分镜视频片段 + 配音 + 字幕合成成片。
|
|
367
|
-
画布上的「成片(finalcut)」节点会把片段合成 MP4,并可导出 **FCP7 XML + SRT** 交给
|
|
368
|
-
FilmCraft 渲染正式成片。
|
|
369
|
-
6. **交付**:成片资产可在「资产」页下载;数据根目录下 `projects/<项目>/…` 有对应文件。
|
|
34
|
+
- **逃生舱**:用户明确要求时传 `override: { by: 'user-explicit', quote: '用户原话' }` 放行(写入审计);
|
|
35
|
+
绝不用 override 绕过用户没同意的事。
|
|
36
|
+
- **显式推进/回退**:`canvas_production_advance`(必须带 reason);日常推进自动,不需要调它。
|
|
370
37
|
|
|
371
|
-
|
|
372
|
-
(节点内的 Craft 按钮、成片节点的导出按钮),对话工具目前不能代替点击这些按钮。
|
|
373
|
-
你能做的是:准备节点与提示词、写入成稿、触发生成、检查状态、并在完成后引导用户到画布执行后期步骤。
|
|
374
|
-
如果用户希望"对话直接驱动后期",请明确提出——这需要为 ArtCraft 增加对应工具。
|
|
38
|
+
## 零、自动创作与引导式工作坊(先判后做)
|
|
375
39
|
|
|
376
|
-
|
|
377
|
-
再重试;`effectcraft` 若未配置只影响片头,不阻塞成片。
|
|
40
|
+
开工先调 `canvas_auto_status`:
|
|
378
41
|
|
|
379
|
-
|
|
42
|
+
- **enabled=true(自动创作已开启)→ 全自动分支**:先 `canvas_open` 自动打开画布;从用户消息提取 brief
|
|
43
|
+
(拍什么/给谁看/什么情绪)。**禁止调用 ask_user_question(任何理由,不得以"只问一个"变通)**——
|
|
44
|
+
信息不足时由编剧室自行拟 3 个候选方向并选定一个,把理由写进会议记录;
|
|
45
|
+
随后**同一轮内必须**调用 `canvas_auto_start` 启动编剧室(调研 → 编剧A/B 独立提案 → 互评 → 监制决策 → 设定集 → 剧本 → 分场 → 分镜 → G2 → 预算单)。
|
|
46
|
+
**全程禁止逐步提问**(导演/题材/规格/影调由监制代选并记录理由);预算单用 `canvas_auto_budget` 出单并汇报一次;
|
|
47
|
+
用户批准后 `canvas_auto_generate` 跑付费段(逐场视频 + 成片节点);要停就用 `canvas_auto_abort`(保留已产出)。
|
|
48
|
+
- **enabled=false → 保持导演工作坊引导流程**(一次一问)。
|
|
380
49
|
|
|
381
|
-
|
|
382
|
-
- ❌ 每个节点都新建项目 → 用 `canvas_write_node` 往同一 projectId 追加
|
|
383
|
-
- ❌ 只写提示词、不写剧本正文 → 成稿必须进 `output`
|
|
384
|
-
- ❌ 节点不留名字 → 一律用 `name` 命名
|
|
385
|
-
- ❌ 未经确认就删除项目/节点 → 先列表确认、再按用户明确要求删除
|
|
386
|
-
- ❌ 分镜还是"中景,他走过来/镜头缓慢推近"这种粗颗粒就急着生成视频 → 先过硬约束 16 的质量闸门
|
|
387
|
-
(每场冲突点 / 每场 1 个大特写 / 连续三镜不同运动 / 景别具体 / 因果钩子 / 六要素),
|
|
388
|
-
重生成分镜不花钱,视频按秒计费
|
|
389
|
-
- ❌ 把景别写成"镜头""画面"、把「大特写」写成"大豆/大特"、把「调度」写成"调职" → 按 `canvas-craft`
|
|
390
|
-
「术语勘误」统一,术语错 = 分镜粗,粗分镜 = 成片糊
|
|
50
|
+
## 一、本插件技能清单(分工与口径入口)
|
|
391
51
|
|
|
392
|
-
|
|
52
|
+
| 技能 | 管什么 | 何时加载 |
|
|
53
|
+
|---|---|---|
|
|
54
|
+
| `canvas-studio`(本篇) | 操作流程:建项目/写节点/触发/查状态 | 任何时候先读 |
|
|
55
|
+
| `canvas-craft` | 剧本四要素、分镜六要素、术语勘误、资产图版式 | 写剧本/分镜/提示词前 |
|
|
56
|
+
| `canvas-layout` | 一类型一列、绝不重叠 | 批量建节点前 |
|
|
57
|
+
| `canvas-director` | 导演透镜/题材/规格/影调/运镜 | 定风格前 |
|
|
58
|
+
|
|
59
|
+
- 调 `canvas_list_skills`:一次返回四份技能说明 + 四层完整清单(id 与名称)+ 项目已选配置。
|
|
60
|
+
- 调 `canvas_skill_pack({ projectId, kind })` 取切片(script/storyboard/prompt/assets),
|
|
61
|
+
**不要整份读技能包文件**;`set:true` 写进项目配置 = 对话与画布自生成同口径的唯一入口。
|
|
62
|
+
|
|
63
|
+
## 二、硬约束(违反 = 操作失败)
|
|
64
|
+
|
|
65
|
+
1. **设定集先行**:写剧本/分镜/生成前必须 `canvas_get_bible` 读、缺则 `canvas_update_bible` 补
|
|
66
|
+
(用户已给创意按其创意写,不另起一套)。创作意图/世界观/风格**只进设定集**,
|
|
67
|
+
【禁止】为它们建任何节点;角色/场景/道具参考图从设定集条目生成(image 节点 → `canvas_run_node`)。
|
|
68
|
+
2. **同一请求最多建一个项目**:`canvas_create_project` 前先 `canvas_list_projects` 查重,同名/同主题直接复用。
|
|
69
|
+
3. **绝不为单个节点建项目**:加内容用 `canvas_write_node`;只有用户明确"另开项目"才新建。
|
|
70
|
+
4. **失败重试不重建资源**:先查是否已创建成功,复用,不靠"再建一个"。
|
|
71
|
+
5. **每个节点都要有名字**(`name`),同名加区分后缀。
|
|
72
|
+
6. **一个剧本节点同时有 `idea` 与 `output`**:正常由节点生成(idea → `canvas_run_node`);
|
|
73
|
+
仅用户明确"直接写稿"才 `target:'output'`。【禁止】拆成两个半残节点、只写提纲占位;
|
|
74
|
+
分镜内容只能放分镜表节点。
|
|
75
|
+
7. **删除是破坏性操作**(G5):`canvas_delete_node` / `canvas_delete_project` 先列表确认 id,
|
|
76
|
+
仅在用户明确要求时执行,必须带 `confirm`(用户原话);改内容永远走 `canvas_update_node`,不需要删。
|
|
77
|
+
8. **完成后让用户看到**:`canvas_open({ projectId })`。
|
|
78
|
+
9. **一致性告警闭环**:`canvas_node_status` 的 `warnings` 非空时逐条 `canvas_update_bible`
|
|
79
|
+
(名称逐字一致、描述可生成),绝不忽略或只补一半;设定集更新后告警自动重算,以最新一次为准。
|
|
80
|
+
10. **分镜粒度**:一个分镜表 = 一个完整场景视频;各镜时长按节奏谱系(普通 2–4s / 快切 0.3–0.8s /
|
|
81
|
+
反转 1–2s / 情绪长镜 ≥5s),支持一位小数、拒绝均匀分布;长剧本按【场N】拆成多个场景剧本节点,
|
|
82
|
+
整集剧本只作总纲不连分镜表;`shots` 上限 24;镜头数按内容节拍(3–10 镜都正常),绝不凑数。
|
|
83
|
+
11. **汇报固定要素**:项目名 + id + 节点名/id + 成稿摘要;有错误如实说明;`genWarn` 必须转达。
|
|
84
|
+
12. **生成前置检查单**:① 镜头清单只来自分镜表 `shots`(读不到就问用户,绝不编造);
|
|
85
|
+
② 一个分镜表只建一个视频节点(G3);③ 先建 1 个、`canvas_node_status` 验证、再继续。
|
|
86
|
+
13. **读不到就问**:必需状态读不到 = 向用户确认的缺口,绝不把"编一份"当替代。
|
|
87
|
+
14. **连贯靠连线**:上一场分镜表 `tail` → 本场 `prev`(`canvas_connect`);生成后第 1 镜自动承接
|
|
88
|
+
上一场尾镜(重叠 ≤0.2s、背景声连续)。【禁止】用名字/序号猜衔接;补连后重跑该分镜表即可修正。
|
|
89
|
+
15. **口型同步**:带 `dialogue` 的镜头必须让说话角色画面内开口(近/中近景、脸部可见),
|
|
90
|
+
台词绝不能变画外音;`visual`/`motion` 写明「开口说话、口型清晰可见」。
|
|
91
|
+
16. **分段接戏四字段**:`tail`(动作进行中)/`cam`(可延续)/`start`(仅非续帧)/`seg`
|
|
92
|
+
(只能 opening/continuation/scene_change/new_character/closeup);改 `shots` 必须**整表替换**
|
|
93
|
+
并保留这四字段;只有 `continuation` 接力尾帧。视频优先用 `tailpick` → `frame`;
|
|
94
|
+
衔接模式三选(参考图融合默认 / 硬首帧 / 忽略首帧);接缝校验偏跳时调低运动或改硬首帧。
|
|
95
|
+
17. **分镜质量闸门(G2)**:生成视频前按六条自检(每场冲突点 / 每场 1 个大特写 / 连续三镜不同运动 /
|
|
96
|
+
景别具体 / 因果钩子 / 六要素齐全);不过先重生成或改 `shots`——**绝不带粗分镜烧视频**。
|
|
97
|
+
术语统一:「大特写」「调度」;motion 写「起点→方式→终点」(勘误表见 canvas-craft)。
|
|
98
|
+
18. **多画布**:`canvas_list_projects` 列出 `canvasId` 清单;用户指明画布时所有工具**显式带 `canvasId`**;
|
|
99
|
+
资产与设定集按项目共享,不重复建。
|
|
100
|
+
19. **记忆先行 + 会话=画布**:开工先 `canvas_my_canvas` 自证「我是哪一集」;绑定会话**代码级禁止**
|
|
101
|
+
跨画布/跨项目(确需切换请用户先解绑);写本集前 `canvas_read_memory`(先调度索引后本集正文;
|
|
102
|
+
设定集存静态、记忆存动态);收尾必 `canvas_write_memory`(title/summary≤120 字/keywords/body/status)。
|
|
103
|
+
|
|
104
|
+
## 三、标准工作流
|
|
105
|
+
|
|
106
|
+
0. **读/补设定集**:`canvas_get_bible` → `canvas_update_bible`(worldview/style/characters/scenes/props)。
|
|
107
|
+
1. `canvas_list_projects` 查重,拿 projectId 与节点 id。
|
|
108
|
+
2. **剧本节点**(一集 60–120s,按【场N】分场):新项目 `canvas_create_project({ name, scriptText: 提示词 })`;
|
|
109
|
+
已有项目 `canvas_write_node({ target:'idea', name:'第X节剧本' })` → `canvas_run_node` → 轮询状态。
|
|
110
|
+
提示词必须点名两条叙事硬约束:每场结尾因果钩子(可拍摄的动作/物件,禁总结句)+ 每场至少一个冲突点
|
|
111
|
+
(目标—阻碍—转折—代价)。生成契约自动注入:4–10 场、每场 10–30s、每场以「【场N】场景名(地点·时间)」
|
|
112
|
+
单独一行开头、对白逐行「角色:台词」、结尾附人物/场景/道具清单。
|
|
113
|
+
3. **铺开到场景**:逐场建「场Y文本」(`canvas_write_node` 写该场原文)+ 「场Y分镜表」
|
|
114
|
+
(`canvas_create_node({ type:'storyboard', connectFrom: 文本节点 })`);
|
|
115
|
+
上一场分镜表 `tail` → 本场 `prev` 依次串联,**连好再生成**该场分镜(重生成分镜免费)。
|
|
116
|
+
4. **逐场视频**:`canvas_run_node` 分镜表 → 读 `shots` → 过 G2 六条 → `canvas_create_node({ type:'video',
|
|
117
|
+
connectFrom: 分镜表, duration: 各镜之和 })` → `canvas_generate_node({ waitSeconds })`。
|
|
118
|
+
多镜头一次生成,**禁止逐镜建节点**(G4);最多为开场首帧/关键镜头补 1–2 张定帧图;
|
|
119
|
+
参考图连视频 `ref` 口,`@资产名@` 命中自动挂载。跨段首帧画布自动接力(连好 `tail→prev` 即可用)。
|
|
120
|
+
5. **参考图**:为设定集每条目建 image 节点(命名规范见下节),prompt 按 canvas-craft「资产设定图版式」
|
|
121
|
+
写足(角色六段式/场景主图+环绕/道具 45° 主图+色卡),不留空壳节点。
|
|
122
|
+
6. `canvas_open({ projectId })` 让用户看到结果。**布局**:要精准摆放(对齐/指定坐标/分列)先 `canvas_layout_get` 读全图坐标,再 `canvas_layout_node` 批量精摆(可 `pinned:true` 钉住);只是想"整体理一下"才用 `canvas_relayout`(粗排兜底,钉住的节点不动)。
|
|
123
|
+
|
|
124
|
+
## 四、@引用与资产命名(跨集一致性核心)
|
|
125
|
+
|
|
126
|
+
提示词用 `@资产名@` 精确引用设定集条目(前后各一个 @,句末也要闭合);
|
|
127
|
+
命中后自动带外观描述 + 参考图资产 `[图N]`。命名规范(`canvas_create_node` 的 `name` 直接写):
|
|
128
|
+
|
|
129
|
+
| 用途 | 命名 | 例 |
|
|
130
|
+
|---|---|---|
|
|
131
|
+
| 角色 | `角色-<名> 设定图` / `参考图` | `角色-张山 设定图` |
|
|
132
|
+
| 场景 | `场景-<名>` | `场景-褶皱巷` |
|
|
133
|
+
| 道具 | `道具-<名>` | `道具-火漆信` |
|
|
134
|
+
| 分镜整段视频 | `<集数>-<场次> 多镜头视频` | `第1集-场3 多镜头视频` |
|
|
393
135
|
|
|
394
|
-
|
|
136
|
+
纪律:只沿用设定集已有名称、**绝不改名**;已生成参考图持续复用;缺参考图先补再生成。
|
|
137
|
+
同一角色的声音一致性:用视频/成片节点「提取声音参考」(输入角色名,自动按 `dialogue` 定位拼接)。
|
|
395
138
|
|
|
396
|
-
|
|
397
|
-
- `action=apply` + `spec` → 写入项目并落盘;客户端打开 3D 导演台会自动套用
|
|
398
|
-
- `action=get` → 读回当前规格
|
|
139
|
+
## 五、节点类型与生成能力
|
|
399
140
|
|
|
400
|
-
|
|
401
|
-
|
|
141
|
+
| 类型 | 用途 | 要点 |
|
|
142
|
+
|---|---|---|
|
|
143
|
+
| `script` | 剧本 | `idea`=创作提示词,`output`=成稿 |
|
|
144
|
+
| `storyboard` | 分镜表 | 源端=场景文本连线;`shots` 结构化镜头 |
|
|
145
|
+
| `image` | 图片(合并类型) | 有 `assetId` 即资产;面板不渲染成段文字(≤4 字标签) |
|
|
146
|
+
| `video` | 视频(合并类型) | 多镜头一次生成;`duration`=各镜之和 |
|
|
147
|
+
| `text` / `finalcut` | 自由文本 / 成片 | finalcut 导出 FCP7 XML + SRT 交 FilmCraft |
|
|
148
|
+
|
|
149
|
+
- **改不删**:改内容一律 `canvas_update_node`(prompt/idea/output/text/shots/ration/duration 等;
|
|
150
|
+
结构字段不可改)+ 重新生成;用户改提示词/换参数全程不需要删节点。
|
|
151
|
+
- **生成**:图片 30–120s、视频数分钟;`canvas_generate_node({ waitSeconds })` 一次等终态
|
|
152
|
+
(画布页面须打开),或 `waitSeconds:0` 后轮询 `canvas_node_status`(≥10s 一次,不反复触发)。
|
|
153
|
+
- **视频提示词自动结构化**(分镜+参考图+设定集 → 厂商参考生成格式):你只需保证
|
|
154
|
+
① 每镜 `dialogue` 有「角色名+逐字台词」② 设定集条目带「外观:」「声音:」③ 参考图已连线。
|
|
155
|
+
- **失败如实说**:`canvas_node_status` 的 error / `genWarn`(截断、忽略参数、接缝校验)必须转达,
|
|
156
|
+
绝不谎报已生成;模型未配置时建议用户在画布设置里更换。
|
|
157
|
+
- **参数不臆造**:文本走 Harness 默认(画布可覆盖输出上限/温度);图片/视频仅发送用户配置的覆盖项。
|
|
158
|
+
|
|
159
|
+
## 六、ArtCraft 后期(PhotoCraft / EffectCraft / FilmCraft)
|
|
160
|
+
|
|
161
|
+
前置:安装 `dsh-artcraft` 并配置 CLI 路径(设置 → Craft 卡片显示就绪状态)。
|
|
162
|
+
顺序:素材就绪 → 资产落盘(同步按钮)→ PhotoCraft 调色 → EffectCraft 片头 → FilmCraft 成片渲染 → 交付。
|
|
163
|
+
**边界如实告知**:后期执行按钮在画布 UI 上,对话侧负责准备节点/提示词/触发生成并引导用户点击;
|
|
164
|
+
先 `artcraft_status` 探活,链 id 以 `artcraft_recipes` 返回为准(不背名单);QC PASS 前不宣告完成。
|
|
165
|
+
|
|
166
|
+
## 七、必须避免的错误
|
|
167
|
+
|
|
168
|
+
- ❌ 一次请求建多个项目 / 每个节点建项目 → 查重复用 + `canvas_write_node`
|
|
169
|
+
- ❌ 只写提示词不给成稿落点 / 节点不留名字
|
|
170
|
+
- ❌ 未经确认删除(G5 会拒)→ 先列表确认,再按用户明确要求执行
|
|
171
|
+
- ❌ 粗分镜直接生成视频(G2 会拒)→ 重生成分镜不花钱,视频按秒计费
|
|
172
|
+
- ❌ 景别写"镜头/画面"、大特写写成"大豆" → 按 canvas-craft 术语勘误统一
|
|
173
|
+
- ❌ 整集剧本直连分镜表 / 逐镜建图片视频节点(G4 会拒)→ 场景拆分 + 参考图资产
|
|
174
|
+
- ❌ 跨集不开工不读记忆、收尾不回写 → 下一集重复创作、丢伏笔
|
|
175
|
+
|
|
176
|
+
## 附:3D 导演台(预演)
|
|
177
|
+
|
|
178
|
+
`canvas_director_stage`:`action=help` 列姿态/道具/片段;`action=apply` + JSON 规格写入并落盘;
|
|
179
|
+
`action=get` 读回。规格:`title/duration/env/characters[]/props[]/cameras[]/shots[]`(详见工具描述)。
|