- 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。
52 lines
3.4 KiB
Markdown
52 lines
3.4 KiB
Markdown
# v2.8.0 发布说明 · Release Notes(prove)
|
||
|
||
## 1. 一句话
|
||
|
||
`marqdo prove` 正式发布:知识文件的定理表 → Lean 4 证明 → 自动判定。
|
||
没有 Lean 工具链也能跑(离线符号执行,诚实降级);有 Lean 时全链路证明,
|
||
假定理给出路径见证反例,离线与 Lean 分歧时显式报错永不落绿。
|
||
|
||
`marqdo prove` ships: theorem tables in knowledge files compile to Lean 4
|
||
and are judged automatically. It runs without a Lean toolchain (offline
|
||
symbolic execution, honest degradation); with Lean, fake theorems get
|
||
counterexamples and any offline/Lean divergence fails loudly.
|
||
|
||
## 2. 亮点(Highlights)
|
||
|
||
| | |
|
||
|---|---|
|
||
| 定理表 | `| 定理 | 结论 | 前提 | 策略 |`,结论文法:`结果.ok`、`包含(轨迹,…)`、`长度(轨迹)`、参数比较,且/或/非组合 |
|
||
| 六段管线 | 装载 → 降级 → 定型 → 生成(Lean 4.35)→ 判定(离线先行 + Lean 复核)→ 证书 |
|
||
| 离线判定 | F1–F5 片段符号执行:路径枚举、轨迹形状、构造器结构、自由原子二分、区间字面重述与反例见证(毫秒级) |
|
||
| 单调性护栏 | 离线 `checked` 但 Lean 证不出(或反例被证出)→ `error[proof.divergence]` 退 1——绝不让离线判定比 Lean 更乐观 |
|
||
| 诚实状态 | `proved > checked > unverified > rejected > unproved > error`;`checked ≠ proved`;无 Lean 时状态如实降级(咨询性退 0),`--require-lean` CI 严格模式退 2 |
|
||
| 反例 | 假定理给出区间端点见证(如 `金额 = 10001`)并指回定理表行号 |
|
||
| 证书缓存 | 复合键(源码⊕计划⊕库⊕Lean 版本⊕CLI 版本),`.marqdo/prove/`,命中跳过判定;`--no-cache` 绕过 |
|
||
| 目录模式 | `prove --all 目录`(`--max-files` 默认 200):逐文件出证,整体取最差,聚合 JSON |
|
||
| 差分一致性 | T4 语料:解释器求值 == Lean 语义(算术/中文标识符/分支/拼接/i64 边界/结构字段) |
|
||
| 工具链 | `--lean` 显式指定 → `MARQDO_PROOF_LEAN` → PATH;内嵌判定库按内容哈希缓存构建,无需 lake/elan |
|
||
|
||
## 3. 使用(Usage)
|
||
|
||
```bash
|
||
marqdo prove 审批.mq.md --json # 判定 + 单个 JSON 报告
|
||
marqdo prove emit 审批.mq.md # 只生成 Lean 模块 + plan.json
|
||
marqdo prove audit 审批.mq.md # 只审查可证子集(不写盘)
|
||
marqdo prove --all skills/ --json # 目录聚合(整体取最差)
|
||
marqdo prove clean # 清空 .marqdo/prove
|
||
```
|
||
|
||
测试:`cargo test --test prove`(无 Lean 全绿)·
|
||
`MARQDO_PROOF_LEAN=<lean> cargo test --test prove_lean --test prove_corpus --test conformance`(有 Lean 全链路 + 40 夹具单调性 + T4 一致性)。
|
||
|
||
详见 [design/prove-cli.md](../design/prove-cli.md)(命令面、可证子集与判定管线)与
|
||
[skill-proof-theory.md](../verification/skill-proof-theory.md)(库形式化说明)。
|
||
|
||
## 4. 已知限制(Known limitations)
|
||
|
||
- `foreach` 维持 `proof.foreach_pending`(可证子集无循环;fold 编码 → 2.9)。
|
||
- 跨模块调用 = 不透明操作;assume-guarantee 后置条件复用 → 2.9(依赖假设表 T3)。
|
||
- 除零/模零:解释器为运行时错误,判定库模型返回 `.int 0`(已记录偏差)。
|
||
- 分支条件暂不支持字段访问(解析器文法限制;prove 侧已就绪,放开即生效)。
|
||
- i64 溢出:解释器报运行时错误;判定库 `Int` 无界(语料只测界内值)。
|