codex-pets-react

这是一个为 Codex 宠物精灵图（spritesheets）提供声明式 React 封装的轻量级库。它包含 SpriteAnimator、PetWidget 等组件及 petReducer、usePetController 等状态管理工具，支持帧动画播放、拖拽、固定定位、事件回调与状态同步，并基于统一的 codexPetAtlas 契约解析精灵图布局。适用于需要在 Web 应用中嵌入交互式宠物角色（如 AI 工作流中的代理助手可视化界面）的场景，尤其适配 Plannotator 类规划与复盘工具。