Files
HomeAgent/internal/memory/static_embedder_test.go
JianFeeeee 6d38a164eb chore(module): Go module 路径随托管地迁移 gitcode → github
## 背景

仓库早已迁移到 GitHub(`github.com/JianFeeeee/HomeAgent`,CI/CD 都在那边跑),
gitcode 保留为**国内只读镜像**(`ci.yml` 的 sync-gitcode-main 快进推送)。
但 go.mod 的 module 路径一直是 `gitcode.com/JianFeeeee/...` —— 既与权威源
不符,`meta.SourceURL`(AGPL §13 的源码提供入口)也指向镜像而非实际运行的代码。

## 关键区分(这是本次改动安全的前提)

两个 module 是**不同**的,影响面差一个数量级:

| module | 谁依赖 | 改它的后果 |
|---|---|---|
| `.../HomeAgent`(主仓) | **只有主仓自己** | 内部重构,零外部影响 |
| `.../homeagent-sdk`(SDK 仓) | 主仓 49 文件 + 所有外部插件 | 需重编插件 |

★ 实测确认:**插件不 import 主仓 module**(`strings qq/plugin.bin | grep HomeAgent` = 0),
只依赖 SDK 仓。而插件与内核的边界是 **RPC 方法名字符串**
(`plugin.init` / `tool.invoke`…,见 proc/protocol.go),**与 Go module 名无关**。
⇒ module 改名**不改变任何 wire 协议**,现网已装的插件照常运行。

SDK 的 GitHub 仓名是 `homeagentsdk`(无连字符),module 路径必须与之精确匹配,
否则 `go get` 会因路径不符失败,故取 `github.com/JianFeeeee/homeagentsdk`。

## 改动

- `go.mod` / `go.sum`:两个 module 路径 + require/replace
- 277 个 Go 文件 + Makefile + 打包脚本的 import 与 ldflags 路径
- SDK 仓 `meta.CoreModule`、`tools/hmapdev` 的 module 声明与工程模板
- 对外文档/链接的仓库地址(README、PLUGIN_DEV、OVERVIEW 等)

## 明确**保留** gitcode 的地方(镜像机制,不能动)

- `GITCODE_TOKEN`、`GC_URL="…@gitcode.com"`(CI 同步 job)
- `gitcode.com/api/v5/...`(release 附件上传)
- git remote `gitcode`(镜像拉取/推送)
- `docs/zh/ci-cd-runbook.md`(整篇讲镜像运维)

## 验证

- `go build ./...` / `go vet ./...` 绿
- `go test ./... -count=1` → 48 包 ok / 0 FAIL
- hmapdev 工具链编译通过(`third_party/homeagent-sdk/tools/hmapdev`)
- 全仓残留检查:module 形态的 `gitcode.com/JianFeeeee` = 0
- 镜像机制抽验:GC_URL / @gitcode / api/v5 / remote 均完好

## 顺带修正

`hmapdev/templates.go` 的注释此前写「gitcode 的模块不在 proxy.golang.org 上」——
module 已迁 GitHub,该论断不再成立。改为如实说明**为何仍默认 replace 到本机 SDK**:
离线可构建、避免版本漂移、内网可用。理由与托管地无关,故 replace 保留。
2026-10-08 10:40:17 +08:00

237 lines
5.7 KiB
Go

package memory
import (
"math"
"sort"
"testing"
"time"
"github.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)
}