Files
marqdo/doc/design/change-m6-t1-session.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

3.7 KiB
Executable File
Raw Blame History

变更记录:M6 T1 会话内陈旧检测 + 会话末汇总

状态 Implemented
日期 2026-10-22
里程碑 M6(t1-session-staleness.md · staleness-providers.md T1)
改动文件 src/label.rs · src/mlsp.rs · src/view/mod.rs · tests/occlusion.rs
影响面 MLSP repair_apply 新增可选字段;新增 session.summary 方法

1. 机制

repair_apply 内部同一作用域里同时有 source(改前)与 new_source(改后), 所以「描述是否还成立」可以纯内存判定:

stale ⟺ 标签文本未变 ∧ payload 指纹变了

配对按 (标签文本, 出现序号),因此移动代码不会误报。

请求:

{"method":"repair_apply","params":{
  "source":"…","ranges":[[3,3]],
  "edits":[{"op":"replace","line":3,"text":"**a = [按税率算总价](100 * 0.2)**"}],
  "check_labels":true}}

响应:

{"id":1,"ok":true,"result":{
  "source":"…","edits_applied":1,
  "labels":{"newly_seen":1,"stale":[
    {"label":"按税率算总价","line":3,
     "code_past":"100 * 0.1","code_now":"100 * 0.2"}]}}}

同一份 source / new_source 就是"前一状态"——不需要 git、不需要台账、 不需要沙箱里的 exec 权限。这是"agent 回路不需要 VCS"的落地。


2. 会话末汇总(你要求做)

session.summary 返回并重置计数:

{"ok":true,"labels_stale_seen":1,"labels_fixed":0,
 "labels_outstanding":1,"items":["按税率算总价"]}
字段 含义
labels_stale_seen 本次会话累计发现过多少条(去重按标签)
labels_fixed 曾经 outstanding、现在不再 stale 的条数
labels_outstanding 仍未处理
items 未处理的标签文本(只给文本,不重复诊断细节)

设计:客户端在收尾时调用一次即可闭合;不主动打屏,不污染协议。


3. 关键取舍

取舍 理由
check_labels 默认 false 零开销、零噪音;agent 框架在修复回路里显式打开
标签变了 → 不报 作者改描述本身就是"已复核"的信号
新标签 → 不报 无历史可比
指纹用 Debug 只需进程内一致;跨版本稳定指纹是 T2/T3 的事
payload 渲染用 view::expr_display 让 code_past/code_now 是人能读的表面语法,而非 AST 调试串

4. 测试

层 内容 结果
集成(3) 只改 payload → stale 含 code_past/code_now;同时改标签 → stale: [];session.summary 计数正确 ✅
全量 cargo test --release 590 passed / 0 failed(M10 后 587 + 3)

反向验证:t1_silent_when_label_also_changes 证明"改描述即复核"不会误报。


5. 边界

项 说明
只看本次编辑 跨会话漂移是 T2/T3 的职责(可选 provider)
解析失败则跳过 修复后的源码可能语法错误,此时不评测标签,交给 validate
会话状态是进程级 一条 MLSP 连接(一个进程)即一个会话;session.summary 后清零

6. 变更清单

文件 变更
src/label.rs StaleItem · payload_fingerprint · compare · SessionSummary(含 record)· OcclusionSite.payload_fp/payload_src
src/mlsp.rs repair_apply 的 check_labels;session.summary;进程级 SESSION
src/view/mod.rs pub use render::expr_display(供诊断渲染 payload)
tests/occlusion.rs 3 个 T1 集成测试
doc/design/change-m6-t1-session.md 本文件