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/行尾空格全清。已提交本地,未推送。
This commit is contained in:
@@ -29,7 +29,7 @@ lftpd(本目录)
|
||||
|
||||
- **ftpTask 就绪屏障**:`osEventFlagsWait` 等两位就绪必须加 `osFlagsNoClear`,
|
||||
否则位被先到的消费者清掉 → FTP 21 端口静默不监听(无日志无报错)
|
||||
- **lftpd 大局部缓冲**:已按 `docs/内存管理/RAM使用分析与优化方案.md` §1.4 静态化 9 处
|
||||
- **lftpd 大局部缓冲**:已按 `docs/内存管理/RAM使用分析与优化方案.md` §4.1.4 静态化 9 处
|
||||
大局部缓冲(BSS +4.6KB),使 ftpTask 栈峰值从 3480B 降到 1184B——**勿改回局部变量**
|
||||
- **上传中止截断**:FTP STOR 中途断开后首笔复连被截断(TRAP-NET-18)已在 `net_socket.c` 侧修复
|
||||
- 本目录受 pre-commit 的**部分排除**(第三方代码)
|
||||
@@ -38,4 +38,4 @@ lftpd(本目录)
|
||||
|
||||
- 测试指南:`docs/测试说明/FTP_Test_Guide.md`
|
||||
- 台架探针:`test/host/ftp_abort_probe.py`、`MDK-ARM/ftp_freeze_probe.py`
|
||||
- 内存优化:`docs/内存管理/RAM使用分析与优化方案.md` §1.4
|
||||
- 内存优化:`docs/内存管理/RAM使用分析与优化方案.md` §4.1.4
|
||||
|
||||
Reference in New Issue
Block a user