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 保留。
104 lines
3.7 KiB
Go
104 lines
3.7 KiB
Go
package core
|
||
|
||
import (
|
||
"strings"
|
||
"testing"
|
||
"time"
|
||
|
||
agentIO "github.com/JianFeeeee/HomeAgent/internal/agent/io"
|
||
"github.com/JianFeeeee/HomeAgent/internal/knowledge"
|
||
)
|
||
|
||
// statusSpace 是带模态元数据的假统一空间(ProviderAdapter 的 Modalities() 形状)。
|
||
type statusSpace struct{ fakeSpace }
|
||
|
||
func (statusSpace) Modalities() []string { return []string{"text", "image"} }
|
||
|
||
// statusSpaceUnloaded 模拟「provider 建了但没加载成功」。
|
||
type statusSpaceUnloaded struct{ fakeSpace }
|
||
|
||
func (statusSpaceUnloaded) Loaded() bool { return false }
|
||
|
||
// healthcheck_kernel 必须能回答两件事:内核版本号、以及**是否真的启用了 ONNX 模型**。
|
||
//
|
||
// 判据要点:只有 provider 真正 Loaded() 才算启用 ——「配置里写了 provider」不算,
|
||
// 否则模型缺失/运行时缺失时会报成已启用(假绿)。
|
||
func TestKernelStatusReportsVersionAndONNX(t *testing.T) {
|
||
t.Run("已启用:带出 provider/维度/指纹/模态", func(t *testing.T) {
|
||
a := &Agent{
|
||
io: agentIO.NewIOManager(),
|
||
multimodalSpace: statusSpace{},
|
||
embeddingProvider: "chineseclip",
|
||
}
|
||
st := a.GetKernelStatus()
|
||
if !st.ONNX.Enabled {
|
||
t.Fatal("Loaded() 为真时 onnx.enabled 必须为真")
|
||
}
|
||
if st.ONNX.Provider != "chineseclip" || st.ONNX.Dim != 2 || st.ONNX.Fingerprint != "fake-space" {
|
||
t.Fatalf("onnx 身份字段不对: %+v", st.ONNX)
|
||
}
|
||
if len(st.ONNX.Modalities) != 2 || st.ONNX.Reason != "" {
|
||
t.Fatalf("模态/原因不对: %+v", st.ONNX)
|
||
}
|
||
// 内核版本号必须随状态一起报:人格卡要求「版本以运行时快照为准」靠的就是这一项
|
||
if st.Build.Version == "" || st.Build.KernelName == "" {
|
||
t.Fatalf("build 段缺少版本/内核名: %+v", st.Build)
|
||
}
|
||
})
|
||
|
||
t.Run("打开失败:enabled=false 且给出具体原因", func(t *testing.T) {
|
||
a := &Agent{
|
||
io: agentIO.NewIOManager(),
|
||
embeddingProvider: "chineseclip",
|
||
embeddingError: `embedding: open provider "chineseclip": model dir missing`,
|
||
}
|
||
st := a.GetKernelStatus()
|
||
if st.ONNX.Enabled {
|
||
t.Fatal("打开失败时不能报 enabled")
|
||
}
|
||
if st.ONNX.Provider != "chineseclip" {
|
||
t.Fatalf("未启用时仍应带出配置的 provider: %+v", st.ONNX)
|
||
}
|
||
if !strings.Contains(st.ONNX.Reason, "model dir missing") {
|
||
t.Fatalf("原因应包含具体错误: %q", st.ONNX.Reason)
|
||
}
|
||
})
|
||
|
||
t.Run("未配置:说明会走回退路径", func(t *testing.T) {
|
||
a := &Agent{io: agentIO.NewIOManager()}
|
||
st := a.GetKernelStatus()
|
||
if st.ONNX.Enabled || st.ONNX.Reason == "" {
|
||
t.Fatalf("未配置时应 enabled=false 且有原因: %+v", st.ONNX)
|
||
}
|
||
})
|
||
|
||
t.Run("provider 存在但未加载", func(t *testing.T) {
|
||
a := &Agent{
|
||
io: agentIO.NewIOManager(),
|
||
multimodalSpace: statusSpaceUnloaded{},
|
||
embeddingProvider: "qwen3vl",
|
||
}
|
||
st := a.GetKernelStatus()
|
||
if st.ONNX.Enabled {
|
||
t.Fatal("Loaded() 为假时不能报 enabled")
|
||
}
|
||
if st.ONNX.Reason == "" {
|
||
t.Fatalf("应给出未加载的原因: %+v", st.ONNX)
|
||
}
|
||
})
|
||
}
|
||
|
||
// collectKernelStatus 的 knowledge 参数是**接口**类型,而 (*knowledge.Store)(nil)
|
||
// 塞进接口后 `ks != nil` 仍为真 → 调 List() 直接 panic。
|
||
// 这条测试钉住这个成因:一旦不再 panic,说明参数形状变了,
|
||
// GetKernelStatus 里的 typed-nil 守卫就该同步删掉(否则它变成无意义代码)。
|
||
func TestCollectKernelStatusTypedNilKnowledgePanics(t *testing.T) {
|
||
defer func() {
|
||
if r := recover(); r == nil {
|
||
t.Fatal("typed-nil 交给接口参数却未 panic:成因已变,请更新守卫与本测试")
|
||
}
|
||
}()
|
||
var nilStore *knowledge.Store
|
||
_ = collectKernelStatus(time.Now(), "a", "", 0, nil, nil, nil, nil, nilStore, nil, nil, nil, nil)
|
||
}
|