anidoodle 代码手绘（anidoodle）

anidoodle 代码手绘的维护记录。

• 上游：alexgreensh/anidoodle 的 skills/anidoodle/¹，作者 Alex Greenshpun（10x Company），Apache-2.0，许可证原文和 NOTICE 不随附。第三方内容：
  • engine/assets/refs/vangogh-almond-blossom.jpg 是梵高《杏花》（1890），公有领域，取自 Wikimedia Commons，来历见同目录 PROVENANCE.json
  • 音源包不在仓库里，由 soundfetch.mjs 从上游 release sounds-v1 下载：乐器录音取自 VCSL（CC0），三个房间的脉冲响应取自约克大学 OpenAIR（CC BY 4.0，转发要带署名），署名全文见音源许可证
• commit：钉在 25aae33（2026-10-17，版本 0.9.2），当天读时是最新
• 跳过：
  • 插件只带这一个 skill，没有 hooks、agents、commands、mod、MCP，没有组件要转写或丢弃
  • 仓库根的 6 种语言 README、PRIVACY.md、插件清单（.claude-plugin/、.codex-plugin/、.grok-plugin/、.agents/plugins/）、plugins/anidoodle/（给 Codex 插件市场的同步副本，比 skills/ 旧）和同步脚本 scripts/
  • 仓库根 assets/ 下 README 用的演示成品：一张横幅动图、四段演示动图、两段 mp4、8 段试听 mp3、图标和社交预览图，约 33MB²。用户定的：不收进 Gallery，skill 入口只放自带的风格总览图 assets/styles.jpg
  • engine/tools/docs-check.mjs：上游的文档 CI，检查 SKILL.md 不超过 150 行、description 不超过 50 token、6 份 README 里写的画风数和代码一致。这里没有 SKILL.md 和 README，跑起来必然失败
• 翻译之外的改动：
  • SKILL.md 改名 index.md；name 照旧，description 改写成什么时候用、做什么；开头一段末尾加整包声明，补一句为什么要整包；正文前插入风格总览图；七条铁律前加一步：开作品项目时写进该项目的 CLAUDE.md / AGENTS.md；工具表删掉 docs-check.mjs 一行；命令代码块里的注释译成中文
  • 6 个文件改名：references/styles.md 改 references/style-guide.md，因为它和目录 references/styles/ 抢同一个网址；references/styles/INDEX.md、references/music/README.md、references/music/theory/README.md、example/README.md、engine/tools/adapters/README.md 都改 index.md。README 在 zensical 里本来就渲染成目录首页，但 check-links 只认 index.md 承担挂链
  • 上游正文用行内 code 写文档路径，改成相对当前文件的链接，链接文字保留上游写法（相对 skill 根），整包解压后照着读也对得上；指向 .ts、.mjs、.json 的路径仍是行内 code
  • 提到 SKILL.md 的地方改成链到入口页；GitHub 上风格总览图的地址改成本地 assets/styles.jpg；音源许可证里的外部网址挪进脚注
  • 风格索引加「配方」列，链到同目录 30 篇配方，balloon、mellan 两种没有配方页
  • 引擎脚本：registry.mjs 不再生成 references/styles/INDEX.md，只写 engine/styles.gen.json —— 重新生成会用英文表盖掉中译和配方列，新增画风时手工在索引页加一行；launchExample.ts、launch.mjs、scaffold.mjs、verify-export.mjs、adapters/hyperframes.mjs 里指向改名文档的注释和提示跟着改；registry.mjs 开头的说明改成和现在的行为一致
  • engine/test/ 保留：gate.mjs --self-test 读 test/fixtures/，工具表里的 npm test 也指着它

译法

• 译了什么：73 篇 markdown 的正文、标题、表格和链接文字。指令强度对等译：must → 必须，never → 绝不。英文用全大写表强调的词译成中文加粗
• 没译什么：围栏代码块（连同英文注释）、行内 code、文件名、命令和参数、画风 id、产品名。入口页命令代码块的注释是例外，译了
• 格式：英文硬换行的段落合并成一行；被锚点链接指向的 3 个标题补了 { #上游 slug }；嵌套列表缩进统一成 4 格
• 两份生成文件照样译了：风格索引原由 registry.mjs 生成，音乐风格词汇表原由 music.mjs vocab --md 生成，重新跑生成器会得到英文原版
• 统一译名：style → 画风，hand → 手笔，mark → 笔触，plate → 样张，still → 静帧，score → 配乐，craft bar → 手艺及格线，dead air → 冷场，seam → 接缝，token → 信物，gate → 闸门，sound pack → 音源包
• 校验：每篇对照上游原文跑脚本：代码块逐字一致，标题数、表格行数一致，上游的行内 code 都还在（转成链接的路径算在链接文字里），链接目标存在，中文字数 ÷ 英文词数不低于 1.2