merge: P24 512x384 民居密度/村民可辨（writer hash 保留）

1 files changed, 25 insertions, 0 deletions

diff --git a/docs/维护说明.md b/docs/维护说明.md
index b9bd9fe..79ca370 100644
--- a/docs/维护说明.md
+++ b/docs/维护说明.md
@@ -388,6 +388,20 @@ dotnet src/LivingVillage.Headless/bin/Release/net8.0/LivingVillage.Headless.dll
 - 取证钩子：`LV_RIVERSCAPE_WIDTH`/`LV_RIVERSCAPE_HEIGHT`（默认 256x192）把生成器世界扩到
   512x384 跑巡游/性能；`LV_MAPGEN_SHOT=1` + `LV_MAPGEN_WIDTH/HEIGHT/SEED` 出整图。
 
+## 民居密度参数（P24）
+
+- `MapGen.Params.ExtraRiversideHouses`：大图额外沿河民居数量，默认 0；`paramsForSize` 仅对
+  `width>256 || height>192` 设为 **10**。512x384 在原有 8 座桥点民居上再按现有路网泊松散布
+  10 座（`structureRng` 确定性），**共 18 座**，门全部接入路网且 BFS 可达；64x48/256x192 仍
+  4 座、checksum 6042052 / 1284656962 不变。
+- 民居渲染改用 256x192 同款部件：黛瓦（`RoofRidgeSprite`/`RoofEaveSprite`）+ 木墙/窗
+  （`WallWoodSprite`/`WallWindowSprite`）+ 门（`DoorSprite`），替换原黑白矩形色块。
+- 村民可见性证据钩子 `LV_NPC_VISIBLE_LOG=1`：每秒打印 `visible-npcs=K of 30`；512x384 巡游中
+  观测到最大 30/30 全部在屏（`/tmp/opencode/lv-p24-tour.txt`）。
+- 取证：`/tmp/opencode/lv-p24-art/`（`p24-map-512x384-seed{4242,7}.png` 整图、
+  `p24-zoom-houses.png`/`p24-zoom-villagers.png` 局部放大含民居与村民、`p24-tour-0{1,2,3}.png`
+  tour 页、`tour512/` 全量帧），白块回归 0 命中。
+
 ## 已验证命令
 
 ```bash
@@ -473,6 +487,14 @@ timeout 280 xvfb-run -a -s "-screen 0 1280x720x24" env LV_AUTOPLAY_SAMPLE=1 \
   LV_UNLOCK_FPS=1 LV_PERF_SUMMARY=1 \
   dotnet src/LivingVillage.Desktop/bin/Release/net8.0/LivingVillage.Desktop.dll
 
+# P24 512x384 民居密度取证：整图 + 巡游（记录帧；LV_NPC_VISIBLE_LOG 打印可见村民数）
+timeout 240 xvfb-run -a -s "-screen 0 1280x720x24" env LV_AUTOPLAY_SAMPLE=1 \
+  LV_RIVERSCAPE_TOUR=1 LV_RIVERSCAPE_WIDTH=512 LV_RIVERSCAPE_HEIGHT=384 \
+  LV_UNLOCK_FPS=1 LV_NPC_VISIBLE_LOG=1 LV_AUTOPLAY_RECORD=1 LV_RECORD_EVERY=120 \
+  LV_RECORD_NAME=p24-tour- LV_RECORD_DIR=/tmp/opencode/lv-p24-art/tour512 \
+  dotnet src/LivingVillage.Desktop/bin/Release/net8.0/LivingVillage.Desktop.dll
+# 局部放大由 tour512 帧裁 480x360 后 2x 最近邻放大（含民居+村民）
+
 # 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 \
@@ -525,6 +547,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-p24-art/`（P24 512x384：`p24-map-512x384-seed{4242,7}.png` 整图、
+  `p24-zoom-houses.png`/`p24-zoom-villagers.png` 局部放大、`p24-tour-0{1,2,3}.png` tour 页、
+  `tour512/` 全量巡游帧；规格要求的 `/tmp/lv-p24-art` 被沙箱 external_directory deny，落此路径）
 - `/tmp/opencode/lv-p23-art/`（P23 512x384：`p23-map-512x384-seed{4242,7}.png` 整图真实渲染、
   `p23-culled-512x384-seed{4242,7}.png` 视口裁剪、`p23-detail-512x384-seed{4242,7}.png` 1:1 近景、
   `tour512/` 巡游帧）