Sprite Studio：本地优先 AI 2D 游戏美术工作台，Rust 骨骼引擎确定性渲染 + Codex 驱动逐帧动画

by Mycelium Protocol

---

GitHub：JohnKinyanjui/sprite-maker
许可证：MIT
技术栈：Tauri 2 + Svelte + Rust + SQLite + Codex CLI
平台：macOS · Windows · Linux

---

「生成一张好看的图很容易。一个可用于生产的游戏资产还需要稳定的角色识别、干净的透明通道、可读的缩放比例、一致的调色板、清晰的文件结构——如果它要动起来，还需要一个机械上完整的循环。」

这是 Sprite Studio 在 README 第一段就说清楚的问题定位。它不是图像生成器，而是一个把「提示词 → 可交付游戏资产」这条完整流水线做成桌面工作台的工具。

---

一、整体架构：8 个持久标签页

工作台分 8 个标签页，快捷键 Cmd/Ctrl+1 到 Cmd/Ctrl+8：

标签	用途
Chat	提示词、附参考图、查看生成进度和播放输出
Sprites	资产库，按分类和 Pack 筛选，支持全尺寸查看器
References	管理每个聊天的风格和来源参考图
Animate	播放、拖拽时间轴、逐帧检查、循环修复
Rig	放置关节点和骨骼、查看 AI 建议、关键帧姿势、确定性渲染
Sheets	构建精灵表和元数据
Packs	管理协调资产集合
Playground	测试游戏内比例、运动和动画播放速度

左侧边栏固定为工作树和会话列表，工具栏保持持久打开——切换资产不会破坏聊天上下文。

---

二、AI 动画：逐帧生成，不是姿势表

这是整个工作台最关键的技术选择。

常见的 AI 动画方案是生成一张「姿势表」（把所有帧一次生成），再裁切成单帧。问题是这种方式在帧与帧之间很难保持角色一致性——特别是尾部帧会明显漂移。

Sprite Studio 的方案是逐帧生成，每一帧都以原始身份参考和相邻已接受帧作为输入：

[提示词 + 聊天参考图]
    ↓
Sprite Director → 一份聚焦的源素材
    ↓
AI 运动规划 + 物理相位
    ↓
按播放顺序逐帧生成（身份参考 + 邻帧参考）
    ↓
身份、邻帧、边缘、循环检查
    ↓
归一化（分辨率、透明通道、调色板、安全边距、目标姿势）
    ↓
验证 → 播放 → 导出

默认帧数范围 24–48，倾向于「最小完整循环」而非固定帧数。用户可以在设置里切到固定帧数模式（生产流水线需要精确帧数时）。

案例：三种解剖感知运动

README 给出了三个典型案例，说明运动规划有多细：

• 兔子跳跃（8 帧）：不是简单上移，而是蜷起后腿、后腿蹬出、空中收腿、前腿着地、吸震、还原——物理规划器会估算速度/高度/比例的物理包络，除非用户自己指定。
• 龙翅膀（12 帧）：保持同一条龙的视觉身份，同时完成完整的翼展下扑、折叠收回、躯干上扬、腿部延迟、尾部反向平衡。
• 百脚虫（连续体运动）：针对非人形态，使用头尾相位差的身体波动、交替腿组、稳定地面线，以及独立的每个足段接触点。

---

三、Rig 引擎：Rust 原生，确定性，零图像生成

Rig 编辑器是第二条完全独立的动画路径，不经过任何图像生成 API。

工作机制：

1. 在精灵上放置命名关节点（joint、anchor、contact、pivot）和胶囊骨骼
2. 引擎自动为每个骨骼认领最近胶囊内的不透明像素，剩余像素归属最近骨骼——无需手动绘制蒙版
3. 设置每帧的骨骼旋转、缩放、偏移、根位移、持续帧、Z 层级
4. 两骨 IK 解算器让脚和手保持接触点固定（走路循环不会滑步）
5. 最近邻逆映射渲染：输入相同则像素级别完全一致

AI 可以参与第一步：/rig 命令或「Ask AI」把精灵发给 Codex，返回一个 rig-suggestion JSON，包含关节点、骨骼和可选姿势帧（带置信度），自动出现在 Rig 标签页里。之后用户可以手动微调，或直接渲染。

渲染结果落入 assets/<category>/，和 AI 生成的帧同等对待——进精灵库、进动画、进精灵表、进 Playground。

用途：对于需要精确程序化控制的动画（走路循环、简单 UI 元素、确定性重用），Rig 路径比反复跑图像生成要稳定得多。

---

四、生成配置和斜杠命令

生成配置（Profile）

配置	画布	帧数	FPS	适用
Low	32×32	自动 4–32	6	小道具、快速验证
Mid	64×64	自动 4–32	8	多数像素角色和游戏对象
High	128×128	自动 4–32	12	精细角色和平滑运动
Custom	8–512px	1–32	1–60	生产流水线定制

配置是默认值，不是硬限制——每个聊天可以切到 Custom 单独配置。

斜杠命令

命令	用途
/animate	从当前聊天上下文和运动设置构建无缝动画
/sprite	生成一张精美静态精灵
/character	通过 ImageGen 角色 harness 路由请求
/effect	创建动画游戏特效
/pack	生成一组风格协调的独立资产

纯语言提示也能工作，路由器会根据提示内容自动推断正确的 harness。

---

五、质量系统

每帧生成后自动做确定性检查：尺寸、透明边界、重复帧、时序连续性、对齐、缩放、调色板、运动合理性、无缝循环。

这些分数是诊断，不是艺术判断——Sprite Studio 明确写了这一点。播放才是最终评审。

质量分析失败的帧会在 Animate 标签页里标出，用户可以选择修复（AI 润色、非破坏性重绘）或跳过。

---

六、本地构建

依赖

• Bun
• 稳定版 Rust
• Tauri 2 的系统原生依赖（各平台不同）
• 已安装的 Codex CLI（用于聊天对话和模型调用）

# 开发模式
bun install
bun run check
bun tauri dev

# 验证 Rust 核心
cargo test --manifest-path src-tauri/Cargo.toml
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings

# 构建桌面安装包
make release

---

七、设计本质

Sprite Studio 把两条截然不同的路径放进同一个工作台：

• AI 路径（Chat → Animate）：给不确定「它应该长什么样」的人用，用语言描述，看 AI 怎么解读，迭代。
• Rig 路径（Rig → 确定性渲染）：给已经知道「它应该怎么动」的人用，精确控制，帧完全可重现。

两条路径的产物都是同一种资产，进同一个库，走同一条导出流。这是少见的、把「AI 创作」和「程序化控制」做成互补而非竞争的游戏资产工具。

---

Mycelium Protocol — 追踪 AI 系统的底层演化

---

关于 Mycelium

菌丝协议。持续追踪 AI 工具、系统和实验的内容节点。

---

Sprite Studio: Local-First AI 2D Game Art Workbench — Rust Rig Engine + Codex-Driven Sequential Animation

by Mycelium Protocol

---

GitHub: JohnKinyanjui/sprite-maker
License: MIT
Stack: Tauri 2 + Svelte + Rust + SQLite + Codex CLI
Platforms: macOS · Windows · Linux

---

“Generating one attractive image is easy. A production asset also needs a stable identity, clean transparency, readable scale, consistent palette, useful file structure, and — when it moves — a mechanically complete loop.”

That’s Sprite Studio’s opening problem statement. It’s not an image generator. It’s a desktop workbench that turns the full pipeline from prompt to deliverable game asset into a single persistent workspace.

---

Architecture: 8 Persistent Tabs

Tab	Purpose
Chat	Prompt, attach references, track progress, play output inline
Sprites	Asset library — filter by category or pack, full-size viewer
References	Manage per-chat source and style references
Animate	Play, scrub, retime, inspect, repair loops
Rig	Place points and bones, review AI suggestions, keyframe poses, render deterministically
Sheets	Build sprite sheets and metadata
Packs	Review coordinated asset collections
Playground	Test gameplay scale, movement, animation speed

The left sidebar stays reserved for worktrees and conversations. Tools stay open in persistent top-level tabs — inspecting an asset never destroys chat context.

---

AI Animation: Sequential Frames, Not Pose Sheets

The critical technical choice: frames are generated individually in playback order, every call using the exact identity reference and temporal neighbors. Raw results are normalized back to the requested canvas, transparency, crisp palette, safe edge padding, and intended pose before entering the library.

Default range: 24–48 frames, favoring the smallest mechanically complete loop. Fixed-count mode is available when a production pipeline requires an exact number.

Three anatomy-aware motion examples from the README:

• Rabbit hop (8 frames): Not a simple upward shift. Compresses the haunch, pushes from the hind leg, tucks in the air, reaches with the forefeet, absorbs contact, recovers. Physical envelope estimated from visible anatomy.
• Dragon wingbeat (12 frames): Maintains the same dragon identity through a forceful downstroke, folded recovery, body lift, delayed legs, tail counterbalance.
• Centipede (segmented morphology): Phase-shifted head-to-tail body wave, alternating leg banks, stable ground line — a creature harness that handles non-humanoid morphology.

---

Rig Engine: Native Rust, Deterministic, Zero Image Generation

A second, fully independent animation path. No image generation API involved.

How it works:

1. Place named joint points (joint, anchor, contact, pivot) and capsule bones on any sprite — manually, from an anatomy template, or via AI suggestion (/rig or “Ask AI”)
2. The engine auto-claims every opaque pixel inside the nearest capsule; leftovers go to the nearest bone — no hand-painted masks
3. Set per-frame bone rotations, scales, offsets, root motion, holds, z-layering
4. Two-bone IK keeps feet and hands pinned at contact points — walk cycles don’t slide
5. Nearest-neighbor inverse mapping: identical inputs → identical PNG bytes

AI suggestions arrive as a rig-suggestion JSON block with points, bones, optional pose frames, and confidence values. The captured rig appears in the Rig tab automatically.

Rendered frames land in assets/<category>/ and flow into the sprite library, animation, sheets, playground, and exports exactly like AI-generated sprites.

When to use it: walk cycles, simple UI elements, any animation where exact reproducibility matters more than AI interpretation. Far more stable than re-running image generation.

---

Generation Profiles and Slash Commands

Profile	Canvas	Frames	FPS
Low	32×32	Auto, 4–32	6
Mid	64×64	Auto, 4–32	8
High	128×128	Auto, 4–32	12
Custom	8–512 px	1–32	1–60

Profiles are defaults, not hard limits — each chat can switch to Custom independently.

Slash commands: /animate, /sprite, /character, /effect, /pack. Plain-language prompts work too; the router infers the correct harness.

---

Build from Source

# Requirements: Bun, stable Rust, Tauri 2 native deps, Codex CLI

bun install
bun run check
bun tauri dev

# Verify native core
cargo test --manifest-path src-tauri/Cargo.toml

# Desktop bundle
make release

---

Two Complementary Paths

Sprite Studio pairs two fundamentally different approaches in the same workspace:

• AI path (Chat → Animate): for when you don’t know exactly what it should look like. Describe it, see how the AI interprets it, iterate.
• Rig path (Rig → deterministic render): for when you know exactly how it should move. Precise control, fully reproducible frames.

Both produce the same kind of asset, entering the same library, flowing through the same export pipeline. It’s a rare tool that treats AI generation and programmatic control as complementary rather than competing approaches.

---

Mycelium Protocol — tracking the deep evolution of AI systems

© 2026 Mycelium Protocol. All rights reserved.