mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-10-15 12:15:16 +00:00
## 背景 仓库早已迁移到 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 保留。
125 lines
4.0 KiB
Go
125 lines
4.0 KiB
Go
package core
|
||
|
||
import (
|
||
"strings"
|
||
"testing"
|
||
|
||
agentIO "github.com/JianFeeeee/HomeAgent/internal/agent/io"
|
||
"github.com/JianFeeeee/HomeAgent/internal/memory"
|
||
)
|
||
|
||
// TestSceneKeysFor 钉住当前场景的推导优先级:
|
||
// 注入点显式声明 > 通道 > 工具;并列命中且去重。
|
||
func TestSceneKeysFor(t *testing.T) {
|
||
a := &Agent{io: agentIO.NewIOManager()}
|
||
// 通道 + 工具:两个都能独立成立的触发条件,都要带上
|
||
got := a.sceneKeysFor(&agentIO.InputEvent{Source: "qq"}, "qq_get_message")
|
||
want := []string{"chan:qq", "tool:qq_get_message"}
|
||
if len(got) != len(want) {
|
||
t.Fatalf("sceneKeysFor = %v, want %v", got, want)
|
||
}
|
||
for i := range want {
|
||
if got[i] != want[i] {
|
||
t.Errorf("sceneKeysFor[%d] = %q, want %q", i, got[i], want[i])
|
||
}
|
||
}
|
||
|
||
// 注入点显式声明排最前;归一化生效;重复声明去重
|
||
evt := &agentIO.InputEvent{
|
||
Source: "QQ",
|
||
Payload: map[string]interface{}{"scene": " chan:qq/peer:group_1 "},
|
||
}
|
||
got = a.sceneKeysFor(evt, "")
|
||
if len(got) != 2 || got[0] != "chan:qq/peer:group_1" || got[1] != "chan:qq" {
|
||
t.Errorf("显式声明应排最前且通道场景归一: %v", got)
|
||
}
|
||
|
||
// 数组形式声明
|
||
evt = &agentIO.InputEvent{
|
||
Source: "webui",
|
||
Payload: map[string]interface{}{"scene": []interface{}{"chan:qq", "task:reminder"}},
|
||
}
|
||
got = a.sceneKeysFor(evt, "")
|
||
if len(got) != 3 || got[0] != "chan:qq" || got[1] != "task:reminder" || got[2] != "chan:webui" {
|
||
t.Errorf("数组声明未生效: %v", got)
|
||
}
|
||
|
||
// nil 事件不 panic
|
||
if got := a.sceneKeysFor(nil, ""); len(got) != 0 {
|
||
t.Errorf("nil 事件应无场景: %v", got)
|
||
}
|
||
// 未声明的 payload 键不影响
|
||
evt = &agentIO.InputEvent{Source: "cli", Payload: map[string]interface{}{"recall_policy": "none"}}
|
||
if got := a.sceneKeysFor(evt, ""); len(got) != 1 || got[0] != "chan:cli" {
|
||
t.Errorf("无 scene 声明时应只有通道场景: %v", got)
|
||
}
|
||
}
|
||
|
||
// TestSituationFeaturesFor 钉住指纹来源:全部是运行时可观察量,
|
||
// 不需要模型配合也不需要人工标注。
|
||
func TestSituationFeaturesFor(t *testing.T) {
|
||
a := &Agent{io: agentIO.NewIOManager()}
|
||
evt := &agentIO.InputEvent{
|
||
Source: "QQ",
|
||
Payload: map[string]interface{}{"group_id": float64(1027993713)},
|
||
}
|
||
feats := a.situationFeaturesFor(evt, "帮我看看排班表", "qq_get_message")
|
||
kinds := map[string]int{}
|
||
for _, f := range feats {
|
||
kinds[f.Kind]++
|
||
}
|
||
if kinds["chan"] != 1 || kinds["peer_group"] != 1 || kinds["tool"] != 1 || kinds["part"] != 1 {
|
||
t.Fatalf("必备维度缺失: %+v", feats)
|
||
}
|
||
if kinds["topic"] == 0 {
|
||
t.Errorf("话题软特征缺失: %+v", feats)
|
||
}
|
||
if kinds["topic"] > 3 {
|
||
t.Errorf("话题最多 3 个,得到 %d", kinds["topic"])
|
||
}
|
||
|
||
sig := memory.NewSituation(feats...)
|
||
keys := sig.Keys()
|
||
// 归一化 + 数值 id 的转换
|
||
found := false
|
||
for _, k := range keys {
|
||
if k == "chan:qq" {
|
||
found = true
|
||
}
|
||
}
|
||
if !found {
|
||
t.Errorf("通道特征未归一化: %v", keys)
|
||
}
|
||
for _, k := range keys {
|
||
if strings.Contains(k, "peer_group:1027993713") {
|
||
found = true
|
||
}
|
||
}
|
||
if !found {
|
||
t.Errorf("数值型 group_id 未转成特征: %v", keys)
|
||
}
|
||
|
||
// 无事件时不 panic,且只有工具特征时也成立
|
||
if feats := a.situationFeaturesFor(nil, "", "memory_recall"); len(feats) != 1 {
|
||
t.Errorf("仅工具场景应有 1 个特征: %+v", feats)
|
||
}
|
||
}
|
||
|
||
// TestWritePathAttachesBothPaths 钉住写侧的「两条路都挂」:
|
||
// 显式声明优先;否则挂本轮声明的 + 涌现的场景集合。
|
||
func TestTurnSceneKeysBothPaths(t *testing.T) {
|
||
a := &Agent{io: agentIO.NewIOManager()}
|
||
// 声明的通道场景与工具场景都在,涌现键(若有)追加在后
|
||
evt := &agentIO.InputEvent{Source: "qq", Payload: map[string]interface{}{"scene": "chan:qq/peer:group_1"}}
|
||
got := a.sceneKeysFor(evt, "qq_get_message")
|
||
want := []string{"chan:qq/peer:group_1", "chan:qq", "tool:qq_get_message"}
|
||
if len(got) != len(want) {
|
||
t.Fatalf("声明侧场景数不对: %v want %v", got, want)
|
||
}
|
||
for i := range want {
|
||
if got[i] != want[i] {
|
||
t.Errorf("声明侧[%d] = %q want %q", i, got[i], want[i])
|
||
}
|
||
}
|
||
}
|