storyloom

Storyloom 是一个由 AI 驱动的视觉小说引擎，能够实时生成叙事。它使用一个流式 XML 管道（StreamParser → StateManager → EventDispatcher），该管道逐行解析 LLM 输出而不进行缓冲，并采用桥接预取机制在段落中间触发下一次 API 调用，以在阅读时隐藏延迟。 主要功能包括： - 两种游戏模式：文本模式和图形模式，场景内选择以及在检查点处的大纲级路线分支 - 角色精灵和场景背景，配备一个资产管道，能够进行 O(1) 目录匹配、LLM 回退以及异步 AI 生成 - 状态验证：LLM 建议写入，引擎在应用前进行类型检查；被拒绝的写入会反馈给模型 - 通过滑动窗口、永久系统提示锚点以及检查点压缩（约 50K tokens）进行上下文管理 - 共同创作流程：AI 在生成世界、角色和情节之前先采访用户他们的想法 - 模式无关的原子 JSON 保存，允许在任何时候在文本模式和图形模式之间切换 - 通过 gettext 支持英语、简体中文和繁体中文的 i18n - 基于 FastAPI + SSE + 原生 JS SPA 的 Web UI，可选通过 pywebview 提供原生桌面窗口 安装方式包括独立二进制文件（无需 Python）、PyPI 软件包（Python ≥ 3.10）以及从源码编译。可选的附加功能提供原生桌面窗口支持以及使用 onnxruntime 进行生成图像的背景移除。该项目采用 MIT 许可证，并遵循 stdlib-first 的 Python 惯例，使用 Conventional Commits。