diff --git a/go/internal/api/routes/core.go b/go/internal/api/routes/core.go index 8e665c2..02dc5ef 100644 --- a/go/internal/api/routes/core.go +++ b/go/internal/api/routes/core.go @@ -1090,6 +1090,14 @@ func (a *API) RecallDebug(w http.ResponseWriter, r *http.Request) { } // 2026-09-21 五修:与 Recall 完全一致(同一解析函数),保证 debug 端点如实反映 Recall 行为 req.Namespace = resolveRecallNamespace(req.Namespace, req.AgentID, req.Query) + // t_f1ee22e5:与 Recall (core.go:613) 完全同源的 diversity 默认值。 + // 修前 debug 直接用 req.Diversity(缺省 0)⇒ mmr 行报 diversity=0.0, + // 而生产 Recall 走 storage.DefaultMMRDiversity()(实测 tune-state 推送 0.1) + // ⇒ 诊断端点报的 MMR 与生产不同口径(撒的谎比没诊断更贵)。 + // 不硬编码 0.1 —— 读的是同一个 storage 推送原子值,调参器改了就跟着变。 + if req.Diversity <= 0 { + req.Diversity = storage.DefaultMMRDiversity() + } type stepInfo struct { Step string `json:"step"` diff --git a/go/internal/api/routes/recall_debug_diversity_test.go b/go/internal/api/routes/recall_debug_diversity_test.go new file mode 100644 index 0000000..b69516e --- /dev/null +++ b/go/internal/api/routes/recall_debug_diversity_test.go @@ -0,0 +1,99 @@ +package routes + +// t_f1ee22e5:/api/v1/recall/debug 的 diversity 默认值与生产 Recall 对齐。 +// +// 病根:RecallDebug 直接用 req.Diversity(缺省 0),而生产 Recall(core.go:613) +// 在 req.Diversity<=0 时回落到 storage.DefaultMMRDiversity()。tune-state 实测推送 0.1, +// ⇒ debug 报出的 mmr 行 diversity=0.0,与生产不同口径 —— 诊断撒的谎比没诊断更贵。 +// +// 判据:未显式传 diversity 时,mmr 行的 diversity 必须等于 storage.DefaultMMRDiversity() +// 的当前值(调参器推送的真实来源),而不是硬编码常量;显式传值时显式值优先。 + +import ( + "strings" + "testing" + + "github.com/xiaoxue/memoryweave/internal/models" + "github.com/xiaoxue/memoryweave/internal/storage" +) + +// debugMMRDetail 取出 debug 响应 steps 里 mmr 那行的 detail。 +func debugMMRDetail(m map[string]interface{}) string { + steps, _ := m["steps"].([]interface{}) + for _, x := range steps { + s, _ := x.(map[string]interface{}) + if s["step"] == "mmr" { + d, _ := s["detail"].(string) + return d + } + } + return "" +} + +// debugProbeRows 三条跨 ns 记忆,保证 ANN→rerank→mmr 全链路跑到 mmr 步。 +func debugProbeRows() []models.MemoryRecord { + return []models.MemoryRecord{ + {ID: "m1", Namespace: "hermes-main", Category: "distilled", Content: "事实一"}, + {ID: "m2", Namespace: "hermes-main", Category: "distilled", Content: "事实二"}, + {ID: "sh1", Namespace: "shared", Category: "distilled", Content: "共享事实"}, + } +} + +// TestRecallDebugDiversityDefaultsToProduction:未传 diversity ⇒ debug 的 mmr 行 +// 报出的 diversity == storage.DefaultMMRDiversity()(与生产 Recall 同源),非硬编码 0。 +func TestRecallDebugDiversityDefaultsToProduction(t *testing.T) { + saved := storage.DefaultMMRDiversity() + t.Cleanup(func() { storage.SetDefaultMMRDiversity(saved) }) + // 用 0.1 复刻现网 tune-state(/var/lib/memoryweave/tuning-state.json diversity=0.1), + // 同时证明修后读的是「推送值」而非写死的常量:换一个值它就跟着变。 + storage.SetDefaultMMRDiversity(0.1) + + db := &nsAwareRecallLance{rows: debugProbeRows()} + // 请求体不含 diversity 字段 ⇒ 走「未显式指定」分支 + code, m := runRecallDebugHTTP(t, db, `{"query":"生产默认 diversity 口径回归","limit":5,"namespace":"hermes-main"}`) + if code != 200 { + t.Fatalf("HTTP=%d body=%v", code, m) + } + det := debugMMRDetail(m) + want := "diversity=0.1, final=" + if !strings.Contains(det, want) { + t.Fatalf("✗ 未传 diversity 时 mmr 行应报生产默认值(0.1),实际 %q(应含 %q)", det, want) + } + t.Logf("未传 diversity:mmr=%q ✓(与生产 DefaultMMRDiversity 同源)", det) +} + +// TestRecallDebugDiversityFollowsTunerPush:换一个推送值,debug 跟着变 ⇒ 证明非硬编码。 +func TestRecallDebugDiversityFollowsTunerPush(t *testing.T) { + saved := storage.DefaultMMRDiversity() + t.Cleanup(func() { storage.SetDefaultMMRDiversity(saved) }) + storage.SetDefaultMMRDiversity(0.42) // 非 0.1 的哨兵值:修后若仍报 0.1 即为硬编码 + + db := &nsAwareRecallLance{rows: debugProbeRows()} + code, m := runRecallDebugHTTP(t, db, `{"query":"调参推送值跟随回归","limit":5,"namespace":"hermes-main"}`) + if code != 200 { + t.Fatalf("HTTP=%d body=%v", code, m) + } + det := debugMMRDetail(m) + if !strings.Contains(det, "diversity=0.4,") && !strings.Contains(det, "diversity=0.42") { + t.Fatalf("✗ mmr 行应跟随 tuner 推送值(0.42),实际 %q(硬编码或未对齐)", det) + } + t.Logf("tuner 推 0.42:mmr=%q ✓(非硬编码)", det) +} + +// TestRecallDebugDiversityExplicitOverridesDefault:显式传 diversity 时显式值优先,不被默认覆盖。 +func TestRecallDebugDiversityExplicitOverridesDefault(t *testing.T) { + saved := storage.DefaultMMRDiversity() + t.Cleanup(func() { storage.SetDefaultMMRDiversity(saved) }) + storage.SetDefaultMMRDiversity(0.1) + + db := &nsAwareRecallLance{rows: debugProbeRows()} + code, m := runRecallDebugHTTP(t, db, `{"query":"显式 diversity 优先回归","limit":5,"namespace":"hermes-main","diversity":0.7}`) + if code != 200 { + t.Fatalf("HTTP=%d body=%v", code, m) + } + det := debugMMRDetail(m) + if !strings.Contains(det, "diversity=0.7,") { + t.Fatalf("✗ 显式传 0.7 时 mmr 行应报 0.7(显式值优先),实际 %q", det) + } + t.Logf("显式传 0.7:mmr=%q ✓(显式值优先)", det) +}