mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-21 09:28:14 +00:00
healthcheck_kernel 此前没有任何「ONNX 模型是否在用」的信息,只报「向量可用/不可用」, 分不清「统一多模态空间已加载」与「退回到词嵌入/TF-IDF 路径」;人格卡要求 「版本以运行时快照为准」,也缺一个可查字段(build.version 早就在,但没人知道)。 - KernelStatus 新增 onnx 段:enabled / provider / dim / fingerprint / modalities / reason。 判据取 Loaded()(provider 真正打开且元数据合法),**不是**「配置里写了 provider」 —— 后者在模型缺失 / 运行时缺失时也为真,报出去就是假绿。 - 未启用时 reason 给**具体原因**:未配置(说明会走回退路径)/ 打开失败的具体错误。 homed 把「配置的 provider 名」与「打开失败原因」透传给 Agent,仅供状态报告。 - ProviderAdapter 新增 Modalities()(可选能力,按接口断言取用,不改公开契约)。 - healthcheck_kernel 的工具描述同步说明它回答这两件事。 **顺带修一个真实 panic**:collectKernelStatus 的 knowledge 是**接口**参数, (*knowledge.Store)(nil) 塞进接口后 `ks != nil` 仍为真 → 调 List() 直接 panic, 而 healthcheck_kernel 正是走这条路径(panic 发生在工具 goroutine 里)。 GetKernelStatus 改为先按具体指针判空、再赋给接口;并加刻画测试钉住这个成因 (一旦不再 panic 说明参数形状已变,守卫与该测试应同步删除)。 验证:单测 4 例(已启用 / 打开失败 / 未配置 / 未加载)+ 刻画测试; 隔离实例 E2E 7/7:正例 provider=chineseclip → enabled=true、dim=512、模态 2; 反例 provider=nonexistent → enabled=false 且 reason 含具体错误与 provider 名, 真实对话仍通。
104 lines
3.7 KiB
Go
104 lines
3.7 KiB
Go
package core
|
||
|
||
import (
|
||
"strings"
|
||
"testing"
|
||
"time"
|
||
|
||
agentIO "gitcode.com/JianFeeeee/HomeAgent/internal/agent/io"
|
||
"gitcode.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)
|
||
}
|