Files
HomeAgent/internal/memory/static_embedder_test.go
JianFeeeee 5836c2ce5c refactor(memory): 拆除描述式媒体索引,媒体成为一等块并按原生向量融合
背景:此前媒体是靠「生成的描述文本」将就进记忆的——写 marker 进正文、
再由正则反解成 media_refs 与图库里的 type=Media 实体。这条链路有三个
致命缺陷:描述由异步模型生成(未生成前媒体等于不存在)、语义检索实质上
只搜描述文字、图库里的「媒体节点」是描述文本的投影而不是媒体本身。

本提交把这条链路整体拆除,媒体改为按自己的原生向量参与记忆:

一、描述链彻底删除(无残留、无兼容分支)
- media.Item 去掉 Description/DescribedBy 与对应列;
- 删除 Store.Describe / Store.Search / Store.Pending;
- 删除 Agent.mediaDescribeLoop / describePendingMedia 与配置项
  core.memory.media.describe_on_ingest;
- SDK 侧 MediaAttachment 去掉 Description(见 SDK 仓独立提交)。

二、marker 机制删除,媒体归属改为结构化块边
- 删除 mediaMarkerLine/parseMediaMarkers/mediaEntityName/mediaTriplesFromText/
  extractMediaDigests/sentenceWithMediaMarkers/docMediaContext;
- memory.Triple 新增 MediaDigests 结构化字段;句子文本保持原样,
  不再被 marker 污染;
- 块以 sentence --contains--> block / document --contains--> block 结构边
  挂到承载节点(新增 documents 表与 document 节点种类);
- 模型未给原句时用「主谓宾。」拼一句自然语言作落点,不造 marker 文本。

三、旧数据迁移(幂等)
- 新增 GraphDB.MigrateLegacyMediaEntities:把 type=Media 的旧实体按短 digest
  还原成原生块、挂回原句子、删除旧实体与描述关系;Agent 启动时执行;
- CleanupOrphanedSentences 同时看关系引用与块边,避免把只靠块存活的句子
  连同块边一起删掉。

四、向量融合:媒体按图本身被召回
- 新增 vector.FuseVectors(逐维求和 + L2 归一化);
- Doc.DenseVec = 文本向量 ⊕ 文档块的媒体向量(同 fingerprint 才融合),
  新增 Doc.DenseFP,指纹变化触发重算;
- ContextEvent.DenseVec 同理融合事件块;事件新增 DenseFP,Prune 只在
  同一统一空间内比稠密余弦;
- 跨模态视觉路只召回「仍被某层记忆块持有」的媒体,CAS 全库字节不再
  直接充当记忆检索结果。

五、同时纳入本分支既有的嵌入基础改造(此前工作区未提交,缺它 HEAD 不可构建)
- internal/tfidf 懒回退包、千问三段式多模态 ONNX 空间的 Go 侧
  (qwen/embedder.go、image.go、model_input.go)、CLIP 移除、
  sdk.NewStore 分词器签名与调用点、embed 侧车 systemd 单元。

验证:go build ./... 、go vet ./...(含 -tags medialive)均通过;
在 HEAD 的独立 worktree 上重放本次暂存集后 go test -short ./internal/...
全部通过(端口冲突类用例在隔离环境中亦通过)。未提交工作区中与本改造
无关的改动(HarmonyOS、waiter、devicebridge、plan.md 等)。
2026-09-11 11:45:24 +08:00

237 lines
5.7 KiB
Go

package memory
import (
"math"
"sort"
"testing"
"time"
"gitcode.com/JianFeeeee/HomeAgent/internal/memory/vector"
)
type testContextEvent struct {
Timestamp time.Time
Input string
Response string
Vector vector.Vector
}
func cosineSim(a, b vector.Vector) float64 {
var dot, normA, normB float64
for f, va := range a {
dot += va * b[f]
normA += va * va
}
for _, vb := range b {
normB += vb * vb
}
if normA == 0 || normB == 0 {
return 0
}
return dot / (math.Sqrt(normA) * math.Sqrt(normB))
}
func TestStaticEmbedderLoad(t *testing.T) {
e := newSynthEmbedder(t, 300)
if !e.Loaded() {
t.Fatal("embedder should be loaded")
}
if e.Dim() != 300 {
t.Errorf("expected dim=300, got %d", e.Dim())
}
}
func TestStaticEmbedderConsistency(t *testing.T) {
e := newSynthEmbedder(t, 300)
v1 := e.Vectorize("今天天气怎么样")
v2 := e.Vectorize("今天天气怎么样")
if len(v1) != len(v2) {
t.Errorf("same input should produce same dimension count, got %d vs %d", len(v1), len(v2))
}
sim := cosineSim(v1, v2)
if math.Abs(sim-1.0) > 0.0001 {
t.Errorf("same input should have cosine similarity ~1.0, got %.6f", sim)
}
}
func isNumericKey(s string) bool {
if s == "" {
return false
}
for _, c := range s {
if c < '0' || c > '9' {
return false
}
}
return true
}
func TestStaticEmbedderFallback(t *testing.T) {
e := NewStaticEmbedder("")
if e.Loaded() {
t.Fatal("empty path embedder should not be loaded")
}
v := e.Vectorize("测试文本")
if len(v) == 0 {
t.Fatal("fallback vector should not be empty")
}
}
func TestStaticEmbedderAllInDenseSpace(t *testing.T) {
e := newSynthEmbedder(t, 300)
texts := []string{
"今天天气怎么样",
"股票基金投资",
"微积分导数数学题",
"台风天注意安全",
"基金定投",
"数学作业",
"明天会不会下雨",
}
for _, text := range texts {
v := e.Vectorize(text)
for k := range v {
if !isNumericKey(k) {
t.Errorf("%q produced non-numeric key %q — should be in dense space", text, k)
}
}
}
t.Log("all texts produce numeric keys — same dense space")
}
func TestStaticEmbedderSemanticSimilarity(t *testing.T) {
e := newSynthEmbedder(t, 300)
pairs := []struct {
a, b string
related bool
}{
{"今天天气怎么样", "明天会不会下雨", true},
{"今天天气怎么样", "股票基金投资", false},
{"股票基金投资", "基金定投", true},
{"股票基金投资", "微积分导数数学题", false},
{"微积分导数数学题", "数学作业", true},
}
for _, p := range pairs {
va := e.Vectorize(p.a)
vb := e.Vectorize(p.b)
sim := cosineSim(va, vb)
t.Logf("sim(%q, %q) = %.4f (related=%v)", p.a, p.b, sim, p.related)
}
weatherSim := cosineSim(e.Vectorize("今天天气怎么样"), e.Vectorize("明天会不会下雨"))
stockSim := cosineSim(e.Vectorize("今天天气怎么样"), e.Vectorize("股票基金投资"))
t.Logf("[verify] weather-weather=%.4f, weather-stock=%.4f", weatherSim, stockSim)
if weatherSim <= stockSim {
t.Errorf("weather-weather(%.4f) should be > weather-stock(%.4f)", weatherSim, stockSim)
}
}
func TestContextPruneWithRealEmbedding(t *testing.T) {
e := newSynthEmbedder(t, 300)
type event struct {
input string
response string
}
allEvents := []event{
{"今天天气怎么样", "挺好的"},
{"明天会不会下雨", "可能不会"},
{"台风来了", "注意安全"},
{"帮我算微积分", "好的"},
{"导数怎么求", "公式如下"},
{"数学作业", "解答"},
{"股票涨了", "恭喜"},
{"基金收益怎么样", "不错"},
{"最近有什么电影", "推荐"},
{"晚上吃什么", "随便"},
{"帮我定个闹钟", "好的"},
{"查询快递", "已送达"},
}
events := make([]testContextEvent, len(allEvents))
for i, ev := range allEvents {
events[i] = testContextEvent{
Timestamp: time.Now().Add(time.Duration(i) * time.Second),
Input: ev.input,
Response: ev.response,
Vector: e.Vectorize(ev.input + " " + ev.response),
}
}
topK := 4
protectN := 3
query := "基金股票投资"
queryVec := e.Vectorize(query)
if len(events) <= topK+protectN {
t.Fatalf("need more events for pruning test")
}
protectStart := len(events) - protectN
protected := events[protectStart:]
candidates := events[:protectStart]
type scored struct {
evt testContextEvent
score float64
}
scoredEvents := make([]scored, len(candidates))
for i, evt := range candidates {
scoredEvents[i] = scored{evt, cosineSim(queryVec, evt.Vector)}
}
sort.Slice(scoredEvents, func(i, j int) bool {
return scoredEvents[i].score > scoredEvents[j].score
})
keepCount := topK
if keepCount > len(scoredEvents) {
keepCount = len(scoredEvents)
}
keep := scoredEvents[:keepCount]
archived := scoredEvents[keepCount:]
t.Logf("query: %s", query)
t.Logf("=== retained (topK=%d) ===", topK)
for _, s := range keep {
t.Logf(" [%.4f] %s", s.score, s.evt.Input)
}
t.Logf("=== protected (recent %d) ===", protectN)
for _, e := range protected {
t.Logf(" %s", e.Input)
}
t.Logf("=== archived (%d items) ===", len(archived))
for _, s := range archived {
t.Logf(" [%.4f] %s", s.score, s.evt.Input)
}
hasFinance := false
for _, s := range keep {
if s.evt.Input == "股票涨了" || s.evt.Input == "基金收益怎么样" {
hasFinance = true
}
}
if !hasFinance {
t.Error("expected financial events to be retained, but none found")
}
hasWeather := false
for _, s := range keep {
if s.evt.Input == "今天天气怎么样" || s.evt.Input == "明天会不会下雨" || s.evt.Input == "台风来了" {
hasWeather = true
}
}
if hasWeather {
t.Log("NOTE: weather events are still in retained set — may have overlapping vocabulary")
}
t.Logf("remaining: %d = topK(%d) + protectN(%d)", topK+protectN, topK, protectN)
}