 DeepSeek V4.1 Flash
|
9cf6b2fedc
|
把三处功能要求也变成可复跑的检查（structcheck 93 条 + A/B 反证）
背景
----
「点组名不折起」「组名改名框不吞项数」「SignalData 去掉 displayName」
三处用户要求此前只有散文描述与已压缩的历史记录。本提交给它们补上
(a) 源码级断言、(b) A/B 反证、(c) 运行时断言三类证据。
新增 / 修改
-----------
- Tools/structcheck.ps1 新增第 [3] 组「行为与注释不变量」（31 条断言）：
* 折起热区：RowHitPart 产出专用 RowPart::GROUP_TITLE，其矩形正好是「组N」标签矩形；
单击门限 `if (part != RowPart::DISCLOSURE && part != RowPart::GROUP_TITLE)` 全文件恰好 1 处；
ToggleGroupFromRow 恰好 2 个入口（单击门限 + 双击折叠三角）；
双击非名称本体（`if (part != RowPart::BODY) return false;`）不进入改名。
* 改名框：右边界必须是 `statsRight - statsWidth - 6*scale`，且全文件不得出现 `right = statsRight;`；
项数宽度必须来自 GroupStatsText。
* 数据模型：SignalData / SignalGroup 各只声明 1 个字符串字段且名为 name；
RenameSignal / RenameGroup 存在；全仓 displayName / Title() / Set*DisplayName 残留 0 处。
* 注释核验：过时措辞（文件下标 / 所属文件下标 / 原信号所属文件下标 / 文件分组 / 原文件下标 /
文件序号）全仓 0 处；已修正注释确实存在（例如 DerivedSignalRequest::groupIndex →
「原信号所属分组下标」）。
- Tools/structcheck_phrases.txt（新增，UTF-8）：中文短语表，供 .ps1 以 UTF8Encoding($false)
读入后逐条断言（forbid / require）。⚠️ 中文不能直接写进 .ps1 —— PowerShell 5.1 按 ANSI 读脚本。
- 断言总数 62 → 93；退出码仍为 0/1，可直接接 CI。
A/B 反证（判别力）
------------------
回退两处 UI 修复（`if (part != DISCLOSURE && part != GROUP_TITLE)` → `if (false)`；
`right = statsRight - statsWidth - 6*scale;` → `right = statsRight;`）：
* panelanim.exe 147/156（9 项如实失败）→ 恢复后 156/156
失败文案直接点名需求：the group rename box stops before the item counter /
clicking the group name does not start collapsing / does not collapse the group ...
* structcheck 90/93（3 项如实失败）→ 恢复后 93/93
single-click toggle gate accepts only DISCLOSURE / GROUP_TITLE (found 0) /
rename box right edge excludes the item counter / rename box never extends over the counter
运行时断言（数据层，datacheck 69/69）
-------------------------------------
Check(set.RenameSignal(groupIndex, 0, L"改名") && set.Resolve(SignalRef{0,0})->name == L"改名",
"signal rename writes the single name field");
Check(set.RenameGroup(groupIndex, L"我的组") && set.GroupAt(0)->name == L"我的组",
"group rename writes the single name field");
Check(!set.RenameSignal(groupIndex, 0, L"") && ..., "empty rename is rejected (name is never blanked)");
即重命名只写一个 name 字段（编译期已无 displayName 可写），空名被拒。
文档
----
- Documents/refactor_report_2026-10-16.md：新增 §9.7（三处功能要求的源码断言 + A/B + 运行时断言）；
§1.3 补完整 A/B 实测；§9.4 验证表与 §9.5 变更清单同步（62 → 93）。
- Documents/agent_mem.md：§9.37 开头补可复跑证据块；§11.2 第 96 条扩写为三组 + 中文短语数据文件的做法；
变更日志 d2e6fdd 行的结构检查描述更新为 93 条与 A/B 数据。
验证
----
make release 零警告，Target.exe 764 416 B；
structcheck 93/93；verify 49/49；datacheck 69/69；edgecheck 46/46；
panelanim 156/156；errcheck 19/19。
|
2026-10-16 04:56:35 +08:00 |
|
|
DeepSeek V4.1 Flash
|
695b73a366
|
结构证据落库：新增 Tools/structcheck.ps1 + make structcheck（62/62）
背景
----
上一轮报告对「巨型实现文件按职责拆分」与「Components/Shared 共享控件」两件事只有散文描述，
缺少可复跑的证据。本提交把这两项结构约束写成入库脚本，任何人（或 CI）都能一键核验。
新增
----
- Tools/structcheck.ps1（入库，纯 ASCII，退出码 0/1）：
[1] 拆分
* 16 个拆分产物必须存在且非空，并断言核心文件已显著变小
（PlotView.cpp 13 695 → 705 行；SignalPanel.cpp 4 184 → 1 019；
Application.cpp 3 135 → 1 326；DataModel.cpp 2 615 → 1 459）；
* 12 组职责函数必须「只」定义在预期文件里
（PlotView::Paint/PaintLane/PaintHint → PlotViewPaint.cpp；
LaneAtY/CancelDrag → PlotViewInteraction.cpp；FitAll/SetHint → PlotViewFeatures.cpp；
Layout/BuildLaneVisuals → PlotView.cpp；SignalPanel::Paint/OnLButtonDown/EnsureRows → paint/interaction/core）；
* 四个内部头必须声明具名命名空间并带 using-declaration，且把共享工具标 inline
（pvdetail 111 / spdetail 63 / appdetail 27 / dmdetail 4 个 inline 定义）；
* 12 个拆分翻译单元必须真的被编译（Build/Release/*.o 齐全），并用 nm 断言
「绘制符号在 PlotViewPaint.o、PlotView.o 里一个都不剩」；
* 25 个实现文件所在目录必须全部登记在 Makefile；
[2] Components/Shared
* UiControls.hpp 声明 16 个控件，nm 断言这 16 个全部由 UiControls.o 定义（其他 .o 不是定义者）；
* 69 处调用点必须跨 ≥3 个组件（实测 PlotView / SignalPanel / TabBar / Shared）；
* 分层：Components/Shared 不含任何组件头；底层 Utilities/PaintUtil 不依赖 Shared；
Utilities 不含任何功能组件头。
- Makefile：新增 structcheck 目标（make structcheck）。
说明（脚本第一版的两个假失败，已修正判定）
------------------------------------------
1. 判定「控件定义」必须用 UiControls.hpp 里**声明**的名字，而不是「所有 Ui* 函数」：
UiFillRect / UiText / UiMeasureTextWidth 等是底层原语，本就住在 Utilities/PaintUtil。
2. 精确分层不变量是「Shared 不依赖任何组件；底层 PaintUtil 不依赖 Shared；
Utilities 不含功能组件头」，而不是「Utilities 一律不得依赖 Shared」：
Utilities/Src/{PopupMenu,ColorPickerPopup}.cpp 是历史上放在 Utilities 下的自绘 UI 小部件，
允许消费 Shared 控件（方向与各组件一致）。
文档
----
- Documents/refactor_report_2026-10-16.md：
* TL;DR 处更正首版「PlotView.cpp 整体拆分本轮未执行」的错误结论（那是提交 0871eb0 时刻的状态，
已被 e6b7bf6 推翻）；
* §七 标题改为「遗留项与后续建议（逐项的最终处理状态）」；
* §9.4 验证表新增 make structcheck 62/62；
* 新增 §9.6「结构证据：把拆分与共享控件变成可复跑的检查」；
* §9.5 变更清单补充 Tools/structcheck.ps1 与 Makefile。
- Documents/agent_mem.md：
* §9.37 第七节补上可复跑证据与实测行数；
* §11.2 新增第 96 条（结构检查脚本的用法、两个易错判定、精确分层不变量）；
* 变更日志 d2e6fdd 行补充 structcheck；
* 0871eb0 行的「未完成（已如实记录）」改为明确的「已由后续两个提交完成」。
验证
----
make release 零警告，Target.exe 764 416 B；
make structcheck 62/62；verify 49/49；datacheck 69/69；edgecheck 46/46；
panelanim 156/156；errcheck 19/19。
|
2026-10-16 04:48:11 +08:00 |
|