summaryrefslogtreecommitdiff
path: root/docs/维护说明.md
Commit message (Collapse)AuthorAgeFilesLines
* test(p40): 连贯带/同seed/夜光回归 + 运行时证据帧Somhairle H. Marisol6 days1-0/+41
| | | | | | | | | - P40ArtTests 6 例：连贯带覆盖路网且抑制孤立散布、摆放确定性、红灯笼落门口、 红/石灯笼同光晕路径、同 seed 重生成一致、P40 索引在界内 - AssetPackTests 索引列表加 19/20；fsproj 注册 P40ArtTests - scripts/make-p40-closeups.py 乌篷船 2x NEAREST 特写 - docs/维护说明.md 追加 P40 小节；证据 4 帧白块检查 0 命中，重复运行 byte-identical - Release 全量 Desktop 201/201、Kernel 119/119 exit 0
* test(p39): 摆放/光晕/奇偶 spacing 回归 + 运行时证据帧Somhairle H. Marisol7 days1-0/+45
| | | | | | | | | | - P39ArtTests 9 例：桥/船/灯笼/摊位/芦苇地形与确定性、NightLightTilesIncludeRoadLanterns、 StallsAndLanternsDoNotOverlapForOddAndEvenSpacing（奇 {3,5,7,11,13}/偶 {2,4,6,8,12}）、 DegenerateSpacingPlacesNothing（{0,1,-3} 返回空集） - AssetPackTests 更新为 19 格 + 新索引；fsproj 注册 P39ArtTests - scripts/make-p39-closeups.py：2x NEAREST 特写 - docs/维护说明.md 追加 P39 小节；证据 5 帧白块检查 0 命中，重复运行 byte-identical - Release 全量 Desktop 195/195、Kernel 119/119
* docs: P38 界面审计结论、HUD 图标证据与维护说明Somhairle H. Marisol7 days1-0/+40
| | | | | | 审计结论：启动动画/开始界面/HUD 窄条已达标，最大差距为 HUD 缺图标化； 证据 p38-splash-1/2（启动动画帧序列）+ p38-hud-day/night/closeup-2x；说明 digest 恒定（仅渲染层改动），check-no-white-blocks 5 帧 0 命中，附复现命令。
* docs: P37 职业系统证据与维护说明Somhairle H. Marisol7 days1-0/+42
| | | | | | | 证据 p37-occupation-select/fisher-start/farmer-start.png（职业选择页中文可读、 渔夫 vs 农夫开局 HUD/任务对照）；check-no-white-blocks 3 帧 0 命中；两帧差异 仅顶部 HUD 1648px + 左下任务面板 831px、场景区 0，证明职业不改变世界生成。 维护说明补 P37 小节（已落地范围/物品落点限制/复现）。
* docs: P36 情境提示证据与维护说明Somhairle H. Marisol7 days1-0/+51
| | | | | | docs/evidence/p36-prompt-approach-1..4.png 为实际运行帧序列 （靠近无提示→E 交谈出现→对话层打开提示消失→走远提示消失）， check-no-white-blocks 4 帧 0 命中；维护说明补 P36 小节（契约/测试/复现）。
* feat(art): P34 素材扩展切片（水面/屋顶/墙体/栏杆）Somhairle H. Marisol7 days1-0/+36
| | | | | | | | | | | - cc0-tiles.png 由 4 格扩到 12 格：0-3 仍 Kenney 地面，4-11 为自绘构件 （4 水A/5 水B/6 屋脊/7 屋檐/8 木构墙/9 木格窗/10 栏杆/11 门） - 自绘 2 相位水面 cc0WaterTileIndexAt=(tick/32+x+2y)%2，单帧覆盖双相位； 河道与水田/水网共用；江南 fallback 不变 - drawWorld 接入：cc0 模式下民居屋顶/墙/窗/门、桥栏杆、水面走真素材，其余道具仍江南 - AssetPackTests 更新图集尺寸(12 格)+整数缩放，新增构件索引与双水相位用例 - docs/素材来源.md 记录自绘清单；同步 assets-and-licenses 与维护说明 P34 小节 - docs/evidence/p34-*.png 昼/夜/2x 特写/水波/对照（check-no-white-blocks 0 命中）
* feat(art): P33 接入 CC0 ↵Somhairle H. Marisol7 days1-0/+40
| | | | | | | | | | | | 真实像素素材样板（地面+角色竖直切片） - 修复 make-cc0-art.py 地块取样间距：packed sheet 无间距(16px pitch)，旧 17px 误采错格 - 重选草地/石板格 (9,8)/(10,8)/(4,8)/(4,9)，整数 2x NEAREST 重建 cc0-tiles.png - VillageArt 暴露 selectedGround/CharacterAtlasRelativePath 纯函数，保留 LV_ASSET_PACK=cc0 开关与程序绘制江南图集 fallback - 新增 AssetPackTests：图集加载尺寸、整数倍缩放、开关/回退断言 - docs/素材来源.md 记录来源/许可/sha256/构建/开关；同步 assets-and-licenses 与维护说明 P33 小节 - docs/evidence/p33-atlas-*.png 昼/夜/2x 特写/程序绘制对照（check-no-white-blocks 0 命中）
* docs: P32 证据清单（夜间白块修复运行时截图）Somhairle H. Marisol7 days1-2/+53
| | | | | | | | - 补拍 P14 修复后夜间真实运行时帧并入 docs/evidence/（被 .gitignore 命中，git add -f） - 生成器世界 512x384 seed4242 夜/昼整帧 2048x1536 + 桥头河面 2x 特写（灯笼光晕+水面） - 样例村庄真实运行夜/昼整帧 1280x720 + 特写 2x（民居/水面/炊烟） - 维护说明新增「证据清单（P32）」小节与复现命令，更新 docs/evidence 入库说明 - check-no-white-blocks.py 7 帧 0 命中
* docs: P04 维护说明同步（测试计数/模块职责/存档 ↵Somhairle H. Marisol12 days1-12/+63
| | | | v3/职业系统 P11-P15 小节/P23-P31 来源 hash）
* docs: P31 maintenance notes (dialogue bias + four storylines)Somhairle H. Marisol12 days1-0/+47
| | | | | | Change points, evidence commands, frozen gates restated: kernel 119 / desktop 160 green, digest 953775FAEB2F unchanged, 64x48/256x192 checksums pinned, M3 files untouched; art/ evidence kept out of the repo.
* feat(desktop): P30 512 民居增密 + 乡村空区填充 + 主路柔化Somhairle H. Marisol13 days1-2/+42
| | | | | | | | | | | | | | | | | | | - MapGen（仅大图尺寸自适应分支，默认 64x48/256x192 不进入、不消费额外 RNG）： ① ExtraRiversideHouses 16 -> 30，组团 2-5 座；含基础岸屋的路段优先布组并为每座孤立 基础民居贴格配对，placeGroup 试排后按「与既有/同组民居足迹间隙 <=2」过滤，孤立单屋不落地。 512 seed4242：组团民居 24 -> 45，规模 [5;4x6;3x2;2x3]，0 组 <2 座。 ② 新增 GroundTile.PaddyField=4/VegetablePlot=5（成熟 tile；非水可通行）+ Result.Groves （纯视觉）+ Result.Farmhouses（门贴院落路、计入 BFS）；18x14 确定性网格铺田块/树丛/农舍， 离水 >=3 格、避开路网/核心/民居。草地瓦片 96.3% -> 83.9%，水田 11595 + 菜畦 12877 格。 ③ Result.MainRoadCenter 逐列中心线，value noise（scale 130、幅度 ±3）确定性缓弯， 相邻列步长 <=1、遇弯补格保证 4 连通；默认图主街仍笔直。 - VillageArt：水田/菜畦/树丛/农舍渲染（复用成熟 sprite 与同一立面纯函数）、农舍门窗计入夜光、 新增 drawMapRegion 局部真实离屏渲染。 - Game：P30 证据钩子 LV_MAPGEN_P30_SHOT=1（整图 3072x2304 day/night + 田块/主路 512x256@4px）。 - 回归 +5：组团规模/空区填充/田块合规/农舍可达确定性/主路确定性弯曲。 Kernel 92 / Desktop 156 全绿；Release 0 警告 0 错误； final_digest=953775FAEB2F… 3 次一致、performance_determinism=PASS； 64x48=6042052、256x192=1284656962 锁定不变。
* feat(desktop): P29 512 聚落组团 + 夜景灯光径向光晕Somhairle H. Marisol13 days1-0/+53
| | | | | | | | | | | | - MapGen：仅大图新增 ClusterSeed（group seeding）与组团布屋——512 沿横向石板路 （主街+河岸路）成排成组：组内 2-4 座/1 格间隙、组间 4-6 格空档，宽度 2/3/4 分层； 垂柳改为确定性成丛（2-3 株/丛、丛间 3-5 格空档）。独立 clusterRng 不触碰 structureRng，默认图仍不消费 RNG，64x48=6042052 / 256x192=1284656962 锁定不变。 - VillageArt：新增 lanternFalloff（二次 1-(d/r)^2，半径 0 处最大、边缘 0、严格单调无平台）； lanternGlowLayers 按该衰减逐环累积 alpha；drawNightGlows 对桥头灯笼+民居门窗画半径 4 tile 的柔和径向光晕，整图取证与实机 DrawWorldView 共用同一套纯函数。 - 回归 +6：组团行/成丛/衰减/光源确定性；Desktop 151、Kernel 92 全绿，Release 0/0， final_digest=953775FAEB2F… 3 次一致。证据帧见 art/p29-*。
* docs: P28 Desktop 计数修正为 145；忽略证据目录 art/Somhairle H. Marisol13 days1-1/+1
|
* docs: P28 512 大图民居观感整改小节（变更点/取证命令/锁定 ↵Somhairle H. Marisol13 days1-0/+66
| | | | checksum）
* docs: P27 小节补全修复后指标与等价性/门槛Somhairle H. Marisol13 days1-0/+30
| | | | | | | | 补 P27 修复策略（扫描去装箱 + 裁剪判定 O(1)）、修复前后基准对照 （60 天 alloc -64%、ms -28%）、retained_id_checksum 前后一致、 5 天双跑 WorldSave 逐字节相同、digest/PASS 与 Kernel 92/Desktop 143 门槛； 并记录全模拟 --cost-probe 基本持平的原因（逐 tick NPC 快照分配主导， 谣言子系统占比小，留给后续单）。已验证命令补 --rumor-bench。
* perf(kernel): P27 第一步 — Rumor 长跑基准与修复前量化Somhairle H. Marisol13 days1-0/+25
| | | | | | | | | | | | | | | | | | | | | 新增 Kernel 层 Rumor 长跑基准（RumorBench.fs + headless --rumor-bench [days npcs chats_per_day]），把「聊天→生成/追溯谣言」路径从 Sim.step 的 NPC 快照分配解耦，隔离测量谣言工作集随世界年龄的分配/耗时；同 Config 的 retained_id_checksum 证明确定性。 复核 M3-1 前提：World.Rumors 已被 M6a（d94ec2d/cc850bf）按 3 天保留窗口收敛， 单日成本平稳（1/5/10 天 ≈18.7/18.1/19.8s、≈19GB/天），超线性项消失。 剩余 Rumor 成本 = 每次聊天的两条 O(N) 扫描 latestRumorFor/rumorIsDuplicate， 且 [<Struct>] NpcId/RumorId 用 = 比较会逐条装箱（Sim.chat 单独测得 N=16000 时 393,736 B/次、随 N 线性）。 修复前基准（30 NPC，--rumor-bench D 30 2000）： 3d chat_calls=6000 retained=6000 alloc=930,716,456 ms=1626.7 30d chat_calls=60000 retained=8000 alloc=13,419,045,864 ms=12182.5 60d chat_calls=120000 retained=8000 alloc=27,297,668,608 ms=23769.7 （60d 工作集稳定 8000，不随年龄增长。） docs/维护说明.md 新增 P27 小节记录上述现状与量级。不改任何模拟语义。
* docs: P26 范围外遗留事项（另开一单）Somhairle H. Marisol13 days1-0/+4
|
* docs: P26 美术整改小节与 512 昼夜取证命令Somhairle H. Marisol13 days1-0/+54
|
* docs: 新增 P25 巡游村民可见性 + ↵Somhairle H. Marisol13 days1-0/+36
| | | | 孤立石板治理小节与命令（P25）
* docs: 新增「民居密度参数」小节与 P24 取证命令/快照（P24）Somhairle H. Marisol13 days1-0/+25
| | | | - ExtraRiversideHouses 默认/大图取值、512x384 共 18 座、部件渲染、村民可见性证据与快照位置。
* docs: 新增「大世界扩程 512x384」小节与取证命令/快照（P23）Somhairle H. Marisol13 days1-0/+38
| | | | | | | | - 记录 paramsForSize 尺寸自适应（河道每 ~96 行一条、噪声尺度封顶 4x）、 64x48/256x192 逐字节不变、v2 存档边界与 v1 兼容、生成耗时（512x384 约 134-248ms）、 512x384 巡游 perf-summary（mean 153.84/min 51.64/max 228.81）与 VmRSS 185.9-201.9MB。 - 补 LV_RIVERSCAPE_WIDTH/HEIGHT 与 LV_MAPGEN_SHOT 512x384 取证命令及 /tmp/opencode/lv-p23-art/ 快照。 - 默认世界仍 256x192，本轮只交付能力与证据。
* docs: P22 重挑游戏内代表帧 + 大世界默认开启评估（P22）Somhairle H. Marisol13 days1-2/+38
| | | | | | | | - 代表帧改为真实游戏内帧（HUD 近白像素判定），覆盖昼/黄昏/夜三档共 9 张， 覆盖旧标题/启动误帧；补 23:30 夜档巡游取证命令。 - 新增「大世界默认开启评估」：256x192 已是默认（P20 第三步），复核 FPS/内存/ 生成耗时与风险，结论维持默认、保留 LV_LEGACY_MAP 回退；记录 NPC 规则网格 与孤立砖石小块两项遗留观察（仅记录不改）。
* docs: ↵Somhairle H. Marisol13 days1-0/+47
| | | | | | | | | | 新增「大世界」一节：世界参数/回退开关/可达核心/实测性能（P21） - 256x192 生成器参数、world-mode 回退开关、BFS 可达核心保证机制。 - 实测 Desktop Release（Xvfb 1280x720x24，LV_UNLOCK_FPS=1）60s 采样： mean 230.4 / min 199.5 / max 302.8 FPS；VmRSS 181.9–183.4 MB； headless ticks/s 189,595–445,377、alloc≈3.03MB、gen0=0、digest 953775FA…。 - 补 P21 取证命令与 /tmp/opencode/lv-p21-art/ 快照位置。
* docs: 补充 P20 第三步 sample 保持 64x48 的说明Somhairle H. Marisol13 days1-1/+2
| | | | LV_AUTOPLAY_SAMPLE 非巡游保持旧 64x48，仅 LV_RIVERSCAPE_TOUR=1 启用生成器世界。
* docs: P20 第三步河景与可玩接入收口说明与取证命令Somhairle H. Marisol13 days1-1/+32
| | | | | | - 记录默认 256x192 生成器世界接入、LV_LEGACY_MAP 回退、桥头灯笼与 bridgeLanternTiles、序列化确定性与测试计数（Desktop 121 / Kernel 90）。 - 补 p20c-* 昼夜巡游取证命令与快照位置、性能门槛复述。
* feat(mapgen): 河道连续性不变量 + 桥/石板路网/沿河民居（P20 ↵p20-map-gen-foundationSomhairle H. Marisol13 days1-2/+25
| | | | | | | | | | | | | 第二步） - 河道改为贯穿全图连续水带（每列一段、宽度 >= RiverWidth），置于核心区上下 两侧且不相交；新增不变量测试：逐列水段数恒定、每段宽度下限、任意水格 >=2 个水邻居（禁止断裂缺口与孤立水点）。 - Result 新增 Rivers/Bridges/Paths/Buildings/BridgeCrossingsOk；每河 2 座桥、 横贯主路 + 垂直连接路 + 远岸路 + 白墙黑瓦民居（门朝路）。 - 公开 isWalkable/floodFill；ReachabilityOk 现覆盖 30 spawn + 所有门 + 所有桥面， BridgeCrossingsOk 保证每桥两岸同连通域。 - 回归：Desktop 115->119、Kernel 90 不变；final_digest 与基线一致。
* feat(mapgen): 参数化确定性生成器与视口裁剪（P20 第一步）Somhairle H. Marisol13 days1-0/+32
| | | | | | | | | | - 新增纯函数 MapGen：尺寸参数化（默认 64x48，可 256x192），splitmix64 随机游走河道 + 2-3 octave value noise + 泊松式布点；核心区整平后以 BFS 校验 5x6=30 个 spawn 全部可达，不可达确定性修整并复验。 - visibleTileRange/visibleTileCount 纯函数，drawWorld 改为调用之（行为不变）； drawMapFitted/drawMapViewport 仅证据用。 - 存档沿用 v2/v3 边界字段，补参数化边界 round-trip 测试，未改 Sim 语义。 - 回归：Desktop 109->115、Kernel 89->90；final_digest 与基线一致。
* fix(desktop): P19 白天色调去偏黄（day tint ↵p19-daylight-tamingSomhairle H. Marisol13 days1-0/+27
| | | | 中性白平衡，黄昏暖橙保留）
* feat(desktop): P18 黄昏暖色真实渲染（加性暖色 veil + ↵Somhairle H. Marisol13 days1-0/+31
| | | | 双窗口光照 + 时段标签对齐）
* fix(desktop): P17-FIX 起时钩子在 sample/autoplay ↵Somhairle H. Marisol13 days1-9/+19
| | | | 路径生效（resolveStartTick 纯函数 + 回归 + 重拍证据）
* test(desktop): P17 取证钩子（LV_AUTOPLAY_START_HOUR 纯函数起时）+ ↵Somhairle H. Marisol13 days1-0/+33
| | | | 证据与 docs 记录
* feat(desktop): P16-FIX 开始界面截图模式（LV_AUTOPLAY_MENU_SHOT）+ ↵Somhairle H. Marisol13 days1-2/+14
| | | | 真实菜单证据补拍
* docs: P16 启动画面/开始界面/HUD 精美化实施与取证记录Somhairle H. Marisol13 days1-0/+25
|
* docs: M6a 谣言容量上界实施与 1/10/20 天成本复测记录Somhairle H. Marisol13 days1-0/+27
|
* docs: M3-1 流式可观测性/门槛缩尺/长局成本量化Somhairle H. Marisol13 days1-1/+40
| | | | | | | - 维护说明新增 M3 批验小节：流式字段、50x20 门槛理由与实测、--cost-probe 数据表、 Rumors 累积+全表扫描的机理与修复方向候选（本单不实施） - Desktop 基线更新为 86/86 - overnight-status 追加本单实测与待收口
* docs: 记录预乘 alpha 机理与夜间光晕/炊烟接线Somhairle H. Marisol13 days1-3/+34
| | | | | | - Desktop 基线更新为 79/79 - 新增预乘 alpha 机理、lanternGlowLayers、per-tile 水面、炊烟后置遍、角色站位说明 - 补白块校验命令与 P14 证据位置
* docs: 记录 P13 动画语义与确定性证据命令Somhairle H. Marisol13 days1-1/+35
| | | | | | | | - 维护说明更新为 Desktop 75/75、Kernel 79/79 - 新增动画语义小节（图集布局、cellIndex、各帧 tick 窗口） - 新增 P13 证据命令（Xvfb 白天/夜晚录帧 + 接触表脚本） - 新增 scripts/make-animation-evidence.py（镜像渲染端帧数学， 从真实图集生成确定性接触表），忽略 evidence/ 输出目录
* fix(desktop): RiverLantern 模式限定消除TW + 中文维护文档Somhairle H. Marisol13 days1-0/+76
Game.fs 733/741 两条编译警告（FS0049 未限定模式绑 + FS0026 不可达）由 Qualified VillageArt.RenderPropKind.RiverLantern 修复，全仓 0 警告；Leader 所指 Interaction.fs:191 并无编译警告（已记录于验资说明）；docs/维护说明.md 首开：模块职责/O 不变量/信息 digest 变化处理/可复制命令。
generated by cgit v1.2.3 (git 2.39.1) at 2026-10-04 20:04:27 +0000