112 lines
4.2 KiB
Markdown
112 lines
4.2 KiB
Markdown
# 路线图:Marqdo Markdown 语法映射 v0.3(叙述统一)
|
||
|
||
「Markup」= Marqdo 把 Markdown 标记当成语法的那一层(不是另一个产品)。v0.3 = 现行映射:粗体代码、斜体返回。
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | **Done(v1.0.0)** |
|
||
| 日期 | 2026-09-13 |
|
||
| 设计 | [markdown-mapping-v0.3.md](../design/markdown-mapping-v0.3.md) |
|
||
| ADR | [0005-prose-unified-markup.md](../adr/0005-prose-unified-markup.md) |
|
||
| 依赖 | 现有管线 [interpreter.md](interpreter.md) · [pipeline-debug.md](../design/pipeline-debug.md) |
|
||
|
||
---
|
||
|
||
## 目标
|
||
|
||
把 v0.3 宪法落到词法 → AST → 语义 → 双后端,使动机示例(加一函数)成为金样例,并安全迁移存量代码。
|
||
|
||
---
|
||
|
||
## 里程碑
|
||
|
||
### M0 — 设计冻结与双模式骨架(文档 ✅ / 代码 ⏳)
|
||
|
||
- [x] 设计文档 + ADR Proposed + 本路线图
|
||
- [x] **钉死**:空返回词法(设计 §7.2);提及/未使用变量(§4.4);升参 vs 绑定图(§8.2)
|
||
- [x] **钉死**:一行多 `**…**` 按序执行(设计 §12 #6)
|
||
- [x] **不做双模式** — 直接 v0.3 默认
|
||
|
||
**出门:** 设计评审通过;旗标可切换;无行为默认变化。
|
||
|
||
### M1 — 内联扫描与 AST
|
||
|
||
- [x] 金样例目录 `tests/markup-v03/`(夹具 + `gold.rs` `#[ignore]`;见目录 README)
|
||
- [x] `Prose` 行内联扫描:`` `ident` `` / `**…**` / `*…*`
|
||
- [x] `Stmt::Return` ← italic;`Stmt` ← bold Assign/Call
|
||
- [x] `Param.inferred` + 升参
|
||
- [x] `tests/markup-v03/` 金样通过(默认运行时)
|
||
|
||
**出门:** `cargo test markup_v03`(无 ignore)绿。
|
||
|
||
### M2 — 形参推断
|
||
|
||
- [x] `InferParams`:首次 `` `名` `` = 必选;`` `名`=默认 `` = 可选
|
||
- [x] 体赋值 `n=n+1` 不误判为默认
|
||
- [x] 与显式 `+` 合并规则 + 警告
|
||
- [x] 方法 `self`/`自` 排除
|
||
- [x] 金样例:默认实参、位置/具名调用、粗体内调用
|
||
|
||
**出门:** 推断签名与 `+` 兼容套件绿。
|
||
|
||
### M3 — 调用面与消歧
|
||
|
||
- [x] `**callee args**` ≡ `> callee args`
|
||
- [x] else 臂 `N. *` 与返回斜体消歧
|
||
- [x] 一行多 `**…**` 按序执行
|
||
- [x] 金样例:`---` / `*None*` / 整行 `**` / 兼容 `****`;叙述死绑定不升参
|
||
- [x] 诊断:必选缺失、未知 callee(已有 errors 金样);死变量不报错
|
||
- [x] 残缺粗体:与 GAP-06/07「未闭合后恢复」冲突,保持 Comment 跳过恢复,不硬报错
|
||
- [x] 粗体内表达式语句:`**n + 1**` 求值后丢弃(非误判为调用)
|
||
- [x] 叙述斜体:仅整行 / `返回*…*` / 表达式形当返回(`*very important*` 不收束函数)
|
||
|
||
**出门:** `tests/markup-v03/*` 覆盖设计 §9 示例。
|
||
|
||
### M4 — 双后端与工具
|
||
|
||
- [x] 字节码发射跟随新 Stmt 源
|
||
- [x] `view` / Structure:推断形参 `chip inferred` + Functions 大纲标注
|
||
- [ ] (可选)`marqdo migrate markup-v03` 机械改写提示/工具
|
||
|
||
**出门:** tree 与 bytecode 后端对 `markup-v03` 金样一致。
|
||
|
||
### M5 — 默认切换与存量迁移
|
||
|
||
- [x] 默认 `MarkupEdition::V03`
|
||
- [x] 迁移 `tests/**`、`lib/**`、`ext/**`、`public/**`、教程
|
||
- [x] 更新 `.cursor/skills/marqdo/SKILL.md` 硬规则
|
||
- [x] 修订 [markdown-mapping.md](../design/markdown-mapping.md) 为 v0.3 正式正文(或声明由 v0.3 文件接任)
|
||
- [x] ADR 0005 → **Accepted**
|
||
- [x] CHANGELOG / 发版说明(破坏性:标记对调)— **v1.0.0**
|
||
|
||
**出门:** 全量 gold 默认绿(live LLM 无钥跳过);无 v0.2 双模式。
|
||
|
||
---
|
||
|
||
## 非目标(本路线)
|
||
|
||
- 不改插件 ABI / Go libweb
|
||
- 不引入 `def`/`return` 关键字
|
||
- M0–M4 不强制改生产 `.mq.md`
|
||
|
||
---
|
||
|
||
## 风险
|
||
|
||
| 风险 | 缓解 |
|
||
|------|------|
|
||
| 标记对调导致海量假失败 | 双模式 + 分目录金样;默认晚切换 |
|
||
| 形参推断误伤局部变量 | 金样例钉启发式;允许过渡期写 `+` |
|
||
| 空返回 vs `**` 词法 | §7.2 已钉:整行 `**` = 空返回;推荐优先 `---` |
|
||
| 叙述反引号误升参 | §8.2 升参需可执行面读取;死绑定不进 params |
|
||
| Skill/AI 仍按 v0.2 生成 | M5 同步 Skill;过渡期文档标明版本 |
|
||
|
||
---
|
||
|
||
## 修订历史
|
||
|
||
| 日期 | 说明 |
|
||
|------|------|
|
||
| 2026-09-13 | 初稿与设计/ADR 同步 |
|
||
| 2026-09-13 | 空返回与提及性反引号决议合入;M0 文档项勾选 |
|