认知结算 CognitiveSettlement
Run 终态四类认知产物:SessionState、Memory、Reflections、Learnings。
定位
CognitiveSettlement 是 Run 生命周期的强制终态阶段(INV-CTX-40),不可跳过。
唯一例外:panic_stop(进程级崩溃)。
产出
Run 结束
↓ CognitiveSettlement
↓
├── SessionState(会话状态压缩)
├── Memory(记忆条目)
├── Reflections(反思)
└── Learnings(学习)
八条补充公理(AX-C1~C8)
定义 Run 终态认知结算的架构约束。
核心不变量
INV-CTX-40:不可跳过
所有终止路径(end_turn / interrupt / cycle / budget)均执行 Settlement。
INV-CTX-41:主对话模型产出
不使用辅助模型,不使用规则引擎。压缩质量 = 对话质量。
INV-CTX-42:对用户不可见
不通过 SSE 推送到前端,不产生 assistant 气泡。
INV-CTX-43:唯一历史来源
System Prompt 的历史信息仅从 SessionState 注入。
SessionState
INV-CTX-45
MidRunCompression 与 EndOfRunSettlement 使用相同 schema。
INV-CTX-46
Plan 是 SessionState 的子字段,随 Settlement 一同持久化。
信息保全(INV-CTX-44)
首选:认知交班(MidRunHandoff / CognitiveSettlement)
↓ 不可用 / 失败
fallback:机械压缩(丢弃前 ExtractToolEvidence 注入 Pinned system message)
不是"纯容量"——那样会让交班失败时证据蒸发。
降级
3 次重试 → mechanicalFallback + degraded=true + degraded_reason 分类常量。
无事件面(SettlementDegraded 已删除)。
Memory 写入
Settlement 的 memory_entries 走 Memory.Save() 全路径:
- ContentDedupKey
- INV-MEM-24(威胁扫描)
- INV-MEM-31(质量门控)
- INV-MEM-27(写入审批)
强制携带 actor(INV-MEM-08)。
与 Context 压缩的关系
| 机制 | 时机 | 产出 |
|---|---|---|
| MidRunCompression | Run 中途 | SessionState |
| CognitiveSettlement | Run 结束 | SessionState + Memory + ... |
两者使用相同 SessionState schema(INV-CTX-45)。
相关文档
- Run 生命周期 →
run-lifecycle.md - Memory 层模型 →
memory-layer-model.md - Session 管理 →
session-management.md