# Roadmap:lib / ext 代码即文档 | | | |---|---| | 状态 | **Active** | | 日期 | 2026-09-14 | | 相关 | [lib-code-as-docs.md](../design/lib-code-as-docs.md) · [view-markup-surface.md](../design/view-markup-surface.md) · [bracket-call-modifiers.md](../design/bracket-call-modifiers.md) · [collection-access-link.md](../design/collection-access-link.md) | --- ## 0. 总序(防返工) 1. **方括号标记调用**(设计 + AST + 金样)— **已落地** 2. lib / view 设计文档 — **已写** 3. View 表面(Index 链接形、括号调用)— **已落地** 4. 分波改造 `lib/*` → `ext/*` 旧 `>` / 粗体调用、脚注取元解析均保留。 ## 1. 里程碑 | 波 | 内容 | 状态 | |----|------|------| | **Call** | `pre_modifiers`;`tests/structure/bracket-call.mq.md`;mapping / call-arguments | **done** | | **M0 View** | `InterpPart::Index` → `[k](base)`;`call_display` 修饰表面 | **done** | | **M1** | 试点 `lib/table` · `lib/text` · `lib/json`(中英)+ public/stdlib | **done** | | **M2** | 其余 `lib/*` 叙述化;禁新脚注取元 | **done** | | **M3–M4** | `ext/web`、`ext/ai`:脚注→链接取元;叙述;示例可逐步换括号调用 | **done**(取元迁移) | | **M5** | quantum / linalg + full gold | **done** | | **M6** | examples + public/structure + tests/ext·lib 链接取元;cafe 括号调用例 | **done** | | **M7** | structure collection 金样改链接形;public/stdlib 括号调用例 | **done** | | **M8** | 教程第 9 章 + Skill examples → 链接取元 / v0.3 标记 | **done** | | **M9** | 教程其余章节(1–8、10–12、14)全面对齐 v0.3 + 链接取元 | **done** | | **M10** | public/stdlib 剩余演示统一括号调用;public import 返回面修到 v0.3 | **done** | | **M11** | View:`bracket_marked` 使无修饰 `[callee]` 也显示括号形 | **done** | ## 2. 验收(出门) - 括号调用与 `[k](c)` 取元金样并存、不回归。 - 试点库可读:目的句 + 叙述形参 + 一例 + 短实现。 - `cargo test --test gold` 绿。 - 脚注取元金样(`tests/structure/footnote*`)仍保留作兼容门禁。 - 教程与 Skill 示例以链接取元 / `**` 代码 / `*` 返回为准。 ## 3. 修订历史 | 日期 | 说明 | |------|------| | 2026-09-14 | 初稿;Call + M0 标 done | | 2026-09-14 | M1 试点 table/text/json + public/stdlib 标 done | | 2026-09-14 | M2 其余 lib 叙述化标 done | | 2026-09-14 | M3–M4 ext/web+ai 脚注→链接取元 | | 2026-09-14 | M5 quantum/linalg 叙述 + public/features 取元 | | 2026-09-14 | M6 examples/public/tests 批量链接取元 + cafe 括号调用 | | 2026-09-14 | M7 structure collection 金样 + stdlib 括号调用例 | | 2026-09-14 | M8 教程 + Skill examples 同步 | | 2026-09-14 | M9 教程全书对齐 v0.3 标记与链接取元 | | 2026-09-14 | M10 public/stdlib 括号调用扫尾 + import 返回面 | | 2026-09-14 | M11 View `bracket_marked` 无修饰括号调用表面 |