TomeWeaver：将AI对话转化为结构化叙事的游戏引擎

TomeWeaver是一款状态化叙事编排开源游戏引擎，旨在解决AI生成内容的上下文漂移问题，通过结构化设计让玩家冒险可导出为小说级故事书。它在生成式AI自由创造与结构化游戏设计间架起桥梁，支持沙盒与战役双模式，提供多平台兼容及内容创作分享生态。

现有AI叙事工具常被称为'混沌模拟器'，擅长即兴创作却难维持长期一致性，角色性格突变、世界设定随意改写、剧情缺乏逻辑链条，尤其在开放式沙盒游戏中问题突出。TomeWeaver认为需从系统架构层面解决，而非仅依赖提示工程。

TomeWeaver采用状态化设计，维护完整状态数据库（含玩家库存、章节进度等），以结构化JSON存储管理而非作为提示文本。优势包括：精确检索更新不受上下文窗口限制；强制执行游戏规则；可导出为格式化文档成为小说。

1. 叙事桥梁：解决'跳跃剪辑'问题，生成过渡文本编织进故事流，以元数据存储不修改原始内容；2. 双模式：沙盒模式（开放式探索，章节向导手动控制）、战役模式（遵循剧情大纲的'章节卡带'系统）。

针对本地模型JSON格式问题，开发多阶段净化系统：状态机修复器用前瞻解析区分结构标记与对话引号，手术式修复错误；自动平衡token限制导致的中断。支持兼容OpenAI API规范的模型（LM Studio本地部署、OpenAI等云端提供商）。

1. 卡带式生态：每个冒险为独立文件夹（含setup.json、system_prompt.txt等），便于创作分享；2. 导演命令：undo/redo回滚重生成、fix修改细节、expand共同创作，玩家掌握叙事控制权。

基于Python3.10+开发，提供自动化安装脚本（Windows双击setup.bat，Linux/macOS命令安装），通过engine_config.json配置AI提供商。应用场景：游戏开发者原型验证、作家分支叙事实验、教育沉浸式教学、玩家定制AI角色扮演。

TomeWeaver代表AI叙事工具发展方向：让AI成为可靠可控的创作伙伴。其状态化管理、JSON修复等创新为长篇叙事一致性提供参考。项目采用Polyform非商业许可证，个人免费使用，商业需授权，值得AI叙事爱好者深入研究。