- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
60 lines
2.9 KiB
Markdown
Executable File
60 lines
2.9 KiB
Markdown
Executable File
# 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` 无修饰括号调用表面 |
|