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

52 lines
3.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` 无界(语料只测界内值)。