📚 知识库增量盘点 · 2026-07-27 → 2026-07-29 · H31 续
盘点时间：2026 年 7 月 29 日 10:30 (CST) 范围:
v1.19.0 发布说明(7/28)+ 7/28 美术生图清单 生成方式:scripts/docs-to-html/build.py全量重建docs-site/本卷新增:2 篇公开文档(累计 235 篇) 上一卷:2026-07-27-知识库增量盘点-v1(覆盖 7/20 → 7/27,52 篇净增)
一、一句话总结
v1.19.0 发布:第一年主线 + 厨房 + 骰坊 + 后院 + 剧情语音,5 个玩家可感知系统一次性收口。
本次发布 commit
da1aa8f共 458 文件 / 21,029 行新增 / 2,480 行删除,主分支main已 aheadorigin/main2 个 commit(v1.18.0 + v1.19.0)。知识库侧只新增 2 篇公开文档(v1.19.0 发布说明 + 7/28 美术生图清单),但背后是近 150 个 src 文件的实质性推进。
二、新入知识库的 2 篇
📜 1. 《同福客栈》v1.19.0 发布说明 · 7/28
主题:第一年体验收束与经营玩法补全
路径:docs/release-notes/v1.19.0.md(已落入 docs-site/docs/release-notes/v1.19.0.html)
玩家可见更新(原文照录):
- 第一年关键剧情接入完整场景表现 / 选择结果反馈 / 年度复盘 / 年终结算流程。第 360 天按既定顺序完成年度收束,不再停在半成品页面
- 第一年 28 张剧情场景图接入运行时,覆盖月度关键节点 + 年终场景
- 剧情对白语音接入运行时资源,完成格式 / 响度 / 资源引用 / 自动回归检查
- 七侠骰坊补齐可玩的投掷 / 结算 / 存档流程
- 厨房补齐炉灶 / 季节菜 / 宴席组合 / 经营增益逻辑
- 闯荡奖励与经验结算完成补强
- 后院新增 4 层景物表现(落叶 / 井波 / 风铃 / 月光)
工程收口:
- 第一年剧情 / 结果反馈 / 年度复盘 / 胜负终局 / 存档恢复已纳入自动回归
- 关系系统 R-1 本轮只交付三层架构下的数据契约 + 静态表,并修正数据层中的运行时构造逻辑 — 尚未形成玩家可操作的关系系统,本卷不作为已上线玩法宣传
- App 版本:
1.19.0· 路线图:0.10.2· 存档结构:2.1
验证状态与已知限制:
- 第一年 260 条语音资源已完成技术验证,共约 27 分钟;仍需人工逐条试听确认 → 当前状态是"技术验证通过,听感验收待完成",不是最终听感验收通过
- 生产构建仍会报告主入口 JS 体积较大警告(当前 ~2.48 MB);不影响本次部署,但后续要按功能域拆包
- 构建中 5 个 UI slice 路径由运行时解析,Vite 会保留对应提示;线上资源与核心页面需在部署后继续 HTTP + 浏览器复核
发布门禁:
- TypeScript 检查:通过
- 生产构建:通过
- 第一年回归:100/100
- W29 回归:47/47
- 闯荡回归:29/29
- 厨房回归:15/15
- 骰坊专项回归:20/20
🎨 2. 2026-07-28 素材生图清单与 Prompt v1 · 7/28
路径:docs/art/2026-07-28-today-asset-generation-prompts-v1.md
状态标注:prompt-ready / generation-partial / runtime-not-integrated
今日结论(只 2 次生图):
- 郭芙蓉动作图:补 1 张
胜利收势(pic/擂台赛/胜利收势.png) - Year 1 年终场景:生成 1 张
2x2四宫格,覆盖 Day 330 / 350 / 355 / 360
月 2-10 的 24 张场景已存在于运行时目录,后院 M1 拍板为零美术排期,均不进入今天的生图清单。
注意:郭芙蓉动作源图均无 alpha;绿幕抠除、边缘去绿、透明角检查完成前,状态只能写
generated,不能写runtime-ready。
三、commit da1aa8f 速览(开发者)
主题:
feat(release): ship year one closeout and gameplay updates· 7/28 11:45458 files / 21,029 insertions(+) / 2,480 deletions(-)
3.1 新增 / 调整的领域(目录)
| 目录 | 状态 | 说明 |
| --- | --- | --- |
| src/components/account/ | 新建 | 账户面板重构 |
| src/components/adventure/ | 新建 | 闯荡 |
| src/components/dice-game/ | 新建 | 七侠骰坊 UI |
| src/components/fx/ | 新建 | 特效 |
| src/components/ledger/ | 强化 | 账本(失败 / 风险 / 人类内容 / 标题 / 指标 / 建议) |
| src/components/story/{StoryChoiceOutcome, StoryShowcaseVisual, Year1RecordingMode}.tsx | 新建 | 剧情新组件 |
| src/data/audio/year1Voice.ts | 新建 | Year 1 语音配置 |
| src/data/diceGame/{config, index, types}.ts | 新建 | 七侠骰坊数据层 |
| src/data/kitchen/{comboRecipes, seasonalBanquets, seasonalDishes, stove}.ts | 新建 | 厨房数据 |
| src/data/relations/{bondExtensions, favorDefaults, favorPerks, favorStages, index, relationTables, types}.ts | 新建 | 关系系统 R-1 数据契约(backlog) |
| src/data/storyEvents/{month1Showcase, year1Presentation, year1Recording, year1Review}.ts + year1Showcase/ | 新建 / 重组 | Year 1 剧情事件 |
| src/utils/adventure/{experienceLogic, rewardLogic}.ts | 新建 | 闯荡逻辑 |
| src/utils/diceGame/ | 新建 | 七侠骰坊逻辑 |
| src/utils/kitchen/{seasonalBanquetLogic, seasonalDishLogic, stoveLogic}.ts | 新建 | 厨房逻辑 |
| src/utils/playthroughSlotDisplayLogic.ts | 新建 | 周目槽位显示 |
| src/utils/saveVersioning.diceGame.regression.ts | 新建 | 骰坊存档回归 |
| public/audio/voice/year1/{manifest.json, NOTICE.md} + 260 .ogg | 新建 | Year 1 语音资源包(技术验证通过,听感待人工) |
3.2 删除 / 迁移
| 旧位置 | 新位置 |
| --- | --- |
| src/components/story/Month1ChoiceOutcome.tsx | src/components/story/StoryChoiceOutcome.tsx |
| src/components/story/Month1ShowcaseVisual.tsx | src/components/story/StoryShowcaseVisual.tsx |
| src/data/storyEvents/month1Showcase.ts | src/data/storyEvents/year1Showcase/ |
| src/utils/staff/bondPresentationLogic.ts | src/data/relations/ |
| src/utils/storyEvents/month1ShowcaseLogic.ts | src/utils/storyEvents/year1ShowcaseLogic.ts |
3.3 App.tsx 拆控制器(本卷 H30-H31 连续 refactor)
src/components/app/useInnResourceController.ts— 资源src/components/app/useInnSimulationController.ts— 模拟src/components/app/useSaveRestoreController.ts— 存档src/components/app/SystemOverlayLayer.tsx— 弹层src/components/welcome/useWelcomeFlowController.ts— 启动src/components/endgame/useEndgameFlowController.ts— 终局src/components/multiplayer/(commite5d382c) — 联机
按生命周期把"主厅 → 各子系统 → 弹层"拆开。
四、按知识库分类(7 个分类,235 篇)
| 分类 | 总量 | 上卷(7/27) | 本卷净增 |
| --- | --- | --- | --- |
| design 玩法设计 | 101 MD + 2 HTML | 101 | 0 |
| story 剧情角色 | 66 MD + 2 HTML | 66 | 0 |
| art 美术 | 24 MD + 4 HTML | 23 | +1 |
| topics 专题 | 12 MD + 4 HTML | 12 | 0 |
| specs 规范 | 9 MD | 9 | 0 |
| release-notes 发布公告 | 4 MD | 3 | +1 |
| tools 工具 | 0 MD + 7 HTML | 0 + 7 | 0 |
净增 2 篇,但背后是 458 文件 / 21k 行的代码收口 — 玩家可感知更新主要通过运行时呈现,不是文档。
五、working tree 未提交状态(7/29 10:30)
- 修改(M)未提交:164 文件
- 公开分类(
design/story/art/tools/specs/release-notes/...)中的未提交修改:仅 1 个未追踪新文件docs/art/2026-07-28-today-asset-generation-prompts-v1.md(已纳入本卷)
- 其余 ~163 个 M 主要是
handoff/plans/story/中已 commit 文档的"工作区被触碰"状态,无新增公开内容 - 下一个 commit 时建议
git add -u处理掉已追踪的 M,然后单独 review 新文件
六、本卷没有做的事(留待下卷)
- 260 条 Year 1 语音人工听感验收 — 技术验证通过,听感待 P1 拍板进入人工逐条试听流程
- 关系系统 R-1 玩家可操作层 — 本卷只交付数据契约 + 静态表;运行时构造逻辑已修正但未形成玩法
- 主入口 JS 体积 2.48 MB — Vite 拆包,不影响部署但需要做
- 5 个 UI slice 路径 — Vite 提示保留,部署后 HTTP + 浏览器复核
scripts/docs-to-html/check.py180-200 上限(上卷已提)— 本周净增后 235 篇,断言仍会失败,需要按新基准放宽
七、变更管理
- 本盘点是 release-notes 分类下第 5 篇(继
WIKI-部署指南v1.18.0v1.19.02026-07-27-知识库增量盘点-v1之后) - 命名约定:
YYYY-MM-DD-知识库增量盘点-v{N}.md,N 是自 v1.18.0 起的卷号 - v1.18.0 与 v1.19.0 不删,作为官方发布快照留存
- 上一卷(v1)内容已稳定,无需合并
武林周报 · 知识库专刊 · H31 续卷 · 完
七侠镇刊印 · 丙午年 · 客官请进