后端概览

ai-world-sim 仓库是项目的后端服务，基于 Cloudflare Workers 平台构建。它作为整个模拟世界的“大脑”，负责处理时间演进、AI 决策、状态持久化和实时通信。

1. 核心技术栈

• 运行时: Cloudflare Workers
• Web 框架: Hono
• 数据库: Cloudflare D1 (基于 SQLite 的分布式数据库)
• 向量数据库: Cloudflare Vectorize (用于存储和检索 AI 记忆)
• 实时通信: Server-Sent Events (SSE)
• 语言: TypeScript

2. 核心系统

后端服务由以下几个核心系统组成：

• Tick 引擎: 驱动世界时间流逝的核心循环。每个 Tick 触发一次世界状态更新。
• 角色系统: 管理所有 NPC 的属性、状态、位置和职业逻辑。
• AI 决策模块: 利用 LLM (OpenAI/Anthropic) 为每个角色生成行为决策和日记内容。
• 记忆系统: 结合 D1 和 Vectorize，实现角色的短期和长期记忆检索。
• 事件总线: 捕获世界中发生的所有重要事件，并将其持久化及推送给前端。

3. 部署与环境

项目完全部署在 Cloudflare 生态系统中：

• 生产环境: https://ai-world-sim.openserve.cloud
• 数据库: D1 数据库 ai-world-sim
• 部署工具: Wrangler (Cloudflare 官方 CLI)

更多 API 细节请参考 APISpec.md。