技术架构总览
基于 a16z AI Town 的深度二次开发
总览
- 基座：基于 a16z AI Town（Convex + PixiJS + React）深度二次开发。
- 后端 / 实时引擎 / 向量检索：Convex（aiTown 游戏引擎 60 tick/s 模拟；新增 experience / profile 等表与逻辑）。
- 前端：React 18 + TypeScript + PixiJS 7（游戏渲染）+ Tailwind。
- 部署：Vercel（前端）+ Convex 云（后端）。
相对原版 AI Town 的核心定制
| 模块 | 原版 | 候鸟沙城 |
|---|---|---|
| 叙事 | 规则引擎驱动 NPC 行为 | LLM 导演 + 用户交互的动态故事生成 |
| 生图 | 无 | 文生图 + 图编辑 + 七牛 CDN |
| 社交 | 仅 NPC 聊天 | 玩家身份 + 勋章墙 + 长图分享 |
| 场景 | 通用沙盒 | 候鸟沙城（地图 + 节目单 + 现场） |
| 内容 | 硬编码 | 数据文件驱动，非技术人员可维护 |
工程分层
游戏状态与模拟在 convex/aiTown 与 convex/engine；连环画体验在 convex/experience.ts；身份在 convex/profile.ts；文生图与 CDN 在 convex/util/。客户端用常规 Convex useQuery 钩子渲染，历史值用 useHistoricalValue 平滑回放运动。