Next AI Draw.io
draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand
Agent skill that turns Claude Code / Codex into a motion-design studio for voiceover-driven explainer videos — word-level voiceover sync, 109 motion recipe cards, an anti-slideshow camera system, Remotion rendering.
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/skills/vincentwei1021-video-talkcraft)같은 작업에서 AI를 서비스에 연결하는 MCP
draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand
Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.
Verified React chart generation: select, validate, repair, render, and inspect charts through MCP.
같은 종류의 작업, Skill 목록과 같은 순서
| 이 항목 video-talkcraft | impeccable | diagram-design | frontend-slides | guizang-ppt-skill | |
|---|---|---|---|---|---|
| 제작자 | Vincentwei1021 | pbakaus | cathrynlavery | zarazhangrui | op7418 |
| Skill 수 | 1 | 1 | 1 | 1 | 1 |
| GitHub 별 | 2,420 | 113,042 | 68,296 | 32,579 | 30,091 |
| 마지막 코드 변경 | 2026년 11월 19일 | 2026년 11월 19일 | 2026년 11월 19일 | 2026년 6월 24일 | 2026년 10월 30일 |
| 라이선스 | – | Apache-2.0 | MIT | MIT | AGPL-3.0 |
Vincentwei1021의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요
MCP = 손
AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.
Skill = 안내서
작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.
겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.
Claude CodeCodex
제작자 README와 repo 폴더 기준
GitHub account Vincentwei1021 (person), 10 years old
★ 2,420 stars · code last changed 2026년 11월 19일
102 scripts that can run on a computer: runtime/check-runtime.sh, runtime/link-runtime.sh, scripts/pipeline_state.mjs, scripts/workbench_contract_lint.py and 98 more
Could not check every script (some are too large); read them first
No hooks or writes to machine settings found
Checked automatically from the repo files at commit 75e266f (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
먼저: 어떤 AI를 쓰시나요
쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다
This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier
Download from GitHub (whole repo) ↗
Unzip it, then zip only the video-talkcraft folder again. The ZIP must have a video-talkcraft folder with SKILL.md at the top level, no loose files
+Create skillUpload a skillpick video-talkcraft.zip
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs 2026년 11월 12일 · Source: support.claude.com, support.claude.com, code.claude.com
이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Claude Code를 다시 열고 /video-talkcraft를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요
Checked against official docs 2026년 11월 12일 · Source: code.claude.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -vMac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
npx skills add Vincentwei1021/video-talkcraft제작자 README에서 가져온 명령으로, 제작자 코드를 내려받아 실행해요
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
git clone --depth 1 https://github.com/vincentwei1021/video-talkcraft.git /tmp/popnx-skill-vincentwei1021-video-talkcraft-75e266f && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-vincentwei1021-video-talkcraft-75e266f/.' ~/.claude/skills/video-talkcraftChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다
ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
video-talkcraft 폴더를 ~/.agents/skills/video-talkcraft에 넣으세요
~는 홈 폴더($HOME)입니다
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
git clone --depth 1 https://github.com/vincentwei1021/video-talkcraft.git /tmp/popnx-skill-vincentwei1021-video-talkcraft-75e266f && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-vincentwei1021-video-talkcraft-75e266f/.' ~/.agents/skills/video-talkcraftChecked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다
이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
git clone --depth 1 https://github.com/vincentwei1021/video-talkcraft.git /tmp/popnx-skill-vincentwei1021-video-talkcraft-75e266f && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-vincentwei1021-video-talkcraft-75e266f/.' ~/.agents/skills/video-talkcraft이 문장을 복사해 Cursor 채팅에 붙여 넣으세요
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Cursor Agent 채팅에서 /를 입력하고 video-talkcraft 선택
Checked against official docs 2026년 11월 12일 · Source: cursor.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
git clone --depth 1 https://github.com/vincentwei1021/video-talkcraft.git /tmp/popnx-skill-vincentwei1021-video-talkcraft-75e266f && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-vincentwei1021-video-talkcraft-75e266f/.' ~/.cursor/skills/video-talkcraftSkill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.
2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인
✓ 명령 확인 2026년 11월 19일
아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요
처음 8,000자 표시 · GitHub에서 전체 파일 열기
---
name: video-talkcraft
description: 终极口播视频 skill:中文口播稿 + 成品配音 → CPU 字级时间戳 → SHOTBOOK 层矩阵分镜 → Remotion 电影感成片(横屏默认/竖屏)。当用户要"做口播视频"、"解说/科普视频"、"把文案变成视频"、"给配音配画面动效"时使用。默认使用成品配音,可选 Fish Audio 从稿子合成配音与时间戳;数字人生成技术不在本 skill 内(人物素材是输入)。含统一视觉语言(Apple 范式)、108 张动效配方卡、镜头三面分层工作单、七层镜头反PPT系统(极缓推拉相机/让位,运动做减法)、六式运动承接转场(每式一卡)、长镜头世界画布、anime.js+three.js 桥、自动静止检测 + 独立 subagent 评估循环。
---
# video-talkcraft — 口播视频 skill
三大来源合体:**管线**(配音→字级时间戳→Remotion)+ **词汇**(108 张动效配方卡,全配可播 demo + 自包含 tsx)+ **镜头**(七层模型反 PPT 系统)+ **视觉语言**(Apple 范式默认版)。
核心范式:解说词驱动画面,每句都要有**活的画面响应**(相机极缓推拉/已有元素的变化),
但**新元素只在语义拍边界进场,禁止机械的"一句一个新元素"**(一句一元素是堆积型凌乱的制度根源;
分镜按语义段落切,排版预算见 cinematography.md §4.5);
**一个节拍只有一个主角,说完就让位**;字幕句边界 = 全片时间锚点。
## 流程
```
① 文案 → ② 配音输入+时间戳(本机CPU) → ③ 素材 → ④ SHOTBOOK 层矩阵 → ⑤ 实现(全局系统 → 首镜先做先确认 → 其余镜头)
→ ⑥ 渲染 → ⑦ 三重验收(机器闸全过 + 1 轮审片修 P0/P1)→ ⑧ 交付(可选续审 ≤3 轮)
```
## ⓪ 开工体检:统一依赖 + 画幅与视觉语言
**依赖只有一份**:所有口播工程的 `remotion/node_modules` 与 `workbench/node_modules` 都是指向 `<skill根>/runtime/node_modules` 的软链,版本只在
`runtime/package.json` 里钉(`@remotion/*` 全家同号)。**新片开工第一件事**(用户 2026-09-15 定版:每次新做视频都要检查更新):
```bash
bash <skill根>/runtime/check-runtime.sh --upgrade # 装好共享依赖 + 共享无头浏览器 + 链好 workbench;Remotion 有新版就全家升级并冒烟渲 1 帧,不过自动回滚
```
末行 `[runtime] OK` 才往下走;升了级要把 `runtime/package.json` / `package-lock.json` 的改动提交。**制作中途不升级**(母版段缓存不认依赖版本,混版本渲出的段不一致)。
工程目录里**永远不跑 `npm install`**(会写进共享目录);要加包 → 加进 `runtime/package.json`,`npm ci`,再提交。
### 画幅与视觉语言(开工先定,全流程引用)
- **画幅默认横屏 1920×1080**(用户偏好);明确要发抖音/竖屏渠道才用 1080×1920
- 视觉语言:**用户明确点了风格就按用户的来**(整套 token 替换);没点时**先从口播稿判定领域、派生本片风格档**
(`references/design-language.md` §0:读全稿答"讲什么 / 对谁讲 / 什么口吻"→ 领域 → 风格档表给底色策略 / accent / 字体气质 / 材质与卡造型 / 图表语言 / 素材气质 / 能量档,
写进 SHOTBOOK §0 `G0 风格档`),骨架仍是 Apple 范式(一个强调色/一个投影/底色交替分幕/两档字重/
默认幕底:浅 `pastel-mesh-flow` / 深 `mesh-flow-dark`——12 款幕底见 §1.1,代码 `template/motion-systems/backdrop.tsx`),
派生本片 token 落成 `theme.ts`。对任何风格都成立的只有一条:禁止逐场景随手取色。
**卡是中性 UI,进片必须蒙皮**:动效卡的 demo / tsx 是无风格的中性呈现,复制进工程后按风格档改皮(颜色 / 字体 / 圆角 / 材质 / 图表坐标轴与标记 / 占位图形)、
不改运动命门(时序 / 缓动 / 几何比例 / 层级),契约与反例见 design-language §0.4;SHOTBOOK 每镜写**蒙皮行**
## ① 口播稿
- 每句一个信息点,钩子在第一句(数字/冲突);13 句 ≈ 95s
- **数字一律汉字**(时间戳按文本逐字锚定,`197747` 无法与"十九万七千"的读音对位);英文品牌词直接写(中英混合对齐已验证)
- 先调研核实事实,列"事实红线清单"(不可说错的数字/未验证数据不引用)
## ② 配音输入 → 预剪 → 字级时间戳(默认本机 CPU;可选 Fish Audio)
**默认使用成品配音**:真人录音或任何 TTS 皆可,输入 = 一条完整配音(wav/mp3)+ 与之逐字一致的口播稿。
没有录音且用户选择合成时,可使用下面方案 B;它不会替换已有配音或默认的本机 CPU 流程。
**②-0 配音预剪(真人录音必做;TTS 只会压气口,可跳过)**——剪掉口水词(嗯 / 呃 / 那个…)、结巴重说、过长停顿,
**在做时间戳之前**跑(时间戳做完再动音频 = timing / beats 全体错位;预剪 → 时间戳 → 一切后续,顺序不可换):
```bash
python3 scripts/voice_trim.py audio/raw.wav script.json --dry-run --words-out audio/asr_words.json # 先只出报告:逐条 [filler / repeat / pause] 起止 + 共剪多少;ASR 结果落盘
python3 scripts/voice_trim.py audio/raw.wav script.json --words audio/asr_words.json --out audio/full.wav \
[--video dh/host_raw.mp4 --video-out dh/host.mp4] # 用户认可后落盘(吃回上一步的词表,不再跑一次 ASR);同一条录音的人物视频用同一 EDL 剪(音画逐帧同长)
```
- **稿子是真值,宁漏勿错**:只剪 ASR 里**稿子没有的插入段**——全由口水词表拼成的(filler)、等于紧邻稿文的结巴 / 重说(repeat);
ASR 听错稿子里的字永不剪(剪它就剪掉了那个字的真实发音);稿外改了措辞的重说只报告,`--cut-unmatched` 才剪。
词表来源缺省跑 FireRed(与下面时间戳同一后端),也吃剪映等导出的**逐字** SRT(`--srt`)或词级 JSON(`--words`);
句级 SRT 定位不到口水词,脚本会警告。无稿时只剪**整 token 文字恰为**保守词表(嗯 / 呃 / 额 / um…)的口水词——按规范化文字精确比对、不认同音(五≠唔、饿≠呃);
紧邻重复的短词无稿只报告不剪(逐字 token 下分不清叠词与结巴)。剪同录的透明 webm 时会解一帧核 alpha,帧数对但透明丢了也算 FAIL。
- 停顿:≥0.7s 的静音压到 0.35s(留段内最安静的一窗真实房间音,不补数字零),首尾留白 0.25 / 0.5s;
切点先找能量谷、再吸附 30fps 帧网格;`cuts.json` 是 EDL(含源 → 新时间轴映射表,剪人物视频与后续任何对账都吃它)。
- **dry-run 报告必须给用户过目再落盘**:标了「切点未落在静音里,听一下」的条目让用户听那一处;脚本只删不合成,不改语速不改音高。
剪完人物视频后跑 ③ 的 `preflight.py --media-only` 核时长——同一 EDL 只对同一条录音成立。
字级时间戳(对**预剪后**的 `audio/full.wav`):
```bash
# 方案 A(已有录音,本机 CPU 对齐):
pip install zhconv pypinyin sherpa-onnx soundfile numpy # 默认后端 FireRedASR2-CTC int8 的全部依赖
# 首次:下载模型 767MB(model.int8.onnx + tokens.txt)放 ~/.cache/koubo/<模型名>/,地址见脚本头注释
python3 scripts/timestamps_cpu.py audio/full.wav script.json audio/timestamps.json
# 备选(免手动下模型):pip install faster-whisper 后加 --backend whisper(首跑自动下载 460MB)
python3 scripts/make_timing.py audio/timestamps.json remotion/src/timing.json
# 方案 B(可选生成配音 + 时间戳,默认请求 s2.1-pro-free;可用性以 Fish Audio 为准):
pip install requests python-dotenv # 还需 ffmpeg,生成前会检查
# 在 .env 配置 FISH_AUDIO_API_KEY=xxx 及可选 FISH_AUDIO_REFERENCE_ID=xxx(见 .env.example)
python3 scripts/tts_fishaudio.py script.json audio/full.wav audio/timestamps.json --timing-out remotion/src/timing.json
```
- tts_fishaudio.py:默认 `--mode sentence` 每句一次请求,插入 `--pause-sec` 指定的真实静音(默认 0.25 秒);`--mode stream` 整稿一次请求、保留自然停顿。两者均接收 UTF-8 SSE,生成结束才写文件,不提供流式播放。先解码 PCM 再拼接,偏移按采样数计算。空音频、缺失/无效对齐或文本不匹配时报错;只忽略标点、大小写与字符宽度,不自动转换数字读法。中文用接口字级锚点,英文词内插值;`match/ok` 仅确认文本映射,仍需试听。合成后若再预剪,须重新运行 CPU 对齐。
- timestamps_cpu.py:ASR 词级时间戳 → 与口播稿字符级对齐(**CJK 是可靠锚点**,
匹配键=繁简归一+无声调拼音,同音字不算错;拉丁词各家 ASR 都常拼错,在锚点间插值)→
每句 match 质检,<0.90 标出人工听核。默认后端 FireRedASR2-CTC(尾部最稳、零误报;整段喂入 ~200s 崩、内存平方涨,脚本默认按静音切 ≤75s 段再加回偏移,`--chunk-sec` 可调),备选 faster-whisper;
各后端横评数据与模型下载地址见脚本头注释。
- timestamps.json schema:`{sr, total, sentences:[{i,text,start,end,match,ok,words:[{text,start,end}]}]}`
——words 为 CJK 逐字 + 拉丁整段 token(标点跳过);满足此 schema 的任何对齐工具都可替换。
- make_timing.py:转成 timing.json(chars 与文本逐字符 1:1,标点零时长),供 `tSay/msSay` 锚点查询
- 配音自查(耳听):无爆音/截断/误读;句间留 ~0.3s 气口,时间锚点更稳
### ②-1 语义标注(2026-09-22 起必做,正主 `references/semantic-annotation.md`)
口播稿逐句标「这句在做什么」,落成工程根 `semantics.json`——**这是选卡的需求侧产物**,没有它,选卡只剩输入类型一道过滤、剩下几十张卡靠印象挑(2026-09-21 那支片的「我是万里」就这样拿到了全库能量最低的文字卡,库里 P0 的人名条没人查到)。
```bash
python3 <skill根>/scripts/semantic_annotate.py --init # 从 timestamps.json 出骨架(带词法提示 hint)
# 逐句填 sem(26 词封闭词表,见 taxonomy.md「语义索引」)/ weight(main 主句 = 允许进新元素、sub 陪衬句)/ entities / need
python3 <skill根>/scripts/semantic_annotate.py --stats # 校验:与时间戳逐字一致 · 词表封闭 · 词法硬规(我是X→自我介绍、点赞订阅→号召、数量词→数据)· 每镜至少一个 main
```
标注是**派生物**:预剪 → 时间戳 → 标注 → 其后一切;改稿或重剪后 `text` 对不上就是标注失效,重新 `--init`。
**②-1 早于分镜,所以 `shot` 字段此时是空的**(SHOTBOOK 还没写):④ 写完后必须回填一次,否则下游的镜头级覆盖核不到任何东西——
```bash
python3 <skill根>/scripts/semantic_annotate.py --sync-shots # ④ 之后:按 SHOTBOOK 标题的起止秒(或 shots.json)回填 shot,只动 shot,标注不丢
```
## ③ 素材
- **素材清单从 ②-1 的语义标注生成,不靠拍脑袋**:`need` 是 `证据` 的句去截真页 / 找出处,`身份` 要头像与账号信息,`量化` 要图表或数据源,`entities` 里的人名 / 品牌 / 地点 / URL 就是检索词。
- **先给每个镜头标素材模式(多选,可组合)**:`B-roll`(实拍视频)/ `图片`(照片 / 海报 / 插图)/ `截图`(网页 / 界面证据画面)/
`纯动效`——如"B-roll 打底 + 截图证据卡"。新闻/信息类话题证据优先:Playwright 实时截图比泛用 B-roll 更有信息量。
四档对应 taxonomy.md 输入类型代号 **V / 图 / 截图 / 文**,SHOTBOOK 每镜写一行 `素材:V(路径)· 图(路径)· 文`(格式见 ④)
- **实拍素材是必需项,不是可选项**(2026-09-06 硬规):全片零 B-roll / 图片 = 只有动效 + 口播人物 = 观众看到的是"讲 PPT"。
`preflight.py` 对账 SHOTBOOK:**零 V / 图 镜头直接 FAIL**,V / 图 镜头占比 < 1/3 WARN(要在 SHOTBOOK 给依据,如证据类题材以截图为主)。
「本片不做 B-roll」**不允许**写成设计决定;视频源搜不到就降级图片(Pexels photos 原图 → Pixabay),图片也没有才进「未完成 / 未采集清单」。
图片与视频同源同 key,采集规格(分辨率下限、落盘目录、登记)见 `references/broll-sources.md`「配图采集」
- **真图硬规**:话题存在可截的真实页面(产品官网/GitHub/文档/画廊)时,
成片中的浏览器/页面类镜头**禁止用代码 mock 冒充截图**——卡片 demo 里的灰条假 UI 是占位物,
成片必须按卡片"复用指引"整块换成 `<img>` 真图;mock 只允许表现无真实对应物的示意 UI,
且 SHOTBOOK 逐镜标注"为何无真图"。**引申**:口播讲"这样的成片/效果"时,
示例画面必须是真成片片段(`<OffthreadVideo>` 内嵌已有成片/真机内录裁切,muted);
讲"长页面/看板/参数页"时用 Playwright **全页长截图**(放大镜/巡航类动效直接吃真图坐标)。
**真图上的标注坐标一律机器实测,禁目测**:页面元素用 DOM `getBoundingClientRect`、成图用逐像素量测
(目测偏 ±30px 就会把环框到别的元素上);**会滚动/移动的真图,标注(环/框/pill)必须钉在内容坐标系上随内容动**,
钉屏幕固定位就是错位根源
- **单视频镜头要有主题边框**(2026-09-07 用户定版):镜头里唯一主体是一段视频(录屏 / 单条 B-roll / 引用别人的成片或采访)时,
**禁止裸贴满幅、禁止裸放白卡、也不装假播放器**(进度条 / 播放键 / 时间码一律不要——不是真播放器就是在撒谎),视频区必须包一层
`template/components/theme-frame.tsx` 的 `<ThemeFrame kind>`:八式(复古浏览器窗口 / 杂志相框 / 35mm 胶片 / 拍立得 / 工程图纸 / 笔记本 / 邮票齿边 / 双发丝线),
**按片子调性选一式、一片只用一式**,写进 SHOTBOOK 蒙皮行;多视频的卡(bed-echo-blur 前景 / split-60-40-story 左格 / gallery-wall-dolly)的视频区也包同一式。
框只管造型与自己的装饰接力,整体入场 / 退场 / 极缓推归镜头层;框里的画面零处理(不滤镜 / 不缩放 / 不淡入淡出)。
例外只有两种:视频当**底床**不当主体(bed-echo-blur / §1.2 实拍底床),以及产品界面卡(chat-gpt / claude-code 类,皮即内容)。
静图不进框(框说"这是录像",画面不动一眼假;图用 media-pop-in / slow-push-in)。规则与八式表:design-language §1.3
- **网页拍摄不贴图**:找资料/找素材时判定可用的网页,成片里**禁止以静态截图贴屏**,
必须像手持镜头一样"拍"它——**滚**(`evidence-scroll-tour◆`:匀速上滚 ≈10% 页高/s,讲到关질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.