jianshuo/claude-skills / wjs-voicedrop-creating-motion-book
wjs-voicedrop-creating-motion-book
FlaggedUse 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 <书名>".
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/ 直接报错 |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |