Story-to-Game

Story-to-Game: 互动文游生成与运行套件
一套从「小说/剧本转互动文游」到「运行互动文游」的全流程工具，包含两大核心组件：
✅ 分支剧情游戏启动器（HTML单文件）：直接加载JSON剧本，沉浸式游玩纯文字分支剧情
✅ Story-to-Game AI技能：将任意体量的小说/剧本/故事大纲，转化为符合启动器规范的分支剧情JSON

作者
@山音 山之音STUDIO创始人｜编剧、导演、作家
初心榜十大年度AI人物｜非凡大赏AI CREATOR 100年度人物
曾担任北影节AI单元、百度AI电影季等大赛评委；作品在戛纳、釜山、北影、First、HiShorts等数十个电影节展入围获奖。
联系方式小红书@山音  li-yinqian@outlook.com

核心功能
🎮 分支剧情游戏启动器（HTML）
单文件无依赖，直接在浏览器运行，核心能力：
- 极简书架式界面：导入/管理JSON剧本、切换显示模式、载入示例作品
- 沉浸式游玩体验：支持点击/回车推进剧情、选项交互、回退/存档/读档
- 场景/章节系统：大场景卡片、章节检查点、场景/章节动画切换
- 变量与分支：支持val主状态、自定义变量、flag标记、条件选项/自动路由
- 结局&成就：记录解锁结局/成就、结局特效/收束语、成就动画
- 多维度自定义：明暗模式、字号调整、动效强度、自动播放速度

🤖 Story-to-Game AI技能
不是简单的格式转换，而是「原作理解→风格保真→分支设计→质量验证」的全链路叙事改编系统，核心能力：
- 适配多体量输入：短篇小说/中篇/长篇/剧本/故事大纲（按体量自动规划节点数/游玩时长）
- 全维度风格保留：提取原作叙述温度、对白规则、节奏型、视角转换策略，防止风格漂移
- 结构化分支设计：态度/路径/命运分支按比例分配、过渡节点补全、分支内容与主线同等饱满
- 完善的状态系统：戏剧化主状态值、多类型结局矩阵、结局触发兜底（无死胡同）
- 自动化验证：节点可达性、引用完整性、支线深度、结局完整性等13项校验

快速开始
1. 运行互动文游启动器
1. 下载 剧情游戏启动器.html 文件
2. 直接用 Chrome/Edge 浏览器打开（无需部署服务器）
3. 点击「插入JSON剧本」，选择生成好的文游JSON文件，即可开始游玩

2. 使用AI技能生成文游JSON
1. 直接将本项目中的 SKILL.md 文件 或 完整story-to-game压缩包 拖拽至支持文件读取的AI工具
2. 向AI输入你的小说/剧本/故事大纲原文
3. 确认AI给出的改编方向后，等待自动生成符合启动器规范的JSON文件
4. 用启动器导入JSON，验证游玩效果

推荐AI工具
- 基础推荐：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 # 许可证文件

设计理念
1. 保留原作气质：分支的核心是「加深对原作的理解」，而非替代原作
2. 选择必有回响：每一个选择都有即时/持续/结局三层影响，偏离原作时创作全新内容
3. 支线同等饱满：任何分支线的内容深度与主线一致，不敷衍玩家
4. 过渡决定沉浸：自动补全事件间的跳跃，保证剧情衔接自然
5. 反剧透贯穿：改编确认阶段仅展示基础方向，保留游玩惊喜

浏览器兼容
推荐使用 Chrome / Edge（支持 File System Access API，可直接读取本地文件夹作为资料库）；
其他浏览器可通过「插入JSON」方式导入剧本，核心功能不受影响。

注意事项
- AI技能生成的JSON需通过 validate.py 验证后再导入启动器，避免节点断链/死胡同
- 启动器的存档/成就记录存储在浏览器本地，清除缓存会丢失（建议手动存档关键节点）
- 结局设计需遵循「兜底规则」：确保任意选择路径都能抵达某一结局

许可证
本项目采用 MIT 许可证 - 详见 [LICENSE]文件