59 lines
5.0 KiB
Markdown
59 lines
5.0 KiB
Markdown
# Marqdo 知识锚点与证明制品(2.8 → 2.9)
|
||
|
||
> 实现状态:PR #2 第一阶段。保持解释器和原有 `[]()` 求值语义不变,复用 2.8.0 `prove` 与既有 SemanticProject。以下明确区分**已经写入分支的功能**和**尚未完成的跨模块证明**。
|
||
|
||
## 核心语义
|
||
|
||
- AST 内部步骤仍有原来的 `#step-N` 序号,供旧查询、调试与执行日志使用。
|
||
- 在**同一个函数内名称唯一**的标记步骤,获得独立的 `anchor_id = SymbolId#anchor-sha256(normalized_label)`;在前面插入其他步骤不会改变地址。
|
||
- 同函数重复的标记名称**不产生公共锚点**;必须重命名,不得静默采用首个。
|
||
- `definition_digest` 来自该语句源码位置的内容,与稳定身份分开;语句内容更改时身份保留、定义指纹改变。
|
||
- 两种文档引用不执行目标:同函数的 `[阅读依据](#@演算)` 和跨模块绝对地址 `[阅读依据](mq://...#anchor-<sha256>)`。后者应从编译生成的 anchors.json 拿完整 ID,不应凭空手写。
|
||
- 2.8.0 定理表每条唯一声明生成稳定 `ClaimId = SymbolId#claim-sha256(定理名称)`;正文 `[阅读定理](#@定理名称)` 可以定位**声明**,但不会读取或伪造证明状态;同一名称同时匹配知识步骤和定理声明时标记 `ambiguous_anchor`,不猜测。\n- 普通 `[说明](https://...)` 仍为导航,原来表达式位置的 `[描述](payload)` 仍依照原 Marqdo 执行规则求值。
|
||
- **链接不意味着执行权**:解析到知识锚点只生成引用边,不自动调用函数、加载插件或赋予权限。
|
||
|
||
## 制品
|
||
|
||
`marqdo knowledge` 所用的 SemanticProject 原子生成目录下新增:
|
||
|
||
| 路径 | 内容 |
|
||
|---|---|
|
||
| `steps.json` / `refs.json` | 增量字段 `anchor_id`、`definition_digest`、`link_target`、`target_anchor` |
|
||
| `claims.json` | 定理声明索引,初始状态固定为 `declared_unverified`,不等同于证明通过 |\n| `anchors.json` | 稳定公共步骤索引,附所有者、标记文本、源码、效应、定义指纹 |
|
||
| `graph/edges.json` | `defines_anchor`、`references_anchor`、知识步骤到已解析调用目标的 `calls` |
|
||
| `proof-index.json` | 可用或过期的证明收据索引;它不是可执行授权,也不自动证明步骤 |
|
||
|
||
`marqdo prove` 在原本的证明目录附带 `knowledge-links.json`:
|
||
每个定理通过文件 + 函数全名唯一绑定到 `SymbolId`,稳定 `claim_anchor_id` 附带前提、结论、来源、函数的 interface/implementation/closure digest 与可用时的 Lean 证书摘要。
|
||
无法安全绑定时输出 `unresolved`,不匹配别的同名函数。
|
||
`related_anchor_ids` 仅是 **defined_in_same_function_not_individually_proved** 导航关系,绝不意味着 Lean 已分别证明这些内部锚点的性质。
|
||
|
||
## 证据有效性
|
||
|
||
1. 离线 `checked` 不能当作 `proved`。
|
||
2. 只有 `ClaimReport` 显示真实 Lean 判定,且匹配当前报告的原始 `certificate.json`、命题、文件、Lean 工具链与证明库,才可输出 `proved` 关联。
|
||
3. 在知识编译时复核文件源码 SHA、函数接口、实现指纹、传递依赖 closure 指纹及证书字节摘要;失败 => `stale` / `unverified`,`usable=false`。
|
||
4. 同一个声明出现多份可见报告时 => `ambiguous`,不能随意取旧证书或新证书。
|
||
5. 当前证明文件是**本地缓存收据**,不是经过签名的远程授权凭证。对抗性环境必须在可信 CI 中再次用 Lean 验证,不能仅相信 JSON 内的 `status`。
|
||
|
||
## 下一阶段:跨模块 assume–guarantee
|
||
|
||
这是比单纯增加更多 Lean tactic 更重要的方向,但 **本 PR 第一阶段尚未实现**:
|
||
|
||
- 将函数可复用契约分成 `requires / ensures / effects`,全部有已解析 SymbolId 作为身份;
|
||
- 在调用方生成 “调用前提满足” 的证明义务,并以被调者的已验证后置条件作为假设,**明确记录假设链**;
|
||
- 若被调者实现改变、但同一契约被重新证明支持,允许复用不受影响的调用方证明;
|
||
- 若契约失效、闭包改变或假设不能满足,所有受影响证明回退 `stale`,不能保持 `proved`;
|
||
- 对外部 ABI 插件调用,必须给出明确 effect 契约、来源和可信主体,不能把不透明调用宣告为纯函数;
|
||
- 保留 Lean 与解释器对 i64 溢出、除零/模零行为的差异护栏,在证明模型不等价时不给出无限定的成功保证。
|
||
|
||
## 验收指标
|
||
|
||
1. 在任意步骤前插入不相关语句,公共锚点地址不漂移;旧内部编号可以变化。
|
||
2. 只修改锚点表达式,定义 digest 必须变化,锚点地址保持;同名重复拒绝公开。
|
||
3. `#@标签` 与完整 `mq://...` 必须精确解析;不存在锚点报告 unresolved,且不能变成 BoundCall。
|
||
4. `prove` 的函数证明只能关联函数知识,不能将所有带标记步骤标成 proved。
|
||
5. 更改源码、契约、传递依赖或证书后,知识索引拒绝使用过期证明。
|
||
6. 与 2.8.0 原有 CLI / SemanticProject / Lean 测试保持兼容。
|
||
|