# Tapcanvas Demo Patterns

> 使用已提炼的视觉连续性方法论：先锁资产、角色、场景与镜头语义，再做扩镜与视频。

- Skill: `anymouschina/tapcanvas-demo-patterns` (Agent Skill)
- Install (CLI): `npx skillmds@latest add anymouschina/tapcanvas-demo-patterns`
- Raw SKILL.md: https://api.skillmd.com/api/skills/anymouschina/tapcanvas-demo-patterns/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: anymouschina (https://skillmd.com/u/anymouschina)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/anymouschina/tapcanvas-demo-patterns

---


# TapCanvas Demo Patterns

## 来源边界

- 本 skill 已固化经审查的共性规律，不依赖仓库外的原始研究素材。
- 运行时直接使用本 skill，不把 `docs/`、`assets/` 或 `ai-metadata` 当作知识源读取。
- 你只能把这里的方法与本轮实时证据结合使用，不能把 demo 个案细节当成当前项目事实。

## 核心原则

1. 先锁锚点，再写 prompt；prompt 只是表达层，不是事实来源。
2. 图像层先成为连续性 authority，视频层只承担受约束的运动补完。
3. 一次只改一个大变量；不要把角色、场景、机位、光线、动作同时改写。
4. chapter-grounded 生产前，必须先盘点并区分：
   - 角色锚点：角色卡、三视图、`@角色名` 命中结果、章节已确认角色图
   - 场景锚点：权威基底帧、scene/prop reference、selectedReference.referenceBindings、上一组 `tailFrameUrl`
   - 镜头语义锚点：构图、景别、主体比例、朝向、拍摄语法、动作节拍
   - 连续性锚点：章节正文、source bundle、continuity checkpoint
5. 若只有角色卡而没有稳定场景锚点，不得直接批量生成多张图或多段视频；先建立权威基底帧。
6. 关键帧数量、镜头数量与视频段数不预设固定模板；应由主代理基于章节证据、连续性边界与当前目标自行决定。

## 资产锁定法

### 1. Freeze-all-except-one

- 明确声明“除一个变量外，其余全部保持不变”。
- 适用：
  - 改机位
  - 反打
  - 轻微道具变化
  - 背景清理

### 2. 先锁拍摄语法

- 先说明是谁在拍、从哪里拍、镜头是否固定、景别是什么，再谈风格或戏剧升级。
- 不要只写“电影感/震撼/高级感”。

### 3. 镜头语义先于风格迁移

- 若是跨风格改编，必须先冻结：
  - 构图
  - 主体比例
  - 朝向
  - 光影逻辑
  - 动作意图
- 风格迁移稳定后，才允许天气、眼部、道具、局部表情等微调。

### 4. 视频只继承，不重发明

- 视频 prompt 必须继承已锁定关键帧的：
  - 角色身份
  - 场景拓扑
  - 光线/时间
  - 镜头路径
  - 允许动作
- 视频里必须同时写：
  - 允许发生什么
  - 禁止发生什么

## chapter-grounded 生产顺序

1. 先读 `tapcanvas_storyboard_source_bundle_get`
2. 再读 `tapcanvas_storyboard_continuity_get`
3. 再读 `tapcanvas_flow_get` 或当前节点 bundle，确认当前画布状态
4. 列出：
   - confirmed facts
   - locked anchors
   - missing anchors
5. 判断当前属于：
   - `start_new_scene`
   - `continue_from_confirmed_anchor`
   - `repair_continuity`
   - `expand_locked_keyframe`
   - `prepare_video_from_locked_frames`
6. 若无权威基底帧，先创建/规划基底帧
7. 再做单变量扩镜
8. 选稳定关键帧后，再进入视频

## 结构化落板契约

- 当你要用 `tapcanvas_flow_patch` 创建或改写 chapter-grounded 的视觉节点时，本轮每一个相关视觉节点都必须在同一轮同步写入结构化 `data.productionMetadata`；禁止先落节点、下一轮再补 metadata。
- `productionMetadata` 推荐挂在 companion `text` / `storyboardScript` 节点，或显式 patch 到当前章节脚本节点；不要把它埋成只存在于自然语言说明里的隐含判断。

推荐结构：

```json
{
  "chapterGrounded": true,
  "lockedAnchors": {
    "character": ["..."],
    "scene": ["..."],
    "shot": ["..."],
    "continuity": ["..."],
    "missing": ["..."]
  },
  "authorityBaseFrame": {
    "status": "planned | confirmed",
    "source": "selected_reference | tail_frame | existing_flow_anchor | generate_first",
    "reason": "..."
  }
}
```

- `lockedAnchors` 不是装饰字段；至少要把角色、场景、镜头、连续性、缺口分开写清。
- 若本轮要立即执行真实基底帧，`authorityBaseFrame.status` 可以先是 `planned`，但执行态仍应停在“基底帧计划 + 单张 image-like 基底帧节点”。
- 若本轮只是先搭建待执行图谱，可以在 `planned` 下先落 `group + script + pending/needs_confirmation` 的关键帧/视频占位节点，但必须把 `lockedAnchors.missing` 明确写出“基底帧待确认”，且不能把这些节点描述成已出图或已出视频。
- 只要本轮开始落回真实多图/视频结果，或把批量视觉结果写成已执行状态，`authorityBaseFrame.status` 就必须已经是 `confirmed`。

## 多代理分工

- `research`
  - 提取章节事实、角色状态、连续性义务、可用锚点
  - 明确哪些只是 diagnostics，不能当 source of truth
- `writer`
  - 用已确认锚点起草节点、关键帧 prompt、视频 prompt