一套从「小说/剧本转互动文游」到「运行互动文游」的全流程工具，包含两大核心组件： ✅ 分支剧情游戏启动器（HTML单文件）：直接加载JSON剧本，沉浸式游玩纯文字分支剧情 ✅ Story-to-Game AI技能：将任意体量的小说/剧本/故事大纲，转化为符合启动器规范的分支剧情JSON
作者 @山音 山之音STUDIO创始人｜编剧、导演、作家 初心榜十大年度AI人物｜非凡大赏AI CREATOR 100年度人物 曾担任北影节AI单元、百度AI电影季等大赛评委；作品在戛纳、釜山、北影、First、HiShorts等数十个电影节展入围获奖。 联系方式小红书@山音 li-yinqian@outlook.com
单文件无依赖，直接在浏览器运行，核心能力：
- 极简书架式界面：导入/管理JSON剧本、切换显示模式、载入示例作品
- 沉浸式游玩体验：支持点击/回车推进剧情、选项交互、回退/存档/读档
- 场景/章节系统：大场景卡片、章节检查点、场景/章节动画切换
- 变量与分支：支持val主状态、自定义变量、flag标记、条件选项/自动路由
- 结局&成就：记录解锁结局/成就、结局特效/收束语、成就动画
- 多维度自定义：明暗模式、字号调整、动效强度、自动播放速度
不是简单的格式转换，而是「原作理解→风格保真→分支设计→质量验证」的全链路叙事改编系统，核心能力：
- 适配多体量输入：短篇小说/中篇/长篇/剧本/故事大纲（按体量自动规划节点数/游玩时长）
- 全维度风格保留：提取原作叙述温度、对白规则、节奏型、视角转换策略，防止风格漂移
- 结构化分支设计：态度/路径/命运分支按比例分配、过渡节点补全、分支内容与主线同等饱满
- 完善的状态系统：戏剧化主状态值、多类型结局矩阵、结局触发兜底（无死胡同）
- 自动化验证：节点可达性、引用完整性、支线深度、结局完整性等13项校验
- 下载
剧情游戏启动器.html文件 - 直接用 Chrome/Edge 浏览器打开（无需部署服务器）
- 点击「插入JSON剧本」，选择生成好的文游JSON文件，即可开始游玩
- 直接将本项目中的 SKILL.md 文件 或 完整story-to-game压缩包 拖拽至支持文件读取的AI工具
- 向AI输入你的小说/剧本/故事大纲原文
- 确认AI给出的改编方向后，等待自动生成符合启动器规范的JSON文件
- 用启动器导入JSON，验证游玩效果
- 基础推荐：ChatGPT / Claude（支持直接上传文件，操作简单）
- 长篇优选（强烈推荐）：Codex / Claude Code（超长上下文支持，更稳定处理中长篇小说/剧本）
story-to-game-suite/ ├── 剧情游戏启动器.html # 分支剧情游戏启动器（单文件） ├── story-to-game/ # Story-to-Game AI 技能包 │ ├── SKILL.md # 主工作流（九步核心规则） │ ├── references/ # 技能细分规则文档 │ │ ├── json-format-spec.md # JSON 格式速查手册 │ │ ├── step1-ingestion.md # 原作摄入与记忆索引 │ │ ├── step2-style.md # 风格指纹提取 │ │ ├── step3-structure.md # 结构拆解与分支设计 │ │ ├── step4-system.md # 状态系统与结局矩阵 │ │ ├── step5-writing.md # 分段写作规则 │ │ └── step6-validation.md # 验证与输出规则 │ └── scripts/ │ └── validate.py # JSON 自动验证脚本（13 项检查） ├── examples/ # 示例 JSON 剧本（可选） └── LICENSE # 许可证文件
- 保留原作气质：分支的核心是「加深对原作的理解」，而非替代原作
- 选择必有回响：每一个选择都有即时/持续/结局三层影响，偏离原作时创作全新内容
- 支线同等饱满：任何分支线的内容深度与主线一致，不敷衍玩家
- 过渡决定沉浸：自动补全事件间的跳跃，保证剧情衔接自然
- 反剧透贯穿：改编确认阶段仅展示基础方向，保留游玩惊喜
推荐使用 Chrome / Edge（支持 File System Access API，可直接读取本地文件夹作为资料库）； 其他浏览器可通过「插入JSON」方式导入剧本，核心功能不受影响。
- AI技能生成的JSON需通过
validate.py验证后再导入启动器，避免节点断链/死胡同 - 启动器的存档/成就记录存储在浏览器本地，清除缓存会丢失（建议手动存档关键节点）
- 结局设计需遵循「兜底规则」：确保任意选择路径都能抵达某一结局
本项目采用 MIT 许可证 - 详见 [LICENSE]文件