发刊时间：2026 年 7 月 18 日 · 丙午年

卷号：第 22 卷

主题：稳定 · 推进 · 新故事

对应内部公告：docs/handoff/CHANGELOG-2026-06-28-07-18-更新公告.md（72 task / 66 verified / 0 failed）

一句话总结

22 天,6 大模块收口。新装备上线,联机竞标开张,胜利终局拍板,第一年主线拉通,失败后能回家,跨周目有路了——同福客栈的"完成度"又上了一个台阶。

一、新内容(玩家可感知)

1. ⚔️ 联机官府竞标会上线(联机 P2P 房间骨架 v1.1)

江湖里朋友多的掌柜有福了——官府竞标会现在可以联机玩了。

5 态状态机驱动,房间生命周期清晰:创建 → 等待 → 竞价 → 结算 → 关闭
5 秒流拍机制:每次出价自动重置倒计时,5 秒没新出价就流拍,不再无止境拖
断线重连 + 房主转移:网络抖一下也不怕,AI 接管你之前的出价,房主掉线自动转移
顶部条幅 + 房间卡片视觉,跟现有官府竞标 UI 风格统一,看一眼就懂
房间内反狙击 + 最小出价单位机制,不出手就是出局

这只是骨架,真实网络测试(跨设备/异地)留 W30 之后慢慢补,先跑起来再说。

2. 🎽 Phase 1 装备系统正式上线

16 件装备 × 9 档色板,装备系统从"有没有"走到"好不好"。

4 个核心字段全打通:rarity（稀有度）/ qualityTier（品质）/ affixes（词条）/ setBonus（套装加成）
9 档色板让"一眼看出好装备"成为可能,从灰白到金红,视觉分级清晰
装备与词条联动:同一件装备能 roll 出不同词条组合,build 空间打开
6 段投放映射:前 30 天 / 前 90 天 / 年中 / 年末 / 跨年 / 第二年,各有节奏
rollEquipment 工具上线 + 46 组单元测试(45 组合 + 1 旧存档 fallback)

3. 🏆 胜利终局拍板了——"游戏终于能赢"

以前你可能听过"游戏有失败结局",但胜利结局之前还在 placeholder 状态。现在:

触发条件 4 维 AND 复合:经营 + 关系 + 名声 + 时间,四个维度同时满足才能触发
收束页 4 块:结算页 / 关系快照 / 名声定格 / 江湖阅历折算
跨年夜 = 唯一第一锚点:第一年的终点才有资格触发胜利
触发后,所有成就、名声、关系都收成一份永久快照,作为"这一局完美结局"的纪念
继承走账号全局(GlobalProfile),不丢到下一周目

触发条件的具体数值在 7.14 已拍板落盘(victoryConditions.ts),玩家在 7.13 起的快照里能看到倒计时。

4. 📅 第一年主线骨架拉通

"剧情编辑器导出"和"游戏内年线推进"终于接上了——你能在游戏里看到剧情按真实游戏日推进,不是按现实时间。

第一年 = 360 天,从开业第一天到跨年夜,自动推进
年线按"开局 → 推进 → 压力 → 收束"四阶段展开
自动主线 / 剧情任务分界清楚:剧情任务你手动推,自动主线跟着时间走
关键节点提前预告:在进入关键阶段前,系统会通过江湖简报提前告知
阶段投放节奏:前 30 天练手 / 前 90 天熟悉 / 年中第一个高峰 / 年末收束

5. 🔁 跨周目 v1.1 锚点 — 通关了还有第二春

第一年玩完,可以选择开第二周目——保留的江湖阅历和传承道具直接带入。

Year 2/3 startDay 锚定:第一年结算后自动进入第二年,不再断档
折算曲线 1.0 / 0.8 / 0.6 / 0.4:声望、财富、名望按难度系数自动折算
多周目账号成长:每通关一局,下一局的开局就舒服一点
失败终局也算阅历——输了不会白玩,阅历保底

6. 💀 失败终局可恢复 — 输了也能"回家"

以前输了就是真没了。现在失败后有完整的回经营路径:

复盘:失败链完整推进顺序 + 每步触发原因 + 关键压力来源
最近安全点重开:回到最近一个还能继续经营的节点
时间点存档:按时间线回退到任意历史节点,现实时间和游戏时间双显示
终局快照另存:终局状态可保存为单独手动档,留作"那一刻的纪念"

7. 🧭 工具入口统一 — 找东西不再迷路

项目里 HTML 工具页(剧情编辑器、Buff 编辑器、道具编辑器等)现在有统一入口页:

docs/tools/index.html 落盘,分区与入口清楚
统一 HTML 规范,所有工具页风格一致
后续剧情编辑器、Year 1 工具、Buff 设计都进同一入口

这一项主要是给内部用的(策划/设计师),但你看到工具页时风格统一了。

8. 🎭 旧账风波期节点大纲 + 数据展开

R13 剧情线月级 8-12 节点大纲 + 节点数据全部就位:

每个节点 4 字段齐:触发条件 / 2-3 选项分支 / 羁绊变化 / 道具奖励
"旧账风波"被定为第一年主线收束线——这是第一年最重要的剧情
节点进游戏的事件池,玩家能在第一年的特定时段触发
桥接表 + 收束页对接留 W30 续做

9. 🧹 剧情追踪字段净化 — 玩家看到的是干净文案

之前你可能在剧情追踪面板里看到过一些"开发者味很重"的字段(比如 bridge_xxx tags_yyy 这种)。现在:

玩家可见文案净化:所有内部 ID / 蛇形命名 / 技术标签全部去掉
玩家只会看到"上一步、下一步、为什么"的干净提示
开发者字段(用于调试的)移到独立的开发者入口,默认玩家视图不显示

二、已修复(玩家早就想骂的)

| 问题 | 修复 | | --- | --- | | 😤 闯荡"点完出发就没反应"卡死 | ✅ 主链修通,出发 → 推进 → 结算 → 回店全链打通 | | 😤 新手引导重复弹 / 关不掉 | ✅ 引导状态按"账号 + 槽位"作用域隔离,不再乱弹 | | 😤 新手流程按钮点不出 / 黑屏 | ✅ 引导步骤 hook 顺序风险收掉,build 通过 | | 😤 旧存档 continue 后又被新手引导覆盖 | ✅ 恢复旧周目时自动 dismiss 引导,不再被卡 | | 😤 选空槽位 → 仪式 → 回 welcome 槽位还空 | ✅ 主故障链不复现 | | 😤 联机 panel 视觉跟现有 UI 不一致 | ✅ 跟 auction/console/ 视觉规范对齐(部分 residual 已知) |

三、已知问题(透明公开)

我们对玩家不藏 bug,以下是已知但本轮没修完的问题,后续会逐条收口。

联机跨设备真实网络测试未做(本轮只验证本地 + 模拟掉线)
R10 联机 UI 集成仅收口在视觉对照 + checklist,真实网络场景的边界条件留作 residual risk
月 20 真值建立未完成(Year 2 月 20,第 571-600 天,六锚点还在建)
表情包 / 弹幕 / 跨设备同步等联机高级功能留 v1.4+
拍卖类型契约还有残余(21 条 → 0 条已 verified,Q2 lane 收口)

四、下一步预告(接下来 2-3 周)

🎯 月 20 真值建立(Year 2 起点,六锚点进唯一 runtime event registry)
🎯 跨周目 / 多周目交互打磨(Year 1 → Year 2 平滑过渡)
🎯 剧情追踪字段净化全面收口
🎯 联机表情包 + 弹幕(v1.4+ 路线)

五、玩家反馈渠道

游戏内:系统门厅 → 江湖简报 可以直接反馈
内部 issue:走现有 handoff/tasks 通道(开发者参考用)

📎 附录 · 技术参考(开发者 / 内部协作者)

这一节给开发者和技术协作者看,玩家可以忽略。

A. 版本号

| 字段 | 值 | 变更原因 | | --- | --- | --- | | APP_VERSION | v1.18.0 | 6 个主题模块全部 verified,联机骨架 v1.1 升级,Phase1 装备上线 | | ROADMAP_VERSION | v0.13.0 | W29 5 日计划全执行,R7-R14 全部 verified | | SAVE_SCHEMA_VERSION | v1.10 | Phase1 装备模型补 4 字段(rarity / qualityTier / affixes / setBonus)+ 16 件装备全填 → 必须 bump |

B. 存档兼容性

旧存档自动补齐,不需要重建
装备 4 字段在旧存档读入时按默认值补齐:
- rarity:默认 common
- qualityTier:默认 0
- affixes:默认 []
- setBonus:默认 null
新增的 StoryTaskState(白展堂 5 条故事线任务状态)为可选字段,旧存档读入时为 undefined
跨周目新增的 GlobalProfile.runInfo 字段补默认值

C. 关键设计文档

C.1 新增 / 升级

docs/design/active/联机P2P房间骨架-v1.md(v1.0 → v1.1)
- 补 RealtimeBidState 4 态
- 补 ReconnectState 4 态
- 补 5 个核心函数
docs/design/active/跨周目v1.1锚点-v1.md(新)
docs/design/active/胜利终局-truth-source-v1.md(新)
docs/design/active/胜利终局-v1.1数值拍板-v1.md(新)
docs/design/active/Phase1实施切片-v1.md + -checklist.md + Phase1回归测试-v1.md(配套完整)
docs/design/active/剧情线3+预研大纲-v1.md(新)
docs/design/active/启动页v1.3按钮需求-v1.md(新)

C.2 5 日计划文档

docs/plans/active/2026-07-06-5日开发计划-v1.md + -收口.md
docs/plans/active/2026-07-13-5日开发计划-v1.md + -收口.md
docs/plans/active/2026-07-14-X1后续开发计划-v1.md
docs/plans/active/2026-07-20-5日开发计划-v1.md

C.3 内部审查

docs/reviews/2026-07-13-w29-code-quality-audit-v1.md
docs/reviews/2026-07-14-k1-content-reachability-audit-v1.md

D. 源文件改动清单(src/*)

| 文件 | 改动 | 来源 | | --- | --- | --- | | src/App.tsx | 闯荡主链数据源 + 新手引导 dismiss + 类型契约收口 | 6.30 闯荡 hotfix / 7.13 Q3A / 7.13 Q3B-Q4 | | src/components/OnboardingCoach.tsx | hook 次序风险收掉 | 6.30 onboarding stability | | src/components/RoomCard.tsx | 视觉对照调整(不撞 props 签名) | 7.16 R10 联机 UI 集成(partial) | | src/components/StoryTrackingCard.tsx | 玩家可见开发者字段泄漏净化 | 7.15 R12 剧情追踪净化 | | src/data/year1Plan.ts | 文案污染净化(itemLine 字段调整) | 7.15 R12 剧情追踪净化 | | src/data/items/index.ts | 三层架构拆层(数据层清空运行时) | 7.03 item-data-runtime-layer-truth | | src/data/items/*.ts(多个) | 装备模型补 4 字段 + 16 件装备全填 | 7.13 T3 装备模型 | | src/utils/items/equipmentLogic.ts | 装备生成 + 词条 roll 逻辑 | 7.13 T3 装备模型 | | src/utils/items/rollEquipment.ts | 新增 rollEquipment 工具 + 46 组单元测试 | 7.10 phase1-roll-regression | | src/utils/multiplayer/timeout.ts | 5s 流拍 + 断线重连 + 房主转移 | 7.15 R8 P2P timeout | | src/data/storyEvents/oldLedger.ts | 旧账风波期 8-12 节点数据 | 7.13 R13 旧账风波节点 | | src/data/auction/contentTables.ts | 21 条类型错误清零 | 7.13 W30-Q2 | | src/endgame/(多个) | 跨周目 v1.1 锚点 + 折算函数 | 7.12 R14 + 7.13 R14 |

改动文件总数:14 个核心文件 + 若干数据/工具文件

E. 任务卡覆盖度

22 天共 72 个任务卡
✅ verified:66 个(92%)
⏳ active / summarized / pending:6 个(8%)
❌ failed:0 个

F. 关联公告

6.25-6.26 玩法迭代整合公告:docs/handoff/CHANGELOG-2026-06-25-26-玩法迭代与日计划-整合公告.md
6.28-7.18 内部更新公告:docs/handoff/CHANGELOG-2026-06-28-07-18-更新公告.md
本公告(对外):docs/handoff/武林更新公告-v1.18.0-2026-07-18.md

G. 待 P1 拍板事项(不阻塞发布)

是否同意 SAVE_SCHEMA_VERSION 升级为 v1.10(T3 装备模型必须)
月 20 真值是否进 v1.18.0 一并发布(建议并)
R10 联机 UI 集成 residual risk 是否在玩家公告里公开(已公开)
多 owner 长工机制是否作为正式 P1 决议(建议 W30 之后回看)
docs/登录流程.md + .html 双份去留(不影响本公告)

武林周报 · 第 22 卷 · 完

七侠镇刊印 · 丙午年 · 客官请进