fix(api): recall/debug 的 diversity 默认值与生产 Recall 对齐

病根:RecallDebug 直接用 req.Diversity(缺省 0),而生产 Recall(core.go:613)
在 req.Diversity<=0 时回落 storage.DefaultMMRDiversity()(tune-state 实测推送 0.1)。
⇒ /recall/debug 报出的 mmr 行 diversity=0.0,与生产不同口径,诊断撒谎比没诊断更贵。

修法:与 Recall 完全同源的回落 —— 未显式传 diversity 时读同一个 storage 推送原子值,
不硬编码 0.1,调参器改了 debug 跟着变。

回归测试 recall_debug_diversity_test.go:未传→跟随推送值(0.1/0.42 各测,证非硬编码);
显式传→显式值优先(0.7)。复用同包 nsAwareRecallLance/fakeEmbedServer/ runRecallDebugHTTP。

验证:go test ./internal/api/routes/ -count=1 整包绿(修前修后 0 failed,失败数未增)。

回滚:git revert 本 commit(删 core.go 内 4 行回落 + 删 recall_debug_diversity_test.go)。
本 commit 只提交源码,未打二进制、未改 drop-in、未重启 zhiyid。

[task: t_f1ee22e5]
This commit is contained in:
小唯
2026-11-10 04:01:28 +08:00
parent fba425af80
commit 88bdb010cf
2 changed files with 107 additions and 0 deletions
+8
View File
@@ -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"`
@@ -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)
}