diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/维护说明.md | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/维护说明.md b/docs/维护说明.md index 3e055c3..14d11f6 100644 --- a/docs/维护说明.md +++ b/docs/维护说明.md @@ -201,6 +201,29 @@ dotnet src/LivingVillage.Headless/bin/Release/net8.0/LivingVillage.Headless.dll 回归：`StartTickResolutionHonoursEvidenceHourThenDaylightThenMidnight`（Desktop 107→108）， 实测 `tick`：昼 12.0→2,592,000、黄昏 20.75→4,482,000、夜 0→0，`sample.mp4` 为黄昏 20:45。 以上新文件名（`p17-day-12h-*` / `p17-dusk-20h45-*` / `p17-night-00h-*`）为准，旧名作废。 + （P18 复核确认：这批帧起时虽已正确为 20:45，但画面仍为夜蓝冷调，原因是暖色渲染链缺失， + 见 §P18；P17 黄昏/夜间帧的起时有效、但暖色未生效，最终以 P18 证据为准。） + +- 门槛：clean rebuild 0 警告 0 错误；`final_digest=953775FAEB2FDDE97289491AA260BD8D390C571E48A7A13AD2CB6FB7124F7F6C` + 一致、`performance_determinism=PASS`。 + +## P18 批验：黄昏暖色调真实渲染整改 + +- 根因（渲染调用链）：①`lightingBlend` 黄昏暗化窗口 19:30–22:00，使 20:45 的 `blend=0.5`，`Mode` 直接落到 + Night；②暖色仅经 `worldTintAtWarmth` 的**乘性** tint（R+10 / G−6 / B−26）施加于世界，而乘性通道无法把 + 低 R 的绿色植被染成橙色，地面依旧偏绿；③`timePeriodLabel` 20:00 起即为「夜晚」，与暖色窗口错位。 +- 修复：黄昏**暗化**窗口改为 20:00→22:00（20:45 `blend=0.375`，仍 Day），暖色 bump 独立为 19:15–21:45 + （峰值 20:30）；`backgroundAtWarmth` 暖移加强（R+120 / G+20 / B−90），`worldTintAtWarmth`（R+70 / G−10 / + B−75）；新增纯函数 `goldenVeilAlpha`（0..150，峰 150），`Game.DrawWorldView` 在世界与角色绘制后叠加 + **预乘暖色整屏 veil**（`premultiply 255 150 70 veilAlpha`，预乘按自身 alpha 缩放、不会饱和成白块）， + 补上「加性暖光」这一缺失环节；`LanternGlow = max blend (warmth * 0.8)` 让黄昏灯笼同步暖亮； + `timePeriodLabel` 黄昏延到 21:00。 +- 回归：更新光照锚点/单调/确定性用例并新增 veil 锚点（正午/午夜 0、20:30 峰 150、19:00 前 0）， + Desktop 108 / Kernel 89（Kernel 未动）。 +- 证据：`/tmp/opencode/lv-p18-art/`（`p18-dusk-20h45-0{1,2}.png`、`p18-night-deep-01.png`、 + `p18-before-old-dusk-blue.png` vs `p18-after-new-dusk-warm.png`、`sample-dusk.mp4` 13.2 s）。 + 像素复验：旧黄昏画面均值 (55,81,54)（R−B≈1，冷蓝）→ 新黄昏 (153,115,57)（R−B≈95，暖橙），深夜 + (34,60,56) 仍冷；`check-no-white-blocks.py` 0 命中。 - 门槛：clean rebuild 0 警告 0 错误；`final_digest=953775FAEB2FDDE97289491AA260BD8D390C571E48A7A13AD2CB6FB7124F7F6C` 一致、`performance_determinism=PASS`。 @@ -242,6 +265,12 @@ for pair in day:12.0 dusk:20.75 night:0.0; do name=${pair%%:*}; hour=${pair##*:} LV_AUTOPLAY_START_HOUR=$hour LV_AUTOPLAY_RECORD=1 \ LV_RECORD_DIR=/tmp/opencode/lv-p17-art/$name LV_RECORD_EVERY=2 \ dotnet src/LivingVillage.Desktop/bin/Release/net8.0/LivingVillage.Desktop.dll; done +# P18 黄昏暖色取证（20:45 真实帧；深夜把 20.75 换成 0） +timeout 100 xvfb-run -a -s "-screen 0 1280x720x24" env LV_AUTOPLAY_SAMPLE=1 \ + LV_AUTOPLAY_START_HOUR=20.75 LV_AUTOPLAY_RECORD=1 \ + LV_RECORD_DIR=/tmp/opencode/lv-p18-art/dusk LV_RECORD_EVERY=2 \ + dotnet src/LivingVillage.Desktop/bin/Release/net8.0/LivingVillage.Desktop.dll + # 街边细节图集再生成（确定性，二次运行 byte-identical） python3 scripts/make-jiangnan-art.py @@ -275,6 +304,8 @@ python3 scripts/check-no-white-blocks.py evidence/night-run - `/tmp/opencode/lv-p13/evidence/`（P13：`walk-idle-frames.png`、`water-3phase.png`、 `smoke-3phase.png`、`water-2frame.png`、`smoke-2frame.png`、`day-panorama.png`、 `night-lantern.png`、`day-night-compare.png`、`walk-real-run.png`、`day-run/`、`night-run/`） +- `/tmp/opencode/lv-p18-art/`（P18：`p18-dusk-20h45-0{1,2}.png`、`p18-night-deep-01.png`、 + `p18-before-old-dusk-blue.png`/`p18-after-new-dusk-warm.png`、`sample-dusk.mp4`；同一份拷入 `evidence/`） - `/tmp/opencode/lv-p17-art/`（P17：`p17-day-12h-0{1,2}.png`、`p17-dusk-20h45-0{1,2}.png`、 `p17-night-00h-0{1,2}.png`、`p17-diff-before-dawn.png`/`p17-diff-after-dawn.png`、`sample.mp4`； 同一份拷入 `evidence/`） |