№ · 活跃计划 CH.06.27
主页 · 📅 活跃计划 · 版本历史

版本历史

📅 2026-06-27 · 📦 39.5 KB · 📅 活跃计划 · 📝 MD 文档 🏷️ 路线图🏷️ 设计🏷️ 剧情🏷️ 计划🏷️ 时间🏷️ 会话

本文件是本项目的版本与迭代记录入口。APP_VERSION、ROADMAP_VERSION、SAVE_SCHEMA_VERSION 三者彼此独立，不能共用一个数字。

版本规则

  • APP_VERSION

    • 玩家可见的发布版本。
    • 用于 UI 展示、发布说明和对外沟通。
    • 建议采用 MAJOR.MINOR.PATCH。

  • ROADMAP_VERSION

    • 路线图 / 设计文档版本。
    • 只描述规划和内容结构的变化，不等同于实际发布版本。
    • 可以在文档重整、功能拆分、阶段目标变化时更新。

  • SAVE_SCHEMA_VERSION

    • 存档格式版本。
    • 只在存档数据结构变化时更新。
    • 如果旧存档仍可直接读取，则保留兼容说明；如果需要迁移或重建，则必须写清影响范围。

  • 统一原则

    • 三类版本互不联动。
    • 功能改动不必然改存档版本。
    • 文档改动不必然改应用版本。
    • 任何影响玩家存档的变更，都必须在这里补充兼容性说明。

  • 版本更新公告

    • 对外公告只写玩家能看见、能点到、能感受到的变化，包括新入口、新玩法闭环、UI 调整、数值体验、存档兼容和已知限制。
    • 对内公告记录工程和协作事实，包括 App.tsx 重构、表结构拆分、引擎接线、目录边界、测试结果、未合并脏改动和后续会话分工。
    • 还没完成或玩家无法验证的内部重构，不提前写成对外功能卖点。

当前基线

App v1.15.1 / Roadmap v0.10.2 / Save Schema v1.9

时间：2026-06-27 01:06:30 +08:00

变更摘要

  • 新增 2026-06-27 日版本计划，把 27 号真正还要继续派发的内容重新压成一页，不再重复 26 号已收口的剧情追踪 UI、江湖简报入口和已完成回包。
  • 今日前排明确改成 任务线失败终局运行时、终局复盘 / 重开 / 时间点存档、任务线失败终局接线、剧情编辑器导出与年线任务编排 四条主线，外部人物扩展、联机专属掉落和白展堂故事线继续后排保留。
  • 活跃路线图同步补上 27 号的开发者日记口径，说明这一轮只是计划与派发边界重排，不宣称任何新的功能代码已经完成。

存档兼容性

  • 本轮只新增日计划并调整路线图与版本记录口径，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 27 号版本计划继续统一使用 Asia/Shanghai 的完整时间戳，并保持本地 dev server 端口口径为 3106。

App v1.15.1 / Roadmap v0.10.1 / Save Schema v1.9

时间：2026-06-26 16:58:51 +08:00

变更摘要

  • 新增 剧情编辑器导出与年线任务编排技术文档，把剧情编辑器导出的内容明确成一条按 gameTime 推进的一年期任务线。
  • 26 号日计划和路线图同步补上这条新线的派发口径，明确导出剧情遇到终局就截断、没有终局就按年线推进。
  • 这次仍然只做文档收口和派发边界调整，不碰 src/*，也不改存档结构。

存档兼容性

  • 本轮只调整文档和派发口径，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 这条新线是把编辑器导出的故事内容接进年度任务编排，不是新增一套独立终局表。

App v1.15.1 / Roadmap v0.10.0 / Save Schema v1.9

时间：2026-06-26 16:06:26 +08:00

变更摘要

  • 把 任务线失败终局需求池 拆成三份可派发的技术文档：运行时、复盘 / 回档、接线，后续派发不再从单一需求池里取。
  • 日计划、路线图和未执行分册都对齐到新的三文档入口，今天之后的终局派发按文档名走，不再把三条线混成一个池子。

存档兼容性

  • 本轮只调整文档口径和派发边界，不改 SAVE_SCHEMA_VERSION，继续保持 1.9。

备注

  • 这轮需求池终于从单一入口改成三份技术文档，接下来只需要按文档名派发。

App v1.15.1 / Roadmap v0.9.9 / Save Schema v1.9

时间：2026-06-26 15:51:59 +08:00

变更摘要

  • 把 26 号日计划里的失败 / 终局提到今日前排，明确任务线失败终局、终局复盘、最近安全点重开和时间点存档先接闭环。
  • 活跃路线图和未执行分册都改成先排失败终局，再排外部人物、联机掉落和白展堂故事线。
  • 这次仍然只做需求与派发口径收口，不改存档结构，不碰 src/*。

存档兼容性

  • 本轮只调整日计划、路线图和版本记录的口径，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 这次迭代的重点是把“压力很多但没走到任务线失败终局”明确成下一步主方向。

App v1.15.1 / Roadmap v0.9.9 / Save Schema v1.9

时间：2026-06-26 14:37:45 +08:00

变更摘要

  • 在 26 号日计划里继续加排 UI 入口层，把系统门厅、横竖双壳、轻提示和简报入口纳入今日可执行项。
  • 今日派发表从纯 gameplay 扩展到 gameplay + UI 入口，但仍然只写需求，不碰 src/*。
  • 版本号与存档结构都不变，这次只是把今天能继续做的东西补进日计划。

存档兼容性

  • 本轮只调整日计划和版本记录的口径，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 这次加排的目标是让主会话看到 26 号还有哪些入口层需求可以继续派发，而不是把已完成回包重新写成未完成。

App v1.15.1 / Roadmap v0.9.9 / Save Schema v1.9

时间：2026-06-26 14:25:49 +08:00

变更摘要

  • 在开发者日记里补出“后续需求规划”小节，把外部人物扩展接口、联机专属掉落和白展堂故事线接入口径写成下一轮可派发样式。
  • 从未执行分册里移除已完成的剧情追踪 UI，避免它继续留在待派发里和下一轮口径打架。
  • 这次只做路线图与派发边界收口，没有新增存档结构，也没有调整玩家可见版本号。

存档兼容性

  • 本轮只调整路线图、未执行分册和版本记录的口径，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 这次迭代的重点是把下一轮该派发什么说清楚，而不是继续把已经完成的 UI 线程留在待办里。

App v1.15.1 / Roadmap v0.9.9 / Save Schema v1.9

时间：2026-06-26 12:04:43 +08:00

变更摘要

  • 26 号日计划的本轮回包已经收齐：剧情追踪 UI 完成并通过验证，外部人物扩展、联机专属掉落和白展堂故事线只确认了边界。
  • 把日计划从“今日可执行”继续迭代成“本轮执行结果 + 下一轮口径”，方便主会话继续派发剩余三项。
  • 开发者日记同步改写为结果口径，不再把已完成的 UI 线程继续放在待办里。

存档兼容性

  • 本轮只调整日计划与版本记录的口径，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 这次迭代的重点是把已经完成的剧情追踪 UI 从待办里摘掉，并把剩余三项压成下一轮可派发口径。

App v1.15.1 / Roadmap v0.9.9 / Save Schema v1.9

时间：2026-06-26 11:33:36 +08:00

变更摘要

  • 把 26 号日计划从“承接位”重新整理成真正的今日可执行页，明确只保留外部人物扩展接口、联机专属掉落、剧情追踪 UI 和白展堂故事线接入四项。
  • 同步把开发者日记里的 6.26 叙事掰回今天口径，不再继续写成昨天残余的延长线。
  • 今天的版本记录只负责把日计划、路线图和派发边界对齐，不提前宣称任何 6.26 功能已经完成。

存档兼容性

  • 本轮只调整日计划与版本记录的口径，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 这次的重点不是补新功能，而是把 26 号这页从“还能继续承接”改成“今天到底要做什么”。

App v1.15.1 / Roadmap v0.9.9 / Save Schema v1.9

时间：2026-06-26 08:59:16 +08:00

变更摘要

  • 把 26 号日计划重新整理成今天可执行版本，只保留外部人物扩展接口、联机专属掉落、剧情追踪 UI 和白展堂故事线接入四项。
  • 明确 25 号已收口内容不再占用 26 号计划，避免“昨天已收口、今天又重复抄一遍”的跨日混写。
  • 26 号计划与 docs/design/6.26玩法/ 下的新需求池对齐，今天只派发还能继续做、还能继续验收的内容。

存档兼容性

  • 本轮只调整日计划与版本记录的口径，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 这次的目标是让 26 号页面只回答“今天要做什么”，不再承接昨天已经收掉的内容。

App v1.15.1 / Roadmap v0.9.8 / Save Schema v1.9

时间：2026-06-25 19:49:41 +08:00

变更摘要

存档兼容性

  • 本轮只调整日计划、路线图和版本记录的口径，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 今天的版本收口已经从“需求拆分”推进到“执行结果同步”，后续如果再新增残余，应另起新的日计划项，不回写当前 25 号收尾页。

App v1.15.1 / Roadmap v0.9.7 / Save Schema v1.9

时间：2026-06-25 15:53:50 +08:00

变更摘要

  • 把原定 2026-06-26 的羁绊扩张、联机竞标深化、剧情事件扩展和昼夜终局对齐，明确前移到 docs/daily-plans/2026-06-25.md。
  • 将 docs/daily-plans/2026-06-26.md 改成“承接页 · 预留”，只承接 25 号当天真实没有收完的残余，避免两天重复承接同一批任务。
  • 同步整理活跃版路线图与未执行分册的链接和时间口径，明确 25 号并没有“做完”，只是前半段已归档、后半段改为继续承接 26 号需求。

存档兼容性

  • 本轮只调整日计划、路线图和版本记录的口径，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 这次整理的目的，是让主会话只看到“今天还要做什么”，而不是被跨日重复计划误导。

App v1.15.1 / Roadmap v0.9.6 / Save Schema v1.9

时间：2026-06-25 12:42:03 +08:00

变更摘要

  • 把 docs/daily-plans/2026-06-25.md 从“已完成 + 未完成混写”拆成两页：2026-06-25-archived.md 收已归档内容，2026-06-25.md 只保留今天还要做的部分。
  • 这次只是把日计划的历史记录和今日剩余分开，避免 25 号计划继续被误读成“今天已经做完”。
  • 仍然是纯文档收口，不改玩家功能、不改存档结构。

存档兼容性

  • 本轮只调整日计划分流与版本记录，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 这次拆分的目的，是让日计划重新只回答“今天还要做什么”。

App v1.15.1 / Roadmap v0.9.4 / Save Schema v1.9

时间：2026-06-24 19:28:30 +08:00

变更摘要

  • 这次整理把桌面横版操作台和手机竖版操作台正式拆成独立壳层，主页面不再挤在一个大组件里，首页留白和操作区拥挤感都得到明显缓解。
  • 顶栏、侧栏、主客栈、控制台、离线结算和首次引导都改成了独立组件，页面入口和弹层结构更清楚，手机上也能直接进入主要操作区。
  • 版本记录和开发者日记继续按“玩家可感知变化”和“内部结构收口”分层，当前仍是结构整理与内容落位，不改存档格式。

存档兼容性

  • 本轮只调整页面结构、入口布局和文档口径，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 这次的重点不是再加一层新的系统，而是把现有操作面重新排顺，让桌面和手机都能更顺手地进入同一套内容。

App v1.15.1 / Roadmap v0.9.4 / Save Schema v1.9

时间：2026-06-24 18:16:09 +08:00

变更摘要

  • 6 月 24 日日版本的基础系统已进入可验证状态：src/data/economy/** 落了货币 / 数值基线，src/data/buffs/** 落了首批 Buff 配置，src/data/eventTables/** 落了剧情与事件表分层，src/components/PortraitWorkspacePanel.tsx 落了竖版壳层抽离。
  • 版本计划与分派口径已同步收口到 docs/daily-plans/2026-06-24.md，明确货币 / Buff / 剧情短闭环 / App 壳拆分 / UI 线程的当前边界。
  • 主仓库 npm run build 已通过，当前仅保留 chunk size 警告，暂未影响功能验收。

存档兼容性

  • 本轮仅落静态基线、壳层和文档收口，不改持久化结构，SAVE_SCHEMA_VERSION 继续保持 1.9。

备注

  • 当前版本状态仍属 6 月 24 日基础系统落地阶段，不将内部拆分直接宣称为新增玩家功能；后续若继续推进，应按各线程回包的最小摘要继续收口。

App v1.15.1 / Roadmap v0.9.4 / Save Schema v1.9

时间：2026-06-24 11:28:52 +08:00

变更摘要

  • 将 App.tsx 重构提升为 6 月 24 日版本计划的 P0，优先收回编排层职责，避免新增玩法继续堆进同一个大组件。
  • 日计划同步加入 App 拆表与双壳拆分计划 v1，把事件表落位、竖版 / 横版双壳边界和 App.tsx 冻结规则作为今日前置条件。
  • 版本更新公告开始区分对外与对内：对外写玩家可验证变化，对内写重构、拆表、引擎、测试和协作边界。

存档兼容性

  • 本轮只更新计划与版本记录，不改持久化结构，SAVE_SCHEMA_VERSION 保持 1.9。

备注

  • App.tsx 重构是今日内部 P0，不作为玩家已经可见的新玩法对外发布。

App v1.15.1 / Roadmap v0.9.4 / Save Schema v1.9

时间：2026-06-24 10:48:22 +08:00

变更摘要

  • 封存 2026-06-23 日版本计划，把系统门厅、终局复盘 / 重开 / 时间点存档、账号 / 多周目、Buff / 客栈状态、官府竞标会和竖屏回归都留在 23 号边界内。
  • 新增 2026-06-24 日版本计划，承接 docs/design/6.24玩法/ 目录，把货币数值、Buff、道具投放、剧情事件、账号成就和联机竞拍排成今日版本顺序。
  • 今日计划明确先做经济和 Buff 这类基础语言，再让道具投放、剧情事件、账号传承和联机竞拍依次接上。

存档兼容性

  • 本轮只更新日计划、路线图和版本记录，不改持久化结构，SAVE_SCHEMA_VERSION 保持 1.9。

备注

  • 这次只是制定 6 月 24 日版本计划，不提前宣称任何 6.24 玩法已经完成；本地验收端口口径继续记为 3106。

App v1.15.1 / Roadmap v0.9.3 / Save Schema v1.9

日期：2026-06-22

变更摘要

  • 新增 事件表索引 v1 和 可执行事件清单 v1，把随机事件、终局运行时、UI / 弹窗、存档 / 版本和江湖简报拆成独立子会话阶段。
  • 新增 代码结构拆分规则 v1，把 src/data/、src/utils/、src/components/、src/endgame/ 的边界重新收口，避免继续把数据、逻辑和 UI 混在同一层。
  • 将 江湖简报设计 v1 扩成完整需求，并把 同福客栈挂机游戏开发者日记 改成面向读者的发布日记，方便按版本回看今天的整理结果。
  • 继续整理头像资源与切图流程，public/assets/avatars/*.webp 按统一裁切口径重新微调，slice-avatars.js 改为向内收缩裁切区域，减少拼图白线干扰，让人物头像在列表和手机视图里更整齐。

存档兼容性

  • 本轮只更新设计文档、执行清单、头像资源和切图脚本，不改持久化结构，SAVE_SCHEMA_VERSION 保持 1.9。

备注

  • 后续子会话按清单分工推进，主线程只负责版本边界收口与结果汇总。
  • 这次是上一轮版本收口后的继续整理，重点落在内容资源与生成流程，而不是再扩新的玩法系统。

App v1.15.1 / Roadmap v0.9.2 / Save Schema v1.9

日期：2026-06-22

变更摘要

  • 补齐终局存档解释层，时间点存档和终局快照现在会同时说明现实时间、游戏时间、终局链阶段、失败种子和版本线。
  • 时间点存档浏览器新增现实建档时间、最后更新时间、App / Roadmap / Save Schema 版本行和终局焦点说明，便于按版本与因果链回查。
  • 终局收束面板补出败局记录的触发、选择、结果、种子和当前终局链状态，方便读档、重开和复盘入口统一理解。

存档兼容性

  • 继续沿用 SAVE_SCHEMA_VERSION = 1.9，本轮只补可见解释字段和文案，不改存档主结构。
  • 旧存档仍按既有默认值和归一化逻辑读取。

备注

  • 这轮的收口目标是把“可执行事件清单 + 阶段拆分 + 存档解释”统一到一层可见语言里，后续子会话可以直接接着用。

江湖简报设计 / Roadmap v0.9.2 / Save Schema v1.9

日期：2026-06-22

变更摘要

存档兼容性

  • 本轮只新增设计文档和路线图入口，不改持久化结构，SAVE_SCHEMA_VERSION 保持 1.9。

备注

  • 江湖简报是每日固定信息层，不和随机事件判定混写，后续实现可以直接复用天亮时点和现有日志数据。

文档收口 / Roadmap v0.9.1 / Save Schema v1.9

日期：2026-06-22

变更摘要

存档兼容性

  • 本轮只更新设计文档和路线图，不改持久化结构，SAVE_SCHEMA_VERSION 保持 1.9。

备注

  • 这次收口的重点是把“昼夜玩法”和“终局玩法”装进同一套时间年表里，后续子会话只需按时间门槛实现事件和终局即可。

App v1.15.0 / Roadmap v0.9 / Save Schema v1.9

日期：2026-06-22

变更摘要

  • 完善 终局表现与存档读档设计，明确终局页的分层收束结构、最近安全点重开、读取终局快照和读取时间点存档的操作路径。
  • 补充自定义存档的时间点命名规则，统一现实时间 createdAt / updatedAt 与游戏时间 gameTime 的展示口径。
  • 将快照索引、快照正文和导出包拆分为独立概念，便于后续做浏览、筛选、导入与分享。
  • 路线图增加终局重开链路与时间点命名的子会话拆分建议。

存档兼容性

  • 继续沿用 SAVE_SCHEMA_VERSION = 1.9，因为本轮只补设计文档和版本说明，没有新增持久化字段。
  • 旧存档兼容不变。

备注

  • 这版把终局的“怎么结束、怎么回去、怎么按时间点建档”统一成一套操作语言，后续子会话可直接按文档落实现有模块。

App v1.14.1 / Roadmap v0.9 / Save Schema v1.9

日期：2026-06-22

变更摘要

  • 新增 docs/mobile-portrait-rulebook.md，定义竖屏首页的 No-Scroll 壳、四段式区域、上下文主动作和模块下沉规则。
  • 把后续竖屏实现顺序固定为 App shell -> InnCourt -> RandomEventPopup -> 其余模块抽屉化。
  • 本轮只记录规则与文档，不改玩法数据和存档结构。

存档兼容性

  • 继续沿用 SAVE_SCHEMA_VERSION = 1.9，因为本轮只做文档与界面规则更新。
  • 旧存档兼容不变。

备注

  • 后续竖屏实现必须以这份规则为准，不再把桌面布局直接压缩到手机。

App v1.14.0 / Roadmap v0.8 / Save Schema v1.9

日期：2026-06-21

变更摘要

  • 失败预警从 top 3 扩成 12 条可见，并增加分组/折叠视图，方便玩家按高优先级、次级预警和可控观察来浏览。
  • 失败终局可推进链扩展到 5+ 条高频线，税案和旧身份之外的掌柜急召、欠薪、宫厨挖角、贡宴毁约等也能进入连续事件抉择。
  • 新增败局复盘页，能看到触发、选择、结果和失败种子，补齐“败局记录”闭环。

存档兼容性

  • 继续沿用 SAVE_SCHEMA_VERSION = 1.9，本轮只增加运行时展示和记录字段，不改既有存档主结构。
  • 旧存档兼容不变，历史败局记录缺少新字段时会自动按默认值补齐。

备注

  • 下一步可继续把复盘页做成筛选/回放式结构，但当前已能满足“看见风险、理解条件、看到结果与种子”的阶段验收。

App v1.13.0 / Roadmap v0.8 / Save Schema v1.9

日期：2026-06-21

变更摘要

  • 失败终局规则数据补齐到 20 条完整矩阵，原先保留 TODO 的 8 条现在也有只读预警条目和补救门槛。
  • 这批补齐不新增存档字段，继续沿用运行时派生风险和少量失败链状态。
  • 终局中心仍保留 12 条可见预警 + 2 条可推进事件链的结构，但设计文档不再只停留在 TODO。

存档兼容性

  • 继续沿用 SAVE_SCHEMA_VERSION = 1.9，因为本轮只补规则数据，没有改持久化结构。
  • 旧存档兼容不变。

备注

  • 后续若要让其余 18 条更深度接入事件链，再单独扩展链路，不必改当前存档结构。

App v1.12.0 / Roadmap v0.8 / Save Schema v1.9

日期：2026-06-21

变更摘要

  • 失败终局进入第三阶段：总览页新增败局记录区，可看到当前失败链、最近败局记录和可恢复的缓解/失败结果。
  • 失败终局预警扩展到 12 条可见规则，除 6 条核心线外，补上了食安、假票、地契、欠薪、断水、黑名单等高频风险。
  • 两条连续失败链已可随时辰推进并进入缓解或失败记录，结果会以停业、罚款、封灶、离岗等形式留下复盘入口。

存档兼容性

  • 继续沿用 SAVE_SCHEMA_VERSION = 1.9，因为本轮只是扩展既有失败链状态和记录展示，没有再新增存档字段。
  • 旧存档兼容不变，失败记录为空时会显示空态。

备注

  • 12 条可见规则已达当前验收阈值；其余 8 条保留在设计文档 TODO。

App v1.11.0 / Roadmap v0.8 / Save Schema v1.9

日期：2026-06-21

变更摘要

  • 失败终局进入第二阶段：新增运行时失败链状态，税案和白展堂旧身份可随清晨/白天/傍晚/深夜推进预警、加压和抉择节奏。
  • 随机事件弹窗开始承载失败终局事件，至少两条连续链路可进入缓解、延缓或失败记录，不会真正删档。
  • 存档新增 failureEndgame 运行时状态，用于记录失败链阶段和败局记录，旧存档自动补默认值。

存档兼容性

  • 新增 failureEndgame 持久字段，SAVE_SCHEMA_VERSION 提升到 1.9。
  • 旧存档在读取时会自动补齐空的失败链与记录数组。
  • 当前仍不做真正 Game Over，只做可恢复的停业、罚款、封条和离岗记录。

备注

  • 下一阶段继续补复盘/败局记录 UI，并把更多终局预警铺到总览里。

App v1.10.0 / Roadmap v0.8 / Save Schema v1.8

日期：2026-06-21

变更摘要

  • 失败终局进入第一阶段最小落地：新增 6 条核心失败终局的运行时风险判定，覆盖偷税漏税、郭家查封、白展堂旧身份、小贝掌门线、大嘴进宫和秀才假账。
  • 总览页新增“失败预警”卡，展示最高风险的 3 条终局、关键触发项、可用补救项和未满足原因。
  • 补救门槛会明确显示现金、声望、治安、燕捕头信任、角色忠诚/机变、算错账风险等条件，不再是纯随机提示。
  • 当前版本只做预警和补救条件展示，不触发删档、不进入强制 Game Over、不写入终局状态。
  • 帮助手册补充失败预警说明，明确本阶段不会直接强制停业。
  • 事件收获从“用途预告”推进到可消耗：食材、药材、文书、信物、工具、装饰均可在行囊中使用，并消耗 1 件库存。
  • 轻道具使用会即时转化为熟食、员工调养、账房收益、江湖声望/治安、后院维护或客栈装饰收益，并写入经营日志。
  • 事件掉落池补足到 16 个 dropId，覆盖无双帮工、白展堂旧友、江湖说书、古井排队、早市采购、商队午歇、后厨烟火、夜巡、避风客、擂台与文斗等来源。
  • 羁绊事件现在会同步影响对应员工的心情、压力、忠诚等深度状态，不再只更新羁绊值本身。

存档兼容性

  • 本轮不新增持久化字段，SAVE_SCHEMA_VERSION 继续保持 1.8。
  • 失败风险来自当前资源、员工深度属性、羁绊、事件收获和擂台状态的派生快照；旧存档读入后可直接计算。
  • 事件收获沿用 v1.9.0 的 EventDropItem 存档结构，只在使用时递减 quantity 或移除条目，不需要新增迁移。

备注

  • 后续若要把失败种子、压力值、终局阶段或复盘记录写进存档，再单独提升 SAVE_SCHEMA_VERSION 并补默认值。

App v1.9.0 / Roadmap v0.8 / Save Schema v1.8

日期：2026-06-21

变更摘要

  • 事件道具收获进入最小闭环：随机事件选项可配置 eventDrops，玩家选择后会把轻道具写入行囊并记录日志。
  • 新增事件轻道具类型：食材、药材、文书、信物、工具、装饰。
  • 首批掉落接入清晨古井排队、李大嘴赶早市、官道商队午歇、郭芙蓉门口镇场、白展堂旧友夜访、江湖名客拼桌说书等事件。
  • 行囊页区分“闲置装备”和“事件收获”，轻道具展示来源、数量、类型、用途说明，不参与穿戴、精炼和套装统计。
  • 经营总览同步区分装备件数与事件收获数量，避免轻道具污染原有装备构筑判断。

存档兼容性

  • bagItems 从纯装备数组扩展为 BaggageItem[]，可同时存储 EquippableItem 和 EventDropItem，SAVE_SCHEMA_VERSION 提升到 1.8。
  • 旧装备存档仍会按原有逻辑恢复，并自动补上 kind: 'equipment'。
  • 新事件收获以 kind: 'eventDrop'、dropId、category、quantity 等字段保存；旧存档缺少这些条目时不需要迁移。

备注

  • 这版先完成“获得、持久化、展示、用途预告”的 v1.9 最小闭环；轻道具兑换、消耗和与后厨/羁绊/擂台/区域扩建的深度消费逻辑已在后续版本继续推进。

App v1.8.0 / Roadmap v0.8 / Save Schema v1.7

日期：2026-06-21

变更摘要

  • 失败终局文档补充“属性判定体系”，要求每条终局都和店铺资源、角色属性、外部人物信任或失败种子挂钩。
  • 新增 20 条终局判定矩阵，明确补税、贿赂、求情、挽留、自证、担责等选项的资源门槛和属性门槛。
  • 强化 6 条核心终局的详细判定：税案看现金、燕捕头信任和秀才账房能力；郭芙蓉线看好感和家族压力；白展堂线看正直和旧账；小贝线看武力；李大嘴线看忠诚；吕秀才线看算错账次数、聪明和忠诚。
  • 新增“失败终局设计文档”，把税案、查封、挖角、火灾、疫病、地契、罢工等败局整理成可演出的终局库。
  • 为每条失败终局补充时间线、故事、事件、结局和延迟种子，统一接入时间体系的清晨、白天、傍晚、深夜节律。
  • 文档层面补充失败回收、周目遗产和后续子会话拆分建议。
  • 新增“同福羁绊”系统基础骨架：BondState、BondStates、默认羁绊表、归一化工具和读档补齐。
  • 首批羁绊事件接入随机事件池，覆盖郭芙蓉 × 吕秀才、祝无双 × 吕秀才、钱掌柜 × 钱夫人三条线。
  • 总览页新增“同福羁绊”近况卡，可查看当前阶段、羁绊值和首个解锁效果。
  • 随机事件弹窗支持 bondEffects，可在普通数值结算之外推进羁绊阶段与日志。
  • 同福擂台赛接入 v1.8 活动化能力：联机盟友可派已解锁店员助阵，提高擂台热度与秩序，并推进共同目标。
  • 擂台触发接入赶集日/夜市日加成，按日期与时段提高开擂概率、初始热度和秩序压力，总览卡展示当前活动倍率。
  • 总览页新增“复制擂台战报”，擂台结清时也会写入可分享战报日志。

存档兼容性

  • 本轮新增的是路线图与玩法文档，不改代码和存档结构，APP_VERSION 保持 1.8.0，SAVE_SCHEMA_VERSION 继续保持 1.7。
  • 旧存档继续兼容；若后续把失败终局写入持久化，再单独提升存档版本并补默认值。
  • 擂台 v1.8、羁绊与角色深度等已落地字段保持原有兼容策略。

备注

  • 本轮只完成羁绊系统最小骨架和首批内容入口，以及擂台联机助阵、活动加成和战报入口；白展堂 × 佟湘玉线、三角线修正规则、帮助手册说明和更完整的擂台活动奖励仍可继续细化。

App v1.7.0 / Roadmap v0.5 / Save Schema v1.6

日期：2026-06-21

变更摘要

  • 同福擂台赛进入“角色与资源深化”第一步：擂台选项可结算柴、水、熟食、关中银票和山寨赃物。
  • 随机事件弹窗新增资源效果筹码，并在材料不足时置灰对应选项，避免沉默扣除。
  • 擂台路线接入店员等级：郭芙蓉强化守擂热度与秩序，白展堂强化控场，李大嘴强化厨艺擂收益，吕秀才强化文斗名声与秩序。
  • 初擂新增镖师切磋和江湖旧友路线，补齐“镖师、旧友”参赛者类型。
  • 冷却余波接入主循环：高热度提高客流和稀客概率，低秩序提高盗贼风险，总览卡展示余波倍率。
  • 决擂和余波会根据当前焦点角色等级与热度给出额外收益，形成从初擂选择到最终结算的连续反馈。

存档兼容性

  • 本轮不新增持久化字段，继续使用 SAVE_SCHEMA_VERSION = 1.6。
  • 柴、水、熟食、关中银票、山寨赃物和 tournament 字段均沿用现有存档结构。
  • 旧存档进入游戏后仍会按 v1.6 逻辑补齐默认擂台状态。

备注

  • 本轮完成 v1.7 的资源与角色差异基础、参赛者扩展和冷却余波接入；每名角色的更长专属分支可继续在后续子会话扩展。

App v1.6.0 / Roadmap v0.5 / Save Schema v1.6

日期：2026-06-21

变更摘要

  • 新增角色深度属性、俸禄支出与事件掉落开发文档，明确“同福伙计深度养成”作为长期员工系统。
  • 文档定义了健康、体力、疲劳、心情、压力、服务、厨艺、账房、清洁、巡防、武力、机变、人缘、名望牵引、忠诚、志向、俸禄档位等 16+ 属性方向。
  • 补充佟湘玉、白展堂、郭芙蓉、李大嘴、吕秀才、莫小贝、祝无双的角色差异化玩法、支出倾向和事件道具收获。
  • 将后续实现拆分为属性模型与默认值、状态消耗与恢复、俸禄支出结算、事件道具掉落、系统联动验收等子会话。

存档兼容性

  • 当前变更是 Roadmap 文档更新，不改变应用功能和存档字段。
  • APP_VERSION 保持 1.6.0，SAVE_SCHEMA_VERSION 保持 1.6。

备注

  • 后续只有在实际引入 StaffDepthState 并持久化时，才继续提升 SAVE_SCHEMA_VERSION。

App v1.6.0 / Roadmap v0.4 / Save Schema v1.6

日期：2026-06-21

变更摘要

  • 落地 docs/martial-tournament-design.md 中的 App v1.6.0 擂台最小闭环：同福擂台赛会按 setup -> qualifier -> final -> cooldown 推进。
  • 新增 TournamentState、默认值、读档归一化和阶段推进工具，首个主题为“比武招亲”。
  • 随机事件弹窗可展示并结算擂台热度、秩序、阶段和角色焦点，进行中的擂台会优先推进下一节点。
  • 总览页新增“同福擂台赛”状态卡，展示阶段、热度、秩序、焦点角色和下一步提示。
  • 新增“区域扩建与房间营造”系统，把客栈门口、堂中加桌、厨房边桌、二楼住店、楼上包厢、大嘴厨房、后厨院子和五个主角房间纳入统一扩建表。
  • 设施页新增“大堂扩建与房间营造”区块，可消耗铜钱、关中银票和山寨赃物升级区域。
  • 总览页新增区域扩建等级、已扩区域数和桌位容量，并给出门口、二楼、桌位扩建建议。
  • 扩建效果已接入桌位容量、自然进客、夜间客流、顾客结账、离线收益、后院采集、熟食产出、清洁、治安和角色岗位特性。
  • 新增 docs/inn-area-expansion-v1.md，作为二楼住店、包厢宴席和角色房间事件的后续设计入口。

存档兼容性

  • 新增 tournament 存档字段，旧存档缺省时自动补齐为 theme: 'martial_matchmaking'、stage: 'idle'、heat: 0、order: 100、roundsCompleted: 0。
  • 读档会容忍 tournament 内部缺少任意字段，并归一化到可用默认值；旧存档不会直接进入非 idle 阶段。
  • 新增 areaExpansions 存档字段，SAVE_SCHEMA_VERSION 提升到 1.6。
  • 旧存档载入时会自动补齐全部区域为 Lv.0，并根据扩建等级重建桌位列表。
  • 不迁移临时顾客队列，旧存档仍保持原 4 桌开局容量。

备注

  • 第一版先验证区域等级对现有挂机循环的影响，并验证擂台状态、事件链路和总览 UI 的最小闭环；二楼住店订单、包厢宴席链、房间专属事件、擂台联机助阵和复杂战斗动画留给后续版本。

App v1.5.0 / Roadmap v0.4 / Save Schema v1.5

日期：2026-06-21

变更摘要

  • 新增羁绊与感情线开发文档，明确“同福羁绊”作为长期角色关系系统。
  • 首批内容库覆盖郭芙蓉 × 吕秀才、祝无双 × 吕秀才、白展堂 × 佟湘玉、钱掌柜 × 钱夫人。
  • 文档定义了羁绊值、羁绊阶段、关系标签、触发规则、UI 方案、版本拆分和子会话责任。
  • 将后续实现拆分为羁绊数据与存档、首批羁绊事件、总览/帮助手册 UI、三角线与外部人物四类子会话。

存档兼容性

  • 当前变更是 Roadmap 文档更新，不改变应用功能和存档字段。
  • APP_VERSION 保持 1.5.0，SAVE_SCHEMA_VERSION 保持 1.5。

备注

  • 后续只有在实际引入 BondStates 并持久化时，才提升 SAVE_SCHEMA_VERSION。

App v1.5.0 / Roadmap v0.3 / Save Schema v1.5

日期：2026-06-21

变更摘要

  • 新增复杂擂台赛开发文档，明确“同福擂台赛 / 比武招亲”的长期系统设计。
  • 将后续开发拆分为 App v1.6.0 最小闭环、App v1.7.0 角色与资源深化、App v1.8.0 联机助阵与活动化。
  • 文档定义了擂台状态、热度、秩序、角色焦点、事件节点、UI 方案、子会话拆分和验收口径。

存档兼容性

  • 当前变更是 Roadmap 文档更新，不改变应用功能和存档字段。
  • APP_VERSION 保持 1.5.0，SAVE_SCHEMA_VERSION 保持 1.5。

备注

  • 后续只有在实际引入 TournamentState 并持久化时，才提升 SAVE_SCHEMA_VERSION。

App v1.5.0 / Roadmap v0.2 / Save Schema v1.5

日期：2026-06-21

变更摘要

  • 新增“比武招亲”随机事件系列，作为擂台玩法的第一版轻量落地。
  • 首批加入 4 个角色变体：郭芙蓉临时守擂、李大嘴误挂红绸、白展堂旧账擂台、吕秀才文斗招亲。
  • 随机事件弹窗新增“事件系列”标签，玩家能区分普通时辰事件与特殊主题事件。
  • 比武招亲事件会受时段、声望和治安影响：白天/傍晚更常出现，高声望更容易引来围观，低治安更容易引发风险型擂台。

存档兼容性

  • 当前变更不改存档字段结构。
  • 新增事件只影响随机事件池、展示标签与抽取权重，旧存档继续兼容。

备注

  • 这一版先用单次随机事件验证擂台题材；多日连锁、员工等级判定和联机助阵留给后续版本。

App v1.4.0 / Roadmap v0.2 / Save Schema v1.5

日期：2026-06-21

变更摘要

  • 随机事件接入时段亲和：事件会根据清晨、白天、傍晚、深夜获得不同抽取权重。
  • 首批加入 8 个“同福客栈日常 + 江湖风险”事件节点，覆盖早市备料、午市商队、掌灯巡查、深夜避风客等时辰场景。
  • 既有事件补充时段标签，弹窗展示“时辰缘起”，让玩家能感知事件与时间体系的关系。

存档兼容性

  • 当前变更不改存档字段结构。
  • 新增事件只影响随机事件池与权重，旧存档继续兼容。

备注

  • 这一版暂不扩展事件效果字段，柴水熟食等直接资源消耗留给后续版本单独处理。

App v1.3.0 / Roadmap v0.2 / Save Schema v1.5

日期：2026-06-21

变更摘要

  • 时间体系 v1 已落地基础反馈：总览页显示时段效果和倍率提示。
  • 离线回店弹窗补充时间推进摘要，展示起止时间与跨越日数。
  • 版本号基线更新到 App v1.3.0，继续沿用当前存档结构。

存档兼容性

  • 当前变更不改存档字段结构。
  • 旧存档继续兼容，读档后会补齐时间摘要展示。

App v1.2.0 / Roadmap v0.2 / Save Schema v1.5

日期：2026-06-21

变更摘要

  • 为后续开发明确版本化推进规则：功能默认按版本拆分，再按子会话推进。
  • 将时间体系后续工作明确为 v1.x 子版本迭代，不再作为单次大任务推进。
  • 路线图新增当前版本迭代说明，要求版本边界统一验收。

存档兼容性

  • 当前文档调整不改变存档结构。
  • 旧存档继续兼容。

未来条目模板

### App vX.Y.Z / Roadmap vA.B / Save Schema vN
**日期**：YYYY-MM-DD

**变更摘要**
- 
- 
- 

**存档兼容性**
- [ ] 兼容旧存档
- [ ] 需要默认值补齐
- [ ] 需要迁移
- [ ] 需要重建

**备注**
-

记录要求

  • 每次对外可感知的更新，至少追加一条版本记录。
  • 如果是纯文档调整，但不改变玩法或存档结构，可以只更新 ROADMAP_VERSION 的说明，不必改 APP_VERSION。
  • 如果是玩法、经济、时间、联机、地图或道具系统的改动，优先判断是否影响存档，再决定是否提升 SAVE_SCHEMA_VERSION。

本轮工作约定

  • 功能拆分优先进入子会话，主线程只保留版本边界的统筹和收口。
  • 同一版本内，不重复做每个子功能的验收；先把版本包做完，再统一验收。
  • 如果某次迭代只是文档或流程调整，不一定要提升 APP_VERSION，但要把执行规则写清楚。