Skip to content

jianshuo/claude-skills / wjs-voicedrop-creating-motion-book

wjs-voicedrop-creating-motion-book

Flagged

Use when the user wants a whole book (usually a VoiceDrop 书架 book) turned into a chaptered explainer animation narrated by the book's own audiobook (书架「听本章」) — vertical 视频号 9:16 by default, art style auto-picked from the book's content, delivered as an in-browser HTML player and optionally MP4. Triggers — "把这本书做成动画", "做成艺术动画片", "读书动画", "听书配动画", "motion book", "/wjs-voicedrop-creating-motion-book <书名>".

FileKindSize
SKILL.mdskill md11.2 KB
cloud/harvest_kits.shscript3.2 KB
cloud/mb.mjsscript2.4 KB
cloud/probe.mjsscript1.3 KB
cloud/run_book.shscript23.6 KB
cloud/setup_worker.shscript3.3 KB
kits/8bit/.harvestedother16 B
kits/8bit/kit.jsonconfig6.6 KB
kits/8bit/lib.jsscript49.2 KB
kits/USAGE.tsvother3.0 KB
kits/banknote/fonts/NotoSerifSC-Black.woffbinary2.1 MB
kits/banknote/fonts/NotoSerifSC-Regular.woffbinary2.1 MB
kits/banknote/fonts/OFL.txtmarkdown4.2 KB
kits/banknote/kit.jsonconfig1.1 KB
kits/banknote/lib.jsscript16.6 KB
kits/bauhaus/.harvestedother15 B
kits/bauhaus/kit.jsonconfig2.5 KB
kits/bauhaus/lib.jsscript37.0 KB
kits/cave/.harvestedother22 B
kits/cave/kit.jsonconfig2.6 KB
kits/cave/lib.jsscript33.1 KB
kits/constructivism/.harvestedother19 B
kits/constructivism/kit.jsonconfig3.0 KB
kits/constructivism/lib.jsscript47.0 KB
kits/cubism/.harvestedother24 B
kits/cubism/kit.jsonconfig1.6 KB
kits/cubism/lib.jsscript13.0 KB
kits/dali/.harvestedother21 B
kits/dali/kit.jsonconfig4.2 KB
kits/dali/lib.jsscript51.8 KB
kits/dunhuang/.harvestedother13 B
kits/dunhuang/kit.jsonconfig5.7 KB
kits/dunhuang/lib.jsscript49.4 KB
kits/egypt/.harvestedother21 B
kits/egypt/kit.jsonconfig3.9 KB
kits/egypt/lib.jsscript72.4 KB
kits/flat2026/kit.jsonconfig2.1 KB
kits/flat2026/lib.jsscript50.5 KB
kits/ghibli/.harvestedother15 B
kits/ghibli/kit.jsonconfig5.4 KB
kits/ghibli/lib.jsscript74.9 KB
kits/gothic/.harvestedother17 B
kits/gothic/kit.jsonconfig5.6 KB
kits/gothic/lib.jsscript70.6 KB
kits/greek/.harvestedother10 B
kits/greek/kit.jsonconfig2.5 KB
kits/greek/lib.jsscript49.6 KB
kits/haring/.harvestedother19 B
kits/haring/kit.jsonconfig3.4 KB
kits/haring/lib.jsscript36.4 KB
kits/hopper/.harvestedother13 B
kits/hopper/kit.jsonconfig4.2 KB
kits/hopper/lib.jsscript45.2 KB
kits/impression/.harvestedother15 B
kits/impression/kit.jsonconfig6.2 KB
kits/impression/lib.jsscript71.2 KB
kits/ink/.harvestedother19 B
kits/ink/fonts/NotoSerifSC-Black.woffbinary2.1 MB
kits/ink/fonts/NotoSerifSC-Regular.woffbinary2.1 MB
kits/ink/fonts/OFL.txtmarkdown4.2 KB
kits/ink/kit.jsonconfig5.0 KB
kits/ink/lib.jsscript47.7 KB
kits/kirby/.harvestedother14 B
kits/kirby/kit.jsonconfig3.1 KB
kits/kirby/lib.jsscript40.9 KB
kits/klimt/.harvestedother13 B
kits/klimt/kit.jsonconfig6.4 KB
kits/klimt/lib.jsscript36.5 KB
kits/kurzgesagt/kit.jsonconfig1.0 KB
kits/kurzgesagt/lib.jsscript16.1 KB
kits/kusama/.harvestedother15 B
kits/kusama/kit.jsonconfig5.4 KB
kits/kusama/lib.jsscript53.9 KB
kits/matisse/.harvestedother9 B
kits/matisse/kit.jsonconfig6.4 KB
kits/matisse/lib.jsscript43.1 KB
kits/monet/.harvestedother10 B
kits/monet/kit.jsonconfig5.4 KB
kits/monet/lib.jsscript64.5 KB
kits/munch/.harvestedother36 B
kits/munch/kit.jsonconfig2.8 KB
kits/munch/lib.jsscript17.8 KB
kits/nouveau/.harvestedother9 B
kits/nouveau/kit.jsonconfig6.9 KB
kits/nouveau/lib.jsscript34.2 KB
kits/picasso_blue/.harvestedother12 B
kits/picasso_blue/kit.jsonconfig6.2 KB
kits/picasso_blue/lib.jsscript58.4 KB
kits/pop/.harvestedother11 B
kits/pop/kit.jsonconfig2.5 KB
kits/pop/lib.jsscript37.3 KB
kits/raytrace/.harvestedother20 B
kits/raytrace/kit.jsonconfig3.2 KB
kits/raytrace/lib.jsscript39.7 KB
kits/renaissance/.harvestedother12 B
kits/renaissance/kit.jsonconfig6.4 KB
kits/renaissance/lib.jsscript95.2 KB
kits/rickmorty/.harvestedother8 B
kits/rickmorty/kit.jsonconfig2.4 KB
kits/rickmorty/lib.jsscript53.4 KB
kits/roman/.harvestedother18 B
kits/roman/kit.jsonconfig2.0 KB
kits/roman/lib.jsscript53.8 KB
kits/rubberhose/.harvestedother10 B
kits/rubberhose/kit.jsonconfig5.0 KB
kits/rubberhose/lib.jsscript52.4 KB
kits/seurat/.harvestedother15 B
kits/seurat/kit.jsonconfig3.1 KB
kits/seurat/lib.jsscript17.8 KB
kits/shadowpuppet/.harvestedother21 B
kits/shadowpuppet/kit.jsonconfig3.2 KB
kits/shadowpuppet/lib.jsscript43.2 KB
kits/shinkai/.harvestedother9 B
kits/shinkai/kit.jsonconfig3.7 KB
kits/shinkai/lib.jsscript39.0 KB
kits/vangogh/.harvestedother18 B
kits/vangogh/README.mdmarkdown1.5 KB
kits/vangogh/kit.jsonconfig11.1 KB
kits/vangogh/lib.jsscript94.0 KB
kits/vaporwave/.harvestedother12 B
kits/vaporwave/kit.jsonconfig7.7 KB
kits/vaporwave/lib.jsscript57.8 KB
player/template.htmlother13.0 KB
references/章节制作规范.mdmarkdown6.2 KB
references/踩坑.mdmarkdown4.6 KB
references/选画风.mdmarkdown6.3 KB
scripts/add_cover.mjsscript3.7 KB
scripts/assemble.mjsscript9.7 KB
scripts/build_html.mjsscript6.1 KB
scripts/common.mjsscript7.8 KB
scripts/fetch_book.mjsscript1.7 KB
scripts/framing_sheet.mjsscript2.6 KB
scripts/narrate.mjsscript8.4 KB
scripts/new_book.mjsscript4.4 KB
scripts/optimize_html.mjsscript5.2 KB
scripts/pick_styles.mjsscript3.9 KB
scripts/publish_video.mjsscript5.1 KB
scripts/qa_batches.mjsscript3.4 KB
scripts/render_chunks.mjsscript5.7 KB
scripts/render_lock.shscript783 B
scripts/republish_player.mjsscript4.9 KB
scripts/smoke.mjsscript20.7 KB
scripts/split_chapters.mjsscript2.7 KB

references/章节制作规范.md

View on GitHub
# 《{{TITLE}}》· 章节制作规范(给每位章节制作者)

你负责全片里一两章的动画画面。全片 = ch01–ch{{N}},口播就是书架听书的整章朗读(一章常有 4–8 分钟),每章单独计时;你只管自己那几章的「章内局部时间」(0 = 本章口播第一个字)。总装、字幕、整片渲染、HTML 打包由总导演做,你不碰。

## 1. 先读这些(必读)

- `~/.claude/skills/huashu-art-motion/SKILL.md` 的「导演的要求」两节和「六种做坏方式」、`references/镜头语言.md` 第一到四节、`references/动画语法/` 里本片语法({{GRAMMAR}})的「起手必查」。
- 本片画风套件(**只读,不许改**):`代码工程/scenes/book/lib.js`,导出 `K`。现成接口:{{API}}。先通读一遍。本书专属道具在 `scenes/book/props.js`(总导演维护)。
- 你那几章:口播文本 `稿/chNN.txt`(ASR 从听书音频识别出来的,就是观众听到的话);句时间 `音频/chNN.句时间.txt`(`开始-结束  短句`,秒,章内局部时间,可直接拿来定切点);音频 `音频/chNN.mp3`。

## 2. 画风锁(全片一致,不许偏)

- 画风:{{KIT_LABEL}}。所有形状、文字、底都走套件函数,不自己发明新画法。
- 只用色板:{{PALETTE}}(套件里是 `K.C`)。**禁止**蓝紫、渐变底、霓虹外发光、换画风拼贴。
- 贯穿物:按 `稿/README.md` 写的本书主物,每章至少一两镜让它在场。
- 人:不画脸、不画 Q 版小人;人群用 ISOTYPE 图标或剪影,只出手。动物只画剪影。套件 kit.json 的 `notes` 明写放宽的(如 flat2026 的极简五官表情),以套件为准,只用套件给的画法,不另画写实五官。
- 文字:只用套件的 text / popText / callout。**只用 GB2312 里有的字**:繁体、上标(⁶⁰)、½、−、¢ 这类没有,上标手画。手机竖屏最小字号 44px,标签 52px 以上,大标题 100–170px。

## 3. 竖屏版式(1080×1920,视频号 9:16)

- 主体放在 y 200–1350;**y 1380–1560 是字幕带,不放任何字和关键图形**;y > 1574 是视频号底栏遮挡区。
- 每镜结尾调 `K.finish(c)`;屏上大字每镜 ≤ 8 字,整句话交给字幕。
- **长镜头里推近,推近中心要让画面里所有要读的物都留在可见宽度内**(1.25 倍时可见宽 864px:中心 x 必须让最左、最右的物都在 ±432 内)。镜头停在推近后的状态超过 1 秒,切边就会被看见。
- **开场初始状态也要全在画内**:物从两侧滑进来的,第一帧就停在画内边缘,不要从画外开始停几秒。

## 4. 镜头与节奏

- 一镜 2–6 秒(个别 6–8 秒,绝不超过 8 秒);每句口播至少一次状态变化(弹出、形变、钻入、拉远)。
- 镜头:`CAM.track(base, events, lt)` + `K.world(c, cam, fn)`。缓推/横移/拉远是过渡;快推、砸入是重音,只给揭晓、反转、关键数字,每章 ≤ 3 次。推进去要有来有回,不连着三镜往里推;相邻两镜换构图。
- **禁止**「顶部大字+居中图标+淡出」一镜接一镜的 PPT 模板。多用:同一世界里横移到下一件、从细节拉远看全貌、物的形变、连续世界拆成两三镜(用 `K.t0('<那组第一镜 id>')` 拿起点,按全片时间 t 驱动,shots.json 第四列写 `"seamless"`)。
- 开场 3 秒是具体的小场景;每章结尾落在一个物的动作上。所有随机用 `U.hash`/`U.rng` 种子。
- 示意性的数字、图表,画面上标「示意」。口播里说过头的事实画面上别加强,拿不准的回报给总导演。

## 5. 你要交的东西

1. `代码工程/scenes/book/chNN.js`:镜头 id 一律 `cNN_<名字>`,注册 `SCENES.cNN_xxx = { draw(c, lt, t) { … } }`;IIFE 包住,开头 `const D = K, C = D.C, { W, H, TAU } = D, { clamp, lerp } = U;`。新道具挂 `D.cNN_xxx`,不改 lib.js / props.js。
   - 第一镜必须是章节卡:`SCENES.cNN_card = { draw(c, lt, t) { D.chapterCard(c, lt, t, N, D.CHAPTER_NAMES[N - 1]); } };`,时长 = 念章名那一句+0.3 秒左右(听书每章开头会念「第 N 章+章名」)。
2. `音频/chNN.shots.json`:`[[id, 局部开始, 局部结束(, "seamless")], …]`,首镜从 0 开始、首尾相接、最后一镜结束 = 本段音频时长+0.4 秒;切点放在句首前 0–0.15 秒。
3. `代码工程/eras_chNN.js`(自测片子,模板见下)和 `镜头表/chNN.md`(huashu-art-motion `references/镜头表模板.md` 的表格)。
4. 自查:冒烟检查零报错、零缺字;框景线索逐条确认(能看静帧的机器上,每个新镜头渲中段、末段两张静帧全部过目);回报每章镜头数、平均镜长、你觉得最弱的 3 镜和原因。

## 6. 自测命令

```sh
cd {{DIR}}/代码工程
cat > eras_chNN.js <<'X'
window.FILM_SIZE = [1080, 1920]; window.PUNCH = 0;
window.SCENE_LIBS = ['scenes/book/meta.js', 'scenes/book/lib.js', 'scenes/book/props.js', 'scenes/book/chNN.js'];
const SHOTS = /* 粘贴 ../音频/chNN.shots.json */ [];
window.ERAS = SHOTS.map(([id, a, b, sm], i) => ({ id, dur: +(b - a).toFixed(3), ...(i && sm !== 'seamless' ? { transition: { type: 'crossfade', dur: 0.15 } } : {}) }));
X
node --check scenes/book/chNN.js
# 不出像素的冒烟检查(没有 Chromium 的机器也能跑):运行时报错、缺字形、半截字/进字幕带/叠字
node ~/.claude/skills/wjs-voicedrop-creating-motion-book/scripts/smoke.mjs {{DIR}} --film chNN --out ../静帧/chNN/smoke
uv run --with playwright python render.py --film chNN --width 1080 --height 1920 --solo cNN_xxx --stills 1.0,3.0 --no-counter --out ../静帧/chNN/cNN_xxx
# 整章低帧率小样(带口播,正常速度看一遍节奏)
uv run --with playwright python render.py --film chNN --width 1080 --height 1920 --fps 12 --audio ../音频/chNN.mp3 --out ../静帧/chNN/小样.mp4
```

`--film` 名只能是小写字母数字下划线。zsh 里变量不按空格拆词,循环传多个参数用 `${=var}`。不要删除任何文件;临时文件写在 `../静帧/chNN/`。**渲染命令一律加排队前缀** `bash ~/.claude/skills/wjs-voicedrop-creating-motion-book/scripts/render_lock.sh`(同时最多 `RENDER_SLOTS` 个,默认 2;Chromium 一个约 550MB)。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall