polyweave 为 Claude Code 扩展游戏素材检查

如今，coding Agent 已经能写出游戏里不少部分：玩家控制器、菜单逻辑、存档系统。但接下来，你需要一个吉祥物、一段金币音效、一段背景循环音乐，还有第三关，Agent 就帮不上忙了。它看不了渲染图，听不了声音，也没法试玩关卡，更不知道这些东西做到什么程度才算合格。

AI 生成工具也没有解决这个问题。你输入一段 prompt，几秒钟就能拿到一个 3D 模型、一张图片或一句配音，然后真正的工作才刚刚开始。它符合你的草图吗？橙色是你想要的那种吗？循环播放时，接缝处会不会出现咔嗒声？它和另外四十个素材放在一起，像是同一款游戏里的东西吗？生成工具只是猜了一次，而检查结果的人还是你。

polyweave 是一个面向 Claude Code 的免费开源插件，负责接手这些检查工作。

polyweave 最初诞生于一款真实的游戏。Cottony 是一款毛绒主题的三消游戏，里面的爱心、水滴和星星都像用毛毡做成的，落下时还会被挤扁。它的方块在 Blender 中渲染。为了把效果调到位，需要手动调整十四项渲染设置：改一个数字，等大约两分钟出图，看结果，作判断，然后重复。

制作模型很快。大部分时间都花在了「已经有模型」到「确认模型符合要求」之间。polyweave 要解决的，就是这段过程。

核心思路：把「合格」的标准写下来

使用 polyweave 时，游戏的每个部分都会先有一份简短的文件，说明它怎样才算合格。你不用亲自写这份文件。只需用日常语言描述你想要什么，Claude Code 就会把它整理成一组带有明确限制的检查项：

• 轮廓必须与我的草图一致。
• 脸部必须是指定的奶油色，允许有少量偏差。
• 音效必须是 C 调，不能太响，循环播放时不能有咔嗒声。
• 这一关必须比上一关稍难一点。

标准一旦明确，工作就不再依赖人盯着渲染图反复判断。Claude Code 可以生成一个候选版本，对照标准测量，调整设置，再试一次。不合格的结果会在送到你面前之前被淘汰。

四个步骤，完成整个流程

1. 提出需求。 告诉 Claude Code 你需要什么：「做一个像这张草图的吉祥物」「做一段 C 调金币音效」「把第 3 关稍微调难一点」。

2. 制作。 polyweave 会调用适合这项工作的工具，可以是 Blender、Godot、3D 或图片生成工具、合成器，也可以是配音服务。

3. 检查。 每个结果都会按标准测量。不合格就调整，再试一次。

4. 批准。 最好的候选版本会并排显示在审核页面上，每个版本旁边都有对应的检查结果。你可以批准、拒绝，也可以用自己的话提出修改要求，比如「把耳朵做得更圆一点」，Claude Code 就会继续工作。

同一套循环适用于游戏的每个层面：

• 3D 模型： 在 Blender 中制作，或付费调用生成工具获取，再调整到符合你的绘图。
• 图片： 概念图、图标、sprite sheets、商店展示图。
• 音乐： 循环播放时无缝衔接。
• 音效： 通过合成或购买获得，并检查响度和咔嗒声。
• 视觉特效： 粒子、辉光和命中特效等。
• 配音： 用每个角色各自的声音朗读。
• 文字： 名称、对白和文本，检查是否符合你的世界观，以及能否用所选字体正常显示。
• 关卡： 在任何人试玩之前，先测量难度。
• 动画： 以文本形式保存，调整时序只需改一处，而且可以通过 diff 查看变化。
• 游戏套件： 菜单、设置、存档、控制和无障碍功能，安装时就已经经过测试。

所有层面共用一份配置文件、一套记录各个部分制作过程的档案，以及一个审核页面。这样，你可以把游戏的各个部分放在一起判断，而不用逐个工具分别检查。

与你已有的工具配合使用

polyweave 不会替代 Blender、Godot 或你喜欢的生成工具。它处在这些工具之间，用各自能理解的方式与它们交互。

以根据草图制作吉祥物为例，流程是这样的：

1. 在付费获取任何内容之前，polyweave 会先根据你的绘图检查请求，避免把额度花在明显无法匹配的请求上。

2. Meshy 生成模型。polyweave 会在你的项目中保存一份副本，同时记录 prompt、seed、费用和许可证，因此不会因为服务端的内容过期而丢失素材。

3. Blender 渲染模型，polyweave 则把渲染结果与你的草图对照测量：轮廓是否吻合？该出现指定颜色的地方，颜色是否正确？

4. Claude Code 调整渲染设置，直到所有检查都通过。只有到这时，最好的候选版本才会进入你的审核页面。

5. Godot 打开游戏并截取画面，让你看到吉祥物在玩家实际遇见它的场景中是什么样子。

已经有很多工具能把 Agent 连接到 Blender 或 Godot。但它们没有告诉 Agent，什么时候应该停下来。在 polyweave 中，这件事由验收标准负责：Agent 会持续操作工具，直到结果符合要求，而不只是完成了一次操作。

使用哪种工具，只是你 repo 中配置文件里的一行设置。你可以随时更换模型，而每个部分需要通过的标准保持不变。

把信用卡和美术方向交给 Agent，确实有理由让人担心。对此，polyweave 有三条规则，Agent 无法绕过其中任何一条：

• Agent 不能批准自己的作品。 它可以测量一个素材，但只有你能接受它。画面是否合适、声音是否满意、难度是否公平，都由你决定。

• Agent 不能凭自己的判断花钱。 你只需设置一次支出上限。每个付费请求都会先报价，再记入账本；明显无法匹配参考素材的请求，会在消耗任何额度之前被拒绝。Claude Code 可以在上限内自由工作，但永远不能提高这个上限。

• 所有内容都保存在你的机器上。 不需要账号，也没有托管服务。规格、任务和记录都是 repository 中的普通文件，团队成员可以审核或复现任何内容。

每个文件还会保留自己的生成历史：使用了哪个模型、哪段 prompt、哪个 seed，花了多少钱，以及采用什么许可证。编写游戏的致谢页面、检查许可证，都变成了查记录。

已经有真实游戏在用它开发

Viglet Games 正在使用 polyweave 制作游戏，两款游戏都在开发中，计划登陆 Steam：

• Cottony： 一款毛绒主题的三消游戏，也是这一切的起点。
• Spinhold： 一款霓虹风格的环形射击游戏，你会沿着一个旋转殖民地的外侧飞行。

你需要 Claude Code，以及 Python 3.11 或更新版本。Blender 和 Godot 是可选的：polyweave 会告诉你它找到了哪些工具，以及每个缺失的工具能解锁哪些功能。

pip install git+https://github.com/alegauss/polyweave
/plugin marketplace add alegauss/polyweave
/plugin install polyweave@polyweave

在这个项目中配置 polyweave，并根据 docs/sketch.png 为我制作一个吉祥物。

网站：alegauss.github.io/polyweave

代码：github.com/alegauss/polyweave

如果你正在和 Agent 一起制作游戏，我很想知道，游戏的哪一部分仍然占用了你大量时间。欢迎留言。

如果需要采取进一步措施，你可以考虑屏蔽此人，和／或举报滥用行为。