From c0fcf4c4f73de2d2b38efc216cc277225b484b66 Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Wed, 28 Oct 2026 15:40:40 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E5=8F=A3=E5=BE=84):=20=E4=B8=89=E5=A4=84?= =?UTF-8?q?=E5=B8=A6=E6=97=A5=E6=9C=9F=E6=88=B3=E7=9A=84=E5=AE=9E=E6=B5=8B?= =?UTF-8?q?=E5=8F=AA=E8=A1=A5=E3=80=8C=E5=BD=93=E6=97=B6=E3=80=8D=E9=94=81?= =?UTF-8?q?=E5=8F=A3=E5=BE=84=EF=BC=8C=E4=B8=8D=E8=87=86=E6=94=B9=E6=88=90?= =?UTF-8?q?=E7=8E=B0=E5=80=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 三条命中都不是陈旧值、而是**当时的实测记录**，改成现值等于把历史测量 冒充现状；动作 = 只补「当时」二字（并按需注明现值出处）： - docs/内存管理/RAM使用分析与优化方案.md §4.1.1：2026-10-15 缩池那次的 验证口径里「11 页黄金参考」→「当时 11 页」；该集合现按入库张数报 60 张。 - docs/门禁说明/generated-fresh.md §7：2026-10-26 接线基线里的「183 字」 →「当时 183 字」（现值 = ui_cn_chars.txt 唯一码点 218，ASCII 区 0 个）， 并按日期升序在 §9 末行追加当日一行说明本次只锁口径、没动旧数。 - docs/UI设计/UI_数据供给设计说明.md §9 判据表：2026-10-26 双次逐字节 一致那次写的是「当时下限 27 页」，同句现值改报 60 张（与判据本体同源）。 同数不同义、刻意不动（写明理由）：docs/UI设计/UI_界面制作流程.md 的 「最坏路径 < 40KB」是绘制缓冲红线；docs/硬件平台/V0.1_网表详细分析报告.md 的 119/122 是引脚号；docs/测试说明/CH395F_Test_Guide.md 的 262144/4097 是字节数；docs/测试说明/主机单测覆盖率口径.md 的 97/97 是覆盖率分数。 --- docs/UI设计/UI_数据供给设计说明.md | 2 +- docs/内存管理/RAM使用分析与优化方案.md | 2 +- docs/门禁说明/generated-fresh.md | 3 ++- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/UI设计/UI_数据供给设计说明.md b/docs/UI设计/UI_数据供给设计说明.md index 506be8f6..9e91e723 100644 --- a/docs/UI设计/UI_数据供给设计说明.md +++ b/docs/UI设计/UI_数据供给设计说明.md @@ -694,7 +694,7 @@ typedef struct { | 4 | 未标定时页面明确标识（不把码值当伏特） | 目检 + 文本断言（`eng=0` 时带标记） | | 5 | 首帧前显示 `--` 而非 `0.000` | 模拟器：不 publish 直接开页，断言文本 | | 6 | 定值整定全链闭环 | 就地改 → 保存 → 重启 → 值保持 + 校验和自检通过 + 主站 C_RD 一致。**半收口（2026-10-26）**：模拟器侧「改 → 保存 → OK → 回首屏新值已在帧里」已由像素 + 文本断言覆盖（黄金用例 `sparam_save` / `sparam_landed`，越界侧 `sparam_oob`）；**重启保持与主站 C_RD 一致只能上板**——模拟器没有 NAND，`apply()` 到 `prot_set_set_sealed()` 就是终点，这条差距已登记在 `docs/测试说明/模拟器差距清单.md`；另注意 40 项里有 13 项 `comm_addr=0`（纯本地项），主站侧根本读不到，不能拿 C_RD 当它们的判据 | -| 7 | 像素回归稳定 | `ui-golden` 连续两次运行零差异。**已验（2026-10-26，当时下限为 27 页）**：27 页连跑两次逐字节一致（含整定 9 态）——**集合现已扩至 60 页**，双次一致需按同口径重跑回填；轮询定时器不影响——无头模式不调 `lv_timer_handler()`（§9.2 注 6） | +| 7 | 像素回归稳定 | `ui-golden` 连续两次运行零差异。**已验（2026-10-26，当时下限为 27 页）**：27 页连跑两次逐字节一致（含整定 9 态）——**集合现已扩至 60 张**，双次一致需按同口径重跑回填；轮询定时器不影响——无头模式不调 `lv_timer_handler()`（§9.2 注 6） | | 9 | 「写不进去」与「改了不动作」两条事实互不冒充 | 反向文本断言（`check_content_pages.py` 的 `ABSENT`：查看页与只读态不得出现「未标定」徽标与「保存」行）+ 台架：未制造该态——要它必须改坏 /prot_set.bin（破坏产品配置存储，用户裁定 2026-10-26 不做），故 LOCK 态目前只有代码级证据与三重反证（ENTER 被正常消费、遥信 YX31=OFF、开机 CORRUPT=0），**没有像素证据** | | 8 | 主机单测覆盖数据模块 | `test/host/ui_data` 全绿并挂 pre-commit 钩子 | diff --git a/docs/内存管理/RAM使用分析与优化方案.md b/docs/内存管理/RAM使用分析与优化方案.md index 11372f5b..e849d09c 100644 --- a/docs/内存管理/RAM使用分析与优化方案.md +++ b/docs/内存管理/RAM使用分析与优化方案.md @@ -541,7 +541,7 @@ Linker run 时刻**——commit hash 不是稳定身份（重写正文即换 has - 依据：屏幕仅 160×160×1bpp，菜单为轻量控件树；LVGL 内存池只装对象/样式/字符串缓冲，与像素缓冲无关。40KB 来自模板默认值，无适配依据。 - **已落地**：`Lib/lv_conf.h` 与 `simulator/lv_conf.h` 同步改 `(16 * 1024)`——两端必须同值，`lv-conf-sync` 门禁按**生效值**比对。实测水位见 §2.6.2（最重页面峰值 6,568 B = 池的 40%）；`@build` 0 错 0 警，ZI 精确 −24,576 B → SRAM1 由 74.9% 降到 **56.1%**（余 57,504 B）。 -- 验证口径（本次即用它）：`simulator/tests/check_menu_rows.py`（菜单 8 状态像素 + 池基线 5,368 B）+ `simulator/tests/check_content_pages.py`（11 页黄金参考逐字节 + 往返池水位 5,448 B）+ 真机 `menu build done: used=` 日志。 +- 验证口径（本次即用它）：`simulator/tests/check_menu_rows.py`（菜单 8 状态像素 + 池基线 5,368 B）+ `simulator/tests/check_content_pages.py`（当时 11 页黄金参考逐字节 + 往返池水位 5,448 B）+ 真机 `menu build done: used=` 日志。 - **再降 8KB 的前置**：全量 UI 回归（PC 模拟器 + 真机）无 `LV_ASSERT_MALLOC`/分配失败；若 8KB 不够就停在 16KB，不勉强。 #### 4.1.2 启用 CCM RAM（+64KB 预算空间） diff --git a/docs/门禁说明/generated-fresh.md b/docs/门禁说明/generated-fresh.md index 671a42cf..9d330921 100644 --- a/docs/门禁说明/generated-fresh.md +++ b/docs/门禁说明/generated-fresh.md @@ -172,7 +172,7 @@ 与 `font-charset` 的分工要分清：那条查**白框方向**的覆盖（源码在用 ⊆ txt ⊆ 字体 cmap）， 本条查 **txt 与生成链是否同一份**（多一个未登记的字也 FAIL，那条只 WARN）。 - 实测基线（2026-10-26 接线）：`menu-gen` 70 个文件逐字节一致 / `cn-chars` 源码在用 165 ∪ - KEEP_EXTRA 39 = 183 字、两向无差 / `cn-font` 逐字节一致（59,138 B）/ `docs-svg` 14 个生成器 + KEEP_EXTRA 39 = 当时 183 字、两向无差 / `cn-font` 逐字节一致（59,138 B）/ `docs-svg` 14 个生成器 = 9 一致 + 5 存量在册 → 退出码 0。 ## 8. 改这个门禁本身 @@ -196,3 +196,4 @@ 解释器并逐个探针校验（新增显式变量 `DTU_GEN_PYTHON`），挑不出来打 `[ENV]` + 候选表 + 修法、退出码 2 不 SKIP；`--selftest` 加「假解释器必须可诊断」第二项。判据与基线未变 | | 2026-10-26 | 首篇逐项文档（task-18 接线当日）：实证 = `0f7b5a87` 改模板没重跑 + 接线前实测 5 张 `docs/images/*.svg` 已漂（钉成只减不增基线）；在册 4 项 = `gen_menu` / `extract_cn` / `make_font` / `tools/arch_diagram` 全量配图；接线实跑 `menu-gen` 70 文件一致、字库链两向无差、14 个配图生成器 9 干净 5 在册 → PASS | +| 2026-10-28 | 全仓计数复扫（本轮漏改面之一）：§7 接线基线那句里的「183 字」补「当时」二字锁口径。那一行是 2026-10-26 接线的实跑记录，当日实跑数按当日冻结、不臆改成现值；现值另测 = ui_cn_chars.txt 唯一码点 218 个（ASCII 区 0 个；ASCII 0x20~0x7E 由生成器的子集参数另打进子集，不计入字数）。本行只追加 |