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 保留。
105 lines
4.3 KiB
Go
105 lines
4.3 KiB
Go
package core
|
||
|
||
// inputch 总览工具(单工具多视图)的验收。
|
||
//
|
||
// 需求:父 agent 能看到**所有已注册的 inputch**以及**它们的划分情况**。
|
||
// 构筑方式:单工具(input_channels)+ 多视图(view=all|mine|unassigned|by_agent|detail)。
|
||
|
||
import (
|
||
"strings"
|
||
"testing"
|
||
|
||
agentAPI "github.com/JianFeeeee/HomeAgent/internal/agent/api"
|
||
agentIO "github.com/JianFeeeee/HomeAgent/internal/agent/io"
|
||
)
|
||
|
||
func inputChToolCall(args map[string]interface{}) agentAPI.ToolCall {
|
||
return agentAPI.ToolCall{ID: "ic1", Name: "input_channels", Arguments: args}
|
||
}
|
||
|
||
func TestInputChannelsTool_SingleToolMultipleViews(t *testing.T) {
|
||
a := newPreemptAgent(t, newPreemptProvider())
|
||
me := string(a.id)
|
||
|
||
// 同一个插件注册多个 inputch(最基本的输入路由单位);另一个插件再注册一个。
|
||
if err := a.io.RegisterInputChannelFrom("qq", "qq", agentIO.ChannelDef{NoMemory: true}); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if err := a.io.RegisterInputChannelFrom("qq", "qq/device-2", agentIO.ChannelDef{}); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if err := a.io.RegisterInputChannelFrom("sub", "sub/in", agentIO.ChannelDef{}); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
// 划分:qq 与 sub/in 归本 agent,qq/device-2 留未分配。
|
||
if err := a.io.AssignInputChannel("qq", me, 64); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if err := a.io.AssignInputChannel("sub/in", me, 0); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
|
||
// view=all(默认):全部已注册,且带归属插件。
|
||
all := a.executeInputChannels(inputChToolCall(nil))
|
||
for _, want := range []string{"qq", "qq/device-2", "sub/in", "插件 qq", "插件 sub", "无记忆"} {
|
||
if !strings.Contains(all, want) {
|
||
t.Fatalf("view=all 缺少 %q:\n%s", want, all)
|
||
}
|
||
}
|
||
|
||
// view=mine:只有划给本 agent 的。
|
||
mine := a.executeInputChannels(inputChToolCall(map[string]interface{}{"view": "mine"}))
|
||
if !strings.Contains(mine, "qq") || !strings.Contains(mine, "sub/in") {
|
||
t.Fatalf("view=mine 应含 qq 与 sub/in:\n%s", mine)
|
||
}
|
||
if strings.Contains(mine, "qq/device-2") {
|
||
t.Fatalf("view=mine 不应含未分配的 qq/device-2:\n%s", mine)
|
||
}
|
||
|
||
// view=unassigned:只有尚未划出的。
|
||
un := a.executeInputChannels(inputChToolCall(map[string]interface{}{"view": "unassigned"}))
|
||
if !strings.Contains(un, "qq/device-2") {
|
||
t.Fatalf("view=unassigned 应含 qq/device-2:\n%s", un)
|
||
}
|
||
if strings.Contains(un, "sub/in") {
|
||
t.Fatalf("view=unassigned 不应含已划分的 sub/in:\n%s", un)
|
||
}
|
||
|
||
// view=by_agent:划分情况总览(按归属分组)。
|
||
byAgent := a.executeInputChannels(inputChToolCall(map[string]interface{}{"view": "by_agent"}))
|
||
if !strings.Contains(byAgent, me+":") {
|
||
t.Fatalf("view=by_agent 应列出归属 %q:\n%s", me, byAgent)
|
||
}
|
||
if !strings.Contains(byAgent, "未分配") {
|
||
t.Fatalf("view=by_agent 应列出未分配一组:\n%s", byAgent)
|
||
}
|
||
|
||
// view=detail:单个 inputch 的全字段(容量 / 策略 / 回程 / 归属)。
|
||
detail := a.executeInputChannels(inputChToolCall(map[string]interface{}{"view": "detail", "name": "qq"}))
|
||
for _, want := range []string{"inputch: qq", "注册插件: qq", "容量: 64", "无记忆", me} {
|
||
if !strings.Contains(detail, want) {
|
||
t.Fatalf("view=detail 缺少 %q:\n%s", want, detail)
|
||
}
|
||
}
|
||
if miss := a.executeInputChannels(inputChToolCall(map[string]interface{}{"view": "detail", "name": "nope"})); !strings.Contains(miss, "未注册") {
|
||
t.Fatalf("detail 查未注册的 inputch 应明确报错:%s", miss)
|
||
}
|
||
if noName := a.executeInputChannels(inputChToolCall(map[string]interface{}{"view": "detail"})); !strings.Contains(noName, "需要 name") {
|
||
t.Fatalf("detail 缺 name 应提示:%s", noName)
|
||
}
|
||
|
||
// 未知视图必须报错并列出可用值(不要把拼错静默当成默认视图)。
|
||
bad := a.executeInputChannels(inputChToolCall(map[string]interface{}{"view": "whatever"}))
|
||
if !strings.Contains(bad, "未知 view") || !strings.Contains(bad, "by_agent") {
|
||
t.Fatalf("未知 view 应报错并列出可用值:%s", bad)
|
||
}
|
||
}
|
||
|
||
// 一个 inputch 都没有时应给出明确说明,而不是空串。
|
||
func TestInputChannelsTool_NoChannels(t *testing.T) {
|
||
a := newPreemptAgent(t, newPreemptProvider())
|
||
if out := a.executeInputChannels(inputChToolCall(nil)); !strings.Contains(out, "没有任何已注册") {
|
||
t.Fatalf("空登记表应明确说明:%q", out)
|
||
}
|
||
}
|