Files
marqdo/doc/verification/skill-proof-theory.md
T
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

79 lines
4.6 KiB
Markdown
Executable File
Raw 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.
# 判定库 `MarqdoProof.lean` 的形式化说明
> 本文是 [design/prove-cli.md](../design/prove-cli.md) §4–§5 的配套理论摘要:
> 生成文件依赖哪些库事实、离线判定凭什么与 Lean 单调一致、边界在哪里。
> 库本体:[skill-proof/MarqdoProof.lean](skill-proof/MarqdoProof.lean)
> (由 `marqdo prove` 内嵌携带,`scripts/check-proof-library.sh` 校验一致性)。
## 1. 语义模型
生成文件把每个函数降级为纯 Lean 定义:
```lean
def «模块.函数» (env : Env) («轨迹» : List Op) («参数» : Val)… : Val × List Op
```
- `Val`:8 形状和(none/int/num/bool/text/list/map + formula/code 边界),
与解释器 `value::Value` 一一对应(T4 差分一致性测试锁定)。
- `env : Env`:不透明操作的答案函数。**调用者的定理以 env 为全称量词**——
证出即"对任意环境实现成立",这正是 assume-guarantee 的保守形态。
- 不透明操作 = `Op.«调用_显示名»` 构造器 + 追加轨迹;操作名用链接显示文本,
与定理表里 `包含(轨迹, "显示名")` 的写法一致。
- 库函数面:`mqAdd/mqSub/mqMul/mqDiv`(int 面,除零→0,已记录偏差)、
`mqGt/mqGe/mqLt/mqLe/mqEq`(decide 编码)、`mqAccess`(映射字段读取,
方程友好)、`mqResultOk/mqResultError/mqValueOr`(lib/result 结构)。
## 2. 定理形状与判定
每条定理表行生成:
```lean
theorem «模块.函数.定理名» (env : Env) («参数» : Val)… :
(前提 → True) →
((«结果», «轨迹») = «模块.函数» env [] «参数»…) →
mqTruth «结论的 Lean 编码» := by
intro … h_run
unfold «模块.函数» at h_run
try split at h_run -- 按最大 if 嵌套深度重复
all_goals (simp_all [域引理]; try omega)
```
- `decided_by = "lean"`:Lean 内核接受 ⇒ `proved`;`sorry` ⇒ `unverified`;
报错 ⇒ `unproved`(错误指回定理表行)。
- 策略 `none`:定理生成但主体 `sorry`,状态恒 `unverified`——绝不冒充。
## 3. 离线判定(F1–F5)与单调性论证
离线判定器对同一 IR 做符号执行,路径记录 (路径条件, 结果, 轨迹, 变量)。
它与 Lean 的对应关系是**逐构造镜像**:
| 离线闭包理由 | Lean 侧对应 | 单调性依据 |
|---|---|---|
| F1 路径枚举穷尽 | `split at h_run` 产生的同一组目标 | 同一 IR 树,分支集合相同 |
| F2 轨迹形状(包含/长度) | `(轨迹.map Op.name).contains` / `List.length` simp | 字面轨迹的列表运算两侧同构 |
| F3 构造器结构求值 | `mqResultOk/mqResultError/mqValueOr` + `mqAccess` simp 方程 | 同一套库定义;结构字面归约是计算的 |
| F4 自由原子 | split 后假设里的同一原子(`hypothesis` 关闭) | 只承认路径条件中字面出现的原子;路径反例含自由原子时放弃见证(保守) |
| F5 区间字面重述 | split 后假设直接就是结论(`hypothesis`) | 字面匹配,无推理步 |
| F5 区间违反(反例) | 无对应(Lean 同样证不出) | 反例只产生 `unproved`,不产生绿灯;见证 = 区间端点 |
| 不可行路径跳过 | split 后假设矛盾(互斥比较引理 `.elim` + omega) | 前提 ∩ 路径条件为空 ⇒ 该分支假设集 Lean 侧同样矛盾 |
**单调性护栏**:有 Lean 时逐定理复核。离线 `checked` 而 Lean 关不掉,或
离线反例被 Lean 证出 ⇒ `error[proof.divergence]`,永不落绿。护栏使
"离线比 Lean 乐观"成为运行时可见错误而非静默错误;40 夹具语料库
(`tests/prove_corpus.rs`)在 CI 强制 `offline_checked ⊆ lean_proved`。
**已知保守边界**(离线能、Lean 脚本不能,因此离线也必须不做):
- 区间**蕴含**(`金额 > 10000 ⊢ 金额 > 9999`):数学上真,但当前脚本没有
Val 比较的传递引理,simp+omega 关不掉 ⇒ 离线同样 `unverified`
(`f5_interval_closure_scope` 单测锁定)。库补传递引理后两侧同时放开。
- 多变量线性、非线性、文本相等:超出 F5 单变量区间 ⇒ `unverified`;
Lean 侧若能证则升级 `proved`(允许,这是"弱判定被强判定确认")。
## 4. 证书与缓存
证书记录:claim id、结论、策略、状态、`decided_by`(lean/trace/none)、
证据(Lean 报错或离线见证)、库与模块 sha256、Lean 版本、CLI 版本。
缓存键 = 上述全部的 sha256 ⇒ 任何一侧变化自动失效,命中即跳过判定。
证书是**证据陈述**("这次判定是这样"),不是正确性保证——与设计 §0 契约 1 一致。