Lumen

lumen

Lux in motu —— 光在运动。一个使用 Rust（edition 2024、rmcp 3.3）编写的跨平台、跨媒体转换引擎：一个连接媒体格式的操作核心，涵盖 2D 美术与精灵格式、3D 模型和游戏引擎包，并依据以代码为先的记录，在不同格式间进行确定性转换，因此相同的输入记录在任何平台上都会生成相同的输出。Aseprite 精灵和 Bevy 是它最初支持的端点，而非其目的；核心是工厂（一个身份记录，可输出为 2D 或 3D），以及格式之间具名且经过验证的转换器链——一个操作核心，提供三个接口——

• 用于交互式媒体工作的 MCP 工具：精灵操作、检查、调色板、文本、风格预设、梦境动画自动化、QA 关卡和导出后端（PNG 图集、WASM-4、TIC-80、VoidSprite 文件互操作）。所有路径均限制在项目根目录内。
• 用于分派长时间运行的美术任务的 A2A Agent 接口（v0.3.x JSON-RPC），其协议状态包含先试用、再审批的艺术总监循环。请参阅 A2A_DESIGN.md。
• 确定性策略层（APPA 风格，改编自 archestra-ai/OpenAPPA）：每次工具调用在执行前都会依据 lumen-policy.toml 进行检查，决策可重放，拒绝时会指出违反的规则。请参阅 POLICY_DESIGN.md。

配套策略——协作而不重复——见 COMPANIONS.md。lumen 的构建方式、顺序和治理机制（包括首次构建失败后制定的证据规则），见 HISTORY.md。

已验证状态（2026-10-01，primo）

• 构建和 clippy 检查均无问题；303 项测试通过 / 0 项失败 / 8 项忽略 （测试套件分为验证用例和对抗性用例）。
• 针对真实 Aseprite 1.3.18.6-dev 和 Bevy 0.18 BRP 的实时互操作关卡（scripts/interop_check.sh）：5 项通过 / 3 项失败——失败源于 lumen 的假设与真实工具行为之间已记录的前提不匹配；详见 HISTORY.md。

目录结构

• src/ — 操作核心：sprite_ops、inspect、palette、 text、style、dream、qa、export、pipeline、policy、 bevy、doc、vrm，以及 a2a/ 接口（mod、task、http、 registry）。
• tests/ — 验证和对抗性测试套件，包括 interop.rs （实时工具关卡，默认忽略）。
• lumen-policy.toml — 随项目提供的策略；lumen policy check 和 lumen policy replay 是其关卡命令。

许可证

本项目根据 Apache License, Version 2.0 许可。