Skip to content
Back to search

dashi-animationstyle

把一段 15–60 秒的中文口播做成某种画风的动画视频(1920×1080、30 帧/秒的 mp4,带口播和字幕,能直接拖进剪映)。画面全部由 Claude 用 HTML/Canvas 代码画、无头 Chrome 逐帧截图合成,不用生图模型。自带 7 套风格:扁平流程图、手绘笔记、复古报刊、复古剪纸、超现实拼贴、立体卡通、黑底科技。也能照用户给的一张参考图(或一段视频)做一套新风格(用法二),或按一段文字描述先出 2–3 个方向的静帧给用户挑、再定风格(用法三),附风格词典、讲解动画通用规则和动效知识(转场、次要动作、丰富度检查)。用户说「把这段口播做成动画」「用手绘笔记风格做」「有哪些风格」「照这张图的画风做」「我想要黑板报那样的感觉」「检查风格动画的环境」「先渲个例子看看」时使用。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chuspeeism--dashi-animationstyle/badge.svg)](/listings/chuspeeism--dashi-animationstyle)

HTML

<a href="/listings/chuspeeism--dashi-animationstyle"><img src="/api/listings/chuspeeism--dashi-animationstyle/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**环境**:macOS(只在 Apple 芯片上测过)、Node 22 以上、ffmpeg、Google Chrome。whisper-cpp 可选(自动转写字幕用;没有的话给一份文字稿也能做)。

brew install node ffmpeg
git clone https://github.com/chuspeeism/dashi-animationstyle.git ~/.claude/skills/dashi-animationstyle

装好后在 Claude Code 里说:「检查一下风格动画的环境,再渲一个例子看看。」Claude 会跑自检,然后用自带的 Token 例子渲一段 21 秒的成片(Apple M2 Max 上每套 34–72 秒)。

**字体**:兰亭黑、圆体、手札体、翩翩体是 macOS「按需下载」的字体。自检会列出缺哪几个,打开「字体册」搜字体名、点「下载」即可;不下载也能渲,那几个字体会退回苹方。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 220 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: dashi-animationstyle
  3. description: 把一段 15–60 秒的中文口播做成某种画风的动画视频(1920×1080、30 帧/秒的 mp4,带口播和字幕,能直接拖进剪映)。画面全部由 Claude 用 HTML/Canvas 代码画、无头 Chrome 逐帧截图合成,不用生图模型。自带 7 套风格:扁平流程图、手绘笔记、复古报刊、复古剪纸、超现实拼贴、立体卡通、黑底科技。也能照用户给的一张参考图(或一段视频)做一套新风格(用法二),或按一段文字描述先出 2–3 个方向的静帧给用户挑、再定风格(用法三),附风格词典、讲解动画通用规则和动效知识(转场、次要动作、丰富度检查)。用户说「把这段口播做成动画」「用手绘笔记风格做」「有哪些风格」「照这张图的画风做」「我想要黑板报那样的感觉」「检查风格动画的环境」「先渲个例子看看」时使用。
  4. ---
  5. # dashi-animationstyle:风格动画(《大师的AI小灶》出品)
  6. 下文 `$SKILL` 指本文件所在的文件夹(装好后一般是 `~/.claude/skills/dashi-animationstyle`)。命令里的路径都要换成实际路径,带空格或中文的路径加引号。
  7. 一段口播 + 一套风格 = 一个**作品目录**,所有中间文件和成片都在里面:
  8. ```
  9. <作品目录>/
  10. ├── 作品.json 配置:风格、口播、字幕、分镜、输出文件名(新建作品.mjs 写好,render.mjs 从这里读默认值)
  11. ├── 口播.wav 口播(新建作品.mjs 从 m4a/mp3/wav/mov 转来)
  12. ├── 稿子.txt 口播的文字稿(可选,有就更准)
  13. ├── 字幕.json/.srt 字幕:句子、显示字幕、字级时间(字幕.mjs 生成)
  14. ├── 分镜.json/.md 分镜:镜头、关键词、固定上色的词(Claude 写)
  15. ├── timeline.js 页面用的时间线 window.TL(生成timeline.mjs 生成)
  16. ├── index.html 页面(从风格文件夹复制,Claude 按分镜改)
  17. └── <目录名>.mp4 成片
  18. ```
  19. 作品目录放在用户自己的项目里(例如 `./动画作品/<名字>_<风格>/`,`./` 指你当前所在的目录,一般是用户的项目文件夹),**不要放进 `$SKILL` 里**。
  20. ## 第一次用:先确认这台电脑能出片(约 2 分钟)
  21. 1. 检查环境:`node "$SKILL/pipeline/自检.mjs"`
  22. - 报 ✗ 的照提示处理:Node 要 22 以上(`brew install node`)、ffmpeg(`brew install ffmpeg`)、Chrome(装 Google Chrome)。这些要用户自己装,你只告诉他装什么、怎么装。
  23. - 字体报 ✗:是 macOS 按需下载的字体(兰亭黑、圆体、手札体、翩翩体),让用户打开「字体册」搜字体名点「下载」。不下也能渲,但那几个字体会退回苹方。
  24. - whisper 报 ! 是可选的:没有也能做(走稿子 + 静音检测的后备)。
  25. 2. 让用户挑一套风格:`node "$SKILL/pipeline/新建作品.mjs" --list` 列出 7 套;每套的样子看 `$SKILL/styles/<风格>/静帧/` 里的 3 张图(用 Read 看,或 `open` 给用户看)。用户已经说了要哪套,就用那套渲例子;没说就用「手绘笔记」。
  26. 3. 用自带的 Token 例子建一个作品并渲染:
  27. ```bash
  28. node "$SKILL/pipeline/新建作品.mjs" ./动画作品/token_手绘笔记 --style 手绘笔记 --example token
  29. node "$SKILL/pipeline/render.mjs" ./动画作品/token_手绘笔记/index.html
  30. ```
  31. 出来的是 21 秒的成片 `token_手绘笔记.mp4`(讲「提示词和 Token」的一段口播)。实测(Apple M2 Max,v1.3,机器空闲时):手绘笔记 65 秒;各套 34–72 秒(扁平流程图最快,黑底科技最慢)。渲完 `open` 给用户看。
  32. 4. 能出片了,再做用户自己的口播(用法一)。
  33. ## 用法一:自己的口播 + 现成风格
  34. 先问清四件事:口播文件(15–60 秒,超过 60 秒建议分段做);有没有文字稿;要哪套风格;字幕要不要烧进画面(回剪映统一加字幕就不要)。告诉用户用时:**实测一次(10-08,Opus 5.5 当观众,23 秒口播、9 个镜头、手绘笔记)从建目录到最终成片约 30 分钟,其中写页面约 18 分钟(含想构图约 10 分钟)**,转写和字幕 1.5 分钟、分镜 3.5 分钟、静帧和成片(两版)约 8 分钟;只测过这一次、这一套,内容离 Token 例子越远、或用 B 级风格(复古报刊、超现实拼贴,要先重排版式 / 想比喻),按 1 小时准备。中间会停两次请他确认(分镜、3 张静帧)。
  35. 没人可问时(例如让你自己跑完):字幕默认烧进画面,交付时另出一版 `_无字幕`;分镜和静帧的「点头」改成自审,把判断和理由写进 `分镜.md` 末尾和 `静帧/静帧判断.md`。
  36. 1. **建作品目录**
  37. ```bash
  38. node "$SKILL/pipeline/新建作品.mjs" <作品目录> --style <风格> --audio <口播文件> [--script <稿子.txt>]
  39. ```
  40. 有稿子就带上。没有稿子也行。
  41. 2. **转写 → 字幕**
  42. - 有 whisper:`node "$SKILL/pipeline/字幕.mjs" <作品目录>`(实测 20–35 秒的口播转写 2–3 秒)。有 稿子.txt 时按稿子改错字、按稿子的标点分句分条;打印「识别改正」(秒数 + 识别 → 稿子),逐条看一眼。whisper 识别的原文(每段带秒数)存在作品目录的 `whisper原文.txt`。
  43. - 「识别改正」里有 **「→(稿子里没有)」**:识别出了稿子里没有的话。下面「要核对」会说它在几秒、在哪:
  44. - **在口播开头或结尾**:多半是从长录音里剪这段时带进来的邻句(上一句结尾、下一句开头)。字幕已经按稿子去掉,但**成片的声音里还在**。先裁掉再往下做:`node "$SKILL/pipeline/字幕.mjs" <作品目录> --trim auto`(按稿子找切点、切在中间的静音里,原文件留成 `口播_裁前.wav`,裁完自动重跑字幕);自动切得不对就听 `口播_裁前.wav`,用 `--trim 起,止` 手动给秒数(按原文件算)。裁完口播变短,要在写分镜、生成时间线之前裁;已经出过的静帧、成片要重出。
  45. - **在中间**:口误、重复说了一遍,或者稿子漏写了这句;听一下,稿子漏了就补进 稿子.txt 重跑。
  46. - 「(没识别出)→ 稿子的字」:稿子里有、没识别出来,那几个字的时间是插出来的;说得含糊没关系,口播里根本没说就把稿子里那句删掉重跑。
  47. - 没有稿子时:输出是识别原文,没有标点、可能有错字。你照识别结果整理一份**带标点的** 稿子.txt 放进作品目录(只改明显的错字、加标点,不改说法,拿不准的问用户),再跑一次 `字幕.mjs`。
  48. - 没有 whisper:要有稿子,`node "$SKILL/pipeline/字幕.mjs" <作品目录> --no-whisper`。用静音检测找句界、句内按字数摊时间(实测字级平均差 0.08 秒、最差 0.45 秒)。打印的「待核对」里是没找到停顿、按字数估的句界,误差可能到 0.4 秒;能听的话听一下,不对就直接改 字幕.json 里那两条的 start/end。
  49. - 把打印的字幕表(每条的时间和文字)给用户看一眼。字幕规矩:一条一行,约 20 个字以内;文字以音频为准。
  50. 3. **写分镜**(`分镜.json` 给机器读,`分镜.md` 给人看;照 `$SKILL/examples/token/分镜.json`、`分镜.md` 的样子写,字段见文末)
  51. - 镜头跟着句子切,一个镜头 1.5–5 秒,一个镜头只讲清一件事;写清每个镜头「画面要讲清什么」、关键字(2–4 个)、运动设想(什么词说到时出现什么)。
  52. - **每个镜头写变化清单**(v1.2):进场 → 主动作 → 次要动作(呼吸、飘动、闪烁、粒子)→ 出场或转场,写进 `分镜.json` 镜头的 `变化` 字段(不进时间线)、`分镜.md` 加一列「变化」。每 2–3 秒要有一个看得见的新变化;转场至少 3 种、同一种别连用 3 次。写法、秒数的依据、各风格适合哪几种转场:`$SKILL/knowledge/动效和画面变化.md` 第一到三节。
  53. - 关键词卡点:`marks` 里写名字、在第几条字幕、原文短语;生成时间线时自动从字级时间算出秒数。
  54. - 挑 **2 个全片固定上色的词**(`高亮`,role A / B,对应风格卡里的强调色 A/B)。标准:挑这段话的两个**核心名词**(观众看完要记住的那两个概念),最好在字幕里出现 2 次以上、在画面里会反复露面;两个最好是一对(Token 例子:成都 / 旅行;观众实测:窗口 / 模态)。A 给先出场、更重要的那个。再挑 3–8 个字幕里要强调的词(`字幕强调`)。
  55. - **字幕里上色是按字面精确匹配**:字幕里出现和 `高亮` / `字幕强调` 一模一样的字才标,不拆词、不认近义词。所以 `高亮` 写「模态」时,「多模态」里只有「模态」两个字上色,「多」不上色。想把「多模态」整个标出来:把「多模态」加进 `字幕强调`——手绘笔记、扁平流程图、复古剪纸、黑底科技是「长的优先」,整个「多模态」按强调词的样子标(「模态」就不再是强调色);复古报刊、立体卡通、超现实拼贴是两层叠着标,「多模态」三个字都有强调标记、其中「模态」同时是强调色。或者 `高亮` 直接用「多模态」(那「文字模态」里的「模态」就不上色了)。取舍写进 分镜.md。
  56. - 想不出某个概念怎么演,查 `$SKILL/knowledge/从11套里学到的.md` 第七节:先看「通用概念怎么画」表(范围、太多、太贵、失忆、分类、能力齐全……),再看 11 套各用什么演 Token 例子的「聊天框、切分、海量数据、推断」。
  57. - 把镜头表(镜头、时间、台词、画面)给用户看,**点头再画**。
  58. - 生成时间线:`node "$SKILL/pipeline/生成timeline.mjs" <作品目录>`(关键词找不到会报错并告诉你在哪条字幕里找的)。
  59. 4. **写页面**(主要用时):**从模板改**。作品目录里的 `index.html` 就是这套风格的 `模板.html`(7 套都有):底座(配色、字体、质感、部件、镜头、页眉、字幕,原样留着)+ 按镜头自动排的骨架,已经能吃任何时间线。
  60. - 先直接渲一张静帧看看骨架(`render.mjs … --stills 3 --outdir <作品目录>/静帧 --prefix 骨架`)。骨架只有标题和关键词,**不能直接交差**。
  61. - 读 `$SKILL/styles/<风格>/风格卡.md` 的「换内容时怎么改 → 从模板改」:模板里哪块是底座、哪块是骨架、有哪些现成部件。部件长什么样、怎么组合,对照同一文件夹的 `示例_Token.html`(Token 例子的完整页面,只当参考;拿新时间线直接打开会报错)。
  62. - 把「场景:按新分镜重写」那一块换成真正演内容的画面,**再把 `render(t)` 里调骨架的那一行(手绘笔记是 `drawSections(t, v);`,各套见风格卡,模板里那行有「← 场景入口」注释)换成你自己的分段函数**,骨架的代码删掉。只加新函数、不换这一行,画面上还是骨架。
  63. - 要用示例页里的部件(例如机器人、聊天框),连它用到的常量、小函数一起抄过来;手绘笔记的模板已经带了观众实测时写好的常用部件(机器人、气泡、信息小卡、成绩单、色块词、颗粒章、※),见模板里「常用部件」那段注释。
  64. - 场景多时分块写(每段一个文件,最后拼成 index.html),每写完一段出几张静帧看(`--prefix 调试`),实测这样每段都一次跑通。
  65. - **默认动效**(v1.3):7 套模板自带这套风格的背景层(一直在动)、镜头交界的默认转场(按 `TL.shots` 自动轮换)和每个镜头的慢推,换任何时间线都自动生效;开关和每个切点用什么转场在模板开头的 `FX_DEFAULT`、`FX_PLAN`(不是每套都有 `FX_PLAN`,见风格卡「默认动效(v1.3)」)。你写的场景如果在某个切点自己做了转场,就把那个切点的默认转场关掉,别叠两层。
  66. - **转场和次要动作**(v1.2):调 `动效部件.js`(新建作品时已复制进作品目录;用法在文件开头)。模板里有两个函数:`fxBefore(t)` 在画场景之前(推移、慢推、震屏),`fxAfter(t)` 在场景之后、字幕之前(故障撕裂、擦除、翻页、纸片盖屏、粒子、泛光),在里面写 `动效.glitch(g, t, 换场时刻)` 这类调用。背景至少两层、一直有东西在动;盲测里好用的手法(城市剪影、流动网格、灯管字通电、粉笔头、撕边纸……)和代码要点见知识文件第四、六节。
  67. - 页面约定(必须遵守):舞台 1920×1080;`<script src="timeline.js"></script>` 引时间线;定义 `window.seek(t)`,**画面只由 t 决定**;准备好后 `window.ready = true`;保留 `NOSUB` 开关(`const NOSUB = /[?&]nosub=1/.test(location.search)`,画字幕和字幕底带的函数开头 `if (NOSUB) return;`);**每帧开头把画布状态整套复位**(`动效.resetCtx(g)`,每帧重画的离屏画布也要)——上一帧留下的 lineCap、setLineDash、globalAlpha 会漏到下一帧,按顺序出片看不出来,单独出静帧就不一样(v1.3 前立体卡通、黑底科技、复古报刊的示例页都踩过)。
  68. - 时间一律从 `TL` 取(`TL.mark('词')`、`TL.shots`、`TL.cues`),**不写死秒数**;用不确定有没有的关键词先 `TL.has('词')`。
  69. - 读字:观众要看清的字原尺寸 48 像素以上;字幕不小于 60 像素;底部约 170 像素只放字幕,页眉区也别压。
  70. - 性能:每帧最好 150 毫秒以内;颗粒、纸纹只生成一次缓存,不要逐帧逐像素算,不要逐帧画满屏渐变(见知识库第二节)。
  71. 5. **先出 3 张静帧给用户点头**
  72. ```bash
  73. node "$SKILL/pipeline/render.mjs" <作品目录>/index.html --stills 3.2,12.5,24.8 --outdir <作品目录>/静帧
  74. ```
  75. 秒数挑开头、中段、结尾各一个最能代表画面的时刻(关键词刚出现之后)。**手写、逐字浮现、擦出来的风格(手绘笔记、黑底科技、立体卡通的标题,超现实拼贴的手写批注)字是一个个出来的,要取关键词开始说之后约 0.3 秒**(`timeline.js` 打印的关键词秒数 + 0.3),不然字还没写完(实测 4.95 秒只写出「失」,5.15 秒才是「失忆」)。自己先用 Read 看三张 PNG 和自动生成的 `_480宽检查.png`(字幕和关键字缩到 480 宽还能读;手绘笔记的笔尖跟着写,看一眼笔杆有没有压住要读的字),没问题再 `open` 给用户看。用户不点头就改,再出静帧。
  76. - 重出静帧时,同一目录里同一前缀的旧静帧和旧 480 宽检查图会先挪进 `静帧/旧静帧/<前缀_时分秒>/`,文件夹里只留这一批。调试用的多出几张没关系,用 `--prefix 调试`(或按段 `--prefix A段`)和给用户看的分开。
  77. 6. **出整段**:`node "$SKILL/pipeline/render.mjs" <作品目录>/index.html`(命令放后台;满屏颗粒的几套 作品.json 里已经设了 jpeg 截图;21 秒的手绘笔记 v1.3 实测 65 秒)。出完自检:
  78. - `ffprobe -v error -show_entries stream=codec_name,width,height,r_frame_rate:format=duration -of compact <成片>`:h264 1920×1080 30/1 + aac,时长和片长(分镜.json 的 `duration`,没写就是口播时长)差不到 1 帧(按帧向上取整,21.17 秒的口播出来是 21.20 秒)。
  79. - 确定性(v1.3,几秒钟):`node "$SKILL/pipeline/render.mjs" <作品目录>/index.html --check-determinism auto`,三个时刻各比一次「单独 seek」和「先跳到别处再回来」,要全是 ✓;有 ✗ 就按页面约定那条复位画布状态。
  80. - 出检查图(不出片,23 秒的片子约 7 秒):`node "$SKILL/pipeline/render.mjs" <作品目录>/index.html --scan --check-marks`,在 `<作品目录>/检查/` 里:
  81. - `扫片_1.png`、`扫片_2.png`…:每秒 3 帧、一张 4×8 格(约 10.7 秒),看有没有截断、叠字、闪烁、空白,字幕是不是跟着换;镜头交界前后 0.5 秒最容易出事。
  82. - `卡点.png` + `卡点_说明.txt`:每个关键词开始说之前 0.1 秒、之后 0.35 秒各一帧,一行两个词;「前」那格还没有对应动作、「后」那格已经开始出现,就是卡上了。
  83. - 字幕对得上:扫片里每格下面的字幕跟着口播换;拿不准的时刻单独出静帧看。
  84. - **丰富度检查**(v1.2):`node "$SKILL/pipeline/丰富度检查.mjs" <成片.mp4>`,每 2.5 秒一格拼成 `检查/丰富度_扫片.png`,算相邻两格差多少(字幕带不算)。判「不过」、或标了「几乎没变」的那几秒,回去补变化(新东西进场、推近拉开、换色),静止超过 2 秒的补次要动作;再对照知识文件第七节的自查表(转场不要全片一种)。盲测 6 版里这个分数高的那版,3 组都是作者觉得更丰富的。开场是整屏盖色或黑屏开机时第 1 对会特别大,脚本另报「去掉第 1 对的平均」,那个数也要 ≥ 10。
  85. 7. **交付和修改**:告诉用户成片路径(`open` 打开)。要回剪映统一加字幕:`node "$SKILL/pipeline/render.mjs" <作品目录>/index.html --no-subtitle`,输出自动叫 `<名字>_无字幕.mp4`(给了 `-o` 也会加「_无字幕」),不会覆盖带字幕的成片;字幕用作品目录里的 `字幕.srt`。v1.3 起 7 套模板和示例页关掉字幕时字幕底带也一起不画;你自己加了字幕底带的,记得也放进 `if (NOSUB) return;` 里。用户提意见时按「第几秒、哪个东西、改成什么」收,改完重出静帧确认,再重渲整段。
  86. ## 用法二:照一张参考图(或一段视频)做新风格
  87. 用户给一张自己喜欢的画面(截图、海报、插画)或一段视频,照它的画风做一套新风格,再套到口播上。先告诉用户三件事:
  88. - **结果不保证**:我们照 11 份参考做了 11 套,作者留了 7 套;每套 1 小时到 1 小时 45 分(口播、字幕、分镜已经有了的前提下),一般要出 2–4 轮静帧才像。
  89. - **参考图的版权由用户自己负责**:只拿来学画风(颜色、字体气质、线条、版式),成片里不出现原图;skill 不带、不传任何别人的图,作品目录里的参考图是用户自己放的。
  90. - 参考里的真实照片、复杂手绘插画,代码只能画出近似的版本。
  91. 0. 口播先按用法一第 1–3 步做出字幕和分镜;只想先试风格,用 Token 例子(`--example token`),定了再换自己的口播。
  92. 1. **读参考**:用 Read 看图,写下 4–6 条「看到了什么」(底色、主线、字、部件、留白、质感)。细节裁一块放大:`ffmpeg -i 参考.jpg -vf "crop=宽:高:x:y,scale=iw*2:-1" <作品目录>/参考_局部.png`(先 `sips -g pixelWidth -g pixelHeight 参考.jpg` 看尺寸);gif 取第一帧 `-frames:v 1`。参考是视频:先出总览 `ffmpeg -i 参考.mp4 -vf "fps=1,scale=480:-1,tile=4x3" -frames:v 1 <作品目录>/参考帧总览.png`,再挑几帧原尺寸细看;还要看**动法**(东西怎么出现、多快、一拍几张、怎么换场;第 11 套黑底科技就是照一条视频做的),按 `knowledge/动效和画面变化.md` 第一节记成进场、主动作、次要动作、转场。
  93. 2. **取色**:`node "$SKILL/pipeline/取色.mjs" <参考图> 16 [x:y …]`,先看按面积排的主色,再对底、主线、标题、强调物逐点取;每个用途一个色值,写清对应参考图哪里。强调色 A/B:参考图里有红有蓝就用它自己的;只有一种,缺的用默认(红 `#d41928` / 蓝 `#2373ce`);都没有,用色板里最醒目的两种对比色;其余颜色避开 A/B 的色系(知识库 `从11套里学到的.md` 第六节)。字和底的对比度按 `knowledge/讲解动画通用规则.md` 第二节算。
  94. 3. **挑字体**(只在本机已装的里挑,不下载、不装):
  95. - 先认参考图里的字是哪一类:宋 / 衬线、黑体(多粗)、圆体、手写、书法(楷、隶、魏碑、行楷)、窄体英文、等宽;每一类 macOS 里有哪些、像什么,查 `knowledge/风格词典.md` 第二节「字体对照」。
  96. - 同一类里挑 2–3 个候选,把标题那句话各渲一张静帧并排比(改字体栈,`--stills 某秒 --prefix 字体A`),挑字形、粗细、字面宽度最像的;写进字体栈时**最后垫一个一直都在的**(苹方、冬青黑体 `Hiragino Sans GB`、宋体-简 `Songti SC`)。
  97. - **按需下载的字体**(兰亭黑、圆体、手札体、翩翩体、楷体、隶变、魏碑、报隶、行楷、凌慧体、娃娃体、雅痞)没下载时只带一部分字,一个词里会一半是它、一半退回苹方。用到就告诉用户:「打开『字体册』,搜『<中文名>』,点『下载』」;不下载也能渲,按风格卡里写的替代出。
  98. - 用户自己装在 `~/Library/Fonts` 的字体能拿来试,但风格卡和字体栈里要写好系统替代,并出一张「去掉用户字体」的静帧确认还像(知识库第五节有 7 套的实测)。
  99. 4. **写风格卡**:照 `knowledge/风格卡模板.md` 在作品目录写 `风格卡.md`:先填「来源」「看起来什么样」「配色」「字体」,部件、行号等页面写完再补。
  100. 5. **选底座**:按下表挑最接近的现成模板,`node "$SKILL/pipeline/新建作品.mjs" <作品目录> --style <它> …` 建目录(`index.html` 就是它的模板;用 `--example token` 建的是 Token 示例页,先 `cp "$SKILL/styles/<它>/模板.html" <作品目录>/index.html` 换成模板)。先只改底座:配色(`C`、`COL_A` / `COL_B`)、字体栈、背景质感、线条画法、字幕带;骨架和字幕逻辑先留着,渲一张静帧看底座对不对,再按分镜写场景。**看主体怎么画,比看底色要紧**:黑底上的粉笔线稿仍从手绘笔记起步,换底色和笔触。
  101. | 参考图的特征 | 从哪套模板起步 | 主要改什么 |
  102. |---|---|---|
  103. | 线稿、手写、笔记感(手绘、白板、粉笔黑板、手账、水彩线稿) | 手绘笔记 | 底色、笔触(`Sk` 的线宽和颜色、加纹理)、手写字体 |
  104. | 扁平色块、图标、步骤箭头(扁平插画、瑞士、包豪斯、孟菲斯、等距 2.5D) | 扁平流程图 | 配色、形状语言(圆角 / 直角 / 几何)、投影 |
  105. | 报纸杂志版面、分栏、衬线大标题(日系杂志、瑞士网格、复古报刊) | 复古报刊 | 版面网格、字体、纸色;B 级,先重排版式 |
  106. | 纸片剪贴、网点照片、定格跳动(剪纸、拼贴、贴纸、波普) | 复古剪纸 | 纸色、剪边、网点、每秒几张 |
  107. | 一个大比喻的概念海报、粗衬线 + 手写批注(超现实、概念海报) | 超现实拼贴 | 先想新比喻;B 级 |
  108. | 有体积的立体物件、光面、柔和渐变(黏土 3D、玻璃、立体图标) | 立体卡通 | 材质 5 值(亮 / 本色 / 暗 / 最暗 / 反光)、底色 |
  109. | 深底 + 细线 + 辉光、电影感(黑金、霓虹、蓝图、暗色水墨) | 黑底科技 | 线色、辉光、颗粒、字体 |
  110. 6. **出 3 张静帧自查**:开头、中段、结尾各一张(关键词开始后约 0.3 秒),和参考图拼在一起看:`ffmpeg -i 参考.jpg -i 静帧1.png -filter_complex "[0]scale=-1:540[a];[1]scale=-1:540[b];[a][b]hstack" <作品目录>/静帧/参考对比.png`。逐条对:配色、字体、线条和质感、版式像不像;480 宽检查图里字读不读得清;A/B 两个词是不是一眼认得出。判断写进 `静帧/静帧判断.md`,再 `open` 给用户看;不像就改底座重出,一般 2–4 轮。丰富不丰富照 `knowledge/动效和画面变化.md` 第七节看。
  111. 7. **出片**:回到用法一第 4–7 步(按分镜写场景、静帧点头、出整段、自检)。做完后作品目录里的 `风格卡.md` + `index.html` 就是用户自己的一套风格,下次新口播从这个 `index.html` 起步。
  112. ## 用法三:用文字描述想要的风格
  113. 用户没有参考图,只说得出感觉(例如「像小学教室黑板报那样的粉笔风,温暖一点」)。做法:问清楚 → 查知识库把描述翻成参数 → 先出 2–3 个方向(A/B/C)的静帧给他挑 → 挑定后写风格卡 → 出片。知识库的用处:把「温暖」「高级」「复古」这类词落成具体的色值、字体、笔触和动效,并提前避开每种风格最常见的翻车(字太小、颜色太多、满屏颗粒拖慢渲染……)。
  114. 1. **先问清楚**(一次问完;答不上的用括号里的默认;没人可问时按描述自己推,写进风格卡「来源」):
  115. | # | 问什么 | 决定什么 |
  116. |---|---|---|
  117. | 1 | 这段口播讲什么?有没有步骤、数字、对比? | 版式:流程长卷 / 一屏一个点 / 往下读的笔记(默认按分镜内容定) |
  118. | 2 | 想让观众看了有什么感觉?挑 1–2 个:温暖、可靠、好玩、高级、怀旧、紧张、安静 | 色温、圆角还是直角、动效弹不弹 |
  119. | 3 | 年代感:现代 / 八九十年代 / 民国 / 未来 / 无所谓(无所谓) | 字体(衬线 / 黑体 / 手写)、纸纹、网点、褪色 |
  120. | 4 | 像什么材料做的:纸、黑板、白板、屏幕、玻璃、黏土、水彩、霓虹灯…… | 底和笔触的质感 |
  121. | 5 | 颜色:偏暖 / 偏冷 / 黑白 / 高饱和 / 低饱和;有没有一定要或一定不要的颜色(品牌色) | 底色、主色、强调色 A/B |
  122. | 6 | 热闹还是克制,1–5 分(3):1 = 一屏一个东西、大量留白,5 = 满屏贴纸、一直在跳 | 颜色个数、部件密度、运动幅度 |
  123. | 7 | 给谁看、在哪看:小学生 / 大众 / 专业人士;手机还是电脑(大众、手机) | 字号、字体气质、一屏放多少字 |
  124. 2. **翻成参数**:读 `knowledge/风格词典.md` 第一节「描述词 → 参数」和最接近的 1–3 种风格条目,把问卷答案落成一张参数表:底色、主线色、1–2 个辅助色、强调色 A/B、字体栈(标题 / 正文 / 字幕)、线条和质感、版式、动效、起步模板(用法二第 5 步那张表)。每一项写依据(词典第几种、哪条规则)。再读 `knowledge/讲解动画通用规则.md`:字号、对比度、颜色预算、一个镜头一件事、动效时长——这些不随风格变,三个方向都要守。参数表里加一行「动效」:背景层怎么一直动、用哪 3 种以上转场(`knowledge/动效和画面变化.md` 第三、四、六节)。词典里写「已实测」的(霓虹赛博)先读它的风格卡,从它的实测页起步。
  125. 3. **出 2–3 个方向的静帧**:三个方向要真的不一样(同是粉笔风:A 经典墨绿黑板报 + 彩色粉笔花边,B 暖色木框黑板 + 米黄粉笔、克制,C 黑板 + 彩纸剪贴标题),不是同一套换个颜色。做法:
  126. - 建作品目录(还没口播就用 `--example token`),`--style` 选起步模板。**用 `--example token` 时 `index.html` 是 Token 示例页,不是模板**,先换成模板:`cp "$SKILL/styles/<起步模板>/模板.html" <作品目录>/index.html`。在 `index.html` 开头写 `const DIR = 'A';` 和三套参数 `DIRS = { A: {…}, B: {…}, C: {…} }`(配色、字体栈、质感和装饰的开关),底座里用到颜色、字体的地方都从 `DIRS[DIR]` 取。
  127. - 复制成三份、只改那一行:`for d in A B C; do sed "s/^const DIR = 'A';/const DIR = '$d';/" index.html > 方向$d.html; done`
  128. - 每份出同样两个时刻的静帧:`node "$SKILL/pipeline/render.mjs" <作品目录>/方向A.html --stills 秒1,秒2 --outdir <作品目录>/方向静帧 --prefix 方向A`(B、C 同理)。
  129. - 拼成一张对比图(一行一个方向,从上到下 A、B、C):在 `方向静帧/` 里 `ffmpeg -y -pattern_type glob -i '方向?_静帧_*.png' -vf "scale=960:540,tile=2x3" -frames:v 1 方向对比.png`。
  130. - 先自己用 Read 看,再 `open` 给用户,每个方向配一句话:是什么感觉、适合什么、各自的风险。
  131. - 实测一次(10-08 自检,描述「像小学教室黑板报那样的粉笔风,温暖一点」,手绘笔记起步,只到方向静帧):写补丁改底座 + 三套参数约 6 分钟(另有 1 分钟修补丁脚本的匹配),三个方向各出 2 张静帧每个不到 1 秒。还没人当观众从头实测过用法三。
  132. 4. **挑定后**(也可以是「A 的颜色 + C 的标题」):把挑定的参数写死进 `index.html`(删掉 `DIR` 和另外两套),照 `knowledge/风格卡模板.md` 写 `风格卡.md`,再照用法一第 4–7 步写场景、出 3 张静帧点头、出整段。
  133. ## 规矩
  134. - 画面只用 HTML/CSS/SVG/Canvas 代码画;**不用生图模型**;不引外部资源(CDN、网络字体、网络图片)。
  135. - 不用 CSS 动画、transition、requestAnimationFrame、Date.now()、不带种子的 Math.random()(要随机用带种子的,例如 mulberry32,在 seek(t) 里每次重建)。
  136. - 字体只用 macOS 自带的,或在字体栈里写好系统替代;按需下载的字体提醒用户在「字体册」下载。
  137. - 一次渲一套(同时跑很多个会互相拖慢 2–5 倍);渲染命令放后台。
  138. - 作品目录放在用户的项目里,不往 `$SKILL` 里写东西;`styles/`、`examples/` 只读,要改就复制到作品目录再改。
  139. - 软件要用户自己装;不替用户下载、安装任何东西。
  140. - skill 里不放任何第三方的图;用户给的参考图只放在他自己的作品目录里,版权由用户负责,成片里不出现原图。
  141. ## 做不到的事,和交给谁
  142. - 一次只适合一段 15–60 秒;整条 10 分钟的片子全做成动画要很多小时,挑最需要画面的几段做。
  143. - 配乐、音效、转场、和真人画面穿插:回剪映做(成片是普通 mp4,带口播)。
  144. - 好不好看、像不像这套风格:要用户自己看,不满意就提意见改。内容离 Token 例子越远(例如讲做菜),要新画的部件越多,越要多出几轮静帧。
  145. - 只在 macOS(Apple 芯片)上测过;Windows 没测(字体和 Chrome 路径都不一样)。只用 Opus 5.5 测过,别的模型写页面的质量没测。
  146. - whisper 识别有错字(专有名词、英文最容易错),稿子以用户为准。
  147. ## 附:7 套风格速览(详见各套 风格卡.md)
  148. | 风格 | 看起来 | 适合讲 | 新 Mac 要先在「字体册」下载 | 出片截图 |
  149. |---|---|---|---|---|
  150. | 扁平流程图 | 奶油底、琥珀标题带、编号横向流程 | 步骤、原理、因果链 | 兰亭黑(不下退苹方) | png |
  151. | 手绘笔记 | 米白纸墨蓝线稿 + 橙色,逐笔描、逐字写 | 概念拆解、观察记录 | 手札体、圆体、翩翩体 | png |
  152. | 复古报刊 | 整版报纸,往下潜进深蓝插图区 | 科普解读、专题报道感 | 不用(全是常驻字体) | png |
  153. | 复古剪纸 | 皱奶油纸上一层层剪纸、定格跳动 | 有态度的观点、几个关键东西 | 兰亭黑 | jpeg |
  154. | 超现实拼贴 | 米灰海报、特粗衬线大标题、一个大比喻 | 思维方式、认知、连锁后果 | 翩翩体、手札体 | jpeg |
  155. | 立体卡通 | 炭黑底、光面立体物件、杂志分栏 | 科学原理、拿工具处理东西的过程 | 兰亭黑、圆体 | jpeg |
  156. | 黑底科技 | 近黑底、暖金细线、衬线字由虚到实 | 高端科技概念、原理、历史趋势 | 不用 | jpeg |
  157. ## 附:文件和字段
  158. **风格文件夹** `$SKILL/styles/<风格>/`:`风格卡.md`(配色、字体和系统替代、构图、部件、动效、强调色 A/B、字幕区、渲染速度、换内容时怎么改、踩过的坑)、`模板.html`(通用模板,新作品从它改;7 套都有)、`示例_Token.html`(Token 例子的完整页面,看部件怎么用的参考)、`静帧/`(样片的 3 张 jpg,文件名是秒数)。另有 `styles/霓虹赛博/`(v1.2 实测过一次,只有风格卡、`实测_Token.html` 和静帧,不在 `--list` 里;用法三挑霓虹时用)。
  159. **分镜.json 字段**(`examples/token/分镜.json` 是完整例子)
  160. | 字段 | 必填 | 内容 |
  161. |---|---|---|
  162. | `说明` | 否 | 写给人看的备注,生成时间线时不读 |
  163. | `duration` | 否 | 片长(秒)。不写就是口播时长;口播最后一个字离结尾不到 0.5 秒时(`字幕.mjs` 会提醒),写成比口播长约 1 秒,片尾多停一会儿:最后一条字幕留到片尾,`render.mjs` 在口播后面补静音(v1.3) |
  164. | `标题` | 否 | 页眉标题 → `TL.title` |
  165. | `shots` | 是 | `[{id, cues:[字幕编号…], title, 关键字:[…], 时间点:[…], 要讲清, 运动设想}]`;`start`/`end` 可以不写(按字幕自动算,第一个从 0 开始、最后一个到片尾)。整段都不写时按句子自动分(只适合试渲) |
  166. | `shots[].时间点` | 否 | 这个镜头里要卡点的关键词,写 `marks` 里的 name(例如 `["打开", "聊天框", "例句"]`),提醒自己这个镜头哪几个动作要卡在哪几个词上;不进 `TL`,生成时间线时检查名字在不在 `marks` 里,不在就提示 |
  167. | `marks` | 否 | `[{name, cue, phrase, nth}]`:在第 cue 条字幕里找 phrase(不写就是 name);不写 cue 就在全文找第 nth 次 |
  168. | `高亮` | 否 | `[{text, role:"A"}, {text, role:"B"}]`:全片固定上色的两个词 → `TL.highlights`(怎么挑见用法一第 3 步;字幕里整词精确匹配、长的优先) |
  169. | `字幕强调` | 否 | 字幕里要强调的词 → `TL.emphasis`(同样整词精确匹配) |
  170. | `素材` | 否 | 任何你想带给页面的数据(例如一组聊天记录、清单)→ `TL.assets` |
  171. | `例句` `例句切分` `数据样例` | 否 | Token 例子专用 → `TL.example`、`TL.data`;新内容不用写 |
  172. **页面里的 `window.TL`**:`duration`、`title`、`text`、`cues`(`{id,text,start,end,show,hide}`)、`chars`(字级时间 `{text,start,end,cue}`,英文词算一个字)、`shots`(`{id,start,end,title,cues,keywords}`)、`marks`、`highlights`、`emphasis`、`assets`;函数 `TL.cueAt(t)`、`TL.shotAt(t)`、`TL.mark(名字)`、`TL.markEnd(名字)`、`TL.has(名字)`。
  173. **render.mjs 常用参数**:`--stills 秒,秒,秒`(静帧 + 480 宽检查图,配 `--outdir`、`--prefix`;同前缀的旧图先挪进 `旧静帧/`)、`--scan`(扫片拼图)、`--check-marks`(关键词前后帧拼图;这两个只出检查图、不出片,默认放 `<作品目录>/检查/`)、`--preview`(10 帧/秒、960×540,看节奏)、`--from 秒 --to 秒`(只渲一段)、`--no-subtitle`(文件名自动加「_无字幕」)、`--format jpeg`(满屏颗粒时快一倍多)、`--check-determinism auto|秒,秒`(确定性检查,v1.3)、`-o 输出.mp4`、`--audio 文件`、`--chrome 路径`。`node "$SKILL/pipeline/render.mjs" --help` 看全部。
  174. **字幕.mjs 参数**:`--no-whisper`(没有 whisper 时只用稿子 + 静音检测)、`--trim auto`(按稿子裁掉口播两头稿子里没有的话)/ `--trim 起,止`(手动裁,秒数按原口播)、`--script 稿子.txt`、`--max 20`(每条字幕最多几个字)。输出 `字幕.json` / `.srt`,有 whisper 时还有 `whisper原文.txt` / `.json`。
  175. **出错时**:页面脚本报错会停下并打印行号;「20 秒内没有定义 window.seek」先查 timeline.js 在不在页面旁边、脚本有没有报错;字体没生效(族名写错会悄悄退回苹方)就渲一张静帧看;找不到 Chrome 按提示装或用 `--chrome`。
  176. **别的工具**:`pipeline/取色.mjs <图片> 16 [x:y …]` 取主色和指定点颜色(做新风格时用);`pipeline/丰富度检查.mjs <成片.mp4>` 看画面变化够不够(用法一第 6 步);`pipeline/动效部件.js` 转场和次要动作的共用函数(用法一第 4 步;v1.3 加了 `resetCtx` 复位画布、`iris` 圆形遮罩、`sweep` 色块横扫,后两个能用 `area` 只盖一块)。
  177. **知识库**(`$SKILL/knowledge/`):`从11套里学到的.md`(做 11 套样片踩过的坑、渲染速度、字体实测、概念怎么演;开头有四份知识的索引)、`风格词典.md`(描述词 → 参数、macOS 字体对照、27 种风格各怎么做,用法三主要查它)、`讲解动画通用规则.md`(字号、对比度、字幕安全区、颜色预算、一镜一事、动效时长,注了出处)、`风格卡模板.md`(新风格的空白风格卡)、`动效和画面变化.md`(v1.2:每个镜头的变化清单、多久一个新变化、各风格的转场、分层和推拉、动画原则、盲测里好用的手法、丰富度自查表、共用部件用法)。
README.md · README · 73 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # dashi-animationstyle:风格动画(Claude Code skill)
  2. 把一段 15–60 秒的中文知识口播,交给 Claude 做成某种画风的讲解动画:1920×1080、30 帧/秒的 mp4,带口播和字幕,能直接拖进剪映接着剪。
  3. 画面全部由 Claude 用 HTML / Canvas 写代码画出来,再用无头 Chrome 逐帧截图合成,**不用生图模型**。
  4. 下面 7 张动图是同一段 21 秒口播(讲「AI 怎么读懂一句话」)在 7 套风格里的同一个 5 秒(7.6–12.6 秒:提示词 → 分词器把句子剪成 Token)。
  5. > 出品:《大师的AI小灶》。完整展示视频(7 套同步平铺 + 每套完整一遍)发在 X:[@dashiAIxz](https://x.com/dashiAIxz)。
  6. ## 自带 7 套风格
  7. | | |
  8. |---|---|
  9. | **1 立体卡通**:炭黑底、光面立体物件、杂志分栏。适合讲科学原理、实验过程<br>![立体卡通](docs/1_立体卡通.gif) | **2 黑底科技**:近黑底、暖金细线、衬线字由虚到实。适合讲高端科技概念、历史趋势<br>![黑底科技](docs/2_黑底科技.gif) |
  10. | **3 超现实拼贴**:米灰海报、特粗衬线大标题、一个大比喻。适合讲思维方式、认知<br>![超现实拼贴](docs/3_超现实拼贴.gif) | **4 复古剪纸**:皱纸上一层层剪纸,定格跳动。适合有态度的观点<br>![复古剪纸](docs/4_复古剪纸.gif) |
  11. | **5 复古报刊**:整版报纸,往下潜进深蓝插图区。适合科普解读、专题报道<br>![复古报刊](docs/5_复古报刊.gif) | **6 扁平流程图**:奶油底、琥珀标题带、编号横向流程。适合讲步骤、原理、因果链<br>![扁平流程图](docs/6_扁平流程图.gif) |
  12. | **7 手绘笔记**:米白纸、墨蓝钢笔线稿 + 一种橙,逐笔描、逐字写。适合讲概念拆解、观察记录<br>![手绘笔记](docs/7_手绘笔记.gif) | 每套的 3 张高清截图在 `styles/<风格>/静帧/`,配色、字体、动效写在 `styles/<风格>/风格卡.md`。 |
  13. ## 三种用法
  14. 1. **现成风格**:交一段口播,说「把这段口播做成手绘笔记风格」。Claude 转写出字幕、写分镜给你确认,再画 3 张静帧给你确认,然后出整段。
  15. 2. **照参考图做新风格**:给一张你喜欢的画面(截图、海报、插画)或一段视频,说「照这张图的画风做」。结果不保证,一般要出 2–4 轮静帧才像。
  16. 3. **用一句话描述**:例如「像小学教室黑板报那样的粉笔风,温暖一点」。Claude 先问几个问题,查 skill 里的风格词典(27 种风格的配色、字体、动效),出 2–3 个方向的静帧给你挑。
  17. ## 安装
  18. **环境**:macOS(只在 Apple 芯片上测过)、Node 22 以上、ffmpeg、Google Chrome。whisper-cpp 可选(自动转写字幕用;没有的话给一份文字稿也能做)。
  19. ```bash
  20. brew install node ffmpeg
  21. git clone https://github.com/chuspeeism/dashi-animationstyle.git ~/.claude/skills/dashi-animationstyle
  22. ```
  23. 装好后在 Claude Code 里说:「检查一下风格动画的环境,再渲一个例子看看。」Claude 会跑自检,然后用自带的 Token 例子渲一段 21 秒的成片(Apple M2 Max 上每套 34–72 秒)。
  24. **字体**:兰亭黑、圆体、手札体、翩翩体是 macOS「按需下载」的字体。自检会列出缺哪几个,打开「字体册」搜字体名、点「下载」即可;不下载也能渲,那几个字体会退回苹方。
  25. ## 用时和限制
  26. - 一段 20–30 秒的口播套现成风格:实测一次约 30 分钟(23 秒、9 个镜头、手绘笔记),内容离例子越远越久,按 1 小时准备。中间会停两次请你确认(分镜、3 张静帧)。
  27. - 照参考做一套新风格:每套 1 小时到 1 小时 45 分;我们照 11 份参考做了 11 套,留了 7 套。
  28. - 一次只适合 15–60 秒的一段;整条 10 分钟的视频挑最需要画面的几段做。
  29. - 配乐、音效、和真人画面穿插回剪映做。好不好看要你自己判断,不满意就按「第几秒、哪个东西、改成什么」提意见。
  30. - 只在 macOS 上测过,只用 Claude Opus 5.5 测过。
  31. ## 目录
  32. | 位置 | 内容 |
  33. |---|---|
  34. | `SKILL.md` | 给 Claude 读的完整说明:三种用法的步骤、规矩、做不到的事 |
  35. | `styles/<风格>/` | 每套风格:`风格卡.md`(配色、字体、构图、动效、踩过的坑)、`模板.html`(新作品从它改)、`示例_Token.html`(例子的完整页面)、`静帧/` |
  36. | `pipeline/` | 自检、新建作品、转写字幕、生成时间线、渲染、取色、丰富度检查、共用动效部件 |
  37. | `knowledge/` | 风格词典(27 种风格)、讲解动画通用规则(字号、对比度、安全区、动效时长,带出处)、动效和画面变化、做 11 套样片的经验、风格卡模板 |
  38. | `examples/token/` | 自带例子:21 秒口播「AI 怎么读懂一句话」的音频、字幕、分镜、时间线 |
  39. | `docs/` | README 用的动图 |
  40. ## 版本
  41. | 版本 | 内容 |
  42. |---|---|
  43. | v1.0 | 7 套风格的模板和例子;转写、分镜、渲染、自检脚本 |
  44. | v1.1 | 按一次观众实测修订:字幕识别改正、裁口播、扫片和卡点检查 |
  45. | v1.2 | 第二、三种用法;风格词典、通用规则;动效知识、共用转场部件、丰富度检查 |
  46. | v1.3 | 7 套例子按动效规则重做;模板自带背景动效和转场;去掉字幕时字幕底带一起去掉;整理成公开版 |
  47. ## 许可
  48. 代码和文档:MIT(见 `LICENSE`)。
  49. `examples/token/口播.wav` 是作者本人的声音,取自 B 站视频《【告别AI文盲】5分钟速通AI黑话!》(BV1tMHYzkEnY),只供试用这个 skill,不要用在别的作品里。
  50. skill 不带任何字体和第三方图片;用法二里你给的参考图只放在你自己的作品目录里,版权由你自己负责,成片里不出现原图。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.