Beta 0.20.0・阶段终版更新

《芙田物语 AlfFarmTale》的所有版本变更。版本格式遵循 主版本.次版本.修订号，并按发布阶段加 Alpha / Beta 前缀

[Beta 0.20.0] — 2026-06-21・Prologue 章节解锁

“故事开始了：雨夜、卷宗、即将到来的海鸥岛。”

本次更新在 alpha0.19.2 的基础上，正式解锁序章 Prologue 章节、引入体力 / 食物双轨制、重做可破坏建筑系统，并大幅扩展银岚城（SilverMist）内容。属于一次较大的内容性版本重写。

✦ 故事・新内容

全新 Prologue 章节「WuningHouse」

解锁 Wuning 居所三联场景 + 完整开场剧情。新增 / 改动的场景：

WuningHouse（wuning 居所）：雨夜 Alf 闯入收卷宗的房间，屋内带事故片段视频播放（自带 Skip 按钮）
WuningHouseAlf（卧室）：按 F 拾取关键道具 → 走到床边点 “Sleep” → 推进一日 + 切到走廊
WuningHouseCorridor（走廊）：走到 Wuning 私人房间入口触发回忆对话门
三联场景统一接入 PointLight2D 烛火闪烁系统
专属 BGM《Silent Rain Narrative》全程循环

配套新增资产

音效：雨声、雷声（3 变种）、翻页声、开锁声、撞击声
角色立绘：Wuning 全身立绘、Alf 剑击 + 放置动画
场景贴图：Wuning 三联场景全套室内贴图、SilverMist 屋内贴图

新任务

表格

ID	摘要	触发方式	奖励
101	海鸥岛旧农场代管	到达 Birth 场景自动完成	10× 卷心菜种子

✦ 玩法・系统大改

体力 / 食物 / 休息系统（核心升级）

旧版单一能量条改为「跑步消耗可自然回复」+「劳作永久扣除」双轨制：

跑步消耗（按住 Shift）：归零后 2 秒喘息期，期间 Shift 无效但不致死锁
永久扣除：锄地 / 浇水 / 砍树 / 建造 / 播种全部累加 energy_floor，封顶 energy_max
8 种食物可食用：右键手持 Food 类物品直接吃，吃掉永久降低体力下限 → 上限自动上升
- 苹果 / 胡萝卜 +5、番茄 / 茄子 +6、小麦 +4、卷心菜 +8、南瓜 +10、小黄瓜 +7
体力 ≤ 0 拦截：锄头 / 浇水壶 / 斧头完全无法使用，range 提示自动隐藏
累瘫对话：体力跌到 0 那一帧边沿触发一句 Alf 提示，不会反复弹
能量条 UI 升级：体力归零时变暗红色，条不再消失（避免玩家误判为 bug）

农田生长 × 浇水联动

旧版：时间推进就生长
新版：只有 moisture > 0.5（视觉湿润）时才生长
不浇水约 50 分钟后生长自动暂停，再浇水立即恢复
所见即所得，wet 视觉 ↔ 生长状态对齐

可破坏建筑系统重做

砍栅栏 / 箱子 / 床 / 装饰统一走斧头（HoldEffectResource 抽象），大部分 1 下碎
砍宝箱：先吐内部所有物品到地上，再让宝箱消失，不会丢东西
锄头新功能：可擦带 metadata/tellable = true 的装饰 tile（如 Afforest 层），擦完自动变可耕地，主动扩展开垦空间
配置集中在 Level 顶部两张 const 表，加新特例改表不动 Inventory 资源

SilverMist 热闹起来了

新增 3 个 NPC + 3 家新商店：

表格

NPC	角色	商品
NPC 4001	装饰 / 家具店主	90+ 件摆设（床、椅子、沙发、书架、画作、食物摆盘、餐具、盆栽、钟、衣柜）
NPC 4002	食材 / 种子店主	全 8 种食物 + 全 7 种种子
NPC 4003	武器 / 工具店主	sword、wood、axe、hoe、sprinkler

旧 npc2001 工具店大幅精简：只留 axe /hoe/sprinkler /sword/carrot /carrot_seed

✦ 视觉・体验优化

启用 MSAA 2D / 3D 抗锯齿，场景锯齿大幅缓解
室外相机缩放 1.2 → 1.8，视野更近更舒适
室内相机缩放 1.5 → 2.0，屋内更聚焦
Wuning 三联场景 + Alf 全身动画 + Wuning 立绘全套到位
SilverMist 场景首次加入室内
新增 BGM 池混合播放：未注册专属 BGM 的场景自动从 village_01 + birth 两池随机选播

🐛 修复

「砍完树后不能耕地」：4 个 outdoor 场景的 hidden 美术辅助 Tree 层不再阻挡锄地判定
满体力误判守卫：旧版 floor > 0 时吃东西被误拦，现在用 future_current 预测算法判断
开局能量条不满：默认 energy_floor 从 1 改回 0.0，且 .tres 显式声明 energy_max / current / floor 三字段
Afforest 装饰 tile 阻挡开垦：锄头走 BreakableTellable 通用入口
「离开区间反复触发对话」：状态机改用 Area2D._on_*_body_entered 边沿信号，不再每帧检测
Web 镜像种子路径错位：birth_fellable_tree_exist_resource.tres → birth_fellable_tree_resource.tres 对齐桌面端
室内 mouse_focus 光标方块错乱：indoor 场景自动隐藏
BGM 衔接错乱：Wuning → SilverMist 切换时按当前 level_name 重播
能量条归零完全看不见：旧版直接 visible=false，现在保留条 + 暗红色提示

⚡ 性能 / 存档

桌面端存档全部写到 res://archives/<slot>/，不再覆盖 res:// 源文件，多 slot 不再互相污染
Web 端 cold-start 镜像范围扩展到 16 个新场景存档
WebSaveAdapter 新增 swap_to_runtime_deep 递归 swap，Inventory 物品引用刷新
InventoryNode._relink_inventory_after_swap() 修正 Web deep-swap 后玩家改动写到旧 bag 的 bug

📁 文件改动（按模块）

plaintext

新增资产
  assets/sound/                    雨声 + 雷声 + 翻页 + 开锁 + 撞击 + 剑击 SFX
  assets/sound/bgm/                Silent Rain Narrative (Prologue BGM)
  used/character/alf/...           全身动画 + 剑击 + 放置
  used/character/wuning/...        Wuning 立绘全套
  used/scene/wuninghouse/...       Wuning 三联场景全套贴图
  used/scene/silver_mist/...       SilverMist 室内新增

新增场景
  levels/wuninghouse/              Prologue 主场景
  levels/wuninghouse_alf/          Prologue 卧室
  levels/wuninghouse_corridor/     Prologue 走廊

新增 NPC
  compoents/npc/npc4001/           SilverMist 家具店主
  compoents/npc/npc4002/           SilverMist 食材种子店主
  compoents/npc/npc4003/           SilverMist 武器杂货店主

新增 / 重构模块
  compoents/breakable/             通用可破坏抽象（breakable.gd + 子类）
  compoents/chest/                 current_cell 字段追踪
  compoents/fellable_tree/         7003 走 to_tool() 统一入口
  managers/sound_manager/          BGM 池混合 + 早返守卫
  dialogic/timeline/Alf_stamina_deplete.dtl   累瘫对话

体力食物链
  structs/character_resource.gd    energy_floor 默认 0.0
  structs/inventory.gd             restore_value 字段
  compoents/character/character.gd  consume_food() + 满体力守卫
  compoents/character/children/attribute/children/statusinfo/statusinfo.gd
                                  边沿触发累瘫对话 + 能量条 UI
  compoents/range_prompt/          体力归零拦截 + 切工具抛光
  structs/hold_effect_resource.gd  consumes_energy() 虚方法
  compoents/character/hold_effect/7001.gd / 7002.gd / 7003.gd
                                  override consumes_energy() = true

历史版本（简表）

表格

版本	标签	主要内容
Beta 0.20.0	`10d5eb3`	Prologue 章节 + 体力食物系统 + 可破坏重构 + SilverMist 三 NPC
Alpha 0.19.2	`5ce519c`	双端存档（Web SaveAdapter + 桌面 / Web 路径适配）
0.17.2	`911278b`	修复 bug
0.17.1	`34590ad`	新增建筑系统
0.16.3	`dd9bee0`	添加界面 UI
0.16.2	`09df524`	修复 bug
0.16.1	`25b2ca4`	替换了 bag 逻辑、移除原有拖拽逻辑
0.16.0	`43d7627`	添加商店功能
0.15.9	`0c5800b`	添加商店界面
0.15.8	`553a34f`	布置工会场景
0.15.7	`177e50d`	添加光影系统
0.15.6	`177247d`	添加树阴影
0.15.5	`c379bd5`	新增工会场景
0.15.4	`e81056f`	完善走路音效
0.15.3	`911b179`	—
0.14.6	`29e300e`	—
0.14.1	`47ba21a`	添加任务列表
0.13.4	`f20def7`	完善音效数据结构
0.13.3	`d4a0e6a`	添加音效系统
0.12.4	`c04e262`	—

版本约定

主版本：剧情 / 玩法机制大改（例：0.20.0 加入体力食物系统）
次版本：新增场景 / 新 NPC / 新系统模块
修订号：bug 修复 / UI 调优 / 资产微调
Alpha → Beta：序章打通 + 核心玩法闭环后切换