Phys Pet Kit

Phys 是黑、红、奶白三色的构成主义工程与 AI 工作伙伴。本仓库包含可直接用于网站的高清透明图集、57 帧动画素材、无依赖 JavaScript 播放器、React 包装组件、演示页和完整接入规范。

快速运行

npm test
npm run demo

浏览器打开 http://localhost:8080/examples/vanilla/。

目录

assets/       正式图集、GIF/MP4 预览、静态关键帧和动作清单
src/          无依赖浏览器播放器与样式
react/        React 包装组件
types/        TypeScript 类型声明
examples/     可直接运行的示例
docs/         素材规范、接入说明和校验报告
scripts/      素材完整性校验

设计边界

• 正式运行时使用 PNG 图集，不使用 GIF；清晰度更高、状态可控、体积更稳定。
• 单元格和动作行是稳定接口，不应随意裁剪图集。
• 网站缩放通过 scale 控制，建议范围 0.5–1.25。
• 公共网站使用前阅读 NOTICE.md。

详细接入见 docs/INTEGRATION.md。