AIGG
AI-generatedReal-world Games
家庭登录 开始创作
AIGG / 文档中心 · DOCS

AIGG 文档中心

从产品愿景到底层接口,从家长到工程师,从游戏运行时到玩偶/周边 AI 创作,再到 AI Admin、Langfuse、数据飞轮和工厂生产文件。这里统一维护 AIGG 当前真实口径:243 游戏(220 核心 + 23 棋盘/地图 runtime) / 7+14 runtime 硬件 / 24 3D 道具 / 15 产品 Chiplet / 11 官方产品图 / 31 AI capability。本轮新增打击节奏 10 款,小白可用 AI 生成地鼠节奏、鼓谱、口令、灯光记忆和短窗口连击。

4 份产品设计稿
50+ 份技术文档
0 个数据审计 issue
v3.20 当前口径 · 打击节奏首批 10 款(2026.06.04)

当前系统口径 CURRENT · 2026.06.04

所有页面都按同一份事实源说话。 GameSpec、runtime 硬件、3D 道具、产品 Chiplet、官方产品图、AI capability、AI 测试与 Langfuse 观测已经重新梳理;新增打击节奏品类后,创作者也能用 AI 生成打地鼠、太鼓、节拍轨道、口令反应和灯光记忆等短局。

CURRENT STATUS · 事实口径

当前系统与数据口径 NEW

243 游戏(220 核心 + 23 棋盘/地图 runtime)、7 类 runtime 主机、14 类 runtime 物理道具、24 个 3D 道具、10 场景、17 AI 原型、15 产品 Chiplet、11 官方产品图、31 capability。

2026.06.04
STRIKE RHYTHM · 打击节奏

打击节奏 10 款落地 NEW

打地鼠、太鼓、节拍轨道、口令反应、Simon 灯光记忆、Beat Saber 切拍等经典玩法的物理转译和 AI 创作字段。

10 games · AI assisted
PUZZLE LOGIC · 逻辑益智

经典纸笔谜题 10 款落地 NEW

数独、迷你填词、寻字、Kakuro、Nonogram、KenKen、逻辑表格、密文、Slitherlink、Nurikabe 的物理转译和 AI 创作字段。

10 games · AI assisted
AUDIT · 数据一致性

项目数据一致性审计

`tools/audit_project_data.py` 覆盖 GameSpec、硬件、3D 道具、场景、AI profile、Chiplet、AI Admin 和文档入口。当前 0 issue。

0 errors · 0 warnings
PRODUCT CREATION · 玩偶与周边

AI 玩偶与周边创作链路

2D 生图、官方产品图参考、2D 转 3D、3D 在线编辑、15 个 Chiplet 模块、AI 自动放置电子件、BOM、云端审核和工厂生产。

Studio + Factory
FREE GENERATION · 自部署方案

免费 2D/3D 生成落地方案 NEW

ComfyUI/FLUX、Qwen-Image、Hunyuan3D、TripoSR、Stable Fast 3D 的自部署接口、worker 契约和 Studio 打通方式。

Self-hosted first
PRODUCT IMAGES · 官方产品图

官方玩偶与周边图片库

爱心萌可、AIFUFU、双足机器人、轮式熊猫、魔法萌朵、乐奇、小酸奶、鱼人娃娃等 11 个统一产品资产。

11 assets
CREATOR STUDIO · 创作工作室

进入 Creator Studio v4.3 NEW

统一创作工作室:五步流(向导/对话/画布/素材/测玩)+ AI 副驾 + 完成度环。账号、上架与收益在 /ugc-studio/ 创作者门户。

/aigg-studio-v2/
3D
MODEL DEBUGGER · 3D 工具

3D 模型编辑与 Chiplet Debug

预览模型、标注 socket、选择 Chiplet、生成 BOM、调试电子件放置和生产文件导出。

15 modules · 6 presets
AI
AI ADMIN · 观测与数据飞轮

AI Admin 与 Langfuse

31 capability、8 agent、AI 测试数据、Prompt 管理、模型路由、安全限流、Trace 和 Optimizer 数据飞轮。

Langfuse ready

v3.17 · 物理运行契约 + 真实语音输入 2026.05.24

Web runtime 现在是线下物理游戏模拟器,不是网页假按钮。 语音/跟读任务必须真实打开麦克风录音,达到最短时长后才能推进;AI 玩家走可追踪的模拟麦克风;核心 GameSpec 已批量修复不合理的“没说话也算完成”任务。物理冷却、输入去重、输出过期取消、快慢 AI 分工也同步进入文档。

v3.16 系列 · 大厅 + 2D + landing 房间预览 + nav 滑动 + 去 emoji 2026.05.21

主大厅重做成房间浏览器 — 参考 Among Us / Jackbox / Tabletop Simulator: 实时公开房间列表(每张卡看到游戏 + 主持人 + 玩家数 + 状态)+ 4 字房间码快速加入 + 243 个游戏分宏分类浏览开新房 + LIVE 徽章 + 最近玩过侧栏。 landing 主页加 "现在有人在玩 · LIVE" 实时房间预览区 + 顶栏大厅 CTA 按钮 (15s 自动刷新, 有等人房间时红圆角徽章显示数字, 桌面+移动都可见)。 v3.16.1 nav 装不下时加 mask 渐隐 + 脉冲箭头 + 一次性 "滑动看更多" tooltip + 鼠标滚轮转横向。 v3.16.2 大厅页全面去 emoji (中文字 + SVG 线条图标) + 返回按钮层级修正 (room/runtime 跳 lobby 而不是 landing)。 取消混乱厨房专属代码后路, 所有 catalog 游戏完全平等

v3.14-v3.15 · 戏剧性 + 音乐方案 + 游玩记录 + 视觉系统 5 docs · 2026.05.15

参考混乱厨房抽出"戏剧性 5 维公式" 对核心游戏注入 tagline/intensity/drama_hooks。AI 音乐 + 音效方案调研落地路线图。每次试玩都记录到 play_session, game-runtime 顶部显示玩家身份, buyer-portal 加"游玩记录" tab。v3.15 全站 emoji → SVG 自动替换(170 emoji 100% 覆盖), Identity Bar 重设计跟整体视觉一致。

v3.13.x 系列 · 引擎调优 + Studio 升级 + 统一账号 5 docs · 2026.05.15

把混乱厨房特化优化抽象成"通用 Pattern → 推进/评分映射" 对核心游戏生效。修了 binding 死锁(5 角色 4 玩家永远卡住)、Studio SpecEditor 升级到 v3.13 字段集、画布场景连线孤立问题。v3.13.4 统一账号体系:家庭+创作者+管理员共用一套登录,实名认证非强制。所有改动 100% 向后兼容,作者显式赋值永远优先。

产品设计稿 DESIGN · 4 docs

这 4 份文档是 AIGG 项目的"宪法"——任何代码改动都以这里为准。HTML 格式,可在浏览器直接打开。

M22 创作平台 GAME + PRODUCT CREATION

2026.05 这一阶段把 AIGG 改造成"通用引擎读 GameSpec 数据驱动",创作者不写代码就能做游戏;现在进一步扩展到玩偶和周边产品创作:AI 生成 2D/3D 形象,3D 在线编辑,按 15 个 Chiplet 模块组合电子件,最终提交审核和生产。

SPEC EDITOR · 创作完全指南

GameSpec Studio 创作者指南 已被 Creator Studio 取代

旧版 SpecEditor 文档(界面已被 v4.3 Creator Studio 取代,spec/validate 等 API 仍有效)。8 个任务原语 + Self-Consistency 校验 + Telemetry + FAQ 仍可参考。

14 KB · 327 行
ENGINE MODES · 双模式

引擎双模式 · 满血 vs 快速 M22.13 NEW

两种引擎模式的差别、何时用、怎么切。玩家在 game-runtime 一键切换,创作者在 spec 强制,部署级环境变量。性能对比 + FAQ。

10 KB · Markdown
AI
GAME AI · 集成原理

Game AI 集成原理

17 个 AI 原型模板、game_ai_loader 加载逻辑、persona overlay 注入流程、强约束 prompt 防漂移机制。

Markdown
CHANGELOG · 变更日志

v4.4 完整变更 · M22 全部子里程碑

M22.0 通用引擎核心 → M22.5 Studio UI → M22.6 智能迁移 v2 → M22.7-8 运维 + Telemetry → M22.10 AI 辅助 → M22.11 真实玩家 bug 修复 → M22.13 双引擎模式 + game-runtime UI → M22.14 开源资源 + 碰撞 + 朝向

v4.4 完整
ASSETS · 开源资源系统

16 个 CC0 资源 pack M22.14 NEW

KayKit 角色 / Quaternius 自然 / Kenney 音效。tier 编排(base/standard/full) + 6 mirror failover + _loaded.json v2 + 4 层 fuzzy match + TARGET_HEIGHTS 真实尺寸表 + 朝向约定 + 完美降级。

10 KB · Markdown
GAME RUNTIME · 模拟器

2D/3D 游戏运行时模拟器 v3.17 更新

大厅 + room + 2D/3D runtime。243 游戏 + 24 个 3D 道具模型 + 10 场景模板。新增真实麦克风输入、物理冷却、AI 模拟麦克风、开源资源 / 碰撞 / 朝向约定。

13 KB · Markdown

入门 & 运维 GETTING STARTED · OPS

家长、创作者、工程师、运维都从这里入门。Markdown 文档可在 GitHub / 编辑器中查看。

CREATOR STUDIO · 创作工具

Creator Studio 五步流创作指南 v4.3 NEW

统一创作工作室(/aigg-studio-v2/):小白向导 → AI 对话 → 可视化画布 → 素材音效 → AI 测玩,AI 副驾计划/批准/可回滚,完成度环 AGR 前移。旧 aigg-studio / pgc-studio 已并入。给所有创作者必读。

14 KB · Markdown
AI
AI · 超时调优

AI 超时与流式机制 v4.2 NEW

3 个超时变量(创作 600s / runtime 90s / 首字 30s)、流式 SSE 协议、三级 JSON 修复、Provider fallback 链、诊断日志。

10 KB · Markdown
ADMIN · 管理员指南

管理员指南

从首次部署到日常运维。aigg CLI 全部子命令、aigg install / status / logs / metrics / cert-status / upgrade-frontend 等使用手册。

HTML · 80 KB
PM
PM · 产品经理

给产品经理

不读代码也能看懂 AIGG 的能力边界、商业模型、与 BP 的对应关系。Phase 1-3 已交付什么、还差什么。

15 KB · Markdown
DEPLOY · 部署

一键部署 SOP

从空白 Ubuntu 到完整 AIGG 集群的 5 分钟流程。Caddy 自动证书 / EMQX MQTT / Postgres / aigg-server / 7 个前端入口。

6 KB · Markdown
LANGFUSE · 自部署

Langfuse 一键自部署 v4.7 GA

1 条命令 + 0 浏览器操作。Headless Initialization 自动建 user/org/project + 烧 API keys + 写回 conf + 重启 aigg-server。AI trace 永久持久化、网页改 prompt 60 秒生效。

11 KB · Markdown
LANGFUSE · Prompt

Langfuse Prompt 管理

装好 Langfuse 后,所有 AI prompt 都从 Langfuse 拉(60 秒内热生效)。本地 fallback 保证可用性。版本化 + A/B + 灰度。

Markdown
AI GATEWAY · 开发者

AI Gateway 开发者指南 v5.0 NEW

20 个 capability registry · gateway.call() 统一入口 · prompt 解析优先级 · 写新 capability · Phase 6 灰度迁移指南。改 AIGG 后端代码必读。

9 KB · Markdown
OPTIMIZER · 数据飞轮

Optimizer Agent 操作指南 v5.1 NEW

数据飞轮实际操作手册:1 键触发反思 · 3 种决策(approve / approved_ab / reject)· 占位符校验 · LLM-as-judge 沙盒评分 · admin 双确认 · 推荐运营节奏。

9 KB · Markdown

技术深度 DEEP DIVES · 17 docs

架构、API、Phase 进度详情。所有 .md 文档可下载到本地用编辑器打开。

01
README · 项目总览
5 分钟看懂 AIGG 在做什么、关键模块在哪、怎么跑起来
Markdown
02
ARCHITECTURE · 技术架构
aigg-server / EMQX / Postgres / Redis / Caddy / Hub-app 全局架构图与数据流
39 KB
03
API 参考
REST / WebSocket / MQTT 全部端点。家庭注册、设备配对、UGC 上传、4 关审核、买家市场
Markdown · 41 KB
04
CHANGELOG · 版本日志
从 v0.1 到 v5.2 全部里程碑、Breaking Change、迁移指引。最新 v5.2 加入 Phase 4 (ReviewPipeline + 人工审核) + Phase 6 (capability_id 全覆盖)
v5.2
05
HARDWARE · 硬件参考
7 类 runtime 主机、14 类 runtime 物理道具、24 个 3D 道具模型、15 个产品 Chiplet、视觉硬件谱系、机器人 BOM
14 KB
06
GAME_RUNTIME · 游戏运行时
/play/ 入口的 Three.js 3D 场景、MQTT 物理玩偶联动、catalog schema、开源资源 / 碰撞 / 朝向(M22.14)
13 KB
07
ASSETS · 开源资源系统
16 个 CC0 资源 pack(KayKit / Quaternius / Kenney) + tier 编排 + 6 mirror + _loaded.json v2 + fuzzy match + TARGET_HEIGHTS
M22.14 NEW
08A
PRODUCT_IMAGE_ASSETS · 官方产品图片库
11 个官方玩偶、机器人和产品集合图,统一 ID、文件名、默认 Chiplet 预设和页面使用位置
11 assets
08
OPERATIONS · 运维手册
日常监控、告警处理、容量规划、备份恢复、镜像升级
15 KB
09
PRODUCTION · 生产环境
高可用部署、TLS 证书续期、火山云 / 阿里云 / 自建 IDC 实操对比
10 KB
10
MIRROR_PROFILE · 镜像加速
国内/海外环境镜像源切换。Docker / pip / apt / npm 加速配置
10 KB
11
AI 架构 v2 · 9 phase 完整路线图
8 个 agent 分组 + 数据飞轮设计。Phase 0-7 已全部 GA(基础设施 / Capability Registry / Gateway / GameAnalyst 状态机 / ReviewPipeline + 人工审核 / Optimizer Agent MVP)。Phase 8 fine-tune 等数据攒够再做。
v5.2 · 8/9 GA
12
AI_GATEWAY_GUIDE · 开发者必读
gateway.call() 统一入口 · 20 个 capability 注册表 · prompt 解析优先级(Langfuse > 本地 fallback)· 写新 capability 4 步骤 · Phase 6 灰度迁移指南 · 老代码迁移示例 · 排错
v5.0 NEW
13
OPTIMIZER_AGENT_GUIDE · 数据飞轮操作
admin / 运营手册。一键触发 + LLM-as-optimizer 反思机制 + 占位符校验 + LLM-as-judge 评分 + 三种决策(全量 / A/B / reject)+ 推荐运营节奏 + 故障排查
v5.1 NEW
14
LANGFUSE_SELFHOST · 自部署完全指南
1 条命令 headless 自动化 → 6 容器 stack + 自动建 user/org/project + 自动写 PK/SK 回 conf + Caddy 子域名反代 + LE 证书 + sync-keys 补救命令
v4.7 GA
15
M19 完成报告 · UGC 创作者经济
4 关审核流水线 / Beta 池 / 家庭买家市场 / 收益分成 — 112 个测试全过
M19 ✓
16
M20 完成报告 · JWT + 支付通道
认证服务 / Stripe + 微信支付 / 评分 / 7 前端入口 GA — 68 个测试全过
M20 GA ✓
17
NEW_GAMES · 50+ 新游戏接入
从 4 个内置 demo 扩展到 243 部精选,catalog 接入与自动化场景渲染机制
10 KB

需要帮助? SUPPORT