Daily Build 更新
按日期记录开发分支的更新，日期采用 UTC；尚未合入的试做内容单独标注。以下为每日开发更新记录，尚未提供独立 Release 下载包。各日期描述当时的变更，当前规则见系统一览。
2026.09.24
已合入游戏开发分支 · 404 序章与任务引导
游戏 PR #111 已合入 dev，对应提交 469e096。从 404 开始的新时间线加入可玩的入住序章，再衔接已有的消磁门牌入门调查。
| 类型 | 更新 | 说明 |
|---|---|---|
| 剧情 | 404 入住序章 | 依次完成移动、与 N-07 交互、确认遗留物处理规则、确认入住通知和离开 404 五个步骤；门外的金属声引出后续调查。 |
| 引导 | 默认任务标记 | 根据当前任务目标推导金色 ! / ? 标记；目标在其他房间时先指向出口，前往指定房间的步骤也可获得路线指引。 |
| 交互 | 对话选项任务图标 | 能推进当前任务步骤的对话选项右侧显示黄色任务图标，让场景中的指引延续到具体选项。 |
实现边界：本轮接入序章与已有 S01 入门调查的衔接，不代表文档中的 S01 扩展调查、完整证据链和三权登记均已实装。体验新增剧情需开启新时间线；旧存档保留创建时嵌入的内容配置。
已合入游戏开发分支 · 广场物件与五间黑框房间
以下美术与布局更新已合入游戏 dev，本日记录截至提交 0bd1cd8。
| 类型 | 更新 | 说明 |
|---|---|---|
| 美术 | 广场新增三件独立资产 | 下层回廊接入庭院树、集市摊位和门边盆栽组，补充场景布置；九角色试放属于前一日更新。PR #105。 |
| 美术 | 四间房切换黑框背景 | Rook 的账房、花园维护层密室、归零等候区与合约咨询室同步更新背景、布局和运行地图。PR #106、#107、#108、#109。 |
| 美术 | 余烬公开赌桌大厅黑框版 | 保留四个出口与固定舞台，调整西侧返回通道，拉直边框并去除装饰造成的轮廓凸起。PR #114。 |
| 工具 | 色键去背流程同步主线 | 资产制作规范统一纯色底生成、全图色键去背与边缘去色污染流程。PR #104。 |
进度口径：截至上述游戏提交，26 间房中 17 间使用黑框背景、9 间使用普通背景。黑框接入不等于独立家具装修或逐房间通行验收完成。
已合入文档开发分支 · 序章卡片与房间快照
文档 PR #30、#32、#33、#35 已合入 dev。
- 主线任务卡新增 S01 扩展版与独立的 404 序章卡片，沿用 Writer / Coder 双视图；序章文案收敛为入住确认、基础操作和遗留物处理规则。
- S01 扩展卡描述更完整的调查、证据与权利登记设计；卡片状态不等同于游戏功能已完成，序章卡仍标记为
proposal。 - 房间布局对照快照更新到游戏
9b96c9d，包含广场三件新物件和本轮前四间黑框房间，黑框数量由 12 间增至 16 间。
快照差异：文档房间页固定为 16 间黑框、10 间普通背景，尚未包含随后合入的余烬公开赌桌大厅；游戏本日最新进度为 17 间黑框。房间页不会自动追随游戏分支。
已合入酒馆实验分支 · 小酒桌与座位交互
游戏 PR #110、#112 已合入 experiment/tavern-agentic，对应提交 cae0c38；以下不属于主线 dev 更新。
| 类型 | 更新 | 说明 |
|---|---|---|
| 场景 | 两张小酒桌与侧向座位 | 休息室接入小酒桌和配套座位，调整家具锚点、碰撞范围、座位交互区域与玩家坐姿对齐。 |
| 交互 | 单一近邻交互目标 | 多个交互范围重叠时，只选择最近的一个目标进行高亮和响应 E 键，减少同时出现多个交互提示的情况。 |
| 工具 | 家具坐姿静态预览 | 从场景、地图配置和正式 PNG 生成坐姿对照，可查看座位相对位置与碰撞覆盖；静态预览不代替游戏内通行和交互验收。 |
验证范围：本条依据已合入提交及相关剧情、任务引导、地图和文档配置整理；本次日报未新增测试、构建、浏览器试玩或部署核验。以上为开发进展，不代表发布独立 Release 下载包。
2026.09.23
已合入游戏开发分支 · 广场角色试放
游戏 PR #103 已合入 dev，对应提交 92d5162。从 404 出门后的下层回廊广场可以查看新角色的实际尺寸与动作；这次是场景试放，不代表新增角色剧情或 Agent 自主行为已经接入。
| 类型 | 更新 | 说明 |
|---|---|---|
| 美术 | 九个角色集中试放 | Alice、Alex、Bob、Lucky、Pete、Kurt、莉奈、老板娘与 Player 展示角色加入广场，原有可操控主角保持不变。 |
| 动画 | 四向待机与行走 | NPC 根据朝向和移动状态选择真实动画帧；修正 Alice 行走错误引用待机帧导致只平移的问题，前后方向与图集命名对齐。 |
| 交互 | 每人走一圈 | 靠近角色后可查看动画素材，并选择沿短路线走一圈、回到原位；路线避开门口和其他角色的初始占位。 |
| 调整 | 角色体量与预览入口 | 缩小初版过大的角色显示，Player 展示角色再单独放大至 51×82，其余为 45×72；移除“四向站立／移动动画（素材缺失）”占位按钮。 |
存档提示：使用游戏 dev 的本地入口，开启新时间线后从 404 出门；旧存档继续保留创建时嵌入的场景与角色配置。
已合入文档开发分支 · 房间对照与进度速览
文档 PR #26、PR #27 已合入 dev，新增房间布局对照与总进度。
| 类型 | 更新 | 说明 |
|---|---|---|
| 工具 | 每间房最多四图对照 | 对照原始完整 PNG、普通空背景、黑框空背景，以及当前拼装布局；未收录的版本明确标注，不把候选素材当成运行中版本。 |
| 工具 | 自动绘制拼装布局 | 浏览器按游戏快照中的地图和场景实体绘制背景、物件、可交互家具与门，无需手工截图；支持缩放和 NPC 初始站姿显隐。 |
| 进度 | 26 间房快速总览 | 当前快照中原始 PNG 为 26/26，12 间使用黑框、14 间使用普通背景；6 间已接入独立物件，总计 175 件。状态表可选择房间查看详细对照。 |
| 版本 | 固定数据来源 | 图片与布局固定到游戏提交 92d5162，保留来源和图片校验值，图片地址携带提交号；数据更新需重新导出，不会自动追随游戏最新分支。 |
进度口径：这些数字反映快照中已收录、已接入的内容，不是今天新增的房间或家具数量，也不是房间装修完成百分比。已有黑框背景或独立物件不等于布局已经验收；尚无独立物件的房间明确列为待接入。
已合入文档 · 31 张主线任务提案
文档 PR #28 已合入 dev，将新版主线任务卡 扩展为 S01–S31 共 31 张独立 YAML 卡片，沿用 Writer / Coder 双视图。
- 每张卡围绕接触、实物、缓存、证词、404／N-07 重建与三权登记组织六个阶段，补充材料来源、证据替代与任务完成边界。
- 主线总览补充多任务并行、共享证据只读引用、NPC 总状态与任务标记分离，以及行为信号的记录边界。
- 卡片仍为
proposal，不是 31 条已可玩的任务。阶段串联与材料任意顺序取得的表达、权利主张人、共享来源 ID 和运行时字段仍待叙事与工程评审。
验证范围：角色接入阶段完成房间导出与路线、行走帧引用核对，最终九角色版本未进行完整游戏测试或逐角色步态验收；房间总览 PR 的文档构建通过。任务卡 PR 记录 31 份 YAML 解析通过、同步最新 dev 前构建通过，同步后未重跑。本次日报依据合入记录与对应文件整理，未新增测试、构建、浏览器验收或部署核验；以上合入不代表发布独立 Release 下载包。
2026.09.22
已合入酒馆实验分支
以下内容已合入游戏 experiment/tavern-agentic（PR #89、#90、#91），对应游戏代码提交 3ac2036；不属于主线 dev 更新，也不代表已发布独立正式版本。
| 类型 | 更新 | 说明 |
|---|---|---|
| 场景 | 休息室独立家具 | Embers Lounge 接入黑框房间背景、吧台、牌桌、沙发、地毯与酒瓶等独立资产，同步调整家具布局、占位与通行区域。 |
| 功能 | 七个可用座位 | 配置 3 个吧台座位与 4 个牌桌座位，接入对应朝向的玩家坐姿；吧台座位统一朝向柜台。 |
| 修复 | 座椅比例与遮挡 | 统一四向牌桌椅的显示比例，调整人物、椅子与牌桌的图层关系；朝北座椅拆分座面与前景，保留坐下后的椅背遮挡。 |
| 功能 | 老板娘四向动画 | 绯月预览素材补齐四向待机与行走，人物显示随朝向和移动状态切换；缺少方向动画的旧素材仍回退到原有待机动画。 |
| 交互 | 休息室行走演示 | 老板娘预览先在 404 接入，随后迁入休息室吧台内侧；选择“走一圈给我看看”可观看沿柜台内侧往返的行走演示。动画预览面板按实际素材显示缺失提示。 |
| 工具 | 统一色键去背流程 | 资产制作统一为纯色底生成、全图色键去背、边缘去色污染与深浅底验收；按主体选择底色，覆盖封闭镂空，图像服务配置与聊天模型配置分离。 |
当前边界：本轮重点是休息室场景、座位交互与角色动画演示，不代表已完成牌桌游戏、酒水服务或 NPC Agent 自主行为；本地未提交的预览素材与代码调整不计入本次记录。
验证范围：本条记录依据已合入提交及场景、剧情配置核对；本次整理未运行游戏测试、构建、浏览器试玩或文档站构建，也未核验部署状态。
2026.09.21
已合入开发分支
以下内容已合入游戏 dev（PR #86、#87、#88）；这不代表已发布独立正式版本。
| 类型 | 更新 | 说明 |
|---|---|---|
| 功能 | 手动存档 | 设置菜单新增“立即存档”，可主动保存当前进度，自动存档继续保留；没有新进度时不重复生成存档，回放期间不可手动保存。 |
| 调整 | 主线聚焦房间探索 | 从主线移除酒馆内容包及餐饮、演出、教学系统，继续保留房间探索、S01 调查、基础任务、物品与经济能力。 |
| 开发 | 酒馆实验独立维护 | 酒馆代码与素材保留在 experiment/tavern-agentic，后续 NPC Agent 与酒馆玩法在实验分支探索，不默认合回主线。 |
| 调整 | 调试入口收敛 | 移除时间调速面板；保留反引号打开的开发控制台，目前仅提供 help。 |
| 限制 | 暂停调试传送 | 发现 tp 可能导致存档回放分歧后，先移除控制台传送入口；待 agentic 合入、录制方案确定后再考虑恢复，不继续扩展当前录制逻辑。 |
验证范围：主线清理阶段的类型检查通过，提交时完成暂存文件格式化。手动存档补充了回归用例，但尚未执行；最新整合版本未进行完整测试、构建或浏览器试玩。
存档提示：房间存档继续保留。主线不再提供旧酒馆存档的导入与续玩，也不会主动删除旧酒馆数据；体验酒馆请使用实验分支。本次暂停 tp 不会修复已包含传送记录的问题存档。
2026.09.20
已合入开发分支
以下内容已合入 docs dev，对应提交 21c3f3b（PR #19）；这不代表已发布独立正式版本。
| 类型 | 更新 | 说明 |
|---|---|---|
| 工具 | Agent 任务卡标准 | 为编剧 Agent 固定任务级触发条件、地点、前置、实体、阶段动作、成功条件、效果和中断边界；时间只作为任务触发条件，不要求编写分钟级阶段时间轴。 |
| 工具 | Writer / Coder 双视图 | 同一份 YAML 可切换为剧本可读的 Writer view，或保留实体 ID、条件和效果的 Coder view；旁白、玩家和 NPC 使用友好显示名。 |
| 工具 | 阶段卡片浏览 | 一个任务由多个阶段卡组成，可点击阶段或使用上一阶段／下一阶段翻页；页面显示触发时间、地点、前置和任务完成结果。 |
| 文档 | 公共任务卡页面 | 在 docs site 增加剧本任务卡标准，并从导航与侧栏进入；游戏仓库模板指向公共标准。 |
验证范围：任务卡示例 YAML 解析通过，VitePress 构建通过；预览页面已生成 Writer / Coder 切换和阶段翻页。未运行完整站点浏览器验收。
待合入 · 剧本卡片迁移
PR #21 将旧版表格时间线转换为新的卡片式剧本：
| 内容包 | 更新 | 说明 |
|---|---|---|
tavern | 酒馆任务卡 | 将移动教学、帮工、客房、结识诗人、学琴和两条遗物线索拆成 7 张 Writer / Coder 任务卡。 |
remaining-time | S01 主线卡 | 将“消磁门牌：入门调查”整理为从观察、取证、核对到暂存的六阶段主线卡。 |
TBD | 后续范围 | S01 后续、Eden 的所有权与许可、赌坊线和其他未确认剧情继续标记为待敲定。 |
2026.09.18
S01 章节阶段性搭建
本日完成“消磁门牌”入门调查的章节骨架和首轮场景接入；当时仍是阶段性试做，最终可玩收尾在 9 月 20 日合入。
| 类型 | 更新 | 说明 |
|---|---|---|
| 剧情 | S01 任务骨架 | 将 404 号舱与下层回廊组织成一次短调查：查看 317 门牌、询问 Ash、阅读旧记录、请 N-07 核对，再把门牌放入 404 柜中暂存。 |
| 编剧 | 可交付阶段卡 | 明确任务起因、人物事实边界、玩家可见背景、阶段条件、对白意图、物件去向和未决设定，作为后续实现依据。 |
| 场景 | 317 门牌接入 | 生成并放置独立门牌素材，先完成回廊墙面位置与交互空间的核对。 |
| 结构 | 调查顺序 | 查看门牌、询问 Ash、阅读旧记录三个调查入口允许顺序不限；材料齐备后才进入身份核对与暂存。 |
当日边界：章节仍处于设计与实现衔接阶段，台词和交互尚未作为完整 S01 正式收尾；后续补齐可玩流程、物件转移、阶段指引、存档恢复与回放检查，并在 9 月 20 日合入当前开发分支。
2026.09.17
已合入开发分支
以下内容已合入 dev，对应游戏代码提交 fd06e63；这不代表已发布独立正式版本。
| 类型 | 更新 | 说明 |
|---|---|---|
| 功能 | 从 404 号舱开始探索 | 默认本地入口切换至 404 号舱，接通 26 个房间与 27 对双向连接，可在房间之间往返。 |
| 美术 | 独立家具与布局 | 404 接入 20 件可独立摆放的家具和小物；保留房间空背景与原始布局，便于继续布置内饰。家具目前提供显示与占地，尚未接入开柜、坐下或睡眠等交互。 |
| 美术 | 房间人物与玩家外观 | 导入 29 套 NPC 素材，在 14 个房间放置 32 个驻留实例；NPC 当前显示待机首帧。玩家接入四方向待机、行走与冲刺显示，房间 NPC 的动画播放和剧情交谈仍待接入。 |
| 修复 | 人物占位对齐 | 调整 NPC 脚点与实际占用位置，减少视觉位置和阻挡位置不一致的情况。 |
| 功能 | 独立传送物件 | 入口提示、触发范围和返回位置可单独调整；已处理部分门内触发、台阶通道及公共厨房出口宽度。 |
| 修复 | 连续自动存档 | 录制缓冲达到容量上限时直接保存已有事件，不再必须凑满 1000 个事件；写入成功后继续录制，写入失败保留内存进度。 |
| 保留 | 酒馆入口与存档 | 原酒馆通过 just dev-tavern 继续访问；房间地图与酒馆分别保存进度。 |
| 后续 | 逐图校准传送点 | 全地图入口的视觉位置、通行宽度和返回落点已列入 Roadmap，后续结合实机反馈逐图调整。 |
本地试做 · 尚未合入
404 新增黑框室内候选：保留北侧背墙和独立家具，将侧墙与前墙改为房间边界，门口留出通道。墙沿加入细描边、灰绿截面与柔和阴影，出口地板逐渐融入黑色；同时调整画布底色和相机下缘，让角色靠近出口时走向屏幕底部。
围墙与黑框两套素材均保留，当前仍使用围墙版。黑框方案及配套相机调整尚未合入，视觉与通行手感仍在比较验收中。
验证范围：房间包与 NPC 对齐的 3 项针对性检查、自动存档与记录轮转的 3 项针对性检查通过；黑框试做另做了边界和出口往返检查。自动检查不代替全地图实机验收，本轮未运行完整测试或构建。
存档提示：体验新的房间内容需开启新时间线；旧时间线继续使用嵌入的场景配置。地图尺寸、入口和碰撞的后续调整也需在新时间线中体验。
2026.09.15
| 类型 | 更新 | 说明 |
|---|---|---|
| 功能 | 室外探索 | 酒馆与林间营地双向通行，沿用同一时间线的时间、存档与回放流程。室外提供探索与通行，尚未接入人物活动。 |
| 功能 | 帐篷入口 | 进入左侧帐篷门洞返回酒馆；经过或停留在门前不触发场景切换。 |
| 架构 | NPC 身份统一 | 人物在活动结束后保留身份；动态顾客离店后保留记录，后续去向与再次来访尚未实现。 |
| 架构 | NPC 能力与活动归属 | 商店、作息、服务、演出和教学配置归属 NPC；座位绑定进入活动状态，订单等共享进度由对应系统维护。 |
| 架构 | 地图 JSON 配置 | 地形、碰撞、图层和环境动画使用 JSON 配置；场景负责摆放与连接，剧本负责对白、条件与任务。 |
| 维护 | 格式检查与文档 | 增加 Prettier CI，整理世界架构说明。 |
存档提示：体验室外场景与新的 NPC 配置需从存档 0 开启新时间线；旧时间线继续使用原内容与规则，旧存档仍可恢复和回放。
2026.09.14
| 类型 | 更新 | 说明 |
|---|---|---|
| 功能 | 吉他指导练习 | 正式结识诗人后，可在演出结束且他有空闲时借琴学习；结束后归还，学习进度保留，可再次复习。 |
| 功能 | 练习操作与判定 | W、A、S 对应高、中、低音区，提示经过判定线时按键。按错影响短句首音，漏按使该句留白，伴奏继续；跟上足够短句即可完成练习。 |
| 功能 | 曲谱与音频 | 《Song Of Growth》使用木吉他音色；老师示范、玩家练习和首演共用编配，包含和弦伴奏及力度变化。 |
| 功能 | 示范、重试与跳过 | E 开始练习，Esc 结束；准备时可听示范，曲终可重试。首演增加“跳过”入口，接续演出后剧情。 |
| 功能 | 学琴任务 | “弦上的第一步”记录借琴与练习过程；诗人留到 21:00 再开始离场。 |
| 功能 | NPC 每日作息 | 绯月 10:00 返回、次日 00:30 离场；莉奈 13:00 返回、23:00 离场；诗人 18:30 返回、21:00 离场。离场时结束交谈，莉奈先完成已接待客人的服务；路线受阻可能延迟到达。 |
| 功能 | 等待与睡眠滑条 | 统一选择 1–24 小时，等待默认 1 小时、睡眠默认 8 小时；确认前显示结束时刻、余时消耗和剩余余额。 |
| 功能 | 阶段任务回顾 | 任务面板逐步展示背景、目标与经历；帮工、结识诗人、客房和学琴任务完成后保留总结。 |
| 功能 | 任务进度通知 | 新任务、进度变化和完成时，在左侧显示提示。 |
| 功能 | 对话键盘导航 | W/S 或 ↑/↓ 选择，E 确认，Esc 离开；选项高亮并自动滚入视野，打开对话或切换话题后默认选中首项。保留鼠标与 Tab/Enter 操作。 |
存档提示：新的作息、课程和任务内容需开启新时间线；已有时间线保留开始时的剧情内容。
2026.09.12
| 类型 | 更新 | 说明 |
|---|---|---|
| 功能 | 吟游诗人 | 经绯月介绍并相识后，可围绕不同话题交谈；演出时在专属区域演奏，周围客人作出反应。 |
| 功能 | 条件对白与话题 | 绯月区分初次见面与再次来访，并按营业时段和忙碌程度回应；日常问候与任务话题分别提供入口。 |
| 功能 | 场景对白气泡 | 对白与可滚动选项显示在角色身边，同时扩大游戏画面展示空间。 |
| 功能 | 临时客房任务 | 清理第一张餐桌并领取赠饮后，绯月邀请玩家暂住楼上；“一个落脚点”引导上楼查看床铺。 |
| 功能 | 客房睡眠 | 当时提供睡 8 小时或睡到次日 16:00 的选项，确认前显示醒来时间与生命消耗；客房免房费，睡眠消耗经过的时间。9月14日已改为时长滑条。 |
| 修复 | 商人交易条件 | 商人可达且可正常交谈时即可交易，打烊后也可买卖。 |
| 功能 | 交互轮廓提示 | 靠近可交互人物与物件时显示白色轮廓。 |
| 功能 | 多柜台服务站位 | 服务员可使用多个柜台交接位置，减少单个位置受阻时的停顿。 |
存档提示：体验新增对白与任务需开启新时间线；已有时间线保留原剧情内容。
2026.09.11
| 类型 | 更新 | 说明 |
|---|---|---|
| 功能 | 世界时间推进 | 时间按段推进并结算生命余时；普通交谈期间，人物活动与世界时钟继续运行。 |
| 功能 | 等待与暂停 | 主动等待可推进至较晚时刻；后台与闲置暂停保留当前进度。 |
| 功能 | 背包与遗物收藏 | 普通背包和遗物收藏分开，通过 1、2 或界面入口打开；收藏提供 31 个固定格位，获得顺序不改变位置。 |
| 功能 | 遗物线索 | 未获得的遗物可查看已发现的线索与来源，获得后展示名称、故事和效果；发现线索不会直接获得遗物。 |
| 功能 | 隐藏 HUD | 隐藏 HUD 后仍可查看对话、获取提示并访问设置。 |