跳至内容
小岛物语 · 实现与验收记录

小岛物语 · 实现与验收记录

所属专题:小岛物语 · Godot 游戏开发

这是开发批次的证据附录。命令、测表和日志摘录记录的是作者与实现方当时做过的检查,不是本页向玩家交付的游戏、原图或音频。想先看岛上能做什么,可读一分钟玩法演示的制作手记;要追一个问题在哪一轮被改掉,从下面的批次进入。

批次在这里核对什么当批结论的边界
v176个物件、17张截图;移动、送礼、卖出与存档棋盘底漏掉栅栏浅绿块,首轮观感不是定论
A深色底复查与暖色灯修的是素材与混合方式,不是寻路
B横桥、岸线、70个物件视觉岸线与不可走格分别检查
C栏杆遮挡、商店面板、7份WAV导出基准音不等于逐字播放时的随机音高
D35张步行帧、头部对齐测表颜色误差不评价步态好不好看
E · E 修复固定配音、未录动态句;联网、增益与截图时序客观解码和角色试听分开,常规测试没有访问服务
F · F 修复四曲初测、夜曲重测;隔离前后对照修复表取代初版夜曲;两环境通过不等于读取了原档
G57.4秒成片的分镜与输出固定部分台词和站位,不是随机游玩录像

v1:启动条件与第一轮结果

持有对应工程、已把 Godot 可执行文件的实际路径设在 GODOT_BIN 环境变量里时,可从工程根目录常规启动:

& $env:GODOT_BIN --path .

v1 实现方使用隔离工作区,不能沿用常规安装和默认用户目录,于是另取官方同版本引擎、核对 SHA-256,记录版本为 4.7.2.stable.official.ed1daf0bf。以下是隔离启动方式:

python tools/run_godot.py --path .

run_godot.py 只为子进程准备工作区内的用户目录和证书配置,不改系统设置。游戏代码仍读 user://save.json;常规安装版与隔离启动器下,同一个相对名落在不同目录。这个差异要到 F 批的音乐测试才暴露出来。

如需在另一份受限工作区准备同版本引擎,可执行 python tools/fetch_godot.py;素材和数据已经生成,正常运行无需重建。抠图重建命令为 python tools/process_assets.py。python tools/build_data.py 现在只重建地图与地面距离场,不覆盖已验收的台词、物品 JSON;它会覆盖手工编辑的地图。若仅手工编辑了 data/map.json,可用 python tools/terrain_fields.py 更新地面距离场。

v1 实现范围:这些是输入与状态,不是测试结论

  • 左键点击寻路,长按每 0.15 秒更新目标;水和建筑内部点击会落到最近可走格。点击动物、落地物品、果树或花丛会先走近再交互。滚轮缩放 0.8–1.6。
  • AStarGrid2D 使用 octile 和禁止穿角的对角移动,之后进行带 5 px 边缘余量的视线平滑。所有可走格组成同一连通区域,人物不互相阻挡。
  • 地面是一张 64×44 数据纹理驱动的连续 shader,包括草地斑块、细点、沙粒、软路沿、木桥、水面流动与岸边泡沫。地图为 64×44 的岛形,包含六栋住宅、一家商店、两座桥和 76 个场景物件。
  • 默认字体的原生 default_font.res 内嵌所提供 ZCOOL KuaiLe TTF 的相同字节,使全新缓存下的首次 --import 也能在字体导入之前初始化主题。替换源字体后可运行 python tools/run_godot.py --headless --path . -s tools/bake_font.gd 重建这个资源。
  • 所有人物和场景物件在 YSortedWorld 下按脚底排序。程序动画包括走路弹跳、轻微旋转、压缩、呼吸、左右翻转和椭圆阴影。遮住玩家的高物件淡化到 0.55。
  • 六位居民共 282 条对话条目,部分包含多句。每个问候时段、初遇、送礼反应、告别池各 4 条;聊天每级 5 条。文本包含情绪标记、居民互相提及及所有指定占位符。
  • 对话提供 40 字/秒打字、点击补全/推进、140×140 上半身头像、角色主题色姓名牌、表情气泡、合成动物语和 0.3 秒的对话镜头。每日首次招呼、首次见面、聊天与礼物有独立持久化标记;好感 10/25 升级并追加系统提示。
  • 居民在家附近闲逛;22:00–6:00 返回自家门口隐藏,点击住宅显示睡觉提示。店主提供卖东西入口;玩家住宅会保存当天进度;告示牌和信箱也可点开。
  • 每天产生 6 个贝壳、4 根树枝;果树每日摇一次、落 1–3 个苹果,花丛每日摘一朵。已经收空的当天掉落物不会在重新读档时重刷。
  • 背包 20 格,单格同类物品上限 99。拾取有飞向背包的图标和提示。商店按单格出售一个或全部数量,铃钱滚动增长。送礼通过同一背包选择,喜爱物品 +3,普通 +1,每人每日一次;聊天每日 +1。
  • 时间一秒对应一分钟,初始第 1 天 8:00;午夜刷新资源与每日限制。夜晚有 CanvasModulate 蓝色环境及路灯、房屋窗户的暖光。进入游戏显示并淡出标题。
  • 存档通过临时文件与替换写入,在交互、每 15 秒及关闭窗口时保存。包含时钟、铃钱、背包、位置、好感、每日限制、采集标记、剩余落地物和对话去重记录。

v1 对规格的三处具体化

  • 为使物品表中的椰子可获得,椰子树沿用果树的每日摇落流程,产出 1–3 个椰子。设计给出了椰子售价和阿福的喜好,但未单列获取方式。
  • 堆叠上限取 99,这是对「20 格背包、显示数量」的具体化选择;放在 items.json 可调整。
  • 初始玩家名为「小岛友」,可在存档中的 player_name 调整。规格未要求创建角色或改名界面。

v1 测试命令与通过项

以下是 Godot 4.7.2 stable 的当批记录。命令保留参数,工作区以外的绝对路径不公开;只知道批次、不知道目录名的截图目的地分别记作 $BatchBShots、$BatchCShots、$BatchDShots、$BatchEShots,它们是不同批次的自选输出目录,不是四个可点击的附件。启动器记录引擎输出,退出码为0但有报错也视作失败。

python tools/run_godot.py --record=import.log --headless --path . --import
python tools/run_godot.py --record=smoke.log --headless --path . --quit-after 120
python tools/run_godot.py --record=tests.log --headless --path . -s tests/run_tests.gd
python tools/run_godot.py --record=screenshots.log --path . -- --screenshot-test "--shot-dir=$PWD/test-results/screens"

v1 当次通过记录(断言次数不是独立用例数):

  • 导入:[ DONE ] first_scan_filesystem、[ DONE ] loading_editor_layout,EXIT CODE: 0,无引擎或脚本报错。
  • 运行 120 帧:READY: 小岛物语 | 64x44 | 76 props | 6 NPCs | day 1,EXIT CODE: 0,无报错。
  • 逻辑测试:RESULT: 9015 assertions, 0 failures、ALL TESTS PASSED、EXIT CODE: 0。覆盖全部 1,344 个可走格的连通性、220 组 A* 及平滑路线的无碰撞检查、门口/不可达点击、台词池数量/占位符/邻居提及/去重、好感阈值与每日限制、五种售价/精确结算/容量/堆叠、存档往返与覆盖写入、当天采空后的读档。
  • 非 headless 截图:SCREENSHOT TEST PASS: 17 images、EXIT CODE: 0。真实注入鼠标输入完成散步、接近 NPC、初遇/多句推进、聊天、拾取、背包、商店卖出、再次交谈、送喜欢的礼物、送礼按钮禁用;随后验证夜景、六位居民回家隐藏、睡觉住宅提示、树前/树后的排序与全岛总览。

截图文件在 test-results/screens/01_daytime.png 到 17_island_overview.png。其中 03_dialogue.png / 04_choices.png 检查对话,06_backpack.png / 07_shop.png 检查面板,12_night.png 检查暖光和夜色,15_y_sort_behind.png / 16_y_sort_front.png 对照遮挡。另有 test-results/screens_review.jpg 总览图。

v1 的限制: 当时只看了棋盘格底,不能据此说没有浅绿背景;同样,夜景截图完成也不等于灯色对了。截图模式独立运行,不读写正常存档。默认目录为 user://screens/,也可显式指定输出位置。下面 A 批的深色底与夜景复查,取代首轮这两项观感判断。

Batch A:两项视觉修复(A1 / A2)

  • A1:四边连通背景与封闭空隙共用颜色距离、色相、饱和度判定。近白色保留,路灯原图的粉色光边也按颜色清理;全部 33 张素材重新生成。增加 _raw/cutout_check_dark.png,底色为 #203020,供逐个检查浅粉、浅绿残留,棋盘格检查图仍输出。
  • A2:灯光改为颜色 #ffc870 的 unshaded 径向透明 sprite,中心亮、边缘按原径向纹理柔和衰减,路灯半径 110 px。18:00–19:00 线性渐亮,05:00–06:00 线性渐灭,白天隐藏。房屋窗户使用相同暖色与时段。环境色与其他 UI 的原有时间曲线保持原值。
  • 灯光实现与 §9 的 PointLight2D / 加法示例有所不同:采用透明混合,避免光色与绿色草地或蓝色 CanvasModulate 相乘后偏绿,满足本轮指定的暖橙黄色效果。
  • 原有 tests/run_tests.gd 未修改,实际输出仍为 RESULT: 9015 assertions, 0 failures、ALL TESTS PASSED。额外在忽略版本控制的 test-results/check_lighting.gd 检查 9 个时间点、白天隐藏、半径和材质;实际输出 PASS lighting: 9 time samples, daylight hidden, 05:00-06:00 / 18:00-19:00 fades, radius 110, unshaded #ffc870。
  • 最终素材命令输出 PASS: 33 transparent sprites; _raw/cutout_check.png; _raw/cutout_check_dark.png。已逐个查看深色底检查图,并放大复查栅栏、兔子、鸭子、路灯;未见浅粉/浅绿残留块,浅色部位保留。最终非 headless 截图输出 SCREENSHOT TEST PASS: 17 images、EXIT CODE: 0,已打开 01_daytime.png 与 12_night.png 确认白天无光晕、夜晚灯窗暖色。导入、120 帧运行、原有逻辑测试和额外灯光检查均退出 0,无引擎/脚本报错。

Batch B:地图、地面与桥

  • 广场为约 8×6 格椭圆。道路使用平滑曲线,宽 1.1–1.35 格,连接各户、商店、桥头与东南沙滩;草地为主体。ASCII 土路占陆地 174/1468 (11.85%),烘焙后的视觉土路实测 12208/93432 (13.07%),均低于 15%。
  • 两座桥东西横跨南北河道,桥格各为 2×2,桥面每端延伸 16 px 到岸上;木板南北排列,南北两侧为深色边框和短柱。桥格可走,其他河格仍不可走。
  • 海岸/河岸从原始格边烘焙平滑距离场,shader 增加浅水带与浪花。烘焙偏移限制为 10 px,shader 噪声扰动不超过 2 px;测试抽样实测最大偏移 10 px,连同扰动小于半格 16 px。道路直接使用同一组曲线的距离场,避免显露格子。地面仍由一个 shader 绘制;相对 §3 的每格 1 像素示例,改为 512×352、每格 8×8 采样的距离场,满足本批岸线与路径平滑要求。
  • 物件调整到道路旁:告示牌与部分路灯移至广场/小路边,东南原本落在海格上的一棵椰子树移到沙滩;随机边缘树林避开道路及河边,最终 70 个物件。所有物件落点、占地及视觉路径均有检查,各户与商店门口均可达。
  • scripts/world.gd 仅改地面材质的数据接入与截图编排;截图模式新增 03_river_bridge.png,保留原有截图名,合计 18 张。对话、商店、存档、人物、灯光与寻路实现未改。
  • 新增文件:tools/terrain_fields.py、assets/terrain/fields.png 及其 Godot 导入设置。修改文件:tools/build_data.py、data/map.json、scripts/ground.gdshader、scripts/world.gd、tests/run_tests.gd、本说明。

本批实际执行:

python tools/build_data.py
python tools/run_godot.py --record=batch_b_import.log --headless --path . --import
python tools/run_godot.py --record=batch_b_smoke.log --headless --path . --quit-after 120
python tools/run_godot.py --record=batch_b_tests.log --headless --path . -s tests/run_tests.gd
python tools/run_godot.py --record=batch_b_screenshots.log --path . -- --screenshot-test "--shot-dir=$BatchBShots"
git diff --stat -- data/
  • 地图生成:PASS map: 64x44, 70 props, 2 east-west bridges; dirt 174/1468 (11.85%); npcs.json/items.json untouched. 另行重复生成并比较 SHA-256,地图/距离场确定性一致,npcs.json 与 items.json 相对本批开始逐字节未变。
  • 导入:[ DONE ] loading_editor_layout,退出 0,无报错。运行:READY: 小岛物语 | 64x44 | 70 props | 6 NPCs | day 1,退出 0,无报错。
  • 测试:PASS map: dirt 174/1468 (11.85%), 70 dry props, all doors reachable; bridges-only crossing; shore shift 10.0 + 2 px <= 16;RESULT: 12210 assertions, 0 failures;ALL TESTS PASSED;退出 0。保留原有逻辑测试,并补充桥格/河水阻挡、关闭所有桥后两岸断开、物件落点/占地、门口可达、土路比例、视觉路径与岸线偏移检查。
  • 非 headless 截图:SCREENSHOT TEST PASS: 18 images,退出 0。已亲自打开最终 01_daytime.png、03_river_bridge.png、17_island_overview.png,并复查 12_night.png;确认横桥、窄路、椭圆广场、平滑海岸/河岸及浅色水边带。
  • git diff --stat -- data/:仅 data/map.json | 539 ...,1 file changed, 386 insertions(+), 153 deletions(-)。
  • 地图 JSON 与烘焙 PNG 必须一起更新;新增距离场脚本提供仅烘焙当前地图的入口。未发现本批新增的运行或测试问题。

Batch C:栏杆、界面与音效导出

  • 桥南北两侧各增加独立绘制的 21 px 矮立柱与横木,放在同一 Y 排序层;纯视觉节点,不添加碰撞,不改变地图或寻路。
  • HUD 铃钱改为紧凑的「图标 + 数字 + 铃钱」一行,面板按时钟/金额内容宽度收紧。岛名及副标题增加阴影和描边,描边按当前文字亮度切换深浅色,兼顾昼夜可读性。
  • 商店按物品行数计算高度,最小 200 px、长列表滚动。空状态为「背包空空的,去海边转转再来吧,嗯哼。」;打开商店隐藏头像对话框与选项,关闭后恢复狸叔的选项。背包与送礼面板仍使用原网格尺寸。
  • scripts/voice.gd 集中合成动物语。六位居民与 player 默认声音都由同一个 synthesize() 生成,游戏缓存并播放同一份 PCM;角色基准音高烘焙在 PCM 中,播放仍有每字 ±8% 的随机变化。导出的是基准音高的一声,方便比较角色,游戏的 -22 dB 播放音量及随机变化属于播放参数。
  • 新增 --dump-voice=<目录>,启动后直接导出并退出,不初始化游戏会话。可同时用 --headless。文件为 cat.wav、dog.wav、rabbit.wav、bear.wav、duck.wav、raccoon.wav、player.wav,均为 22050 Hz、16-bit PCM、单声道。player.wav 同时作为默认/系统声音。原始基准声长 40 ms,各居民按基准音高缩放时长,保持原来音高播放方式的效果。

实际执行命令:

python tools/run_godot.py --record=batch_c_import.log --headless --path . --import
python tools/run_godot.py --record=batch_c_smoke.log --headless --path . --quit-after 120
python tools/run_godot.py --record=batch_c_tests.log --headless --path . -s tests/run_tests.gd
python tools/run_godot.py --record=batch_c_voice.log --headless --path . -- "--dump-voice=$PWD/test-results/voices"
python tools/run_godot.py --record=batch_c_screenshots.log --path . -- --screenshot-test "--shot-dir=$BatchCShots"

C 批结果:导入输出 [ DONE ] loading_editor_layout;120 帧运行输出 READY: 小岛物语 | 64x44 | 70 props | 6 NPCs | day 1;测试输出 RESULT: 12265 assertions, 0 failures、ALL TESTS PASSED;音效模式输出 VOICE DUMP PASS: 7 WAV files、PCM 16-bit mono 22050 Hz; shared gameplay synthesis;截图输出 SCREENSHOT TEST PASS: 19 images。以上命令均退出 0,无引擎/脚本报错或泄漏警告。

新增界面/音效测试覆盖紧凑 HUD、商店空/一行/多行/滚动高度、打开隐藏对话和关闭恢复、背包尺寸恢复,并逐字节比对导出 WAV 的数据块与游戏实际 AudioStreamPlayer 的 PCM。另用 Python wave 独立读取 7 份导出文件,确认 PCM 格式、16-bit、mono、22050 Hz 及非静音数据。测试播放后等待音效结束,避免测试进程提前退出导致音频资源清理警告。

已亲自打开最终 01_daytime.png、03_river_bridge.png、07_shop.png、新增 07b_shop_empty.png,另复查夜间岛名 12_night.png。音效文件在 test-results/voices/。本批未发现新增已知问题。

本批修改 scripts/interface.gd、scripts/world.gd、tests/run_tests.gd、本说明;新增 scripts/bridge_rail.gd、scripts/voice.gd 及两份 Godot .uid 文件。

Batch D:逐帧步行

运行 python tools/process_walk.py 重建 7 位角色的 35 张图片及 assets/sprites/walk/walk_frames.json。选帧来自 _raw/walk/selected.json,待机来自 _raw/selected.json;未指定 p2 时复用 p。换帧时修改选帧清单并重跑处理脚本、Godot --import,不需要修改播放代码;生成候选的 tools/gen_walk_frames.py 保持原样。

  • tools/process_assets.py 只抽出 cutout_canvas() 接口,复用原有逐图背景采样、封闭背景/投影剔除、连通区域筛选及边缘去色溢。原 cutout() 的默认缩放、裁剪行为不变。步行管线以 896×1152 原始画布处理,不会重写已有静态 PNG。
  • 取原图头顶到身体高度 25% 的区域,在源图 ±6 px 内搜索整数平移,以预乘亮度与透明度误差对齐轮廓/内部特征;不缩放。横向中心取头部区域自身,避免狗伸出的饼干手臂影响中心。然后取全套帧的联合包围盒加 12 源像素边距,统一缩放到长边 512。
  • 校色先在对齐后的上部 60% 平坦、相同材质像素拟合 RGB 仿射变换(强度 1.0,增益限制 0.85–1.2、偏置 ±20);再按整个前景的 32 个对应色簇作 0.9 强度的局部校正,修复衣服与毛色的灰淡,色簇间柔和插值。色簇的校色参数由相同位置的平坦前景像素配对计算,避免姿势改变导致粉色腮红被误配为书页米黄色。每帧具体参数、校色前后 RGB RMSE 与头部平移均记录在 JSON 的 processing 下。RMSE 在同一组稳定前景像素上比较,单位为 0–255 RGB;它不代表肢体姿势误差。
  • JSON 的 foot_y、head_y、head_x 均为输出 PNG 画布像素;source_crop 与 translation 为原始画布像素,正方向为右/下。foot_y 是原图待机脚底的半透明阈值轮廓,head_y 是头顶。idle_height 记录旧静态精灵以 72/texture_height 缩放时的实际可见高度,以此计算新比例;所有帧共用比例与 offset,待机脚底在节点原点。
  • scripts/actor.gd 的 PLAYER_FRAME_STRIDE=13.0、NPC_FRAME_STRIDE=9.0 是每帧实际行走距离(px)。沿路线逐段累加路程,循环 a → p → b → p2;起步左右脚交替,首脚随机。停止、对话即回 idle。逐帧步行无压扁/旋转,仅 passing 帧上抬 2 px;待机保留 1.00–1.02 呼吸。缺少角色元数据时沿用旧静态程序动画。头像仍使用原始静态纹理,其他行为与系统不变。
  • _raw/walk_check.png、_raw/walk_check_dark.png 每行依次为 idle/a/p/b/p2,蓝线标头顶、橙线标共用脚底;_raw/walk_check_game.png 使用与游戏相同的名义 72 px 比例。步行脚的收起/伸出可相对地线变化,不做逐帧脚底对齐。
  • 截图模式保留原 19 张,新增 18_three_walking.png(玩家、橘子、阿福处于 passing 帧)和 walk_sequence_00.png 至 07.png,共 28 张。序列以真实移动代码每次推进 13 px,200×200 裁剪,共用脚底位置,连续展示两个循环。

D 批执行命令:

python tools/process_walk.py
python tools/run_godot.py --record=batch_d_import.log --headless --path . --import
python tools/run_godot.py --record=batch_d_smoke.log --headless --path . --quit-after 120
python tools/run_godot.py --record=batch_d_tests.log --headless --path . -s tests/run_tests.gd
python tools/run_godot.py --record=batch_d_screenshots.log --path . -- --screenshot-test "--shot-dir=$BatchDShots"
  • 处理:PASS walk: 7 characters, 35 aligned frames; 3 check images; static PNGs byte-identical,退出 0。
  • 导入:[ DONE ] loading_editor_layout;运行 120 帧:READY: 小岛物语 | 64x44 | 70 props | 6 NPCs | day 1;均退出 0,无脚本/引擎报错。
  • 测试:PASS walk: 7 frame sets, distance cycle 0..5 strides, split timesteps/polyline distance, idle/talk/stop, size/feet, alternating starts, missing-character fallback;RESULT: 12561 assertions, 0 failures;ALL TESTS PASSED;退出 0。测试实际调用 JSON 纹理加载器和角色移动代码,另覆盖缺 p2 时像素复用、路径走完同帧回 idle,以及读入缺少 player 的 JSON 后回退静态动画;预期纹理顺序使用测试独立定义的 a/p/b/p2,避免与实现同错。
  • 截图:SCREENSHOT TEST PASS: 28 images;序列日志为 a/p/b/p2/a/p/b/p2,累计距离 0/13/26/39/52/65/78/91 px;退出 0。8 张裁剪均为 200×200。已亲自查看最终三张素材检查图、01、三人步行图及全部序列;未见背景块/投影残留,白色身体保留。另在 test-results/walk_sequence_review.png 拼接静态总览,并输出 test-results/walk_preview.gif(87 ms/帧)方便复核节奏。最终步幅、摆臂与饼干手臂衔接的美术取舍留给策划验收。
  • SHA-256 对照输出 PASS protected: 38 files byte-identical (33 static PNGs + 5 protected inputs);保护输入为 DESIGN、两个选帧清单和两个素材生成脚本。git diff -- assets/sprites/*.png data/ DESIGN.md 无输出。只忽略 _raw/walk/*.png 候选,选帧 JSON 与生成脚本不被忽略;未提交、未修改暂存区。

下表为校色后稳定前景 RGB RMSE 范围(0–255),以及 a / p / b / p2 的头部平移(源图 px,右/下为正;idle 为 0,0):

角色RMSEa / p / b / p2 平移
player1.891–2.136(0,0) / (0,1) / (0,0) / (0,1)
npc_cat2.646–3.090(-1,1) / (-1,4) / (0,1) / (0,0)
npc_dog2.776–3.086(1,1) / (1,0) / (0,0) / (1,0)
npc_rabbit2.014–2.292(0,0) / (0,0) / (0,0) / (0,0)
npc_bear2.685–2.962(0,0) / (0,1) / (0,0) / (0,1)
npc_duck2.170–2.586(0,0) / (0,0) / (0,1) / (0,0)
npc_raccoon2.185–2.624(0,0) / (0,0) / (0,0) / (-1,0)

本批修改 .gitignore、tools/process_assets.py、scripts/actor.gd、scripts/world.gd、tests/run_tests.gd 和本说明;新增 tools/process_walk.py、assets/sprites/walk/ 下 35 张 PNG/导入设置及 JSON、三张 _raw/walk_check*.png。原始静态 PNG、地图、地面、对话/商店/存档/语音系统均未修改。未发现本批新增的运行或测试问题。

Batch E:居民 TTS 语音

data/voices.json 保存六位居民的 voice / speed / pitch / style及在线开关、基础播放增益;后面提到的在线补偿与静音估算是 E 修复批补入的。修改其中某位居民的声音参数后,运行 python tools/gen_voice.py 再运行 Godot --import;只会重新请求该角色的新参数缓存键。改台词后同样重跑。默认玩家名从设计沿用「小岛友」;测试会核对它与 IslandState 的真实默认值一致。玩家改名导致的新句子可在线获取。

  • tools/gen_voice.py 递归遍历全部池和数组段落里的每一句,按游戏相同的占位符替换和情绪前缀剥离规则生成 显示文本。manifest 用显示文本精确索引,不用送往 TTS 的规范化文本。TTS 规范化函数只做 ♪ → 空串、~ → ,;GDScript 同名函数保持一致。{time} / {day} 原句不做离线生成。
  • 缓存键为 SHA-1:voice、speed 的六位小数字符串、pitch、style、规范化文本,用换行分隔后取 UTF-8 哈希。原始 MP3 保存在忽略版本控制的 _raw/voice_cache/。Python 请求始终串行,完成后至少间隔 0.3 秒,提交接口要求的声音参数;空/不足 2048 字节视为失败,首次之外重试 3 次,0.8/1.6/3.2 秒退避。连续三句最终失败会断路并在报告逐句列出,可重跑恢复;不制造替代音频。
  • ffmpeg 解码为 24 kHz mono,按 10 ms RMS 窗、-45 dB 阈值只裁两端,保留各约 60 ms,不删除句中停顿。轻度压缩(threshold 0.06、ratio 4、attack 2 ms、release 80 ms)避免突发峰值压低整句响度,然后双遍 loudnorm 到约 -16 LUFS / -1.5 dBTP,输出 mono 24 kHz、Vorbis q4。缓存内另记后处理版本;调整处理算法可复用 MP3,重处理无需联网。
  • 每个 OGG 解码后检查 RMS 非静音、时长满足 0.10*字数 ≤ dur ≤ 0.55*字数+0.8;字数为汉字、英文字母和数字。报告保存至 test-results/voice_report.json,含逐句响度/峰值/RMS、各角色总时长与每字时长、全部跳过/失败原句。manifest 外的 OGG 自动清理。
  • default_bus_layout.tres 注册 Master、Music、Voice、SFX,后三者送往 Master。本批不添加 BGM。整句 TTS 和原有 beep 都走 Voice;TTS 播放器为 -6 dB,beep 保留原先的 -22 dB 和逐字随机音高。离线素材约 -16 LUFS,播放约 -22 LUFS,为 Batch F 的背景音乐留下余量;后续 BGM 可从约 -30 LUFS 的实际播放响度开始混音。
  • IslandVoice 保留 synthesize/build_bank/dump,新增 manifest 查询和串行 HTTPRequest 队列。单次请求超时 4 秒,同样带全部参数,最多 3 次重试并退避。成功 MP3 保存在 user://voice_cache/<sha1>.mp3,用 Godot 的 AudioStreamMP3.load_from_buffer 加载,内存/磁盘重复使用;不要求玩家安装 ffmpeg。在线缓存保留 API MP3,离线 OGG 经过裁剪与响度归一化。在线片段(含磁盘缓存)携带 gain_db=online_gain_db,播放音量为基础 -6 + 4.5 = -1.5 dB;离线片段携带 gain_db=0,仍以 -6 dB 播放。在线打字时长估算为 max(0.4, MP3.get_length()-online_silence_s),不改写 MP3 音频。
  • 新台词先查离线/磁盘缓存;命中后整句播放,禁用该句的全部逐字 beep,打字速度为 clamp(汉字字母数字数/dur,10,40)。未命中且在线开启时,先正常 beep 打字并请求;1.2 秒内到达、同一行且对话框仍显示才切换整句语音。过期结果只缓存,不能盖过新台词;系统提示和 ( 开头旁白始终 beep,禁止请求 TTS。
  • 点击补全当前行不截断语音;切下一句、结束对话以 80 ms 淡出旧播放器。测试和 --screenshot-test 会强制禁止真实 HTTP;测试只能通过显式注入本地 MP3 替身启用请求路径,另有真实请求计数断言。tests/fixtures/voice.mp3 为本次 API 的真实返回,不是合成 beep。

跳过的 12 句(正常游戏在线获取;离线/截图时 beep):

居民时间句天数句
橘子现在{time},离下一顿还远!要不要先跑到桥那头?第{day}天的下午也要精神满满!喵呜!
阿福{time}了呀?早餐要是变成午餐,是不是可以吃两份?第{day}天的午觉,跟第一天一样值得认真对待。
棉花现在{time},先喝点水再出门,好吗?第{day}天啦。新冒出的嫩叶,还记得昨天的雨。
老熊{time}了?这海里的鱼倒挺会赖床。哼,今天第{day}天,你总算认得桥往哪边走了吧。
嘎嘎现在{time},正适合岛上第一诗人亮相!第{day}天的灵感,正从我的贝雷帽里溢出来。
狸叔现在{time},不急着花钱,先看看岛上的好天气。第{day}天,生意不一定要多,邻居一定要都认得。

E 批固定句生成报告(每字时长单位秒,平均值后为最小–最大):

居民固定句总秒数秒/字平均 LUFS
橘子47168.260.2095(0.1683–0.2878)-15.89
阿福47188.130.2415(0.1758–0.3253)-15.92
棉花47192.720.2311(0.1916–0.2773)-15.93
老熊47186.790.2383(0.1900–0.3344)-16.38
嘎嘎47176.370.2120(0.1500–0.3117)-16.09
狸叔47169.400.1960(0.1550–0.2458)-16.35

合计 282 条 / 1081.67 秒,12 条动态句跳过,0 条失败。首轮完整生成实际请求 283 次(另有先行 1 条探测缓存;生成中两次下载中断重试均恢复)。校准重处理与最终复跑均为 0 次请求。最终 OGG 共 7,921,803 字节;含 manifest / Godot 导入设置的目录为 8,085,598 字节,约 7.71 MiB,无孤立 OGG。所有 282 条都满足解码、时长与非静音检查。

最终 volume_db=-6.0 的依据是对每个最终 Vorbis 解码后再次运行 ffmpeg loudnorm 测量,六位居民平均 -15.89 至 -16.38 LUFS;播放均值约 -21.89 至 -22.38 LUFS。全体最大发声峰值 -0.20 dBTP,播放时约 -6.20 dBTP,保留超过 6 dB 的数字峰值余量。少数高峰值短句的积分响度较低,完整逐句范围见报告;最小值为狸叔 -19.31 LUFS。没有用实际尚未添加的 BGM 声称混音已验收。

实际执行:

python tools/gen_voice.py
python tools/gen_voice.py  # 最终缓存复跑:0 network requests
python tools/run_godot.py --record=batch_e_import.log --headless --path . --import
python tools/run_godot.py --record=batch_e_smoke.log --headless --path . --quit-after 120
python tools/run_godot.py --record=batch_e_tests.log --headless --path . -s tests/run_tests.gd
python tools/run_godot.py --record=batch_e_screenshots.log --path . -- --screenshot-test "--shot-dir=$BatchEShots"
  • 生成及复跑:RESULT voice: 282 clips; 12 dynamic skipped; 0 failed; 0 network requests; 7921803 OGG bytes,VOICE GENERATION PASSED,退出 0。日志分别为 batch_e_generate.log、batch_e_normalize.log、batch_e_cached.log。
  • Godot 导入:[ DONE ] loading_editor_layout,EXIT CODE: 0;运行 120 帧:READY: 小岛物语 | 64x44 | 70 props | 6 NPCs | day 1,EXIT CODE: 0。
  • 测试:PASS TTS: 282 exact resolved manifest keys, clip loading/durations/cache keys, Voice buses, real UI playback/skip/fade/fallback, timely/late/stale fake fetch and MP3 disk cache, zero real HTTP;RESULT: 14595 assertions, 0 failures;ALL TESTS PASSED;EXIT CODE: 0。原有 12561 项断言继续通过,新增完整显示文本集合/反向多余键检查、每条音频时长、Python/GDScript 哈希及规范化一致性、播放路径、速度上下限、系统/旁白禁止联网、3 次重试与短响应拒绝。淡出测试等待回调的节点延迟释放完成后检查,避免帧末释放顺序导致误报。
  • 截图:SCREENSHOT TEST PASS: 28 images,EXIT CODE: 0,模式开始和结束均断言真实请求被禁用/计数为零。亲自打开了最终 03_dialogue.png、07_shop.png,对话文本、头像与商店显示正常;未更改其他视觉系统。
  • git diff --check 通过;git diff -- data/npcs.json data/items.json data/map.json DESIGN.md scripts/actor.gd tools/gen_assets.py tools/gen_walk_frames.py 无输出。未提交或改变暂存区。

当批另有工程内试听页 test-results/voice_review.html,每位两句(初遇与口头禅),共12段,使用游戏的 -6 dB 增益。客观解码/响度测量与声音是否贴合角色分开验收:前者见上表;老熊听来是否严肃、阿福语速和句尾是否合适,留给策划试听。这不是公开试听链接。

本批修改 .gitignore、project.godot、scripts/voice.gd、scripts/interface.gd、scripts/world.gd(只接入截图禁网参数/断言)、tests/run_tests.gd 和本说明;新增 data/voices.json、default_bus_layout.tres、tools/gen_voice.py、assets/audio/voice/ 的 282 个 OGG/导入设置与 manifest、tests/fixtures/voice.mp3 及导入设置。原台词、地图、行走帧、商店与存档逻辑不变。

Batch E 验收修复:代理、在线音量与截图稳定性

运行时代理选择顺序为 voices.json.proxy 非空显式值 → HTTPS_PROXY → https_proxy → ALL_PROXY → all_proxy → 直连。空配置启用自动发现,空环境变量继续向后查找。支持 http://host:port、host:port、末尾 / 和带方括号的 IPv6;不支持 SOCKS/认证代理。NO_PROXY(或小写 no_proxy)按端点主机名匹配,支持完整主机、域名及子域、前导点/*. 和全局 *,命中后即使有显式代理也直连。纯静态解析/选择函数有单元测试;HTTP 请求同时设置 set_https_proxy 和 set_http_proxy。正常游戏仍为单次 4 秒、最多 3 次重试;测试/截图仍禁止真实网络。

在线原始片段约 -20 至 -22 LUFS,增加 4.5 dB 后约 -15.5 至 -17.5 LUFS,再应用基础播放音量 -6 dB,接近离线素材的实际播放响度。该补偿基于验收提供的原始响度范围;未重新生成或修改已验收的 282 条离线素材。增益与静音估算通过每个 clip 传递,首次下载、内存和磁盘缓存一致,不会给离线 OGG 叠加补偿。改变这两个全局参数无需重新下载音频,重启游戏即可读取。

独立真实联网脚本 tools/voice_online_smoke.gd 等待第一个 process_frame 后创建请求,使用实际 IslandVoice.request_clip 队列、唯一临时缓存目录,检查真实响应/落盘字节;结束后清理缓存。它不属于 run_tests.gd,只发起一次请求,默认超时 4 秒,CLI 覆盖只作用于本进程。dur 输出的是扣除静音估算后的讲话秒数;ms 包含队列收尾间隔。

python tools/run_godot.py --record=voice_online_smoke.log --headless --path . -s tools/voice_online_smoke.gd
python tools/run_godot.py --record=voice_online_smoke_unreachable.log --headless --path . -s tools/voice_online_smoke.gd -- "--proxy=$UnreachableTestProxy" --timeout=1

也可用自行安装的 Godot console 替代启动器。两条命令分别代表正常接入和故障对照,后者的 $UnreachableTestProxy 代表使用者指定的不可达测试端点;不列原开发环境的连接配置。

截图脚本原先固定等待 3.8 秒,并把按下/释放分隔到两帧;跨帧按下期间若 _process 的 delta 达到 0.15 秒,就可能走入拖动重寻路分支,覆盖点击目标。现在等待渲染后的视口、相机 current、UI 布局、标题淡出和实际可用路径;模拟输入显式 flush,并在同一轮完成按下/释放,之后等待渲染/布局。世界点击另检查真实 _click_world 处理计数,移动失败直接报错退出,避免断言中止协程后一直等总 watchdog。正常游戏拖动逻辑未改。

本次修改 data/voices.json、scripts/voice.gd、scripts/interface.gd、scripts/world.gd、tests/run_tests.gd、本说明;新增 tools/voice_online_smoke.gd 及 Godot 生成的 .uid。未 commit。

本次实际验证(日志在 test-results/):

python tools/run_godot.py --record=batch_e_fix_import.log --headless --path . --import
python tools/run_godot.py --record=batch_e_fix_tests.log --headless --path . -s tests/run_tests.gd
python tools/run_godot.py --record=batch_e_fix_headless.log --headless --path . --quit-after 120
python tools/run_godot.py --record=batch_e_fix_screens_1.log --path . -- --screenshot-test "--shot-dir=$PWD/test-results/screens_fix_1"
python tools/run_godot.py --record=batch_e_fix_screens_2.log --path . -- --screenshot-test "--shot-dir=$PWD/test-results/screens_fix_2"
python tools/run_godot.py --record=batch_e_fix_screens_3.log --path . -- --screenshot-test "--shot-dir=$PWD/test-results/screens_fix_3"
  • 导入:[ DONE ] loading_editor_layout,EXIT CODE: 0,无脚本错误。首次导入发现的静态返回路径错误已修复,此处为修复后完整导入结果。
  • 逻辑测试:PASS voice proxy: pure parsing, precedence, NO_PROXY hosts/domains;RESULT: 14915 assertions, 0 failures;ALL TESTS PASSED;EXIT CODE: 0。包含 282 个离线片段 gain=0、在线首次/缓存 gain 和静音估算、0.4 秒下限、真实 UI 应用增益和打字速度检查。
  • 120 帧 headless:READY: 小岛物语 | 64x44 | 70 props | 6 NPCs | day 1;EXIT CODE: 0。
  • 真实代理成功:VOICE ONLINE SMOKE PASS status=200 bytes=25632 dur=3.372 ms=1419;EXIT CODE: 0。
  • 不可达代理:VOICE ONLINE SMOKE FAIL status=0 result=13 bytes=0 ms=1265 error=none (result 13=timeout, 2=connect failure);EXIT CODE: 1,预期失败;无额外引擎/脚本报错。两种路径结束后均无临时缓存目录残留。
  • 新一次 --import 之后,截图连续三次各输出 SCREENSHOT READY: rendered viewport, UI layout/title, camera and navigation、SCREENSHOT TEST PASS: 28 images -> ...screens_fix_1/2/3、EXIT CODE: 0,均包含真实移动断言和零网络请求断言。已打开检查第二次的日间/点击移动/对话/商店/空商店/夜间图,合览保存在 test-results/batch_e_fix_review.png。
  • git diff --check 通过。此次未修改离线音频、manifest、地图、台词、行走素材或商店/存档逻辑,未 commit 或改变暂存区。

Batch F:四时 BGM、可替换曲目与音量设置

作曲和渲染

运行 python tools/compose_bgm.py,无需 mido;脚本自己写 SMF type 0 MIDI,Python 依赖 numpy 和 imageio-ffmpeg。每首 4/4、32 小节,结构为 A / A’ / B / A’’ 各 8 小节。PIECES 中逐首写明 32 个和弦、两小节问答动机、BPM、调性和 GM 乐器(编号从 0 开始);改 chords、motif、answer 后重跑即可。固定随机种子只用于力度 ±8、起音 ±10 ms;旋律不随机抽音,强拍落和弦音、弱拍级进,反复时改变后两小节,B 段换高音区与轮廓。伴奏分解和弦,低音根/五度;CC7/10/91 控制各声部音量、声像和适量混响。

曲目调性/BPM;主奏与配器AA'BA''
morningF/100;长笛、尼龙吉他、原声贝斯、轻 hi-hat/shakerI vi IV V I iii ii VI vi IV V iii vi ii VIV V iii vi IV I ii VI vi IV V I vi ii V
afternoonC/92;马林巴、单簧管仅叠奏钩子、拨弦弦乐、贝斯、刷奏军鼓I iii IV I vi ii IV VI iii IV I vi ii Vsus Vvi iii IV I ii vi IV VI iii IV I vi ii Vsus V
eveningG/84;电钢琴、尼龙吉他、低音量弦乐、贝斯I iii IV V vi iii ii VI iii IV V vi IV ii VIV V iii vi ii V I VI iii IV V vi IV Vsus V
nightD/68;音乐盒、轻钢琴、弦乐、稀疏贝斯,无鼓I vi IV V iii vi ii VI vi IV V iii vi Vsus VIV I ii vi IV iii ii VI vi IV V I vi Vsus V

早晨是短上行问句、下降回答;午后把动机放在弱拍,单簧管只在每段开头/收尾露面;傍晚用长音和下降轮廓,B 段从 IV 起;夜曲留更长休止,最后一小节后半停止起新音,余响自然接回开头。

工具查找顺序是 CLI 显式路径 → 预备路径 → PATH;ffmpeg 的预备路径由 imageio_ffmpeg.get_ffmpeg_exe() 提供,找不到会明确报错退出。可用 --fluidsynth=<exe>、--soundfont=<sf2>、--ffmpeg=<exe> 覆盖。默认预备路径:

exe、DLL、sf2、临时 WAV 均留在 gitignored 的 .tools/;保留的作品是 _raw/bgm/*.mid(每首两次连奏,约 6–10 KB)及 assets/audio/music/*.ogg。没有添加工具二进制或音色库到版本控制,没有 commit。

MIDI 连奏两遍,FluidSynth 44.1 kHz stereo 渲染;L=round(44100*128*60/BPM),只截 [L,2L),让首部继承前一遍的混响。音符相位统一延后 150 ms(夜曲 250 ms),把接缝放在自然余响里。SF2/混响并非严格逐采样周期,因此另做两端各 2 ms 的端点连续性修正:向共同端点值平滑修正小的 DC 差,保留全部 L 样本,不做淡到零、不挖静音洞。ffmpeg 双遍 linear loudnorm 到 -20 LUFS,再编码 Vorbis stereo q5;最终 OGG 解码后重新测量、检查样本长度、响度与接缝。渲染完成后再运行 Godot 导入,避免导入尚在写入的 OGG。

F 批初版测表。 test-results/bgm_report.json 当时记录的是第一次交付的四首 OGG。表中 RMS/peak 差值为线性满刻度幅度,比较解码后接缝两侧各50 ms;单样本跳变取左右声道最大值。夜曲这行记在这里供前后对照,不能当作修复后成品的测量。

曲目长度 sLUFStrue peak dBTP接缝 RMS 差 / peak 差单样本跳变
morning76.800000-19.95-7.090.001705 / 0.0088500.000488
afternoon83.478254-19.96-4.550.001396 / 0.0041500.000275
evening91.428571-19.97-6.200.003464 / 0.0018010.000092
night112.941179-19.99-2.670.000041 / 0.0002750.000000

自检比较固定种子 1000 处内部相邻 50 ms 窗口的 RMS/peak 波动中位数;四首内部 RMS 波动中位数分别为 0.009017、0.012638、0.004697、0.004120,接缝均更小;实际采样跳变还须小于内部跳变的 99.9 分位。此处对规格“任意随机窗口”采用典型内部波动的统计口径,不是所有随机窗口的最小值(静音/稳态窗口的最小波动可能为零);这是明确的验收口径偏差,保留数值供复核。端点 2 ms 修正也是在原规格第二遍截取基础上的补充处理。

这个标准排查的是接缝突变,两边都静下来也可能“差得很小”。后来回听夜曲才查出约一秒的空洞;新增的连续静音判据及替代测表见F 修复批。

游戏内播放与替换

scripts/music.gd 的 IslandMusic 只读 data/music.json,与 MIDI/AI 生成方式无关。时段沿用 IslandState.time_band():6–12 morning、12–18 afternoon、18–22 evening、22–6 night。始终只有两个 Music 总线播放器;开场 2 秒淡入,时段切换默认 4 秒等功率淡化(sin/cos)。每曲 gain_db 是播放器增益。

将 AI OGG 放进 assets/audio/music/,在对应时段只改配置(然后 Godot 导入/重启):

"morning": {
  "file": "res://assets/audio/music/your_candidate.ogg",
  "gain_db": 0,
  "loop_mode": "crossfade",
  "loop_crossfade": 3.0
}

loop_mode 缺省为 seamless,复制流资源后开启 OGG 原生 loop;crossfade 关闭原生 loop,在 length-loop_crossfade 用另一播放器从 0 播同曲,并等功率淡化。极短片段的淡化长度最多为总长 45%。若时段切换撞上自交叉淡化,先用 120 ms 连续旋转当前增益向量、收掉较轻的一份,再使用空闲播放器切入新时段;最新请求优先,不创建第三个声音,不突然丢掉尚可听到的播放器。自交叉淡化的“增益峰值”测试使用两播放器平方增益之和,测得 0 dB;不同音频片段本身的相位/峰值仍由素材决定。

路径缺失只警告并保持静音/淡到静音。所有 PCM/OGG 的资源释放先停止播放;Godot 4.7.2 的停止由混音线程消费,销毁仍播放的 Music 时等待两个实际混音周期(上限 100 ms),避免 --quit-after 突然退出时保留解码器引用。

NPC 对话 session 打开时 0.4 秒压低音乐 6 dB,结束后 0.8 秒恢复;商店临时隐藏对话框仍属于同一 session,系统提示不压低。Duck 作用于两个播放器、叠加每曲增益,不覆盖用户总线音量。

音量与独立设置

HUD 左上面板右侧新增 ♪ 按钮,打开 440×330 的声音设置面板(中文“音乐音量”“语音音量”“全部静音”)。滑块直接应用 Music/Voice 总线;静音只控制这两个声音总线。IslandAudioSettings 以 ConfigFile 保存到 user://settings.cfg 的 [audio],默认 music=0.7、voice=1.0、muted=false;不改 save.json 的版本、格式或字段。关闭设置不推进正在打字的对话。

默认校准常量 IslandAudioSettings.MUSIC_BASE_DB=-7.0。70% 转线性增益是 -3.098 dB,因此默认 Music 总线为 -10.098 dB。基于四首最终 OGG 的实测 -19.95 至 -19.99 LUFS,播放约 -30.05 至 -30.09 LUFS;对话 duck 后约 -36.05 至 -36.09 LUFS。离线声音实测约 -16 LUFS,播放器 -6 dB、Voice 默认 0 dB,约 -22 LUFS,即高于对话中的音乐约 14 dB。音量是基于最终音频 loudnorm 测量及实际总线/播放器增益计算的电平,不声称已用尚未收到的 AI 素材完成混音。AI 素材若响度不同,用该曲 gain_db 调到约 -20 LUFS 的源素材基准即可。

截图与测试

截图新增 01b_audio_settings.png,整套变为 29 张。截图模式用独立 Timer(每 0.5 秒、PROCESS_MODE_ALWAYS)检查窗口,最小化时恢复 WINDOWED 并前置,输出 SCREENSHOT WARNING: window was minimized, restored;不依赖 frame_post_draw。总超时输出真实耗时、最后完成的截图名、window_mode。--screenshot-minimize-test 是可选故障注入,在 01 后主动最小化一次,用于回归恢复路径。

python tools/compose_bgm.py
python tools/run_godot.py --record=batch_f_import.log --headless --path . --import
python tools/run_godot.py --record=batch_f_tests.log --headless --path . -s tests/run_tests.gd
python tools/run_godot.py --record=batch_f_headless.log --headless --path . --quit-after 120
python tools/run_godot.py --record=batch_f_screenshots.log --path . -- --screenshot-test "--shot-dir=$PWD/test-results/screens_f"
python tools/run_godot.py --record=batch_f_minimized_screenshots.log --path . -- --screenshot-test --screenshot-minimize-test "--shot-dir=$PWD/test-results/screens_f_minimized"

生成器最终输出 BGM COMPOSITION PASS: 4 MIDI + 4 OGG; 5821985 bytes; deterministic A/A'/B/A'' form,退出 0;四个 OGG 合计 5,821,985 字节(约 5.55 MiB),连同导入设置为 5,823,566 字节,低于 12 MB。Godot 导入与 120 帧 headless 均 EXIT CODE: 0,退出资源警告已修复。

F 批运行结果(当时使用隔离启动器;常规环境随后发现的43条失败见 F 修复批):

  • --headless --import:[ DONE ] loading_editor_layout、EXIT CODE: 0,日志 test-results/batch_f_import.log。
  • -s tests/run_tests.gd:RESULT: 15627 assertions, 0 failures、ALL TESTS PASSED、EXIT CODE: 0,日志 test-results/batch_f_tests.log。实时采样的断言数随帧率变化;原 Batch E 全部测试仍通过。缺失曲目用例有一条预期 WARNING: Music track missing: missing ...not_here.ogg,没有脚本错误或资源泄漏警告。
  • 自交叉淡化:MUSIC LOOP CURVE: 211 samples; min power=1.000000 max power=1.000000 peak gain=0.0000 dB;用真实短 PCM 播放位置触发至少两次循环,实际播放器音量与平方增益曲线一致。另覆盖真实世界 11:59→12:00、旧流停止、真实 UI duck/restore、换 OGG 路径、loop 标记、设置滑块/静音/重载、存档版本/字段不变、中途切时段、缺失资源。
  • --headless --quit-after 120:READY: 小岛物语 | 64x44 | 70 props | 6 NPCs | day 1、EXIT CODE: 0,日志 test-results/batch_f_headless.log。
  • 普通截图:SCREENSHOT TEST PASS: 29 images -> ...screens_f、EXIT CODE: 0,日志 test-results/batch_f_screenshots.log。
  • 主动最小化截图:SCREENSHOT WARNING: window was minimized, restored 后继续生成全部图片,SCREENSHOT TEST PASS: 29 images -> ...screens_f_minimized、EXIT CODE: 0,日志 test-results/batch_f_minimized_screenshots.log。亲自打开最终 screens_f_minimized/01b_audio_settings.png,音符按钮不遮挡 HUD,两个滑块与深棕色静音文字正常显示。常规截图及最小化运行均保持零 TTS 网络请求。
  • git diff --check 通过;离线 TTS、地图、台词和行走素材没有 diff。没有执行 git add 或 commit。

本批新增 tools/compose_bgm.py、_raw/bgm/*.mid、assets/audio/music/*.ogg 及导入设置、data/music.json、scripts/music.gd、scripts/audio_settings.gd(及 .uid);修改 scripts/interface.gd、scripts/world.gd、tests/run_tests.gd、本说明。沿用 Batch E 的音频总线;语音、地图、NPC、行走素材、存档代码未改。未 commit。

当时交给制作人的问题是:午后的马林巴是否抢耳?夜曲音乐盒的高音舒不舒服?重复32小节后会不会疲劳?这些不是上表能代答的。四个时段最后都选了 MIDI,选择过程见音频设计。

Batch F 验收修复:测试存档隔离与夜曲连续性

F 批验收方在常规运行环境报告43条失败;这不是下面修复复测的断言次数。根因属于 (a) 测试隔离问题。world._ready() 原本就先读取存档,再初始化音乐,游戏的加载顺序正确。旧测试却读取调用者的真实存档,然后强设 11:59,并假定一次 music._process(5.0) 能完成所有阶段。如果存档来自其他时段,开场淡入期间切换时段会先进入 retire;该次调用只完成收退并开始下一阶段,不能同时完成后续淡入。因此中午断言碰到的是尚未完成的过渡,产生连锁失败。实际逐帧更新可以正常完成;没有修改 scripts/music.gd。

world.gd 新增可在入树前注入的 save_path,读取及自动保存共用它,正常游戏仍默认 user://save.json。测试在 res://.tools/test-runs/<进程号>_<时间戳>/ 建立独立存档、设置、语音缓存和导出夹具,结束后清理;不再依赖运行器替换 APPDATA。音乐测试明确加载 11:59 夹具,另覆盖下午、傍晚、夜间存档的初始曲目、淡入期间切时段,以及随后 11:59→12:00 的真实世界更新。测试还在真实存档可读时对整个测试过程执行只读 SHA256 前后比较。

夜曲弦乐 pad 改为每小节保持 4.45 拍,跨过下一小节起音,包含最后一小节接回第一小节;主旋律和钢琴的留白保留。新增命令只重渲染指定曲目,但仍检查全部四首成品:

python tools/compose_bgm.py --only night

自检逐采样检查双声道均低于 -60 dBFS 的连续区间,同时合并尾部和头部的循环区间,超过 250 ms 就报错退出;每首输出 longest_silence_ms 等字段。249 ms / 251 ms 边界、尾首各 150 ms 的循环区间、单声道仍有声音的情况均已单独检查。该检查能拒绝修复前夜曲(本次解码测得循环静音 1089.274 ms)。接缝仍沿用已验收的内部相邻 50 ms 窗口波动中位数标准。

F 修复批替代测表,仅替代 F 初版的 night 行。 四首没有全部重作;夜曲保留主旋律的休止,底下的弦乐不断。

指标结果
长度112.941179 s
响度 / true peak-19.98 LUFS / -2.62 dBTP
全曲最长静音 / 循环接缝静音0.294785 ms / 0 ms
接缝 RMS 差 / 内部 RMS 差中位数0.00144477 / 0.00404681
接缝 peak 差 / 内部 peak 差中位数0.01058960 / 0.01274109
接缝单采样跳变0.00109863
文件大小1,859,066 字节

生成器输出 BGM COMPOSITION PASS: rendered night; checked 4 MIDI + 4 OGG; 5850401 bytes; deterministic A/A'/B/A'' form,退出 0。其余三首 MIDI/OGG 没有 diff,OGG SHA256 与修复前一致;其最长静音分别为 morning 0.816327 ms、afternoon 0.589569 ms、evening 0.340136 ms。

实际验证使用工作区内官方 Godot 4.7.2 console 可执行文件(安装路径在本沙箱不可访问)。导入命令 python tools/run_godot.py --record=batch_f_fix_import.log --headless --path . --import 退出 0。以下测试均直接启动 Godot,没有经过 tools/run_godot.py,并向 --log-file 传工作区内的绝对日志路径:

& .\.tools\Godot_v4.7.2-stable_win64_console.exe --headless --path . --log-file "$PWD\test-results\batch_f_fix_real_engine.log" -s tests/run_tests.gd
环境实际输出退出码记录
保持真实 APPDATARESULT: 15661 assertions, 0 failures / ALL TESTS PASSED0test-results/batch_f_fix_real_direct.log
APPDATA 指向新建空目录(LOCALAPPDATA 同步隔离)RESULT: 15628 assertions, 0 failures / ALL TESTS PASSED0test-results/batch_f_fix_empty_direct.log

断言数含按实际帧采样的音乐曲线检查,所以随运行帧率变化。缺失曲目的预期 warning 仍保留,没有脚本错误。两次运行的 TEST ISOLATION 分别确认使用真实用户目录和全新空用户目录。

存档证据的边界: 本轮沙箱不能读取真实 user://save.json,所以无法证明原档前后字节相同,也没有在可读原档条件下复现旧失败。两次日志均打印 USER SAVE GUARD: save absent or unreadable; byte comparison unavailable。测试世界用注入的夹具;只在原档可读时才另做前后 SHA-256 比较。

本次仅修改本说明、scripts/world.gd、tests/run_tests.gd、tools/compose_bgm.py、_raw/bgm/night.mid、assets/audio/music/night.ogg。未执行 commit。

Batch G:玩法演示视频(自动驾驶 + Movie Maker)

python tools/record_demo.py            # 默认 1920x1080 → test-results/demo/cozy_island_demo.mp4
python tools/record_demo.py --size 1280x720 --out <path.mp4>
  • -- --demo 启动 scripts/demo_director.gd:全新的第 1 天 8:20,不读写存档,固定随机种子,语音只用离线片段(结束时断言 TTS 网络请求为 0),用默认音量而不是本机的 settings.cfg。所有操作都走真实鼠标事件(与 _screen_click 同一条路径)。Movie Maker 不录系统光标,所以画面里另画一个箭头指针,带滑动、按下回弹和点击波纹。
  • IslandDialogue.forced("id:pool" → 下标)用来固定几句短台词,保证总时长可控;正常游戏里它为空。橘子、棉花、狸叔原地不动,其余居民照常闲逛。
  • 分镜(时间为 1080p 实录):0 s 标题 → 2.0 s 点地走路 → 4.9 s 摇果树、捡苹果 → 6.9 s 摘郁金香 → 8.3 s 捡贝壳 → 10.0 s 打开背包 → 11.9 s 初见橘子并聊天 → 23.3 s 送苹果(喜欢,好感 +3)→ 33.8 s 狸叔小店卖贝壳(+60 铃钱)→ 47.4 s 18:00→22:15 延时(暮色、路灯窗光、BGM 早晨→傍晚→夜晚、居民回家、镜头拉远)→ 55.8 s 画面和声音一起淡出,57.3 s 结束。
  • 录制工具用 --write-movie … --fixed-fps 30 逐帧渲染(不受机器卡顿影响,结果可复现)。MJPEG 质量和窗口尺寸覆盖只在本次运行时写进 override.cfg,结束后还原(项目里的 window_width_override 比 --resolution 优先)。之后用 ffmpeg 编码 H.264 CRF 18 + AAC 192k,两遍 loudnorm(线性增益)到 -16 LUFS / -1.5 dBTP,并自检时长 ≤ 60 s、分辨率和音轨。
  • 实测:57.4 s,1920×1080,48 MB,-15.8 LUFS;demo 单测(存档不动、离线、固定台词)通过。

截至 G 批仍保留的限制

  • 已知表现限制:高物件避挡区域使用包围矩形近似,靠近树冠透明边角时也可能提前淡化;物件点击另外检查了 alpha,落地小物品保留较宽松的点击区域。寻路使用独立格子占地。角色使用正面步行帧与左右翻转,没有额外的侧面/背面帧;Batch D 按本轮要求替代 §5 的单图步行表现。
  • 当批未发现阻断运行、逻辑测试或截图模式的故障。画面与台词是否合意仍由策划验收;录制用的固定站位不是普通游玩的承诺。

工程文件索引(含后续批次新增项)

project.godot                 引擎、窗口、字体、主场景设置
scenes/main.tscn              精简入口场景
scripts/world.gd              世界构建、输入、交互、昼夜、截图编排
scripts/navigation.gd         网格、阻挡、最近格与路径平滑
scripts/actor.gd              人物动画和居民状态机
scripts/prop.gd               物件表现、遮挡、采集与夜间灯光
scripts/interface.gd          HUD、对话、背包、商店、合成语音
scripts/dialogue.gd           台词抽取、去重与占位符
scripts/game_state.gd         好感、时钟、背包、结算、存档
scripts/ground.gdshader       连续地形和水面
data/map.json                 ASCII 地形、物件占地、门口、尺寸
data/npcs.json                六位居民及全部中文台词
data/items.json               五种物品、价格与堆叠上限
assets/fonts/                 中文字体及授权
assets/sprites/               33 张透明 PNG
assets/sprites/walk/          35 张逐帧人物 PNG、共用画布/脚底/校色元数据
tools/process_assets.py       四边颜色采样、连通抠图、羽化与检查图
tools/process_walk.py         共用原尺寸抠图、头部对齐、校色、统一裁剪与检查图
tools/build_data.py            数据作者源稿与确定性地图生成
tools/bake_font.gd             将提供的 TTF 存为首次导入即可读取的原生字体
tools/fetch_godot.py           官方 4.7.2 下载、续传、校验
tools/run_godot.py             受限环境启动器及日志记录
tests/run_tests.gd             自动化逻辑测试
_raw/cutout_check.png          全部抠图的棋盘格检查图
test-results/                 本机日志与验收截图(忽略版本控制)
.tools/                       本机引擎及隔离用户配置(忽略版本控制)

本文写作中使用了 AI 辅助。文字采用 CC BY-NC-SA 4.0 许可。

最后更新于