docs: P20 第三步河景与可玩接入收口说明与取证命令

- 记录默认 256x192 生成器世界接入、LV_LEGACY_MAP 回退、桥头灯笼与
  bridgeLanternTiles、序列化确定性与测试计数（Desktop 121 / Kernel 90）。
- 补 p20c-* 昼夜巡游取证命令与快照位置、性能门槛复述。

1 files changed, 32 insertions, 1 deletions

diff --git a/docs/维护说明.md b/docs/维护说明.md
index 0123fa3..ce08443 100644
--- a/docs/维护说明.md
+++ b/docs/维护说明.md
@@ -290,6 +290,28 @@ dotnet src/LivingVillage.Headless/bin/Release/net8.0/LivingVillage.Headless.dll
   裁剪帧 1050/49152 = 2.1%，1:1 单帧 ≈ 0.7 ms（implied ≈1300-1600 fps）。
 - 门槛同上：clean rebuild 0/0；`final_digest` 3 次一致、`performance_determinism=PASS`。
 
+## P20 第三步：河景与可玩接入收口
+
+- 默认可玩世界改走 **256x192 生成器**：`Game` 启动时 `Sim.configureBounds 256 192` 并
+  `MapGen.generateWithSize 256 192 42UL`，用 `WorldBootstrap.initialWorldInMap` 以生成器核心可达区站位
+  （30 NPC 全落可达核心，avatar 落核心中心）；`LV_LEGACY_MAP=1` 或 `LV_MAP_SCALE>1`/`LV_MAP_TOUR=1`
+  回退旧路径（64x48 样例世界 / ProceduralMap 大世界）。`WorldBootstrap.initialWorldWithPlacement`
+  为显式站位入口，旧 64x48 函数字节口径不变（Kernel/Desktop 既有断言不动）。
+- 渲染接入：`VillageArt.drawWorld` 新增 `pixel` 与 `mapGen : MapGen.Result option`——
+  Some 时按生成器瓦片绘制地面（1 水 / 2 石板路 / 其余草地）、叠加 `drawMapStructures`（桥面 + 白墙黑瓦民居 + 门）
+  与桥头 `LanternSprite`，并跳过 64x48 样例平面/道具；水格沿用既有 `waterFrameTickAt` 多相位波纹。
+- 河景灯笼：新增 `VillageArt.bridgeLanternTiles`（每桥每列最上/最下格 = 桥两端）；夜间 `LanternGlow`
+  沿用既有预乘同心圆 `lanternGlowLayers ... 255 214 150`（软暖盘，无过曝白芯），生成器世界用桥头灯笼位置。
+- 确定性：`MapGen.serialize` 对尺寸/seed/瓦片/河道/桥/路/民居做序列化，同 seed 逐字节一致；
+  `SameSeedSerializationIsByteIdentical` + `MapWorldPlacementUsesReachableCoreSpawns` 两条新测试。
+- 回归：Desktop **119 -> 121**，Kernel **90** 不变；clean rebuild 0 警告 0 错误；
+  `final_digest=953775FAEB2FDDE97289491AA260BD8D390C571E48A7A13AD2CB6FB7124F7F6C` 3 次一致、
+  `performance_determinism=PASS`（未触 Kernel/Sim 数值路径）。
+- 证据（`LV_AUTOPLAY_SAMPLE=1 LV_RIVERSCAPE_TOUR=1`，`LV_RECORD_NAME=p20c-*`）：真人走位巡游沿桥/路/民居门
+  逐帧录制，`/tmp/opencode/lv-p20-art/p20c-day-*.png`（`LV_AUTOPLAY_START_HOUR=12.0`）与
+  `p20c-night-*.png`（20.75）各若干；挑出 `p20c-day-bridge-01.png`、`p20c-day-buildings-01.png`、
+  `p20c-night-bridge-01.png`、`p20c-night-lantern-01.png` 等代表性帧；716 张全过白块回归 0 命中。
+
 ## 已验证命令
 
 ```bash
@@ -335,6 +357,13 @@ for pair in noon:12.0 dusk:20.75 night:0.5; do name=${pair%%:*}; hour=${pair##*:
     LV_RECORD_DIR=/tmp/opencode/lv-p19-art/$name LV_RECORD_EVERY=2 \
     dotnet src/LivingVillage.Desktop/bin/Release/net8.0/LivingVillage.Desktop.dll; done
 
+# P20 第三步：默认生成器世界的昼夜巡游录制（真走位，含桥面行走帧；p20c-* 命名）
+for pair in day:12.0 night:20.75; do name=${pair%%:*}; hour=${pair##*:}; \
+  timeout 150 xvfb-run -a -s "-screen 0 1280x720x24" env LV_AUTOPLAY_SAMPLE=1 \
+    LV_RIVERSCAPE_TOUR=1 LV_AUTOPLAY_RECORD=1 LV_RECORD_EVERY=20 LV_RECORD_NAME=p20c-$name- \
+    LV_RECORD_DIR=/tmp/opencode/lv-p20-art/p20c-$name LV_AUTOPLAY_START_HOUR=$hour \
+    dotnet src/LivingVillage.Desktop/bin/Release/net8.0/LivingVillage.Desktop.dll; done
+
 # P20 大地图生成器取证（整图 + 裁剪帧；每 seed 一拍即退，日志打印 gen_ms/drawn/culled）
 for seed in 4242 7 99; do timeout 120 xvfb-run -a -s "-screen 0 1280x720x24" env \
   LV_MAPGEN_SHOT=1 LV_MAPGEN_WIDTH=256 LV_MAPGEN_HEIGHT=192 LV_MAPGEN_SEED=$seed \
@@ -380,7 +409,9 @@ 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-p20-art/`（P20：第一步 `mapgen-256x192-seed{4242,7,99}.png` 整图、
+- `/tmp/opencode/lv-p20-art/`（P20 第三步：默认生成器世界昼夜巡游 `p20c-day-*.png`/`p20c-night-*.png`
+  （含桥面行走）、代表帧 `p20c-day-bridge-01.png`/`p20c-day-buildings-01.png`/
+  `p20c-night-bridge-01.png`/`p20c-night-lantern-01.png`；P20：第一步 `mapgen-256x192-seed{4242,7,99}.png` 整图、
   `mapgen-culled-256x192-seed{4242,7,99}.png` 裁剪帧；第二步 `p20b-map-256x192-seed{4242,7,99}.png`
   整图（含桥/路/沿河民居）、`p20b-detail-256x192-seed{4242,7,99}.png` 桥/路/民居 1:1 近景、
   `p20b-culled-256x192-seed{...}.png` 裁剪帧）