📚 知识库增量盘点 · 2026-07-20 → 2026-07-27 · H30 → H31
盘点时间：2026 年 7 月 27 日 19:23 (CST) 范围：
docs/公开目录在 v1.18.0(7/20)发布之后到当前(7/27)的全部新增/修改 生成方式：scripts/docs-to-html/build.py全量重建docs-site/,同时check.py校验 本卷收录:52 篇新公开文档(7/20: 9 / 7/23: 8 / 7/24: 5 / 7/25: 20 / 7/27: 10)
一、一句话总结
一周时间,Year 1 从"剧本完成"推进到"主链打磨 + 收口链"。
12 份对白稿(对白稿 v1)+ 12 份节气增强版(月度剧情叙事)全部落盘;Day 355-360 年终链 (C4) 切片就位;后院 M1 / 七侠骰坊 / 关键节点评分 / 因果矩阵 / 模块打磨总纲 — 5 张新切片把"Year 1 最后一公里"拆清楚。知识库现在有 232 个公开页,比上卷(7/20)净增 52 篇。
二、按主题分类(玩家/策划视角)
1. 🎬 第一年主线对白与节气叙事(本月最大宗)
剧本对白稿 v1(12 份) — 月 01 到月 12 全量就位,每份是 30 天一卷的确定性剧情锚点:
月01:开张适应期·月02:街坊熟络期·月03:初遇挑战期·月04:扩建起步期·月05:江湖初闻期·月06:盛夏经营期·月07:羁绊萌芽期·月08:擂台预热期·月09:大日子逼近期·月12:岁末收束期- 触发规则:
第一年剧情对白玩法与触发规则-v1定义"经营中的确定性剧情锚点" — 玩家正常经营推进时间,到日 / 时段后主线对白稳定出现,选择会改资源 / 员工 / 羁绊 / 旗标,但不会因为随机数把年线节点永久抽丢 - 总纲:
第一年主线剧情对白总纲-v1把 12 份节气增强月本的主题 / 日期 / 场景 / 角色关系 / 选择方向全部串成一张表
节气增强版(按月本节气补叙事层):
- 已落地:月 01 / 02 / 03 / 04 / 06 / 07 / 09 / 12(8 份),覆盖第 1-30 / 31-60 / 61-90 / 91-120 / 151-180 / 181-210 / 241-270 / 331-360 天
2. 🔧 Year 1 最后一公里 — 实施切片(7/27 新出 5 张)
| 切片 | 干什么的 |
| --- | --- |
| 第一年功能模块打磨总纲-v1 | 定调:Year 1 已不是"内容没做完",而是"主体可玩,最后一公里尚未统一验收"。下一阶段不扩事件、不新建系统,只把开业 → 跨年这条链打磨完整 |
| 第一年关键节点体验评分-v1 | 短中期实现链:C4 年终链 → 四张岁末图 → 年度摘要派生 → 四条正常路径验收 |
| 第一年关键选择因果矩阵-v1 | 把"承诺守住规模"vs"承诺关系/口碑优先"这种已定义但没进终局摘要的差异落表 |
| 第一年 C4 年终链实施切片-v1 | C4 只把 Day 355 来年方针、Day 360 跨年落款、岁末胜负结论收成玩家可读摘要;不改变事件顺序 / 四维阈值 / 存档结构 / 第二年内容 |
| 第一年关键选择因果矩阵-v1 | 同上,已记录差异的进终局摘要链路 |
3. 🏡 后院补全(2 张)
| 文档 | 干什么 |
| --- | --- |
| 后院玩法补全方案-v1 | 玩家视角后院 tab 只有 4 件事:看柴水储量、点劈柴按钮、点汲水按钮、把员工调去劈柴/挑水/大堂 |
| 后院 M1 施工切片-v1 | M1 最小可玩版本施工蓝图,严格走三层架构(数据 / 逻辑 / UI) |
| 最近 commit:feat(backyard): add 4 scenery layers (leaf / well ripple / wind chime / moon) — 后院已加 4 层背景层(落叶 / 井波 / 风铃 / 月光) |
4. 🎲 七侠骰坊(2 张 + 1 经济报告)
| 文档 | 干什么 |
| --- | --- |
| 《七侠骰坊》实施切片-v1.2 | 切片 v1.2,目标:"缺钱时有活路,富裕时可冒险" |
| 七侠骰坊概率与经济报告-v1 | 跑 docs/economy-sim/dice-game-sim.ts 出的概率/经济数据 |
| 代码:src/data/diceGame/ + src/components/dice-game/ + src/utils/diceGame/ 已建 |
| 已挂 save versioning:src/utils/saveVersioning.diceGame.regression.ts |
5. 💕 角色羁绊与好感度系统设计
design/backlog/gameplay/角色羁绊与好感度系统设计-v1.md把"挂机经营里跟这群人混熟不熟"做成一组长期可感知、可积累、可作用玩法的关系层。这是 backlog(未排进本周),但本卷先把设计落盘。
6. 🎨 美术资产 — Year 1 月 2-10 场景
2026-07-27-year1-month02-10-scene-intake-v1:24 个目标文件全部由tools/assets/split-year1-showcase-scenes.js一次性产出- 上卷已有:月 02-12 场景生成 kit + 缺失清单 v2 + 缺失批量 prompts
7. 📈 经济模拟与验收
七侠骰坊概率与经济报告-v1(见上)2026-07-24-year1-360day-balance-report-v1:Year 1 360 天平衡跑出来的报告
8. 🗺️ 执行计划
2026-07-27-Year1产品体验打磨执行计划-v1:本卷(7/27 起)的执行计划
三、按知识库分类(7 个分类,232 篇总量)
| 分类 | 总量 | 上卷(7/20) | 本卷净增 | 备注 |
| --- | --- | --- | --- | --- |
| design 玩法设计 | 101 MD + 2 HTML | ~80 | +21 | 大头来自 Year 1 切片 + 后院 + 骰坊 + 羁绊 |
| story 剧情角色 | 66 MD + 2 HTML | ~36 | +30 | 12 份对白稿 + 8 份节气增强版 + 总纲 + 触发规则 |
| art 美术 | 23 MD + 4 HTML | ~13 | +10 | 月 2-10 场景 + 缺失清单 v2 + 生成 kit |
| topics 专题 | 12 MD + 4 HTML | ~6 | +6 | economy-sim + uirefactor |
| specs 规范 | 9 MD | ~9 | 0 | 稳定 |
| release-notes 发布公告 | 2 MD | 1 | +1 | 本卷新出:2026-07-27-知识库增量盘点-v1.md |
| tools 工具 | 0 MD + 7 HTML | 7 HTML | 0 | HTML 工具集,稳定 |
注:
handoff/plans/daily-plans/reviews/不进公开站(内部协作文档),但docs-site/raw/留原档以供回溯。
标签云(Top 10)
| 标签 | 文档数 | | --- | --- | | 玩法设计 | 141 | | 剧情 | 127 | | Buff | 97 | | 界面 | 91 | | 终局 | 77 | | 时间 | 79 | | 主线 | 63 | | 装备 | 53 | | 美术 | 40 | | 规范 | 34 |
四、代码侧本周改动(developer 速览)
数据来源:
git log --since="14 days ago"14 个 commit + working tree 100+ 改动文件本节给开发者,玩家可跳。
4.1 主要 commit(7/13 → 7/27)
| Commit | 主题 |
| --- | --- |
| 139b9cb | feat(backyard): add 4 scenery layers |
| 235c0ef | chore: organize project maintenance tools |
| 70c347f | docs: consolidate gameplay plans and showcase evidence |
| c534c5c | feat: complete story and adventure gameplay loops |
| c00da2d | docs: add canonical year1 dialogue design and scripts |
| e2fcc84 | feat: integrate story and gameplay runtime systems |
| 8c35732 | fix: restore landing video for balanced graphics |
| 9d0af08 | feat: expand progression and item gameplay systems |
| 1fd565a | refactor: extract inn simulation controller |
| 1ac145a | refactor: extract inn operations controllers |
| e5d382c | refactor: extract multiplayer flow controller |
| aed06ad | refactor: extract endgame flow controller |
| 1f0a926 | refactor: split welcome flow and app overlays |
| acdff5c | feat: checkpoint gameplay and UI before App split |
| 09a2903 | feat: complete W29 closeout and X1 follow-up lanes |
4.2 新增模块(目录)
src/components/account/(账户面板重构)src/components/adventure/(闯荡)src/components/dice-game/(七侠骰坊)src/components/fx/(特效)src/components/story/{StoryChoiceOutcome, StoryShowcaseVisual, Year1RecordingMode}.tsx(剧情新组件)src/data/account/achievementGroups.tssrc/data/adventure/rewards.tssrc/data/audio/(音频数据层)src/data/diceGame/src/data/kitchen/{comboRecipes, seasonalBanquets, seasonalDishes, stove}.tssrc/data/relations/(新关系数据)src/data/storyEvents/year1{Presentation, Recording, Review, Showcase/}.tssrc/utils/adventure/{experienceLogic, rewardLogic}.tssrc/utils/diceGame/src/utils/kitchen/{seasonalBanquetLogic, seasonalDishLogic, stoveLogic}.ts
4.3 删除模块(已被新切片吸收)
src/components/story/Month1ChoiceOutcome.tsx→ 迁到StoryChoiceOutcome.tsxsrc/components/story/Month1ShowcaseVisual.tsx→ 迁到StoryShowcaseVisual.tsxsrc/data/storyEvents/month1Showcase.ts→ 迁到year1Showcase/src/utils/staff/bondPresentationLogic.ts→ 迁到relations/src/utils/storyEvents/month1ShowcaseLogic.ts→ 迁到year1ShowcaseLogic.ts
4.4 重点重构
App.tsx拆控制器:useInnResourceController/useInnSimulationController/useSaveRestoreController/useEndgameFlowController/useWelcomeFlowController- 这些都是 H30 末期 + H31 初的连续 refactor,把"主厅 → 各子系统 → 弹层"按生命周期拆开
五、本卷没有做的事(留待下卷)
- 月 20 真值建立 (Year 2 第 571-600 天,六锚点) — 7/27 dispatch 已派工,等 7/27-relations-r1-data-contract 收口
- 联机 P2P 真实网络测试 — v1.18.0 留的 residual,跨设备/异地场景还没跑
scripts/docs-to-html/check.py公开页数 180-200 上限 — 本周净增 52 篇后,公开页到 232。check 会断言失败,需要按真实新基准放宽(check 本身是 QA 工具,不是构建门)- Year 1 C4 年终链验收 4 条正常路径 — 切片已就位,验收留 W31
- 后院 M1 实施 — 切片已出,代码落点待开工
六、变更管理
- 本盘点 doc 是 release-notes 分类下第 3 篇(继
v1.18.0WIKI-部署指南之后) - 下次
build.py跑后,本篇会自动出现在docs-site/docs/release-notes/2026-07-27-知识库增量盘点-v1.html - 老 v1.18.0 不删,留作"6.28-7.18 历史快照"
武林周报 · 知识库专刊 · H31 卷 · 完
七侠镇刊印 · 丙午年 · 客官请进