概述
XianTu(仙途)是一个AI 驱动的修仙文字冒险游戏,采用”AI 即游戏引擎”的创新架构——所有游戏逻辑都由 LLM 计算,前端代码仅负责执行指令和渲染界面。本文是对该项目技术架构和核心系统的深度分析总结。
项目简介
XianTu 是一个基于现代前端技术栈构建的修仙文字冒险游戏,核心特点是将传统游戏引擎的逻辑计算全部交给 AI 完成,实现了一个高度动态、可扩展的游戏世界。
技术栈
| 类别 | 技术 |
|---|---|
| 框架 | Vue 3.5 (Composition API) |
| 语言 | TypeScript 5.8 |
| 状态管理 | Pinia 3.0 |
| 路由 | Vue Router 4.6 |
| 构建工具 | Webpack 5.99 |
| 数据可视化 | Chart.js、Pixi.js |
| 本地存储 | IndexedDB |
| AI 集成 | Gemini、Claude、OpenAI、DeepSeek |
核心架构:”AI 即游戏引擎”
XianTu 最核心的设计理念是所有游戏逻辑都由 LLM 计算,而不是传统游戏那样由代码引擎处理。
提示词里的公式 = 游戏规则书
项目中的 textFormats.ts 包含了大量游戏公式:
1 | 最终+幸运+环境+状态 |
这些公式不是前端代码用来计算的,而是塞进 system prompt 里让 LLM 读的说明书。LLM 需要自己:
- 根据当前角色属性 + 公式,算出判定值
- 与难度基准对比,判定成功/失败等级
- 根据结果写叙事文本
这种设计的优势是游戏内容高度动态,AI 可以根据玩家行为生成前所未有的剧情和机制。
四层记忆系统
XianTu 实现了完整的四层记忆系统,用于在长对话中保持游戏世界的连贯性:
| 层级 | 名称 | 作用 | 生命周期 |
|---|---|---|---|
| 第1层 | 短期记忆 | AI 每回合生成的叙事文本 | 超过5条后自动淘汰 |
| 第2层 | 隐式中期记忆 | AI 返回的 mid_term_memory 字段 | 短期记忆淘汰时晋升为正式中期记忆 |
| 第3层 | 中期记忆 | 累积的隐式中期记忆 | 累积到25条后触发 AI 总结 |
| 第4层 | 长期记忆 | AI 总结的精炼摘要 | 永久保留,支持向量检索 |
记忆流转流程
1 | 每回合 AI 响应 |
CoT 思维链系统
XianTu 使用思维链(Chain of Thought)技术来规范 AI 的输出格式和行为。核心提示词包含 7 大类、40+ 条检查项:
核心指令类别
| 类别 | 关键指令示例 |
|---|---|
| 基础同步 | set 角色.位置、add 元数据.时间.分钟 |
| 修炼与突破 | add 角色.属性.境界.当前进度 |
| 渡劫系统 | 每道天雷扣血扣灵气、渡劫成功/失败处理 |
| 战斗与消耗 | 施法消耗灵气、受伤扣血 |
| NPC 交互 | 好感度、记忆、外貌状态、位置 |
| 世界事件 | push 社交.事件.事件记录 |
| 宗门系统 | 贡献、任务更新 |
AI 在生成回复时必须遵循这些指令,确保游戏状态的一致性。
核心功能模块
1. 角色创建系统
- 世界选择、天资选择、出身选择
- 灵根选择、天赋选择、属性分配
2. 游戏核心系统
- 角色详情、背包系统、功法系统
- 关系网络、记忆中心、世界地图
- 炼制系统、门派系统
3. 存档管理
- 多角色管理、5个存档槽位
- IndexedDB 本地存储 + 云端同步(可选)
4. AI 对话系统
- 多模型支持(Gemini、Claude、OpenAI、DeepSeek)
- 思维链推理、向量记忆系统
- 动态剧情生成
5. 联机功能
- 联机穿越、实时同步
- SillyTavern 嵌入支持
与传统游戏引擎的对比
| 维度 | 传统游戏引擎 | XianTu (AI 游戏引擎) |
|---|---|---|
| 逻辑计算 | 代码引擎 | LLM + 提示词公式 |
| 内容生成 | 预定义内容 | 动态生成 |
| 扩展性 | 需要更新代码 | 更新提示词即可 |
| 一致性 | 确定性 | 依赖提示词质量 |
总结
XianTu 项目展示了 AI 驱动游戏的全新范式——“AI 即游戏引擎”。通过将游戏逻辑交给 LLM 处理,实现了极高的内容动态性和扩展性。
四层记忆系统解决了长对话中的上下文遗忘问题,CoT 思维链确保了 AI 输出的一致性和可解析性。这种架构对于构建 AI-Native 应用具有重要的参考价值。