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 保留。
160 lines
4.6 KiB
Go
160 lines
4.6 KiB
Go
package core
|
|
|
|
import (
|
|
"strings"
|
|
"testing"
|
|
|
|
agentAPI "github.com/JianFeeeee/HomeAgent/internal/agent/api"
|
|
agentIO "github.com/JianFeeeee/HomeAgent/internal/agent/io"
|
|
)
|
|
|
|
type mockOutputDevice struct {
|
|
name string
|
|
caps agentIO.OutputCapability
|
|
tools []agentIO.ToolDef
|
|
toolFn func(string, map[string]interface{}) (interface{}, error)
|
|
}
|
|
|
|
func (d *mockOutputDevice) Name() string { return d.name }
|
|
func (d *mockOutputDevice) Type() agentIO.DeviceType { return agentIO.DeviceOutput }
|
|
func (d *mockOutputDevice) Description() string { return "mock " + d.name }
|
|
func (d *mockOutputDevice) Tools() []agentIO.ToolDef { return d.tools }
|
|
func (d *mockOutputDevice) Start() error { return nil }
|
|
func (d *mockOutputDevice) Stop() error { return nil }
|
|
func (d *mockOutputDevice) OutputCapabilities() agentIO.OutputCapability { return d.caps }
|
|
func (d *mockOutputDevice) ChannelDef() agentIO.ChannelDef { return agentIO.ChannelDef{} }
|
|
func (d *mockOutputDevice) Execute(tool string, args map[string]interface{}) (interface{}, error) {
|
|
if d.toolFn != nil {
|
|
return d.toolFn(tool, args)
|
|
}
|
|
return nil, nil
|
|
}
|
|
|
|
func TestExecuteOutputListChannels(t *testing.T) {
|
|
io := agentIO.NewIOManager()
|
|
dev := &mockOutputDevice{
|
|
name: "speaker",
|
|
caps: agentIO.CapText | agentIO.CapAudio,
|
|
}
|
|
io.RegisterDevice(dev)
|
|
|
|
a := &Agent{io: io}
|
|
result := a.executeOutputListChannels()
|
|
if result == "" || result == "没有可用通道" {
|
|
t.Errorf("expected channel list, got: %s", result)
|
|
}
|
|
}
|
|
|
|
func TestExecuteOutputListChannelsEmpty(t *testing.T) {
|
|
io := agentIO.NewIOManager()
|
|
a := &Agent{io: io}
|
|
result := a.executeOutputListChannels()
|
|
if result != "没有可用通道" {
|
|
t.Errorf("expected '没有可用通道', got: %s", result)
|
|
}
|
|
}
|
|
|
|
func TestExecuteOutputSendTool(t *testing.T) {
|
|
io := agentIO.NewIOManager()
|
|
io.RegisterDevice(&mockOutputDevice{
|
|
name: "screen",
|
|
caps: agentIO.CapText,
|
|
})
|
|
|
|
a := &Agent{io: io}
|
|
tc := agentAPI.ToolCall{Name: "output_send__screen", Arguments: map[string]interface{}{
|
|
"payload": "hello world",
|
|
"type": "text",
|
|
}}
|
|
result := a.executeOutputSendTool(tc)
|
|
if result != "ok" {
|
|
t.Errorf("expected ok, got: %s", result)
|
|
}
|
|
}
|
|
|
|
func TestExecuteOutputSendToolEmptyContent(t *testing.T) {
|
|
io := agentIO.NewIOManager()
|
|
a := &Agent{io: io}
|
|
tc := agentAPI.ToolCall{Name: "output_send__screen", Arguments: map[string]interface{}{}}
|
|
result := a.executeOutputSendTool(tc)
|
|
if result == "" || strings.Contains(result, "已通过") {
|
|
t.Errorf("expected error for empty content, got: %s", result)
|
|
}
|
|
}
|
|
|
|
func TestExecuteOutputSendToolChannelNotExist(t *testing.T) {
|
|
io := agentIO.NewIOManager()
|
|
a := &Agent{io: io}
|
|
tc := agentAPI.ToolCall{Name: "output_send__nonexistent", Arguments: map[string]interface{}{
|
|
"payload": "hello",
|
|
"type": "text",
|
|
}}
|
|
result := a.executeOutputSendTool(tc)
|
|
if !strings.Contains(result, "不存在") && !strings.Contains(result, "不可用") {
|
|
t.Errorf("expected error for nonexistent channel, got: %s", result)
|
|
}
|
|
}
|
|
|
|
func TestExecuteOutputSendToolNoTextCap(t *testing.T) {
|
|
io := agentIO.NewIOManager()
|
|
io.RegisterDevice(&mockOutputDevice{
|
|
name: "camera",
|
|
caps: agentIO.CapImage,
|
|
})
|
|
|
|
a := &Agent{io: io}
|
|
tc := agentAPI.ToolCall{Name: "output_send__camera", Arguments: map[string]interface{}{
|
|
"payload": "hello",
|
|
"type": "text",
|
|
}}
|
|
result := a.executeOutputSendTool(tc)
|
|
if strings.Contains(result, "已通过") {
|
|
t.Errorf("should reject channel without text capability")
|
|
}
|
|
}
|
|
|
|
func TestBuildToolDefsOutputToolsWithDevice(t *testing.T) {
|
|
io := agentIO.NewIOManager()
|
|
io.RegisterDevice(&mockOutputDevice{
|
|
name: "screen",
|
|
caps: agentIO.CapText,
|
|
})
|
|
a := &Agent{io: io, knowledge: nil, docStore: nil, pluginReg: nil}
|
|
tools := a.buildToolDefs()
|
|
|
|
foundSend := false
|
|
foundHelp := false
|
|
for _, td := range tools {
|
|
m, ok := td.(map[string]interface{})
|
|
if !ok {
|
|
continue
|
|
}
|
|
fn, ok := m["function"].(map[string]interface{})
|
|
if !ok {
|
|
continue
|
|
}
|
|
name, _ := fn["name"].(string)
|
|
switch name {
|
|
case "output_send__screen":
|
|
foundSend = true
|
|
case "output_send__screen_help":
|
|
foundHelp = true
|
|
}
|
|
}
|
|
if !foundSend {
|
|
t.Error("output_send__screen should be in tools when device registered")
|
|
}
|
|
if !foundHelp {
|
|
t.Error("output_send__screen_help should be in tools when device registered")
|
|
}
|
|
}
|
|
|
|
func TestGetAllToolsEmpty(t *testing.T) {
|
|
io := agentIO.NewIOManager()
|
|
a := &Agent{io: io}
|
|
tools := a.buildToolDefs()
|
|
if len(tools) < 1 {
|
|
t.Errorf("expected at least 1 tool, got %d", len(tools))
|
|
}
|
|
}
|