diff options
| -rw-r--r-- | docs/维护说明.md | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/docs/维护说明.md b/docs/维护说明.md index 43b8fc4..0e209ab 100644 --- a/docs/维护说明.md +++ b/docs/维护说明.md @@ -421,6 +421,40 @@ dotnet src/LivingVillage.Headless/bin/Release/net8.0/LivingVillage.Headless.dll `p25-zoom-village.png` 放大含 >=8 村民、`p25-tour-0{1,2,3,4}.png` tour 页、`tour/` 全量帧）， 白块回归 241 张 0 命中。 +## 江南水乡第 4 档：512×384 美术可读性与质感（P26） + +- **① 民居立面第二变体**：世界图集由 28 格扩到 **32 格**（尺寸 896x32→1024x32），新增 + slot 28 屋檐挑出 / 29 木格栅窗 / 30 院门；`scripts/make-jiangnan-art.py` 仍为确定性管线， + 二次运行 byte-identical。`VillageArt.houseFacadeVariant (building) = (Left+Top) % 2` 为纯函数， + 沿河沿路确定性交替：变体 A 保持 P24 的黛瓦脊 + 木墙/窗 + 门；变体 B 用 `RoofEaveOverhangSprite` + 向两侧各挑出一格，墙身用 `WallLatticeSprite`/`CourtyardDoorSprite`。只改绘制分支， + 门可达不变量与 `MapGen` 瓦片零改动（64x48=6042052、256x192=1284656962 不变）。 +- **② 河岸细节（仅 512）**：`MapGen.Params.RiverDecorations`（默认 false；`paramsForSize` 仅对 + `width>256 || height>192` 置 true）。`MapGen.Result.Decorations: RiverDecoration list` 三类—— + 护岸石垒 `RevetmentStone` / 芦苇 `Reeds` / 垂柳 `Willow`（占上下两格）。**纯视觉层，不写入任何 + 瓦片**，故沿用 `DecorativeStones` 参数化先例的同时不产孤立石板；装饰只落在紧邻水面的岸格， + 并避开路网/桥面/民居/核心区。回归：`RiverDecorationsOnlyEnabledOnLargeMaps`、 + `RiverbankDecorationsSitOnBanksAndNeverBlockPathsOrBridges`（岸格相邻水 + 不压路/桥/核心）、 + `LargeMapRiverDecorationsAreDeterministic`。 +- **③ 夜晚光照二次整改（仅 Desktop 渲染层）**：新增纯函数 `M6Presentation.moonlightVeilAlpha` + （0..72，仅 deep night 有值，暖色晨昏窗口被 `warmth` 压制）与 `moonlightRgb = (120,170,235)`； + `Game.DrawWorldView` 在金辉 veil 之后叠加预乘冷色整屏 veil，`premultiply` 保证 alpha<250 不可能 + 饱和成白块。灯笼光晕复核回归 `LanternGlowIsRadialWithoutSquareCorners`：逐像素累积同心圆 alpha， + 四角恒为 0、中心行沿半径单调递减，确认无残留方斑（图像级 145+142 帧白块回归 0 命中）。 +- **④ HUD 微调**：`HudLayout.textOutlineOffsets`（上下左右 4 偏移）、`HudLayout.segmentBackdrop` + 与 `Palette.SegmentBackdrop/Outline`；`DrawHudBar` 每个常驻片段（时段/时间/倍速/体力/钱币） + 先铺半透明深色底药丸，再以 1px 深色描边文字，昼/夜两套调色板均不透明描边。回归 + `HudPersistentSegmentsGetBackdropAndOutlineInBothPeriods`。 +- **回归**：Desktop **136 → 143**，Kernel 92 不变（未触 Kernel/Sim 数值路径，未动 M3）。 +- **门槛**：clean rebuild 0 警告 0 错误；`final_digest=953775FAEB2FDDE97289491AA260BD8D390C571E48A7A13AD2CB6FB7124F7F6C` + 3 次一致、`performance_determinism=PASS`；默认世界仍 256×192。 +- **取证** `/tmp/opencode/lv-p26-art/`（沙箱把规格路径 `/tmp/lv-p26-art` 映射到此，不放 git）： + `p26-map-512x384-seed4242.png`（512 整图真实渲染 3072x2304）、`p26-zoom-480x360-2x.png` + （村庄局部 480×360 裁切 → 2× 最近邻放大，含 30/30 可辨村民）、`p26-day-village.png`、 + `p26-night-village.png`（夜景：冷月光 + 桥头灯笼 + HUD）、`p26-hud-day.png`/`p26-hud-night.png` + （HUD 双时段裁切 2×）、`villager-visibility.txt`（autorun 巡游复跑可见村民统计）、 + `white-block-day.txt`/`white-block-night.txt`（0 命中）。 + ## 已验证命令 ```bash @@ -528,6 +562,26 @@ timeout 120 xvfb-run -a -s "-screen 0 1280x720x24" env LV_MAPGEN_SHOT=1 \ LV_RECORD_DIR=/tmp/opencode/lv-p25-art \ dotnet src/LivingVillage.Desktop/bin/Release/net8.0/LivingVillage.Desktop.dll +# P26 512 整图真实渲染（含两种民居立面 + 河岸装饰；产物 p20b-map-*.png，改名为 p26-map-*） +timeout 150 xvfb-run -a -s "-screen 0 1280x720x24" env LV_MAPGEN_SHOT=1 \ + LV_MAPGEN_WIDTH=512 LV_MAPGEN_HEIGHT=384 LV_MAPGEN_SEED=4242 \ + LV_RECORD_DIR=/tmp/opencode/lv-p26-art/map \ + dotnet src/LivingVillage.Desktop/bin/Release/net8.0/LivingVillage.Desktop.dll + +# P26 昼夜村庄巡游录帧（村民可见性日志 + 夜景月光/灯笼/HUD 取证） +for pair in day:12.0 night:23.5; do name=${pair%%:*}; hour=${pair##*:}; \ + timeout 200 xvfb-run -a -s "-screen 0 1280x720x24" env LV_AUTOPLAY_SAMPLE=1 \ + LV_RIVERSCAPE_TOUR=1 LV_RIVERSCAPE_VILLAGE_TOUR=1 LV_RIVERSCAPE_WIDTH=512 \ + LV_RIVERSCAPE_HEIGHT=384 LV_RIVERSCAPE_SECONDS=40 LV_AUTOPLAY_START_HOUR=$hour \ + LV_NPC_VISIBLE_LOG=1 LV_AUTOPLAY_RECORD=1 LV_RECORD_EVERY=30 \ + LV_RECORD_NAME=p26-$name- LV_RECORD_DIR=/tmp/opencode/lv-p26-art/$name \ + dotnet src/LivingVillage.Desktop/bin/Release/net8.0/LivingVillage.Desktop.dll; done +# 局部 480x360 锚定村民+民居质心裁切后 2x 最近邻放大 -> p26-zoom-480x360-2x.png +# HUD 双时段：裁顶部 y 0..44 左 640px 再 2x -> p26-hud-day.png / p26-hud-night.png + +# P26 夜景白块回归（方斑核对，0 命中） +python3 scripts/check-no-white-blocks.py /tmp/opencode/lv-p26-art/night + # 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 \ |