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