diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/维护说明.md | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/docs/维护说明.md b/docs/维护说明.md index 9c44f48..b9bd9fe 100644 --- a/docs/维护说明.md +++ b/docs/维护说明.md @@ -365,6 +365,29 @@ dotnet src/LivingVillage.Headless/bin/Release/net8.0/LivingVillage.Headless.dll - 个别帧右侧有**孤立砖石小块**（地面 `GroundTile.Stone=2` 单格，`VillageArt.fs:664` 绘 `StonePathSprite`），疑似路网/门阶的单格支路残留，需后续单用定点帧确认后再修。 +## 大世界扩程 512x384（P23） + +- Kernel/Sim：边界本就是可变参数（`Sim.configureBounds w h`，默认仍 64x48）；512x384 直接可用。 + 存档 v2/v3 头两字段即 `bounds.w|bounds.h`，v1 旧档仍按 64x48 读入（`WorldSave.parse`）。 + 512x384 存档 round-trip、同 world 两次保存逐字节一致、长跑 20000 tick 的 avatar/NPC 边界 + 与有限性均由 Kernel 用例覆盖（Kernel 90 -> 92）。 +- MapGen 尺寸自适应（`paramsForSize`）： + - 河道数量约每 96 行一条：64x48/256x192 仍 2 条，512x384 得 4 条；第 3 条起在核心区上/下方 + 逐层外扩，互不重叠、不压核心，仍满足「每列恰好一段、宽度 >= RiverWidth、水格 >=2 水邻居」。 + - 噪声特征尺度封顶 4x（`noiseWidthScale`），避免大图退化成过度平滑的放大图；泊松布点间距 + `w/24`、尝试数 `(w*h)/16` 本就随尺寸缩放。 + - **64x48 / 256x192 生成结果逐字节不变**（新增 checksum 锁定用例：64x48=6042052、 + 256x192=1284656962）。默认世界仍是 256x192，本轮不切换。 +- 生成耗时（本机实测，单次）：64x48 ≈ 3 ms；256x192 ≈ 55 ms；512x384 ≈ 134-248 ms + （一次性、进入世界前）。 +- 512x384 巡游帧率（Xvfb 1280x720x24，Desktop Release，`LV_UNLOCK_FPS=1` 放开 vsync）： + 单趟巡游 161.7 s，`perf-summary samples=156 mean_fps=153.84 min_fps=51.64 max_fps=228.81`； + 运行中 `VmRSS` 185.9-201.9 MB。默认 vsync+固定步长为稳定 60 FPS。 +- 取证：`/tmp/opencode/lv-p23-art/`（`p23-map-512x384-seed{4242,7}.png` 整图真实渲染、 + `p23-culled-*`/`p23-detail-*` 视口/近景、`tour512/` 巡游帧），白块回归 0 命中。 +- 取证钩子：`LV_RIVERSCAPE_WIDTH`/`LV_RIVERSCAPE_HEIGHT`（默认 256x192）把生成器世界扩到 + 512x384 跑巡游/性能；`LV_MAPGEN_SHOT=1` + `LV_MAPGEN_WIDTH/HEIGHT/SEED` 出整图。 + ## 已验证命令 ```bash @@ -438,6 +461,18 @@ timeout 120 xvfb-run -a -s "-screen 0 1280x720x24" env LV_LEGACY_MAP=1 \ LV_AUTOPLAY_SAMPLE=1 LV_UNLOCK_FPS=1 LV_PERF_SUMMARY=1 LV_PERF_SOAK_SECONDS=60 \ dotnet src/LivingVillage.Desktop/bin/Release/net8.0/LivingVillage.Desktop.dll +# P23 512x384 扩程取证：整图真实渲染 + 视口/近景（seed 4242 与 7） +for seed in 4242 7; do timeout 120 xvfb-run -a -s "-screen 0 1280x720x24" env \ + LV_MAPGEN_SHOT=1 LV_MAPGEN_WIDTH=512 LV_MAPGEN_HEIGHT=384 LV_MAPGEN_SEED=$seed \ + LV_RECORD_DIR=/tmp/opencode/lv-p23-art \ + dotnet src/LivingVillage.Desktop/bin/Release/net8.0/LivingVillage.Desktop.dll; done + +# P23 512x384 巡游帧率（单趟，解锁 vsync；日志打印 perf-summary 与 VmRSS 可另采） +timeout 280 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_PERF_SUMMARY=1 \ + dotnet src/LivingVillage.Desktop/bin/Release/net8.0/LivingVillage.Desktop.dll + # 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 \ @@ -490,6 +525,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-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/` 巡游帧） - `/tmp/opencode/lv-p21-art/`（P21：`p21-day-bridge-01.png`、`p21-day-river-01.png`、 `p21-day-buildings-0{1,2}.png`、`p21-night-bridge-01.png`、`p21-night-river-01.png`、 `p21-night-street-01.png`；原始帧 `raw-day/`、`raw-night/`） |