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
# 踩坑表(两本 20 分钟书实测,一条一个修法)

| 现象 | 原因 | 修法 |
|---|---|---|
| 整片渲染、两本同时渲,后台进程被杀 | 16GB Mac 内存压力,Claude Code 回收后台 shell | `render_chunks.mjs` 按章一进程、可续跑;并发按空闲内存自动算;一次只渲一本 |
| 冒烟全 0,MP4 渲到某章抛 `arc … radius is negative` 整段失败 | pop 回弹起步让 `r - 线宽` 变负;冒烟按 10fps 抽帧漏过,30fps 撞上 | 套件 lib.js 已全局把 arc/ellipse/createRadialGradient 负半径钳到 0(2026-10-26,《炮声里的股市》ch02_a lensRing、《九百万人的选票》ch08 径向渐变);老工程把这段补进 `scenes/book/lib.js` |
| qa 跑到两百镜左右停住,log 空、没有 qa.md | Playwright 驱动偶发 EPIPE(位置不固定),stdout 缓冲没落盘 | `qa_batches.mjs` 每批 70 镜一进程、失败重试、`PYTHONUNBUFFERED=1`;长任务用 `nohup … &` 脱离会话 |
| 字幕比声音晚半秒,念数字的句子错几秒 | 用了 TTS 自带的字级时间戳:停顿后的句首晚 0.5–1s(实测 16–18% 的句子差 >0.3s),对齐脚本还不认「9,999 / 九千九百九十九」 | `narrate.mjs` 一律火山 ASR + difflib 式按字对齐(对不上的字前后插值) |
| ASR 报 `Invalid audio format … fail to feed audio into decoder` | 多段合成的 mp3 每段都带 ID3 头,夹在文件中间 | 只保留音频帧再存、再推(`mp3Frames`) |
| 想把动画口播写进听书缓存省一次钱 | 两份不是同一段话时会把「听本章」换成别的内容 | 口播只用听书那一份;从不往 `audiobook/` 写,缓存只由听书接口自己写回 |
| 成片被截短 | ffmpeg `-shortest` 按短的那条截 | assemble 在音轨尾部补静音帧到段落表总长 |
| 推近后画面边上半个字、半个物,持续 2–3 秒 | 长镜头(6–8s)把推近终态停住;推近中心只对着画面一侧 | 推近中心取所有要读物的中点;qa「半截字」逐条看 `framing_sheet.mjs` 两帧对比 |
| 开场头两秒物体在画外 | 「从两侧滑入」的初始状态放在画外,又被 lt 偏移拉长停住 | 初始状态放画内边缘;复用旧镜头加 lt 偏移时先看第 0 秒那帧 |
| 画面出现方框/豆腐块,或某个符号换台机器就变样 | 字体是 GB2312 子集,⁶⁰ ½ − ¢ ≠ 繁体都没有;浏览器静默回退系统字体,qa 不报(《一颗药》c09_unlike 的「≠」就是冒烟检查才查出来的) | `smoke.mjs` 每次 fillText 都查 cmap,缺字列出来;上标、≠ 这类手画或换成有的字 |
| 没有 Chromium 的机器上画面没人看 | VPS 不渲像素 | `smoke.mjs` 在 vm 里跑真引擎+假 Canvas:启动错误、运行时报错、缺字形、框景(与 qa 线索 35 条重合 33 条);看不了的(好不好看、近空白)留给 Mac 上的 qa 和审片 |
| HTML 版中文乱码 | Artifact 页面没有 meta charset,外部 js 按 latin-1 读 | 所有 `<script>` 带 `charset="utf-8"`;本地用 `_test.html` 测 |
| HTML 版 `SCENES is not defined` | 场景文件比引擎先执行 | 模板里先 `window.SCENE_LIBS=[]; window.SCENES={}` 再引场景 |
| HTML 版字体不生效 | 浏览器按网址懒加载字体,首帧画完才到 | fetch 成 ArrayBuffer → `new FontFace` → `document.fonts.add`,字体就绪后才插 engine.js |
| `Path2D.ellipse` 把几段连成一笔 | 子路径没 moveTo | 每个椭圆单独一个 Path2D 再 `addPath` |
| popText 传进去的透明度不生效 | 函数内部覆盖了 globalAlpha | 乘上传入值,不覆盖 |
| zsh 循环传多个参数只传进去一个 | zsh 不按空格拆词 | `${=var}` |
| 连续世界后几镜被加了转场 | `window.SEAMLESS` 加载太晚 | shots.json 第四列 `"seamless"`,assemble 读 |
| 最后一章片尾被截 | 每章强制 = 音频+GAP | 只有最后一章允许更长(片名停留) |
| 章间太赶 | GAP 0.4s | `book.json` `gap: 0.8` |
| 字幕一闪而过、空字幕底框、数字被拆两行 | 短句直出 | assemble:≤17 字合并、>18 字拆、数字量词不拆、<0.8s 并或延、空条不出 |
| 门禁黄灯「最长无事件间隔」「最差 30 秒窗口」 | 有意的一镜到底长镜头、沉下来的段落 | 不必改;在交付说明里写时间码和理由 |
| 云端做的书拉回来渲 MP4,每段都 `Page.wait_for_function: Timeout 120000ms` | run_book.sh 拉回时排除了 `代码工程/lib/`(引擎库),页面起不来 | 先 `rsync -a --ignore-existing ~/.claude/skills/huashu-art-motion/scripts/engine/lib/ <项目>/代码工程/lib/`;render_chunks.mjs 开头已加检查,缺 lib/ 直接报错 |
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