小岛物语 · 实现与验收记录
这是开发批次的证据附录。命令、测表和日志摘录记录的是作者与实现方当时做过的检查,不是本页向玩家交付的游戏、原图或音频。想先看岛上能做什么,可读一分钟玩法演示的制作手记;要追一个问题在哪一轮被改掉,从下面的批次进入。
| 批次 | 在这里核对什么 | 当批结论的边界 |
|---|---|---|
| v1 | 76个物件、17张截图;移动、送礼、卖出与存档 | 棋盘底漏掉栅栏浅绿块,首轮观感不是定论 |
| A | 深色底复查与暖色灯 | 修的是素材与混合方式,不是寻路 |
| B | 横桥、岸线、70个物件 | 视觉岸线与不可走格分别检查 |
| C | 栏杆遮挡、商店面板、7份WAV | 导出基准音不等于逐字播放时的随机音高 |
| D | 35张步行帧、头部对齐测表 | 颜色误差不评价步态好不好看 |
| E · E 修复 | 固定配音、未录动态句;联网、增益与截图时序 | 客观解码和角色试听分开,常规测试没有访问服务 |
| F · F 修复 | 四曲初测、夜曲重测;隔离前后对照 | 修复表取代初版夜曲;两环境通过不等于读取了原档 |
| G | 57.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):
| 角色 | RMSE | a / p / b / p2 平移 |
|---|---|---|
| player | 1.891–2.136 | (0,0) / (0,1) / (0,0) / (0,1) |
| npc_cat | 2.646–3.090 | (-1,1) / (-1,4) / (0,1) / (0,0) |
| npc_dog | 2.776–3.086 | (1,1) / (1,0) / (0,0) / (1,0) |
| npc_rabbit | 2.014–2.292 | (0,0) / (0,0) / (0,0) / (0,0) |
| npc_bear | 2.685–2.962 | (0,0) / (0,1) / (0,0) / (0,1) |
| npc_duck | 2.170–2.586 | (0,0) / (0,0) / (0,1) / (0,0) |
| npc_raccoon | 2.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 |
|---|---|---|---|---|
| 橘子 | 47 | 168.26 | 0.2095(0.1683–0.2878) | -15.89 |
| 阿福 | 47 | 188.13 | 0.2415(0.1758–0.3253) | -15.92 |
| 棉花 | 47 | 192.72 | 0.2311(0.1916–0.2773) | -15.93 |
| 老熊 | 47 | 186.79 | 0.2383(0.1900–0.3344) | -16.38 |
| 嘎嘎 | 47 | 176.37 | 0.2120(0.1500–0.3117) | -16.09 |
| 狸叔 | 47 | 169.40 | 0.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;主奏与配器 | A | A' | B | A'' |
|---|---|---|---|---|---|
| morning | F/100;长笛、尼龙吉他、原声贝斯、轻 hi-hat/shaker | I vi IV V I iii ii V | I vi IV V iii vi ii V | IV V iii vi IV I ii V | I vi IV V I vi ii V |
| afternoon | C/92;马林巴、单簧管仅叠奏钩子、拨弦弦乐、贝斯、刷奏军鼓 | I iii IV I vi ii IV V | I iii IV I vi ii Vsus V | vi iii IV I ii vi IV V | I iii IV I vi ii Vsus V |
| evening | G/84;电钢琴、尼龙吉他、低音量弦乐、贝斯 | I iii IV V vi iii ii V | I iii IV V vi IV ii V | IV V iii vi ii V I V | I iii IV V vi IV Vsus V |
| night | D/68;音乐盒、轻钢琴、弦乐、稀疏贝斯,无鼓 | I vi IV V iii vi ii V | I vi IV V iii vi Vsus V | IV I ii vi IV iii ii V | I vi IV V I vi Vsus V |
早晨是短上行问句、下降回答;午后把动机放在弱拍,单簧管只在每段开头/收尾露面;傍晚用长音和下降轮廓,B 段从 IV 起;夜曲留更长休止,最后一小节后半停止起新音,余响自然接回开头。
工具查找顺序是 CLI 显式路径 → 预备路径 → PATH;ffmpeg 的预备路径由 imageio_ffmpeg.get_ffmpeg_exe() 提供,找不到会明确报错退出。可用 --fluidsynth=<exe>、--soundfont=<sf2>、--ffmpeg=<exe> 覆盖。默认预备路径:
- FluidSynth 2.6.1:
.tools/fluidsynth/fluidsynth-v2.6.1-win10-x64-cpp11/bin/fluidsynth.exe。从 https://github.com/FluidSynth/fluidsynth/releases/tag/v2.6.1 下载 Windows 包并解压。 - GeneralUser GS v2.0.3:
.tools/soundfonts/GeneralUser-GS.sf2。从 https://schristiancollins.com/generaluser.php 下载,保留随包许可,另按具体版本及用途核对条款。 - Python 可用
pip install numpy imageio-ffmpeg,后者携带带 libvorbis 的 ffmpeg。
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;单样本跳变取左右声道最大值。夜曲这行记在这里供前后对照,不能当作修复后成品的测量。
| 曲目 | 长度 s | LUFS | true peak dBTP | 接缝 RMS 差 / peak 差 | 单样本跳变 |
|---|---|---|---|---|---|
| morning | 76.800000 | -19.95 | -7.09 | 0.001705 / 0.008850 | 0.000488 |
| afternoon | 83.478254 | -19.96 | -4.55 | 0.001396 / 0.004150 | 0.000275 |
| evening | 91.428571 | -19.97 | -6.20 | 0.003464 / 0.001801 | 0.000092 |
| night | 112.941179 | -19.99 | -2.67 | 0.000041 / 0.000275 | 0.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| 环境 | 实际输出 | 退出码 | 记录 |
|---|---|---|---|
| 保持真实 APPDATA | RESULT: 15661 assertions, 0 failures / ALL TESTS PASSED | 0 | test-results/batch_f_fix_real_direct.log |
| APPDATA 指向新建空目录(LOCALAPPDATA 同步隔离) | RESULT: 15628 assertions, 0 failures / ALL TESTS PASSED | 0 | test-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 许可。