diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/维护说明.md | 25 |
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/` 巡游帧） |