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
---
name: wjs-voicedrop-creating-motion-book
description: 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 <书名>".
---

# wjs-voicedrop-creating-motion-book:一本书 → 分章解说动画(口播=书架听书)

底座是 **huashu-art-motion**(Canvas 逐帧画的引擎、风格配方、qa/deliver 门禁)。本 skill 加三样:整本书的分章流水线、**画风套件**(kits/,选过的画风做成库,下一本直接复用)、**公用组件**(scripts/*.mjs 与 player/,每本书不再重写)。开工前读一遍 huashu-art-motion 的 SKILL.md「导演的要求」和「六种做坏方式」。

**口播就是书架听书那一份整章朗读,不写新稿、不调 TTS。** 听书缓存(R2 `audiobook/<slug>/<stem>.mp3`)有就直接用;没有就经听书接口合成一次,它自己写回缓存,以后用户听书和再做动画都不再花钱。我们这边从不往听书缓存里写。片长=全书朗读长度(一章 4–8 分钟)。

默认:竖屏 1080×1920@30(视频号 9:16)、**交付 HTML 版**;用户要 MP4 才渲(只在 Mac)。

## 流水线

`S=~/.claude/skills/wjs-voicedrop-creating-motion-book/scripts`,项目放 `~/code/art-films/<slug>/`。本 skill 的脚本全是 `.mjs`(Node ≥20)。取书、建工程、取口播、总装、冒烟、打包、发布不要 ffmpeg / Python / Chromium,Tokyo VPS 可跑;`qa_batches`、`framing_sheet`、`render_chunks` 是去调 huashu-art-motion 上游的 `render.py` / `qa.py`(要 uv + Chromium,MP4 拼接还要 ffmpeg),只在能出图的机器上跑。

| 步 | 做什么 | 命令 / 产物 | 在哪跑 |
|---|---|---|---|
| 1 取书 | VoiceDrop MCP `list_books` → `read_book`:slug、章名(写成一行一个的文件)、听书章节 stem(缺省 01…NN) | 章名.txt | 任意 |
| 2 选画风 | `references/选画风.md`:内容画像 → 先语法后画风 → 3 候选同句主镜头、独立评委 7 维打分;新画风先做成 `kits/<名>/`。**探索期**:候选用 `node $S/pick_styles.mjs` 抽,必须真出三张主镜头+独立评委,打分偏向新画风(见选画风.md 第 0 节) | `三方向/评审.md`、`选型结果.jpg`(发给用户,不等回复) | 出主镜头要 Chromium(做书机有;只有 1GB 的 Tokyo VPS 本机没有,别在那上面做书) |
| 3 建工程 | 复制引擎、装套件和字体、写 book.json 与章节制作规范 | `node $S/new_book.mjs <项目> --slug … --title … --kit … --chapters 章名.txt` | 任意 |
| 4 取口播 | 听书 mp3(缓存优先)→ ASR 出时间;稿=听书朗读原文(`<stem>.txt`,对不上才退回 ASR 文本)→ 句时间 | `node $S/narrate.mjs <项目>` | 任意 |
| 5 分章制作 | 章节 agent 并行,每个 1–2 章,brief=`<项目>/制作规范.md`+章号;贯穿物先写进 `scenes/book/props.js` | `scenes/book/chNN.js`、`音频/chNN.shots.json`、`镜头表/chNN.md` | 自查静帧要 Chromium;VPS 上用 `node $S/smoke.mjs <项目> --film chNN` 查报错和框景 |
| 6 总装 | 音轨(帧级拼接+静音帧)、段落表、字幕 | `node $S/assemble.mjs <项目>`(缺章先看:`--allow-missing`) | 任意 |
| 6½ 冒烟检查(必做) | 不出像素地跑完整本:启动错误、运行时报错、缺字形、框景(半截字/进字幕带/叠字,判据同 qa);有错不交付 | `node $S/smoke.mjs <项目>` → `qa/smoke/`(一本 20 分钟约 15s,VPS 约 2 分钟、124MB) | 任意 |
| 7 审片 | 独立审片 agent 看 qa 拼图+口播文本,打分列问题 → 回给对应章节 agent 改 | `审片/*.md` | Mac |
| 8 qa | 冒烟查不到的:画面好不好看、近空白、图形出画、确定性。分批跑、合并;框景线索出两帧拼图,两帧都切边的才改 | `node $S/qa_batches.mjs <项目> <项目>/qa/vN`;`node $S/framing_sheet.mjs <项目> <项目>/qa/vN` | Mac |
| 9 HTML 交付 | 打包公用播放器 | `node $S/build_html.mjs <项目>` → Mac 发 Artifact(`files` 用 `html/artifact_files.json`);VPS 把 `html/` 整个目录传到静态站。build_html 末尾自动跑 `optimize_html.mjs`(合包、字体按书裁成 woff2、预加载;冷启动 10s+ → 3s 级)。改了 `player/template.html` 要让已发布的书跟上:`node $S/republish_player.mjs <slug>`(只换入口页+bundle+字体,不重做画面) | 任意 |
| 10 MP4(要才做) | 按章分段渲、可续跑、并发按空闲内存自动算(`-j` 可手动);出片后自动 `add_cover.mjs` 加 1 秒书封片头+MP4 封面元数据(`--no-cover` 跳过,已有封面不重复加);要分章下载:`node $S/split_chapters.mjs <项目>` → `成片/分章/NN_章名.mp4`(复用分段画面+切口播,不重渲;分章不加书封片头,`--cover` 才加);deliver 门禁 | `node $S/render_chunks.mjs <项目> <项目>/成片/成片_vN.mp4`;`uv run ~/.claude/skills/huashu-art-motion/scripts/deliver.py <mp4> --project <项目>/代码工程 --qa <qa 目录> --root <项目> --vertical yes --out <项目>/output/` | Mac |

**顺序是硬的:步 4 先拿到听书 mp3,步 5 的画面全部按这份 mp3 的 ASR 句时间切镜。** 音频只有这一个来源;全流程唯一可能花 TTS 钱的地方是步 4 里听书缓存没命中的章(一章只一次,之后永久缓存)。

只改了几镜:改 `chNN.js` → 重跑步 9(HTML 不到 1 秒);MP4 删掉 `成片_vN_chunks/chNN.mp4` 重跑步 10,其余章复用。

## 云端制作(Tokyo VPS 本机的做书账号 mb,一次一本)

`bash cloud/run_book.sh <slug> [--only ch01,ch02,ch03]`(Tokyo VPS,root 或 claude-agent):等 engine-router 租到账号 → 拿 `worker.lock`(一次只做一本,后来的排队)→ `ssh -i $MB_ROOT/worker_id mb@127.0.0.1` 复位做书账号(skill 副本对齐 GitHub、清上一单的套件和会话)→ 无人值守 `claude -p` 按本 skill 从取书做到 HTML → 拉回 `$MB_ROOT/books/<slug>/` → `scripts/publish_video.mjs` 发到书架 **voicedrop.cn/books/<slug>/video/** → 杀掉 mb 名下残留进程、删工作目录(`--keep` 保留)。`--dry` 只验环境不派 Claude。2026-11-10 起不再开一次性 Vultr 机器(Vultr reaper 误删过常驻 VPS),也没有 reaper 了:残留进程由下一单开工时清,Claude 进程自带 `timeout <时限>h`。

- 做书账号用 `cloud/setup_worker.sh`(root,幂等)装:Node 22 只装在 mb 家目录(系统 Node 20 给 lab/paint/router,不动)、uv、Playwright Chromium、Claude Code、引擎、本 skill;**mb 的 user slice 限 MemoryMax 2.8G / CPUQuota 150%**,做书吃爆也只杀自己,公众号中转和 lab 不受影响。机器是 2 核 4G:`RENDER_SLOTS=1`、子 agent 一批不超过 4 个,一本约 3 小时。MP4 仍由家里 pro 渲(`video-book-sync`)。
- 凭据只读不复制:火山 ASR 与各账号令牌在 `$MB_ROOT/secrets.env`;缺省 Claude 令牌用写书引擎 `/opt/claude-agent/.env` 的 `CLAUDE_CODE_OAUTH_TOKEN`;书架发布用 `/opt/claude-agent/.config/voicedrop/credentials`。每单开工时写进 mb 的 `~/code/.env`(600)。
- **无人值守(`claude -p`)时子 agent 只能前台并行**:同一条消息发多个 Agent 调用、等这批全部返回再派下一批;绝不用后台 agent、绝不「等通知」就结束回合——`-p` 一结束回合进程就退出,后台 agent 全被杀(2026-10-25 第一单 20 个 agent 做到一半全没了)。`run_book.sh` 的提示词已写死这条;Claude 退出却没做出网页版时,用 `claude -p --continue` 接着同一会话续跑,最多 3 轮;重做时会先把上一轮拉回的半成品传上去接着做。
- 云端没有 VoiceDrop MCP:取书用 `node $S/fetch_book.mjs <slug> 章名.txt`(读书架公开的 `_src/book.json`,要做的章没写完就退出,不开工)。
- **线上入口(像听书)**:任何人打开 `voicedrop.cn/books/<slug>/video/`,没做过就自动下单;lab 服务 `GET|POST https://lab.jianshuo.dev/api/video-book?slug=`(下单)/ `…/status?slug=`(只查)用 systemd-run 起 `video-<slug>` 单元跑 `run_book.sh`(`MB_ROOT=/opt/claude-agent/motion-book`)。闸:只做写完的书、同时最多 1 本(做书账号只有一个,run_book.sh 另有 worker.lock 兜底)、24 小时内最多开工 5 本(`/opt/claude-agent/.env` 的 `VIDEO_MAX_CONCURRENT` / `VIDEO_MAX_PER_DAY`,代码缺省 1 / 2;实现在 jianshuo.dev 仓库 `claude-agent/src/video-book.ts`)。书架已有 `video/` 时接口答 done,不会重做——要重做整本先删 R2 `books/<slug>/video/`。
- **书架标志**:`publish_video.mjs` 发布成功后往线上 `_src/book.json` 合并 `video: {url, publishedAt, duration, chapters}`(chapters 少于全书章数=试看版);写书的 build.mjs 每次整份发布会把它从线上接回来,修书不会抹掉。

## 省时间的关键

- **口播零成本复用**:听书缓存命中就不花 TTS 的钱;ASR 推 mp3 约 40 倍速,几章并发一两分钟完。
- **套件复用与探索**:探索期(选画风.md 第 0 节)偏向没用过的画风,分差 ≤5 选新画风;探索期结束后恢复「已有套件分差 ≤2 就用它」。现有:`kurzgesagt`(科学/医学/技术机制)、`banknote`(货币/央行/金融制度,字体是随套件分发的思源宋体 OFL)、`flat2026`(当代扁平插画:浅暖纸底、颗粒点彩、有表情的成人比例人物;身心/人文,2026-10-27 建,还没做过整本书)。用量流水在 `kits/USAGE.tsv`。
- **套件不丢**:云上新建的 `kits/<名>/` 由编排机 `cloud/harvest_kits.sh` 收回 → 提交进 claude-skills 仓库 → 用部署钥匙推 GitHub(推不出去就留在 VPS 本地提交,下次一起推);Mac 上的同步钩子先把仓库里多出来的套件拉回本地再镜像,不会删掉它们。
- **默认 HTML**:长片渲 MP4 要几小时,HTML 打包不到 1 秒;画面一样,改一镜即时生效。
- **章节并行**:步 5 一次派齐;每章用章内局部时间,互不依赖,总装最后做。

## 交付回报

HTML 链接;听书缓存命中几章、新合成几章;(有 MP4 时)路径、时长、门禁结论和黄灯理由;选了哪个画风、为什么。坑先查 `references/踩坑.md`。

## 运行环境

- 全部:Node ≥20(20 会自动加 `--experimental-websocket`)、huashu-art-motion 引擎(`~/.claude/skills/huashu-art-motion/scripts/engine`,或 `HUASHU_ENGINE` 指向它;VPS 上 `git clone https://github.com/alchaincyf/huashu-art-motion`)、火山 ASR 凭据(环境变量,或 `~/code/.env`,或 `BOOK_ENV` 指向的文件)。
- Mac 另需:uv、ffmpeg、Playwright Chromium(huashu-art-motion 已装),只给 qa / 静帧 / MP4 用。渲染并发由 `render_chunks.mjs` 按空闲内存(每进程留 1.5GB、再留 4GB 余量)和核数自动算:16GB 机器约 2,64GB 的 pro 约 8。
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