Files
HologramAgent-DSH-Memory-Port/docs
jianf 0dfa6dcb27 docs: phase B 判据与变异规则草案(待批,不含实现)
decision 1(http 转发、不背 ONNX)与 decision 3(跳过不报错但失配计数
必须暴露到工具面)已落实到判据;decision 2 未回,全文按草案状态。

开工前必须先定的 4 件事(各附我的建议与代价):

§0.1 ★ HA 的 http 指纹派生式漏了 endpoint
     http_embedder.go:99 只取 "http:"+model+":"+dim。
     换 endpoint(换机器/A-B 服务/换 region)而 model 同名同维时,
     指纹相同 ⇒ 静默混用两个向量空间。
     建议扩展为含 endpoint hash;代价是换 endpoint 触发一次全量重嵌。

§0.2 ★ 空 fingerprint 的带向量块会被静默放行
     block_recall.go:140 的跳过条件是三个 && ⇒ fp 为空时不跳过。
     phase A 的块全都无向量,phase B 回填后「无向量」与
     「有向量但指纹空」是两种不同状态,混在一起用户无法知道怎么修。
     建议三态归类 + fail-closed(no_vector / no_fingerprint / stale / active)。

§0.3 graph_centroid DDL 与 HA 不一致(我的疏忽)
     少了 stats 列,而 HA 靠 meta.Anomalous 决定要不要启用中心化
     (centroid_store.go:205-209)。现在表是空的,改列名零成本。

§0.4 embedding 调用失败是否一并进计数器(与 decision 3 同构,建议纳入)

判据 6 组共 34 条(A 前置重构 / F 指纹空间 / V 融合 / C 中心化 /
D 降级可见性 / H http provider / G 守卫),每条带变异。
变异规则汇总出 12 条必须能红的,其中 M-V1(精确串从布尔降成权重)
是 HA 真实踩过的 bug(0.300 输给 0.534)。

另外三项判断:
- 增加 golden fixture 固化 phase A 召回结果,作为「加向量没顺手改符号路」的守卫
- memory_blocks 要加 vector/fingerprint 两列,phase A 的 DDL 已发布 ⇒
  建议 phase B 第一件事补 PRAGMA user_version 迁移框架(现在 0→1 一步,
  一天成本;等 L2 落地再补就贵了)
- 工作量从原估 3-4 人天上修到 6-7 人天(原估漏了 schema 迁移、
  stablemem_stats 工具、异步化带来的全量测试改动)

不含任何实现。参考仓未改动。
2026-10-30 09:49:07 +08:00
..