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:
@@ -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)
|
||||
}
|
||||
Reference in New Issue
Block a user