0007. Jev 关系分类受控范围接管 (Scoped Jev Relation Classification Takeover)
状态: accepted, 已实现落地 (#65) 日期: 2026-10-03
背景与上下文 (Context)
在 ADR-0003 (离线记忆归约与冲突消解) 中,Hippo 确立了 Cold Path 的四层治理管道:候选发现 (Discovery) -> 关系分类 (Classification) -> 胜者仲裁 (Arbitration) -> 幂等执行 (Apply)。在既有实现中,关系分类默认使用独立的隔离 LLM 实例(temperature=0)。
针对结构化关系分类的轻量化演进,Hippo 先后推进了系列技术铺垫:
- #61 Jev 适配器:建立了极简、强校验、脱敏失败码的
JevClient; - #62 成对关系离线评测:建立了成对数据集、物理隔离事实簇与无网络回放流水线;
- #63 Jev 旁路影子观察:在不干扰主决策的前提下,引入了项目白名单、调用预算与匿名差异审计;
- #64 分类基准与校准门禁:通过 Calibration Split 搜索独立的概率/Margin 阈值,并在 Test Split 上执行零误治理、语言切片独立达标与真实测量约束的 RFC Go/No-Go 门禁。
本 ADR 解决 Issue #65 提出的核心架构决策:在允许的项目、匹配的合格校准产物以及可审计的运行预算同时具备时,如何安全受控地让 Jev 关系分类接管既有流程,同时确保任何异常均保留原记忆,绝不破坏既有数据。
决策 (Decision)
我们决定为 Cold Path 引入受控的 Jev 关系分类接管机制(JevTakeoverClassifier 与 JevTakeoverPolicy),并贯彻以下架构原则:
1. 默认行为零侵入,按项目白名单显式准入
- 默认保持既有分类器:未显式配置接管参数时,
MemoryConsolidator继续运行既有独立 LLM 分类器; - 全要素强校验准入:接管模式必须同时提供
takeover_backend(JevClient)与takeover_policy(JevTakeoverPolicy)。在策略初始化时,严格校验:- 白名单项目集
allowed_projects非空; - 模型必须固定为
jev-1.13.0; - Rubric 必须固定为
memory-relation-v1,且 Rubric 内容哈希与当前规范严格一致; - 校准产物必须状态为
status == "GO"且is_qualified_for_takeover == True;
- 白名单项目集
- 非白名单范围安全隔离:若运行范围为
scope != "project"(如全局范围)或project_id不在allowed_projects中,分类器直接判定为not_allowed并弃权为DISTINCT,绝不调用 Jev,保留全部原始记忆。
2. 独立双阈值约束与 Fail-Closed 弃权机制
- 独立概率与 Margin 门槛:分类器从合格校准产物中加载针对
EQUIVALENT与CONFLICT的独立min_probability与min_margin; - 严格 Fail-Closed:
- 若所选关系的概率低于阈值,或第一与第二名概率差小于 Margin,或 Top-1 发生概率并列(Tie):一律判定为
DISTINCT并记录显式弃权证据; - 若 Jev 发生网络异常、超时、5xx 服务故障或协议解析错误:一律判定为
DISTINCT并记录脱敏的失败代码; - 若达到单次运行的调用预算(
max_calls)或时间预算(max_elapsed_seconds):后续候选对一律判定为DISTINCT并标记运行状态为degraded; - 绝不静默回退:在接管模式下,任何未达标或异常情况均不得隐式回退调用其他远程 LLM 分类器。
- 若所选关系的概率低于阈值,或第一与第二名概率差小于 Margin,或 Top-1 发生概率并列(Tie):一律判定为
3. 单 Seam 职责边界划分:Jev 仅负责关系判定
- Jev 的职能被严格限定在纯语义关系分类(
EQUIVALENT/CONFLICT/DISTINCT); - 胜者必须且只能由 Hippo 既有的
WinnerArbiter依据确认计数、确认时间与全序稳定性矩阵确定; - 胜者事实文本绝不改写,败者软删除标记为
status="superseded"; - 行版本号防并发覆写(Version Revalidation)与共享文件锁机制(Per-identity flock + RLock)保持完全一致。
4. 证据链前置冻结与崩溃恢复幂等性
- 完整的分类证据(模型、Rubric 版本与哈希、校准产物 ID、类别概率分布、Margin、选定概率与应用阈值)在构建计划阶段即冻结写入
OperationPlan.evidence; - Apply 前持久化至磁盘日志
~/.hippo/consolidation/operations/<operation_id>.json; - 崩溃恢复(
_recover_unfinished)直接重放日志中冻结的OperationPlan,严禁在恢复阶段重新调用 Jev,确保重放行为具有确定性,免受重放时外部服务可用性波动的干扰。
5. 定向误合并回滚与平滑停用演练
- 在
ConsolidationApplier中提供版本保护、可断点续跑的定向回滚 Seamrevert(operation_id):- Apply 首次写入前冻结 winner/loser 的完整原始 metadata,并在写入后记录两侧 post-version;
- 回滚在同一 Per-identity 互斥锁下先校验 post-version;若任一侧已被后续 Hot/Warm Path 或其他治理写入修改,则 Fail-Closed 拒绝覆盖;
- EQUIVALENT 回滚直接恢复冻结快照,因此嵌套 lineage、确认计数、来源集合与 freshness 都精确回到操作前状态,不依赖不可逆的反向计票;
- winner/loser 恢复步骤通过
reverting -> revertedjournal 状态分别持久化,中途崩溃后重复调用可继续未完成步骤; - CONFLICT 回滚同样恢复 loser 的操作前 metadata,使误替代事实重新具备召回可见性;
- 随时可通过移除接管参数安全停用 Jev;停用 Jev 不会影响或回退已成功落地的历史治理结果。
收益与影响 (Consequences)
긍 收益
- 低成本高质量离线治理:在受控的垂直项目上利用 Jev 极低的推理成本与微秒级响应完成记忆整理,且不损失治理安全性;
- 全链路防泄漏与可审计性:证据全量固化上链,检索层严格保持
Forbidden Leakage = 0; - 运营高弹性与灾备完备:具备一键停用、未完成幂等恢复以及单操作定向撤销的工程闭环。
⚠️ 权衡与约束
- 不支持跨项目或全局记忆的 Jev 接管(严格限制在项目级白名单内);
- 依赖前序 #64 产生的符合决策级真实测量的 Go 产物,未通过门禁前无法强行开启。