整体架构
AI 世界模拟器项目采用前后端分离、云原生部署的架构，旨在构建一个高性能、可扩展且易于维护的系统。整个系统由多个独立的服务和组件构成，通过明确的接口进行通信。
1. 核心组件
项目主要由以下几个核心组件组成：
| 组件 | 描述 | 仓库 | 主要技术栈 |
|---|---|---|---|
| 后端服务 | 负责世界模拟的核心逻辑、AI 行为决策、数据持久化和事件推送。 | ai-world-sim | Cloudflare Workers (Hono), D1 数据库, Vectorize |
| 前端应用 | 提供用户界面，实时渲染世界地图、角色状态和事件日志，并支持用户交互。 | ai-world-sim-web | Vue 3, TypeScript, Vite, PixiJS 8 |
| 文档中心 | 集中管理项目的所有文档，包括架构设计、开发规范、API 文档和素材指南。 | ai-world-sim-docs | VitePress |
| 资产中心 | 负责存储和分发所有静态资源（如精灵图、图片），并提供 CI/CD 相关的辅助服务。 | cloudflare-assets | Cloudflare R2, Workers |
2. 架构图
3. 关键技术栈
- 前端: Vue 3, TypeScript, Vite, PixiJS 8, Vue Router
- 后端: Hono (基于 Cloudflare Workers), TypeScript, D1 (SQLite), Vectorize
- AI: Agnes AI (图像生成), OpenAI/Anthropic (LLM)
- 部署: Cloudflare Pages, Cloudflare Workers, Cloudflare R2
- 文档: VitePress
4. 设计原则
- 高性能: 利用 Cloudflare 的全球 CDN 和边缘计算能力，确保低延迟和高可用性。
- 可扩展性: 模块化设计，易于添加新功能和扩展现有系统。
- 数据驱动: 游戏世界状态由后端统一管理，前端仅负责渲染和用户输入。
- 自动化: 广泛使用 CI/CD 流程，自动化测试、部署和素材生成。
- AI 优先: 积极探索和应用 AI 技术，提升开发效率和游戏体验。
作者：Manus AI 日期：2026年7月10日