5 Commits

Author	SHA1	Message	Date
wandering1	15aa08552c	docs(问题记录): 删除项目审查与优化建议报告，结论并入模块文档与编号规范 ... 用户裁定：该报告大部分内容已闭环，可删除；仍有价值的迁到合适文档。删前逐条核对， 确认绝大多数结论在仓内早已有权威副本（LV_DRAW_SW_COMPLEX / osFlagsNoClear / SPI 分频 8 / 分层反向依赖存量基线等），只迁真正独有的四类内容： 1. 暂缓理由与重开条件（三条量化门槛）→ RAM 使用分析与优化方案 §4，并明确「本节是唯一 权威」，其它文档只留指针；同时把 10 处指向报告 §5.3 的重开条件引用改指该节。 2. 2026-10-22「常驻 vs 动态」三项诊断（静态前五块 43,462 B = 58%；动态面只有 heap_4， 故栈余量=CCM 余量；栈深主因是日志/配置写链）→ 同文档 §2.5。 3. `_fp_digits` 1,018 B 删不掉的机理与 F-6 根因修法（Q10 宏改单精度，−332 B，4.49e6 例 逐位等价）→ §2.6.4。 4. 「UI 侧缓冲进 CCM」要按 DMA 可达性二分（LVGL 池可进，帧缓冲/推流缓冲不可）→ 暂缓清单。 编号侧（报告曾是 6 个族的属主登记处）： - 原报告 §9 的 26 行「号 → 现在详述于」对照表迁到 docs/编号规范.md 新增 §4.5，6 族 owner_docs 改指该节。规范正文含大量写法示例，直接当定义集会误伤，故 check_ids.py 新增 `_def_owners`：snapshot_only 族剔除规范正文，只恢复可判定、不参与悬空/撞号/裸形 /紧邻判定（实测若不分，裸形 S1 误报 238 条、S-3 与登记簿 S-3 误判重复定义）。 - 11 个已死号（N-03b/N-10~N-13/N-20/N-21/N-24/N-26/S-1/S-2）在 id_aliases.json 登记 status=void 并写明去处——它们被约 110 处代码注释与文档引用，原先只靠「报告里顺带提过 一句」才算有定义，报告一删就集体悬空。N-21/S-1/S-2 一号两义，注记已分别标明。 - 顺带修 id_aliases.json 的 note 被脚本累积重复 26 次；修 registry 里 3 处仍指向改名前的 任务卡文件名（W1-采集保护收尾.md / W8-数据可信.md），以及 iec104_master.py 两处同类注释。 门禁：check_ids --strict 通过（可判定 8747/10410 = 84.02%，基线由 82.6% 抬到 84.0%）； check_doc_links --all --sections-strict 通过（177 文档）；pre-commit 相关钩子全过。	2026-10-25 02:08:58 +08:00
wandering1	504db26698	docs(内存): 阶段子项改层级编号 4.阶段.项，消除与顶层章节同号撞面 ... 根因：`RAM使用分析与优化方案.md` 顶层有 §1 背景 / §2 现状测量（2.1~2.6），而 §4 「方案」下"阶段 N"的子项也用裸号 0.x / 1.x / 2.x——阶段 2 的 2.1/2.2/2.3 与顶层 2.x **完全同号**，阶段 1 的 1.x 又长得像"第 1 章第 x 节"。`doc-links` 对本文自 引用按设计直接放过，于是门禁和人一起看错：AGENTS.md 把"栈余量台账"写成 §1.4， 而 §1.4 其实是阶段 1 的 lftpd 静态化项（上一笔提交的信息里我把它误判成断链， 已 amend 更正）。 改法：阶段子项一律改层级编号，阶段号不变、只加 `4.` 前缀 —— 0.x→4.0.x、 1.x→4.1.x、2.x→4.2.x。共改 14 个标题；文内自引用与实施序列表（S4~S9 那套）、 暂缓清单、§5 预期效果列里的裸号一并补成 §4.x.y。 外部引用同步 15 处：AGENTS.md、lftpd/README ×2、菜单页面设计、RAM预算台账 ×2、 项目架构总览 ×3、FTP_Test_Guide ×3、boot_log_data/README、部署环境要求、审查 报告、ram_baseline.py ×3。最有说服力的两处歧义：审查报告与 RAM预算台账都写 "缩堆见 …§2.2"——既可读成顶层 §2.2（静态大项排行）也可读成阶段 2 第 2 项， 现均为 §4.2.2（阶段 2 第 2 项"缩堆"）。 另修 4 处把 §1.4 当"栈台账"的错指：采样有效性校验设计说明 :441/:593/:650 改 指 §2.3（任务栈配置与实测峰值）与 §4.0.6（静态最坏链与判定）；id_aliases.json 的 note 改指 §4.0.6 并标注"原 §1.4，2026-10-22 层级编号"。 冻结与示例：其它文档**变更记录行**里的旧编号按项目纪律不改写（项目架构总览 :367、RAM预算台账 :98），改在被引文档 §4 开头留一张换算表 + 约定说明；把旧号 当语法示例写的 7 处一并换掉（文档规范 ×3、check_doc_links ×3、rename_ref ×1）， 否则示例本身指向已改名的锚点。主文档版本行 bump 到 v1.3 / 2026-10-22。 门禁：check_doc_links.py --all --sections-strict → 146 个文档 0 问题（章节引用 2513 处、机器可判定 1491）；check_ids.py --strict 增量拦截通过；mem-numbers、 ram_baseline --gate（SRAM1 57.4% / CCM 87.9%）、task-table 全绿；本轮未改任何 .c/.h。16 个文件字节卫生自查 BOM/CR/U+FFFD/行尾空格全清。已提交本地，未推送。	2026-10-22 15:38:14 +08:00
wandering1	8f902e09fd	chore(scripts): doc-links 检查器在 GBK 代码页下崩溃修复 ... - 钩子环境为系统代码页 936（GBK）时，打印含 U+26A0 等字符的告警列表 触发 UnicodeEncodeError，检查器以退出码 1 崩溃（假阴性变假阳性拦截） - 修复：入口处对 stdout/stderr reconfigure(encoding=utf-8, errors=replace) - 验证：GBK 复现 traceback → 修复后跑完；Compare-Object 逐行比对修复前后 正常环境输出字节一致；py_compile OK；无 BOM 变化 - 由 N34 任务队友 fix-doclinks-encoding 实施，Lead 复核	2026-10-13 11:22:43 +08:00
wandering1	d1e6bb4ba7	W5波+N-19收口：FTP鉴权落地、Trap25三连定案修复(N-30)、N-20/N-23/N-26 ... N-19 FTP 鉴权： - lftpd_auth（USER/PASS 状态机 + 连续5次失败锁60s）+ SHA-256 (user||pwd) 口令哈希；config.ini [ftp] 段 user/pwd_hash/write， 出厂 admin/admin 在用有启动告警；lftpd_log.c 删除并入 lftpd_auth - ftp_cfg 配置读写；台架 ftp_auth_bench.py 13/13 N-30 / Trap 25（CH395F_Trap_Records.md 四次定案全记录）： - 修复1 closed-with-data accept：客户端发完正常 FIN 后芯片按 FUN_PARA(0x09) §5.52② 保留 Socket+RX 缓冲，旧代码把 CLOSED 一律 relisten 自毁缓冲 → STOR 必挂 425；改为接受"已关但可读"连接排空 - 修复2 丢 CONNECT 中断探针 net_lost_connect_probe + last_peer_port 幽灵甄别（拆链窗口握手完成但中断丢失，双信源去抖补 accept） - 修复3 send_list/send_nlst 批量单发：背靠背 ~60B 小段毒化芯片 TX （芯片报 SEND_OK 但对端全丢），整份目录一次性写入 - 证伪存档：固定沉降/Socket 轮换冷却/listen 门控（台架 v7 矩阵） - 台架工具 test/board/ch395f_reuse_bench.{c,h} + host 脚本存档 （不注册编译；实验分支 n30-chip-bench 保留） N-20：Error_Handler 死循环降级（记录+复位路径） N-23：scripts/check_registration.py 双端注册反向校验（pre-commit） N-26：GD5F NAND 直 DMA 调用方缓冲窗口断言 验证：BUILD_OK 0/0；ftp_regression 连跑 4 轮 11/11（修复前 LIST#4/#7 100% 挂、STOR#2 曾 100% 425）；ftp_auth_bench 13/13； @test 启动标记 PASS；ci_local L0+L0.5 全过；doc-links 通过。 登记簿 N-30 已销项。	2026-10-11 18:50:24 +08:00
wandering1	a6cdebde62	文档体系重组与 D-7 一致性门禁落地，清理芯片手册孤儿图片 ... - D-6 目录规范化：docs 根目录散落文档归入 UI设计/子系统设计/架构设计/审查记录/ 环境与部署/网络 等子目录，去掉目录名空格，重命名 嵌入式C语言代码规范_V1.0.md - D-7 三档一致性门禁：新增 scripts/check_doc_links.py（链接存在性）、 scripts/gen_task_table.py（FreeRTOS 任务表数值）、scripts/check_mem_numbers.py （内存/Flash 体积），均支持 --check/--write/--diff，pre-commit 钩子同步注册 - D-5 文档索引：新建 docs/README.md，新建 docs/文档规范.md 约束目录命名与链接写法 - D-1 芯片手册瘦身：删除 1069 张无引用孤儿图片（77.06 MB）， docs/芯片手册 120 MB → 41 MB，已引用图片零断链 - 同步 C 源码注释中的文档路径引用（D-6 重组后），构建 0 错误 0 警告	2026-09-26 00:51:53 +08:00