 DeepSeek V4.1 Flash
|
abcf3e6c44
|
refactor(panels): 浮动面板抽出唯一"面板特征层"，消除 3 处分类/滚动几何/滚动设置的重复
背景（用户观察）：7 个实验性功能都有自己的浮动面板，观感与骨架高度一致
（标题栏 = 折起三角 + GX 徽标 + 标题 + ✕，内容区可滚动 + 滚动条，底部按钮行），
但每新增一种面板或改动布局，总会出"意料之外"的缺陷。
审计结论：骨架绘制本来只有一份，真正的问题是**同一套"按种类分支"的代码被抄了多份**：
| 重复项 | 位置 | 份数 |
| --- | --- | --- |
| 分类布尔量（listStyle / countTable / hasButton…） | EdgePanelWidth / EdgePanelLayoutFor / PaintEdgeCursor | 3 |
| 滚动条几何 + 滚动量夹取 | 布局里表格 / 列表 / 自由标记三个分支 | 3 |
| 滚动条绘制（6 行） | 绘制里同样三个分支 | 3 |
| SetLane*Scroll 实现 | PlotViewFeatures.cpp | 7 |
| 按种类转发滚动写入 | 滚轮 / 拖滚动条 | 2 |
| 标题文本 | EdgePanelWidth 的三元式链 / 绘制里的三元式链 | 2（内容还不一致！） |
一、新增"面板特征层"（PlotViewInternal.hpp，pvdetail）
* `PanelStyle PanelStyleOf(EdgePanelKind)`：唯一分类来源，`listRows` / `countTable` /
`markerGroups` + `buildButton` / `twoButtons` / `markerFooter`，`switch` 穷举不写 default
（新增面板漏登记 ⇒ `-Wswitch` 编译报警）。
其中专门区分 `footerButtons()`（底部有按钮行）与 `buildButton`（是"构建为新信号"）——
混为一谈会让「选区截取」底部少预留一行高度（本轮实测 124 → 87 px，被像素基线当场抓住）。
* `PanelScrollMetricsFor(...)`：滚动条轨道/滑块几何 + 滚动量夹取 + 内容宽度扣减的唯一实现。
* `PlotView::PanelTitle(EdgePanelKind)`：标题唯一来源。
⚠️ 修掉一处**潜伏**错误：`EdgePanelWidth` 的标题链漏了 MARK/CLIP（两者按"边沿计数"量宽），
目前两种标题恰好等宽所以看不出来，但任何文案改动都会让宽度与标题不匹配。
二、收敛调用点
* `EdgePanelWidth` / `EdgePanelLayoutFor`（表格 / 列表 / 自由标记三分支）/ `PaintEdgeCursor`
全部改用 `PanelStyleOf` 与 `PanelTitle`；滚动几何改用 `PanelScrollMetricsFor`。
* `EdgePanelLayoutFor` 的 5 层滚动量三元式 → `LanePanelScrollOf(lane, kind)`（该派发点第 33 轮
就已存在，但布局这里一直没用它）。
* `PaintEdgeCursor` 的滚动条绘制抽成 `paintPanelScrollBar(layout)`，三处调用。
* 7 个 `SetLane*Scroll` 改为一行转发到新的 `SetLanePanelScroll(laneIndex, kind, scroll)`；
滚轮与"拖滚动条"两条 `switch`/`if` 链改为直接调它（读与写从此同一个入口）。
三、新增离屏检查 `panelscroll`（护栏）
* 对 7 种面板逐一：可滚动时滚到底 / 滚回顶，断言 `scrollOffset` 夹取到 `maxScroll`、
滑块到达/返回轨道端点、内容区几何不随滚动改变；不可滚动时断言不出现滚动条。
* 用 `MF4-Record.MF4`（566 信号合并到同一网格）实测 6/7 面板可滚（自由标记无固定点，正确）。
没有这条检查，本次收敛就等于"改完只能靠肉眼"。
验证（本机 GCC 15.2.0 UCRT / 125% DPI）
* `panels -mode compare`：7 个面板的**像素哈希与几何逐项不变**（零差异）。
这条检查当场抓到了上面 `footerButtons` 的回归，证明基线有效。
* `OffscreenChecks -all`：6 个检查全 PASS，`checks=87 failed=0`。
* `UnitTests`：`checks=219 failed=0`。
* release 全量零 error / 零 warning；产物 788,480 → **787,968 B**（−512）。
|
2026-11-04 14:20:57 +08:00 |
|
|
DeepSeek V4.1 Flash
|
5c48bf922e
|
review(follow-ups): 落地上轮建议并给出实测结论（#2/#4 回退、#3 不重写）
一、Tools 完善
* OffscreenChecks `edgestats`：改为自动挑"最有起伏"的信号。旧实现固定取
`signals[0]`，而 MF4 的第一条信号是常量（6000）⇒ 三个阈值的断言退化成
"0 == 0" 的空转。现在扫描前 200 条挑 `max-min` 最大者，SCATTER_TEST 上
三个阈值分别得到 (20,19)/(20,19)/(20,19)，与独立参考实现逐位相同。
* UnitTests 新增 `stdio_mingw_vs_ucrt_formats`：把 MinGW ANSI stdio 与系统
UCRT 的 printf 在**本程序实际用到的全部格式**（`%.*f` / `%.6g` / `%g` /
`%.4e` / `%.2f %ls` / `%llu` / `%lld` / `%02X` / `%.2f%%`）上做逐字符比对，
13.6 万次调用 **0 处差异**（覆盖 1e-40~1e40）。它是"把 swprintf 让给 UCRT"
这条体积优化的验收标准。
* Tools/README.md：同步新增用例与断言数量（219 项 / 18 用例）。
二、第 33 轮报告 §10 后续建议的结论（详细数字见 Progress 第 34 轮）
1. **`EdgeScanFor` 状态查找哈希化：实测后回退。**
实现方式为 `deque` + `unordered_multimap<keyHash, EdgeScanState*>`（桶内仍
逐字段比对，碰撞安全；新建/淘汰/定向作废/清空四处同步索引），功能与像素
验证全绿。但 198 个状态的整轮查询只从 0.097 降到 0.073 us/query（一轮省
≈4.8 us），而产物体积 +5,632 B。⇒ 回退。
同时修正报告的量级：原估"288 信号 ≈0.3ms/帧"，实测 ≈20us/帧。
2. **`EdgePanelLayoutFor` 表驱动化：不做。** 实测 1.9~2.5 us/次（每帧约 14 次
≈30us），不是热点；第 33 轮已消除"按种类分派"的重复，剩余 957 行是几何算式
本身，无法表驱动。本轮改为交付"让这类重写可验证"的手段：
`-run panels -mode record/compare` 逐面板比对几何 + 像素哈希。
3. **`wcstod` 自写替身：实测 0 字节收益。** 只加
`-D__USE_MINGW_ANSI_STDIO=0` 全量重编后产物仍是 788,480 B、`mingw_wpformat.o`
仍被链接。原因是预编译 libstdc++ 自己引用 `__mingw_swprintf`：只要还调用
`std::to_wstring` / `std::to_string`（全仓约 80 处，若干处实参是浮点），
gdtoa 必然被链入。⇒ 回退，并在 Makefile 留下说明防止重复尝试。
三、文档
* `Documents/Code_Review_Plan.md` 新增 §六（第 34 轮节点与验收标准）。
* `Documents/Code_Review_Progress.md` 新增第 34 轮逐节点记录（含全部实测数字）。
* `Documents/Code_Review_Report.md` 新增 §11（结论表 + 两处量级修正 + 更新的后续建议）。
* `Documents/agent_mem.md` 新增第 34 轮规则：Tools 约定、两个构建陷阱、
两条"别再重复做"的实验结论。
验证：
* `make release`（删 .o 全量）零 error / 零 warning，产物 **788,480 B**（与改动前一致）。
* `make -C Tools` 零 error / 零 warning。
* `UnitTests.exe` → checks=219 failed=0 cases=18。
* `OffscreenChecks.exe -all` → 5/5 检查 PASS，checks=71 failed=0。
|
2026-11-04 11:52:10 +08:00 |
|