AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它将程序化SDF建模、手绘感描边渲染、物理玩具、天气系统以及实验性动作模块整合为纯客户端网页应用，提供丰富、注重隐私的创意体验。

适合谁使用

数字艺术家与插画师
需要快速生成3D小猫资产的游戏开发者
猫咪爱好者和业余创作者
对程序化生成和Three.js感兴趣的开发者

典型使用场景

为游戏或动画创建独特的3D小猫角色
生成自定义配色和图案的收藏卡片用于社交分享
通过开源项目学习程序化建模与WebGL技术
利用实验性Motion模式探索猫科动物的动作动画

项目优势

完全本地运行，无需登录和后端，保护隐私并支持离线开发
丰富的自定义选项：11种预设花色、可调体型比例、眼睛颜色以及多种玩具和天气
支持中英日三语界面，桌面端与移动端响应式布局
采用非商业开源许可（PolyForm），鼓励学习研究，同时保护商业用途

使用前须知

Motion 模式为实验功能，可能存在稳定性问题
极端体型参数和长时间WebGL运行可能导致性能因设备而异
商业使用需单独书面授权，非OSI批准的标准开源许可证

README 快速开始

Meow Generator

中文 · English · 日本語

一个可以捏体型、换花色、玩玩具、切换天气、尝试动作并生成收藏卡片的程序化 3D 小猫工具。

在线体验 · 反馈问题

非商业源码开放授权 · 商业使用与合作

关于 Meow Generator

Meow Generator 由 Simon_阿文（Simon Lee） 与 海辛（Ring Hyacinth） 共同创作。每只小猫都由种子和可编辑参数程序化生成；相同种子可以重新生成相同的小猫体型、花色、姿势、玩具、垫子、收藏编号与稀有度。

项目采用本地优先的浏览器体验，不需要登录账号，也没有后端服务。

主要功能

基于 SDF 的程序化小猫身体，可调整头身比、圆润度、腿、耳朵、尾巴与毛发
11 种预设花色，以及自定义颜色和花纹参数
眼睛颜色、异瞳、瞳孔尺寸与泪眼形变
多种静态造型与轻微待机动作
实验性的 Motion 模式：19 根骨骼与 14 段动画
手绘感描边、三渲二明暗与可调排线阴影
可抓取和投掷的鱼、鸭子、毛线球、猫窝及其他物理玩具
晴天、阴天、雷雨、下雨与鱼雨场景
GLB 模型导出与 PNG 小猫收藏卡片
实验性的 Codex 宠物导出交接
中文、英文、日文界面
桌面端与移动端布局

小猫收藏卡片

点击 留影 PNG 后，Meow Generator 会读取当前小猫的底色、主辅花纹色和眼睛颜色，为它生成专属的默认卡面。

每只小猫都会获得：

一个稳定的收藏编号，例如 第 2902 张 / 9999
一个由小猫种子稳定决定的 R、SR 或 AR 稀有度
一套从小猫自身颜色提取的默认卡面
可通过“换一个皮肤”切换的圆点、格纹、彩屑与波纹主题
印在导出 PNG 上的公开仓库地址，方便重新找到项目

导出给 Codex（Experimental）

点击 🐾 导出给 Codex，可以为当前小猫准备：

保存体型、花纹、眼睛与配色的参数 JSON
帮助确认最终外观的参考图 PNG
一段可直接复制给 Codex 的创建与安装指令
已验证的橘橘动作样机预览

这个入口只负责准备交接文件，不会自动打开或唤醒 Codex。请把 JSON、PNG 和复制的指令一起发送给 Codex；动作图集生成后，应先检查动作总览与左右方向，再安装为新的独立宠物，避免覆盖已有宠物。

本地运行

需要 Node.js 20.19+ 或 22.12+。

npm install
npm run dev

然后打开。

生产构建：

npm run build
npm run preview

测试

npm run test:share
npm run test:fish-pick
npm run test:poke
npm run test:motion

Motion 测试覆盖 14 段动画、19 根骨骼、蒙皮权重、状态机输入与源动画采样。

操作方式

左键拖动：旋转摄影机
滚轮或触控板：缩放
右键拖动：平移
拖动玩具：抓取与投掷
拖动脸颊或后侧交互区：软体捏猫
拖动后颈：提起小猫
Motion 模式：使用 WASD 或方向键；动作快捷键显示在 Motion 面板中

项目结构

src/sdf.js — SDF 基础形状与 Surface Nets 网格生成
src/catBuilder.js — 小猫结构、花色渲染与面部细节
src/coats.js — 花色、眼睛与姿势定义
src/rug.js — 基于种子的垫子与配色
src/toys.js — Cannon-es 玩具物理与抓取
src/weather.js — 天气、闪电、雨、云与落鱼
src/shareCard.js — 收藏卡片主题与 PNG 生成
src/codexPetPreview.js — Codex 宠物参数、参考图与指令导出
src/mesh2motion*.js — 动作采样、重定向、骨骼与蒙皮
src/i18n.js — 中文、英文与日文界面文案

应用没有后端。运行状态和导出文件只保留在浏览器或用户设备中；项目不包含数据分析或账号系统。

创作者

Meow Generator 由 Simon_阿文与海辛共同制作。

Simon_阿文（Simon Lee）

海辛 / Ring Hyacinth

如需后续版本开发或合作申请，请联系 [ringhyacinth

项目描述

A playful procedural 3D kitten generator built with Three.js.

Meow-Generator