[P3] 文档-代码漂移：README 与 docs/01_软件架构.md 仍描述"本期 MergeBatch+IterBatch、asw_basic/stream_k 待迭代" #10

New Issue

admin · 2026-09-03T10:56:39Z

admin commented

2026-09-03 10:56:39 +00:00

现象：

README.md:71 分支目录注释仍为"(本期: MergeBatch + IterBatch)"；目录树（:76-84）只列 00/01/02 三篇分支文档 —— 实际已有 6 个分支文件与 03~07 五篇分支文档（9/3 入库）；
docs/01_软件架构.md 分层图（:14-24）与 §4"扩展指南"（:101-102）仍写"asw_basic.py / stream_k.py 待迭代、新建 branches/asw_basic.py 接入"——与实际（ASW_Basic 为兜底主干、已实现并测试）直接矛盾；
README 声明 "Python >= 3.8"，代码大量使用 PEP 604（X | None，3.10+）与内置泛型语法（3.9+），虽有 from __future__ import annotations 兜底，但未在任何 <3.14 版本实测，声明与验证脱节。

期望：同步 README/架构文档至 6 分支现状；版本声明改为实测过的范围或补多版本 CI。

参考：测评报告 §5.5、§5.6。

**现象**： 1. `README.md:71` 分支目录注释仍为"(本期: MergeBatch + IterBatch)"；目录树（:76-84）只列 00/01/02 三篇分支文档 —— 实际已有 6 个分支文件与 03~07 五篇分支文档（9/3 入库）； 2. `docs/01_软件架构.md` 分层图（:14-24）与 §4"扩展指南"（:101-102）仍写"asw_basic.py / stream_k.py 待迭代、新建 branches/asw_basic.py 接入"——与实际（ASW_Basic 为兜底主干、已实现并测试）直接矛盾； 3. README 声明 "Python >= 3.8"，代码大量使用 PEP 604（`X | None`，3.10+）与内置泛型语法（3.9+），虽有 `from __future__ import annotations` 兜底，但未在任何 <3.14 版本实测，声明与验证脱节。 **期望**：同步 README/架构文档至 6 分支现状；版本声明改为实测过的范围或补多版本 CI。 **参考**：测评报告 §5.5、§5.6。

admin commented

2026-09-03 12:05:43 +00:00

【修复说明 · 乱码重写】原评论提交时编码损坏、内容不可恢复, 以下按 git 记录 / issue 正文 / 残留文本重建 (要点级, 非逐字原稿):

[P3] 文档-代码漂移 (README/docs/01_软件架构仍写"本期 MergeBatch+IterBatch、asw/stream_k 待迭代") 已修复:

README (7bcacef) 与 docs/01_软件架构 (593ffcf) 同步为六分支全量实现 + 03~07 分支文档清单;
README 目录树补 03_测评报告/ 目录; 移除全部"待迭代"过时声明。

【修复说明 · 乱码重写】原评论提交时编码损坏、内容不可恢复, 以下按 git 记录 / issue 正文 / 残留文本重建 (要点级, 非逐字原稿): [P3] 文档-代码漂移 (README/docs/01_软件架构仍写"本期 MergeBatch+IterBatch、asw/stream_k 待迭代") 已修复: - README (7bcacef) 与 docs/01_软件架构 (593ffcf) 同步为六分支全量实现 + 03~07 分支文档清单; - README 目录树补 03_测评报告/ 目录; 移除全部"待迭代"过时声明。

admin closed this issue

2026-09-03 12:05:43 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: admin/matmul-analysis#10