剧情 / 文案（Story） · 剧情角色

存放《同福客栈挂机游戏》的主线对白稿、角色档案、剧情模拟器。

运行时真值 在 src/data/eventTables/;写作/编辑稿 在本目录; 产品对外展示 看 ../pitch/同福客栈剧情故事.html(2026-08-10 起从根目录归档)。

子目录

| 目录 | 职责 | 文件数 | | :--- | :--- | ---: | | 主线故事/ | year1 月度主线对白稿(初版 / 节气增强版 / 对白稿) | 43 | | characters/ | 角色档案 | 22 | | simulator/ | 剧情模拟器(HTML + CJS 工具) | 7 |

主线故事三版本规则

每个月度主线文档有三个版本,按下列顺序排列:

月XX-<时期>.md — 初版大纲
月XX-<时期>-节气增强版.md — 加入节气和季节描写
月XX-<时期>-对白稿-v1.md — 完整对白稿(配音/演出用)

当代码层与对白稿冲突时,优先级:对白稿-v1 > 节气增强版 > 初版

注意:本目录是写作/编辑稿;如果代码里已经实现但文档没更新, 看 src/data/eventTables/ 的真值,再回来同步文档。

当前覆盖

| 月份 | 初版 | 节气增强 | 对白稿 | 状态 | | :--- | :--- | :--- | :--- | :--- | | 月 01 - 开张适应期 | ✅ | ✅ | ✅ | 完成 | | 月 02 - 街坊熟络期 | ✅ | ✅ | ✅ | 完成 | | 月 03 - 初遇挑战期 | ✅ | ✅ | ✅ | 完成 | | 月 04 - 扩建起步期 | ✅ | ✅ | ✅ | 完成 | | 月 05 - 江湖初闻期 | ✅ | ✅ | ✅ | 完成 | | 月 06 - 盛夏经营期 | ✅ | ✅ | ✅ | 旧题,需对齐月 06 应是深冬 | | 月 07 - 羁绊萌芽期 | ✅ | ✅ | ✅ | 完成 | | 月 08 - 擂台预热期 | ✅ | ✅ | ✅ | 完成 | | 月 09 - 大日子逼近期 | ✅ | ✅ | ✅ | 完成 | | 月 10 - 高潮迭起期 | ✅ | ✅ | ✅ | 完成 | | 月 11 - 余波与反思期 | ✅ | ✅ | ✅ | 完成 | | 月 12 - 岁末收束期 | ✅ | ✅ | ✅ | 完成 | | 月 13 - 旧账风波期 | ✅ | ❌ | ✅ | 待补节气增强版 | | 月 20 - 山雨欲来期 | ✅ | ❌ | ✅ | year2 序幕,待补 |

月 06 文件名是"盛夏经营期"但有 6-25 节气增强版,需重命名为"深冬经营期" (这跟 月06-深冬经营期-节气增强版.md / 月06-深冬经营期-对白稿-v1.md 已一致)。

角色档案 `characters/`

00_overview.md 是总览,后续每个 NPC 一份独立 .md。
命名:<角色名>-v<版>.md(例:佟湘玉-v1.md)
角色剧情相关的事件/选项仍以主线对白稿为准,本目录只放身份/关系/性格。

模拟器 `simulator/`

index.html 主入口,可在浏览器里浏览剧情树
graph.html 剧情节点关系图
storyData.js 剧情数据(从主线对白稿生成,可能滞后)
*.cjs 工具脚本(从 .md 抽取选项/事件)

模拟器是辅助写作工具,不是真值源;真值仍是 .md 文件。

配音集成

主线对白稿通过 configure-tongfu-dialogue-voice 技能批量配音;

配音状态:src/data/audio/year1Voice.ts
解析/路径派生:src/utils/storyEvents/
玩家可见文案只认配音通过的版本。

边界

不要把剧情节点直接写到代码里再回来倒推文档;先写对白稿,再让代码实现。
不要让对白稿超过月 13 / 月 20 之外的范围,除非有新的设计拍板。
角色档案和主线对白稿冲突时:以主线对白稿当前版为准,在角色档案里标"以 <主线对白稿路径> 为准"。

看哪份最快入门

新编剧:看 主线故事/year1-故事总览-玩家向-v1.md + 月01-开张适应期-对白稿-v1.md
找某个事件:看 主线故事/year1-月度对白-速查表-玩家向-v1.md
新角色:看 characters/00_overview.md,再写角色档案
配音状态:看 ../../src/data/audio/year1Voice.ts + 跑 configure-tongfu-dialogue-voice 技能

子目录