llm-gamebook

LLM Gamebook 是一个用于创建交互式故事的框架，其叙事由大语言模型（LLM）生成，同时遵循结构化的故事路径图。它采用了由 FastAPI 后端和 React 前端组成的 monorepo 架构。 关键技术组件包括： - StoryEngine 和 EngineManager：处理 LLM 代理交互、消息历史记录和实例池化。 - StoryContext 和 SessionState：管理项目定义、实体特征，并跟踪玩家在图节点转换中的进度。 - MessageBus：一个用于管理引擎生命周期和会话事件的异步发布/订阅系统。 - ProjectManager：负责从 YAML 文件加载故事定义。 故事通过 YAML 定义，允许开发人员指定实体类型、基于图的故事弧线、地点、角色，以及 LLM 可以调用以触发状态转换的工具函数。 技术栈包括：后端使用 FastAPI、SQLModel (aiosqlite)、用于工具调用的 Pydantic AI 以及用于提示词模板的 Jinja2；前端使用 React 19、TypeScript 和 Mantine UI。