crsolver/claude-pxl

结论先行： 如果你希望像素画以纯源码文件的形式被生成和保存，或者希望让 AI agent 可复现地画图，这个项目值得一试。如果你需要鼠标加图层的绘画流程，它并不适合你。

解决什么问题

之前，一个小型游戏团队或独立开发者要做精灵和动画，通常只有两条路：手工画，或者让 AI 生成一张之后无法精确修改的图。手绘文件难以做 diff、换色或为 30 帧动画重新生成；换色和变体会膨胀成一个个独立文档。用 pxl 之后，唯一的真源变成一个很短的 .px.js 文件：调色板、文本网格精灵、场景、以补丁形式描述的动画帧。运行 CLI 就能得到 PNG、精灵图集加 JSON、以及 GIF；浏览器查看器会在每次保存时逐步回放绘制过程，因此你能看着 agent 画，而不是只看一张成品图。

有什么不同

它的机制是在普通 JavaScript 或 TypeScript 之上加一层很小的领域特定写法：你用文本写画，工具确定性地输出素材。这会实际改变工作流：换色是针对基础精灵的一行调色板替换，镜像和自动描边是开关，动画帧是基础图上的补丁而不是整帧重画。README 还展示了带图层、阴影和可选光照的场景，以及内置像素字体，比单纯的精灵网格格式要多。

代价也很实在。这是把画写成文本，不是画布编辑器：没有指针绘画，精确的徒手绘制会很别扭甚至做不到。作者没有说明能和常见绘画工具的图层文件互通，所以采用 pxl 意味着以生成产物为准，而不是在 Aseprite 一类的可编辑源文件之间来回转换。DSL 承担了不少创作工作，但最终场景质量仍取决于网格和调色板写得怎么样。

谁值得试

适合：正在做小型游戏或演示、希望精灵、图集和 GIF 从可版本管理的源码重新生成，并且不排斥编辑文本的开发者。它也适合 AI agent 工作流——仓库自带一份 agent skill，引导 agent 走“写 → 构建 → 看预览 → 修补”的循环。不适合：主要在画布编辑器里手绘的像素画师，或者需要把生成的 PNG 和现有手绘源文件放在一起继续编辑的团队。

文档给出两条上手路径，这会影响谁能开始：直接克隆后用 Node 运行，或者不克隆直接 npx github:crsolver/claude-pxl build。快速开始里只为第一条路径描述了实时查看器和回放，所以在依赖查看器之前先确认 serve 路径。

使用条件与边界

需要 Node ≥ 22.18。克隆路径由 CLI 直接运行 TypeScript 源码；安装包路径运行 dist/，它由 npm install / npm pack 生成。README 提醒 Node 不会在 node_modules 里剥离类型，所以如果需要打包或内嵌，要用构建产物而不是源码树。

长期维护方面：API 面很宽（调色板与渐变、图元、场景、动画、光照、tilemap），完整参考放在单独的 reference 文档 里。要习惯查阅这份文档，以及阅读指向 file:line:col 并带素材/图层/操作路径的错误提示。对 agent 而言，工作流依赖读取 SKILL.md 和预览输出；只给 agent CLI 而不给技能指引，它可能不会走预期的“画—补”循环。

HotRepo 点评

HotRepo 从 2026-10-24 开始记录这个仓库；在 TypeScript 新项目榜上，2026-10-25 观察到 431 个总 star、排名 #22，前后只有两个记录日期。这只是一个快照，没有每日增长序列，因此无法据此判断热度能否持续。按提供的数据，仓库创建于 2026-10-15，目前十天。投入之前，请在你的 Node 版本上验证文档中的 npx 路径和实时查看器，并确认生成的 GIF 和图集符合你引擎的导入格式。