Files
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- 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。
2026-11-18 10:29:26 +08:00

4.2 KiB
Executable File
Raw Permalink Blame History

路线图: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/Call
  • Param.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 文档项勾选