完善 working6 gmoccapy 页面诊断边界

work/working5/06-决策记录.md

@@ -136,3 +136,28 @@
 - `GMOCAPY_HAL_PIN` 现在覆盖 jog axis press/release、jog increment selection、turtle jog、delete-message 和 warning-confirm。
 - HAL model 和 communication model 现在能分别呈现 hard-button、operator/override input、jog input、message input 的不同语义。
 - UI 诊断增加 `HAL jog` 和 `HAL messages`，浏览器 smoke 通过 DOM 和公开 dispatch 验证这些语义。
+
+## DR-W5-007：低频 settings/tool/user-message HAL pins 按配置启用边界建模
+
+日期：2026-06-27
+
+决策：
+
+- `gmoccapy.unlock-settings` 作为 level-driven settings input pin 记录；默认 `gmoccapy_XYZAB.pref` 为 `unlock_way=use`，所以 Web 中默认只记录 pin level，不把 setup 锁定或解锁。
+- 当测试显式模拟 HAL unlock 模式时，`unlock-settings` 才按 pin level 控制 `setupSensitive`，对应源码 `_on_unlock_settings_changed()` 对 `rbt_hal_unlock` 的条件判断。
+- `gmoccapy.probeheight`、`gmoccapy.blockheight`、`gmoccapy.toolmeasurement`、`gmoccapy.searchvel`、`gmoccapy.probevel` 作为 tool measurement HAL_OUT pins 记录，不伪装成外部 HAL 输入。
+- 当前 `gmoccapy_XYZAB.ini` 没有 `[TOOLSENSOR]`，所以 profile、HAL model 和 UI 诊断明确自动测刀默认禁用，而不是暴露为可操作流程。
+- 动态 `gmoccapy.messages.*` pins 只在 INI 存在 `MESSAGE_*` 配置时创建；当前 XYZAB 没有这些配置，所以 Web 对 `messages.*` dispatch 返回“未配置”的明确 operator message。
+
+原因：
+
+- `gmoccapy.py` 中 `_on_unlock_settings_changed()` 会先检查初始化状态，再检查 `rbt_hal_unlock` 或 user mode；未选择 HAL unlock 时 pin 变化不应改变 setup 页面可用性。
+- `_check_toolmeasurement()` 需要有效 `[TOOLSENSOR]` 数据；缺少探针配置时会显示禁用提示、关闭 `chk_use_tool_measurement` 并使其不敏感。
+- `on_chk_use_tool_measurement_toggled()`、`on_spbtn_probe_height_value_changed()`、`on_btn_block_height_clicked()` 都是 GUI/prefs 侧写 HAL_OUT pins，不是外部 HAL 驱动 GUI 的输入边界。
+- `_init_user_messages()` 只有从 INI 读到 user messages 才创建 `messages.<pinname>`、`messages.<pinname>-waiting`、`messages.<pinname>-response`；当前 `gmoccapy_XYZAB.ini` 没有 `MESSAGE_*` 项。
+
+影响：
+
+- `gmoccapy-xyzab` profile 补齐 settings/tool measurement/toolchange confirm 相关 pins，并记录 no `[TOOLSENSOR]` 与 no `MESSAGE_*` 原因。
+- HAL model 和 communication model 能展示 settings input、tool measurement HAL_OUT、dynamic user message 三类不同边界。
+- Store 和浏览器 smoke 覆盖 `unlock-settings` 默认忽略、HAL unlock level 控制、`blockheight` 诊断记录和 `messages.*` 未配置提示。