v2.0.0

v2.0.0

格物 · 蜡笔状态图 v2。这一版吸收了 Kevin Ngo 的 statechart-art，可以直接从代码里的状态机起片子，画面、声音和交付也都升级了。

发布前用 v2 做了一部实片《一个人的创意团队》来检验：3 分钟，五章，其中一章三条线并行，一章是规则章。做片过程中发现了三处引擎问题，已在本版修好。

新增

• 规则和检查器（来自 statechart-art）：
  • 一章可以写几条规则，海报上的图例标出 ✓ 成立、✗ 打破，以及一共查了多少种情况；
  • 每条被打破的规则各画一条红线；
  • 可以“先破后立”：补一道条件后红线淡去，盖一枚绿章；
  • 检查器把条件当逻辑来算，还会报出走进去就出不来的状态组合。
• 代码进，片子出：XState、Mermaid、SCXML、PlantUML，或 /statechart 技能的输出，都能 import 成片子的骨架；片子里的图也能 export 回去。
• 画法和主题：
  • 八种卡片画法：票据、便签、木牌、圆角卡、铜牌、吊牌、玻璃片、毛毡补丁；
  • 父状态可以画成店面；几条线可以并行，各用一种颜色；
  • 九种主题，包括新的“钢笔彩铅”，也可以由品牌色生成；
  • 横屏有专门的从左到右版式；图太大时海报会自动加高。
• 动效：
  • 图钉落下、卡片晃动，粉圈像蜡笔一样画出来；
  • 盖章时画面一震，溅出墨点；
  • 新增聚光和显微镜小窗，镜头可以推近；
  • 开场可以用一个问题，片尾扫一遍全部海报；
  • 默认把封面合成进视频：先显示 0.5 秒，再渐隐 0.5 秒，然后开始正片。"cover_intro": false 可以关掉。
• 插画：
  • 9 个场景件，人物有多种体型和表情，道具超过 130 件；
  • draft 按空地起草插画；
  • lint 逐条报出压字、出界、太空、太小等问题，并给出改法。
• 声音：
  • 每步可以调语气，有音效和环境声，可以跟着音乐卡点；
  • 读过的字幕会变深，角色跟着旁白张嘴；
  • 可以出英文版。
• 交付：
  • 成片之外另出一份上传母版；
  • 还有分章短片、长图、各平台尺寸的配图、动图、可以逐步看的网页、作品集页和发布包；
  • 所有文件都带 GB 45438 的 AI 生成标识；
  • preview 在浏览器里带声音预览，改了文件会自动刷新。

修复（做实片时发现）

• 竖版里三条线并排的“同一时间”框会出界。现在会自动收紧间距。
• 规则修复后补上的绿色条件会压到旁边的卡片上。现在排版时预先留出位置。
• 场景里调用 $.box 画不出纸箱：它和按名字取卡片位置的函数重名了。现在两种用法都能用。
• 加了封面片头后，交付时间表里逐字的时间也跟着后移 1 秒（来自 Codex 的检查）。

升级须知

• 版式变了，v1 的片子用 v2 重新渲染，画面会和以前不一样。三个旧例子的插画已经按新版式重画。
• 本版没有专门测试旧片子的兼容性。重新渲染旧片子之前，先跑一遍 check 和 lint。

测试

以下测试都通过了，安装包解压后又重跑了一遍：

• 冒烟测试；
• 引擎检查：各种比例、主题和画法；
• 状态图导入导出和检查器：17 项；
• 封面片头：3 项；
• 18 帧基准画面对照：SSIM 都不低于 0.985。

下载

• sweety-statechart-video-v2.0.0.zip：完整 Skill；
• SHA256SUMS-v2.0.0.txt：校验值。

v1.1.1

v1.1.1

这次的修复来自平台实测：Grok Build 和 Claude Code 各自只读 Skill，独立做了一部《泡一杯茶》（带岔路，插画会动），都顺利交付了成片和海报。

修复

• 无旁白的片子看得清字幕。 每一步至少停到字幕读得完（0.5 秒加每秒 7 个字）。以前每步一律 1.2 秒，字幕闪得太快。"read_pace": false 恢复参考作品的 1.2 秒。
• 水印不再压住标题。 制作者小牌从左上角挪到右上角。以前一章快结束、镜头往下滚的时候，小牌会盖住左上角的大标题。

新增

• 泡茶道具：
  • kettle：烧水壶，会冒汽；水开时汽更大，壶盖会跳；
  • teapot：茶壶；
  • teacup：玻璃茶杯，茶色随浸泡变深，茶叶会漂。

下载

• sweety-statechart-video-v1.1.1.zip：完整 Skill，已解压实测，冒烟测试通过；
• SHA256SUMS-v1.1.1.txt：校验值。

v1.1.0

v1.1.0

灵感来自 Ann Nguyen 老师（@ann_nnng）的 the making of nhang：我们做了风格提取，再加上以下特性。

新增

• 任意比例：默认 3:4。"aspect" 可以写任何 W:H（9:16、16:9、1:1、4:5、2.35:1……），短边 1080。
  • 竖版的海报和画面同形；
  • 横版的海报是方的，镜头跟着动作在海报上滚动。
• 时长默认 2–3 分钟：适配大部分自媒体。"duration" 可以写 150、[60, 90]、"1分钟"。
  • check 按旁白语速预估时长，并告诉你要加几步或删几步；
  • plan 离目标差一点时，给每步多留最多 0.7 秒。
• 加自己的声音：scv.py add-voice my-voice --audio 录音.m4a --start 12 --end 25 --text "逐字稿" --consent self --preview。
  • 依次查长度、噪声和逐字稿（Whisper 核对），通过后存进你的本地声音库；
  • 片子里写 "voice": "my-voice" 就能用。
• 一部片里换声音：步骤里写 "voice"，这一句就换成那个声音读。四个声音轮流出场、角色对话都靠它。
• 平台：
  • 支持 Codex、Claude Code、Grok Build、Grok Bot、Muse，后续计划支持 WorkBuddy；
  • 新增 scripts/setup.sh：一键准备渲染环境，最后跑冒烟测试；
  • 没有 Google Chrome 时自动改用 Playwright 的 Chromium；
  • 新增 Codex 的显示信息（agents/openai.yaml）和 references/platforms.md。
• 新例子 examples/intro/：2 分 10 秒的介绍片（默认时长），四个声音轮流出场。

修复

• 镜头在一章之内停在这一章的海报上，只有出口那一步才滚到下一章。以前箭头回到顶上时，镜头会翻回上一章，高海报底部的结尾场景看不到。"player": {"settle": false} 可以恢复参考页的滚动规则。
• 调色板里的颜色名（"sky"、"straw"……）现在在所有画笔里都能用，以前直接传给排线时会画成黑色。
• 一章同时有“同一时间”框和框外的卡片时，起点现在落在框上，两条线都有起点箭头。

下载

• sweety-statechart-video-v1.1.0.zip：完整 Skill，已解压实测，冒烟测试通过；
• SHA256SUMS.txt：校验值。