mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-01 23:07:30 +00:00
* feat(kernel): 模块化内核 + 编译期依赖图定序
把单体 init 序列拆成「模块自声明依赖 + 编译期生成依赖图 + 运行期只读图」。
## 为什么
原 cmd/homed/main.go 里 17 步 init 是**手写顺序**,依赖关系只存在于
注释和人脑里。实测踩到的坑(见 docs/zh/kernel-modularization-design.md):
· nlp.defaultParser 被 initONNXParser 写、被 distiller 读,两者相距 60 行,
只靠 ticker 10min 才没炸(隐式依赖,无声明)
· 加一个模块要人肉找"该插在哪",插错的表现是运行期 nil 解引用
· 关停是 defer ks.CloseAll(),而热更新路径 os.Exit(42) **跳过 defer**
⇒ docStore/distiller/textMem 的 flush 全部丢失(每次热更新都发生)
## 怎么改
- internal/kernelboot/:KernelState(一个结构体收全部包级共享变量,字段
nil 安全)、Module 接口、graphfile(依赖图编解码 + 与二进制 hash 对账)、
scheduler(按 BFS 层并行 Init)、syncbus(层边界写通知)、
lifecycle(Quiesce/Resume 可逆伪关机,区别于一次性 CloseAll)
- internal/kernelmod/<name>/:每个模块一个文件夹,Requires/Provides 自声明;
all/all.go 是唯一的 import 清单(Go 循环导入约束)
- cmd/homed-depgraph:编译期生成依赖图,Makefile 注入 digest
- 运行期只**读**图,不计算顺序(顺序是编译期决定的,源码里没有中央清单)
## 判据
kernelboot 8 条 + 图失败模式 7 条(全部拒绝并给准确错误)+ 模块目录数
与注册表一致性。变异测试 15/15 咬住,含:
· 删掉 AddCloser 的锁 → -race 报数据竞争
· Scheduler 同批跑去重 → 203 vs 200
· 图 hash 不匹配 → 拒绝启动
## 顺带修的缺陷
热更新路径漏调模块关闭 ⇒ 显式 stopKernelModules(),并用 AST 判据钉住
"必须在 os.Exit 之前"(字符串检查在本仓已骗过我三次)。
实测:冷启动 1630ms(5 层/17 模块,原 17 步串行);生产 22 插件全部建链。
* feat(security): 密钥防火墙 + 配置加密 + close 纪律
## 密钥防火墙
模型只见别名、不见明文;插件工具调用入口(StageHost.ExecuteTool)做入向
回填。三维能力:
· 出向:工具输出里的密钥被替换成 [[secret:name]] 别名后才进上下文
· 入向:模型传别名,入口处填回真值(插件完全无感知)
· 存储:config.db 里不存明文(0644 的库可读),敏感值独立 0600 文件
模式库「宁漏勿误伤」:宁可漏掉一次替换,也不把正常文本误当密钥。
## 配置加密
- internal/security/{codec,key,keyring,store,global}.go:AES-256-GCM,
enc:v1: 前缀,密钥轮换(OldKeys 解码 + 新钥加密)
- harden.go:数据目录权限收紧
- embedded.go:支持内嵌主密钥(可选,仍保留外部 key 文件路径)
- EncryptExistingSecrets / AuditSecrets:启动时幂等迁移 + 审计
## close 纪律(用户明确要求:只要调 close 就要有前置检查)
internal/safeclose:Safe / SafeFunc。全仓 37 处裸 close(chan) → 0。
关键教训(都写进注释和判据):
· `select { case <-ch: default: close(ch) }` **不是**并发安全的
(两个 goroutine 可同时命中 default)—— healthcheck 原先是这种写法
· `sync.Once` **不可重入**:X.Do(func(){ Safe(&X, ...) }) 会自锁,
症状是 go test 直接挂住(3 个包 600s 超时),栈里只有嵌套的 Once.Do
· map 里按请求持有的 channel(mcp/stdio.go、clawhubadapter/sidecar.go)
改成 *pendingRPC 包装,每通道一个 once
## 判据
security 全量 + TestNoBareCloseOutsideSafeclose(AST 级扫描,含注释剥离)
+ TestNoNestedSelfOnceDeadlock(正则修正:\w+ 不匹配点号,捕获组要含 '.')。
变异 2/2 咬住。全量 52 包 ok。
* feat(plugin+deploy): 插件三态生命周期、数据目录迁移、发行包修复
## 插件三态生命周期(用户要求:自动启动 / 启用但不自动启动 / 禁用)
- Manifest 新增 requires_facilities / auto_start(*bool,用于区分
"未声明"与"显式 false")
- plugin-host 模块(internal/kernelmod/pluginhost):用 kernelboot.Scheduler
按依赖时机拉起,**不再手写两阶段**
- 运行态停启 StopPlugin/StartPlugin **可逆**:不写 disabled_plugins
(不改用户决定)、不置 shuttingDown(之后还能加载)、会摘掉注册面
- 与 StopAll 的区别写进注释 —— StopAll 置 shuttingDown 后**永久无法加载**,
那是进程退出用的,误用于"暂停"就是关了就死
## 数据目录迁移(伪关机 → 迁移 → 唤醒)
- kernelboot/lifecycle.go:Quiesce/Resume(可逆,区别于一次性 CloseAll),
逆序暂停、逆序恢复、Pause 失败回滚
- kernelboot/migrate.go:BeginMigration/End 编排(先停插件 → 再停内核写者
→ 等在途归零)
- distiller/textmem 增 Pause/Resume 门(不是 cancel —— cancel 不可逆,
恢复要重建整个对象)
- 模块 migration:体检 + 生成可执行迁移脚本
★ 迁移脚本的三个实测教训(都写成了判据):
1. 无条件改 /etc/systemd/system ⇒ 演练把**生产** -data 改成了演练目录。
加 --dry-run(零改动)+ 强制校验 systemd 当前 -data == OLD
2. 本机没装 rsync,脚本在"服务已停、数据未搬"处硬失败 ⇒ cp -a 回退,
并明确警告不保硬链接/ACL(生产 plugindev 有大量 git 硬链接)
## 发行包修复(全部经实测确认)
1. package-linux.sh **完全漏打 depgraph.bin** ⇒ 内核 exit 1
("生产构建(内嵌 hash 非空)但读不到依赖图")
2. build_homed 不走 Makefile ⇒ 单独修 Makefile 无效,必须同时生成图+注入
3. build.sh 的 LDFLAGS 用**历史模块路径 gitcode.com** ⇒ -X 静默 no-op
⇒ --version 显示 unknown
4. Makefile -ldflags 用**单引号** ⇒ 注入了字面 $GRAPH_HASH
## ★ build.sh 的版本号必须校验(真实事故)
原 `VERSION="$(git describe --tags --dirty)"`。无 tag 分支上它返回**分支名**
`backup/pre-identity-rewrite-20261005-51-g03d87a4e-dirty`,被注入 meta.Version
⇒ 插件握手判据 MajorVersion() 把整串当主版本 ⇒ **22 个子进程插件全部
握手失败**("主版本不匹配")。内核活着、systemd active、日志每条都像
插件的问题 —— 实际是发行包带着非法版本号。
修法:git describe 只在形如 vX.Y.Z 时采用,否则回退 meta.Version(权威源),
并对最终值做形态守卫。deploy/packaging/version_guard_test.go 3 条判据,
变异 2/2 咬住。
## deb 的 systemd unit 改为 guard 模式
ExecStart=/usr/bin/homed --role=guard --data /var/lib/homeagent
(worker exit 42 → guard 重拉,不经过 systemd、不计失败)
含 RestartSteps/RestartMaxDelaySec/TimeoutStopSec + 硬化
(NoNewPrivileges/ProtectSystem/ProtectHome/DevicePolicy/ReadWritePaths)。
## 其他
- internal/plugin/proc:非法 JSON 帧的报错**可定位**(内容摘要 + 可能原因 +
修法)。生产实测 1038 条非法帧(插件往 stdout 打日志 = 污染协议通道)
- 示例插件 4 个 14 处 fmt.Printf → log.Printf
- hmapdev 模板同步修复;scaffold 判据剥离注释(模板注释里就含 fmt.Printf)
* chore: 收尾(主密钥轮换命令、IPC/知识库加固、SDK 对齐)
- cmd/homed-key-rotate:把 security 里的 RotateKey/RotateKeyFile/RekeySecrets
串成一条**可执行**的运维路径。没有它,E-1 就只是库里的能力而不是
"出事时能做的事",而轮换的价值恰恰在于能执行。
- cmd/homed:kmod_runtime(模块装配入口)、plugins_scheduled(failback
白名单)、memcandidate、bootstrap_order_test / shutdown_flush_test
- internal/ipc、internal/devicebridge、internal/knowledge:配套加固
- third_party/homeagent-sdk/sdk:PluginMgrAPI 增三态能力(mgrStop/mgrStart/
mgrIsRuntimeStopped)+ settings 对齐
判据:bootstrap_order_test(启动顺序不依赖手写序列)、
shutdown_flush_test(停机的两条路径必须对称 —— exit 42 会跳过 defer,
热更新路径下模块关闭/flush 曾全部丢失)。
* test(security): 测试夹具改用不可误认的占位值(修 push protection 拦截)
GitHub secret scanning 拦住了推送:三处测试夹具用了"看起来像真密钥"的
字面量:
internal/security/prefilter_test.go:39
internal/security/store_test.go:177
internal/security/survey_test.go:20
它们全是**假密钥**(`AKIAIOSFODNN7EXAMPLE` 是 AWS 官方文档的标准示例,
其余是 `abcdefghij...` 这类可读占位符),但扫描器无法区分 —— 它只看形态。
★ 不绕过(不用 unblock URL、不加 allowlist):直接改夹具。
原因:一旦允许"假密钥可以通过",真密钥混进来时就没有最后一道门了。
改法:保留**模式库匹配所需的结构**,把可识别内容换成 FAKE:
glpat-abcdefghijklmnopqrst → glpat-FAKE-TEST-TOKEN-NOT-REAL
sk-abcdefghij...012345 → sk-FAKE-TEST-KEY-NOT-REAL-0000000
AKIAIOSFODNN7EXAMPLE → AKIA0000FAKE0000TEST (保持 20 字符)
ASIAIOSFODNN7EXAMPLE → ASIA0000FAKE0000TEST
xoxb-123456789012-abcdefghijklmnop → xoxb-FAKE-TEST-TOKEN-NOT-REAL
★ 中途踩到一次:AWS 键的模式是 `\b(AKIA|ASIA)[0-9A-Z]{16}\b`(共 20 字符),
我第一次替换成 19 字符的 `AKIAFAKETESTKEY0000` ⇒ 模式匹配不上 ⇒
TestSurvey_WhatIsCaught / TestRecognizesCommonShapes /
TestPrefilterNeverBlocksRealMatches 三条当场变红。
判据正确地拒绝了"为了过扫描器而削弱覆盖"。
顺带核实:全仓 grep 无任何真实密钥泄漏。
* fix(packaging): package-linux.sh 的版本解析与 build.sh 统一
上一版只修了 build.sh,漏了 package-linux.sh —— 它仍只看 git describe:
VERSION="${VERSION:-$(git describe --tags --dirty)}"
无 tag 分支上 git describe 返回**分支名**
(backup/pre-identity-rewrite-20261005-56-g98850e1),守卫会正确拒绝,
但要求人**手动传 VERSION** 才能打包。而 build.sh 早已能自动回退 meta.Version
⇒ 同一个版本,走 build.sh 打得出来、走 package-linux.sh 打不出来。
危害不只是"要手动传参":运维为了跑通会去掉守卫,而分支名一旦进
meta.Version 就是**插件协议主版本**的来源 ⇒ 22 个子进程插件全部握手失败
(这是真实发生过的事故,见 3efa4e5)。
修法:两个脚本用同一套规则(git describe 仅在 vX.Y.Z 形态时采用,
否则回退 meta.Version),并对最终值做形态守卫。
判据:TestBothPackagingScriptsShareVersionRules —— 逐个读两个脚本,
要求都能从 meta/meta.go 取权威版本、都校验 git describe 形态。
变异(把 package-linux.sh 改回旧规则)咬住并准确指出是哪个脚本。
实测:不传 VERSION 跑 package-linux.sh,输出
[PKG] warn: git describe 给出非版本串(...),改用 meta.Version=1.4.0
Version: 1.4.0
* fix(test): 跨仓判据在 CI 上应 skip 而非 fail(修 PR 双红)
CI 上 "Go build / vet / test" 与 "Build linux/amd64" 双红:
--- FAIL: TestHmapdevTemplateImplementsAllPluginMgrMethods
bridge_sync_test.go:170: 读模板: open
../../../third_party/homeagent-sdk/tools/hmapdev/templates/proc_main.go.tmpl:
no such file or directory
## 根因:判据依赖了一个**被 gitignore 的路径**
`.gitignore:33` 有 `third_party/homeagent-sdk/tools/`(SDK 仓自治,本仓不跟踪)。
于是:
· 本机(完整 SDK 检出)有该文件 ⇒ 判据通过
· CI(只 checkout 本仓)没有该文件 ⇒ Fatalf ⇒ **必红**
我提交时只在本机跑测试、没看 CI,所以这个问题拖到 PR 才暴露。
## 修法
文件缺失时 `t.Skipf` 而不是 `t.Fatalf`。
★ 这不是"放弃检查":
· 跨仓一致性由 **SDK 仓自己的判据**守着
(tools/hmapdev/scaffold_stdout_test.go 等),那里才是模板的真实归属地
· 本判据在本机开发时**仍然生效**(已验证:有文件时 PASS,缺文件时 SKIP)
## 验证
· 本机(有文件) → PASS(判据真跑)
· 模拟 CI(移走 tools/)→ SKIP(不再 fail)
· 全量 53 包 ok / 0 fail
## 顺带
同目录还有 e2e_template_test.go 也读 tools/,但它是 `//go:build` 门控的
e2e 判据,CI 默认不跑,无需处理。
---------
Co-authored-by: JianFeeeee <JianFeeeee@users.noreply.gitcode.com>
522 lines
15 KiB
Go
522 lines
15 KiB
Go
package main
|
||
|
||
import (
|
||
"encoding/json"
|
||
"fmt"
|
||
"log"
|
||
"net/http"
|
||
"strings"
|
||
"sync"
|
||
"time"
|
||
)
|
||
|
||
// ===== 模拟数据 =====
|
||
|
||
type Status struct {
|
||
Status string `json:"status"`
|
||
Version string `json:"version"`
|
||
StartedAt string `json:"startedAt"`
|
||
Uptime int64 `json:"uptime"`
|
||
}
|
||
|
||
type Kernel struct {
|
||
Model string `json:"model"`
|
||
Provider string `json:"provider"`
|
||
Status string `json:"status"`
|
||
}
|
||
|
||
type Setting struct {
|
||
Settings map[string]interface{} `json:"settings"`
|
||
Meta map[string]interface{} `json:"meta"`
|
||
Plugins []string `json:"plugins"`
|
||
PluginMeta map[string]interface{} `json:"plugin_meta"`
|
||
DisabledPlugins []string `json:"disabled_plugins"`
|
||
}
|
||
|
||
type Plugin struct {
|
||
Name string `json:"name"`
|
||
Description string `json:"description"`
|
||
Version string `json:"version"`
|
||
Enabled bool `json:"enabled"`
|
||
Builtin bool `json:"builtin"`
|
||
}
|
||
|
||
type PluginInfo struct {
|
||
Name string `json:"name"`
|
||
Description string `json:"description"`
|
||
Version string `json:"version"`
|
||
Enabled bool `json:"enabled"`
|
||
Builtin bool `json:"builtin"`
|
||
Tools []PluginTool `json:"tools"`
|
||
}
|
||
|
||
type PluginTool struct {
|
||
Name string `json:"name"`
|
||
Description string `json:"description"`
|
||
}
|
||
|
||
type Adapter struct {
|
||
Name string `json:"name"`
|
||
Type string `json:"type"`
|
||
Enabled bool `json:"enabled"`
|
||
}
|
||
|
||
type ChatMessage struct {
|
||
Role string `json:"role"`
|
||
Content string `json:"content"`
|
||
}
|
||
|
||
type MemoryItem struct {
|
||
ID string `json:"id"`
|
||
Content string `json:"content"`
|
||
Time string `json:"time"`
|
||
}
|
||
|
||
type Device struct {
|
||
DeviceID string `json:"device_id"`
|
||
Name string `json:"name"`
|
||
Authorized bool `json:"authorized"`
|
||
Online bool `json:"online"`
|
||
Caps []string `json:"caps"`
|
||
}
|
||
|
||
// ===== SSE 管理器 =====
|
||
|
||
type SSEManager struct {
|
||
mu sync.RWMutex
|
||
clients map[chan string]bool
|
||
}
|
||
|
||
func NewSSEManager() *SSEManager {
|
||
return &SSEManager{clients: make(map[chan string]bool)}
|
||
}
|
||
|
||
func (m *SSEManager) Add(ch chan string) {
|
||
m.mu.Lock()
|
||
m.clients[ch] = true
|
||
m.mu.Unlock()
|
||
}
|
||
|
||
func (m *SSEManager) Remove(ch chan string) {
|
||
m.mu.Lock()
|
||
delete(m.clients, ch)
|
||
m.mu.Unlock()
|
||
}
|
||
|
||
func (m *SSEManager) Broadcast(eventType, data string) {
|
||
msg := fmt.Sprintf("event: %s\ndata: %s\n\n", eventType, data)
|
||
m.mu.RLock()
|
||
defer m.mu.RUnlock()
|
||
for ch := range m.clients {
|
||
select {
|
||
case ch <- msg:
|
||
default:
|
||
}
|
||
}
|
||
}
|
||
|
||
// ===== HTTP 处理器 =====
|
||
|
||
type MockServer struct {
|
||
startedAt time.Time
|
||
sse *SSEManager
|
||
mu sync.Mutex
|
||
plugins []Plugin
|
||
adapters []Adapter
|
||
devices []Device
|
||
settings map[string]interface{}
|
||
}
|
||
|
||
func NewMockServer() *MockServer {
|
||
now := time.Now()
|
||
return &MockServer{
|
||
startedAt: now,
|
||
sse: NewSSEManager(),
|
||
plugins: []Plugin{
|
||
{Name: "core", Description: "核心插件", Version: "1.0.0", Enabled: true, Builtin: true},
|
||
{Name: "remotedevice", Description: "远程设备管理", Version: "0.9.0", Enabled: true, Builtin: true},
|
||
{Name: "webui", Description: "Web 用户界面", Version: "0.9.0", Enabled: true, Builtin: true},
|
||
{Name: "knowledge", Description: "知识库管理", Version: "0.5.0", Enabled: true, Builtin: false},
|
||
},
|
||
adapters: []Adapter{
|
||
{Name: "openai", Type: "llm", Enabled: true},
|
||
{Name: "siliconflow", Type: "llm", Enabled: true},
|
||
},
|
||
devices: []Device{
|
||
{DeviceID: "gui-test-local", Name: "GUI 测试设备", Authorized: true, Online: true, Caps: []string{"status", "cmdrun", "deviceinfo"}},
|
||
},
|
||
settings: map[string]interface{}{
|
||
"language": "zh-CN",
|
||
"theme": "dark",
|
||
},
|
||
}
|
||
}
|
||
|
||
// 中间件:CORS + API Key 校验
|
||
func (s *MockServer) middleware(next http.Handler) http.Handler {
|
||
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
||
w.Header().Set("Access-Control-Allow-Origin", "*")
|
||
w.Header().Set("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS")
|
||
w.Header().Set("Access-Control-Allow-Headers", "Content-Type, X-API-Key, Authorization, Cookie")
|
||
|
||
if r.Method == "OPTIONS" {
|
||
w.WriteHeader(200)
|
||
return
|
||
}
|
||
|
||
// API Key 校验(可选)
|
||
// apiKey := r.Header.Get("X-API-Key")
|
||
// if apiKey == "" {
|
||
// http.Error(w, "unauthorized", 401)
|
||
// return
|
||
// }
|
||
|
||
next.ServeHTTP(w, r)
|
||
})
|
||
}
|
||
|
||
func (s *MockServer) handleStatus(w http.ResponseWriter, r *http.Request) {
|
||
writeJSON(w, Status{
|
||
Status: "running",
|
||
Version: "0.9.0",
|
||
StartedAt: s.startedAt.Format(time.RFC3339),
|
||
Uptime: int64(time.Since(s.startedAt).Seconds()),
|
||
})
|
||
}
|
||
|
||
func (s *MockServer) handleKernel(w http.ResponseWriter, r *http.Request) {
|
||
writeJSON(w, Kernel{
|
||
Model: "sensenova-6.8-flash-lite",
|
||
Provider: "siliconflow",
|
||
Status: "ready",
|
||
})
|
||
}
|
||
|
||
func (s *MockServer) handleSettings(w http.ResponseWriter, r *http.Request) {
|
||
if r.Method == "POST" {
|
||
var updates map[string]interface{}
|
||
if err := json.NewDecoder(r.Body).Decode(&updates); err == nil {
|
||
s.mu.Lock()
|
||
for k, v := range updates {
|
||
s.settings[k] = v
|
||
}
|
||
s.mu.Unlock()
|
||
}
|
||
writeJSON(w, map[string]string{"status": "saved"})
|
||
return
|
||
}
|
||
|
||
writeJSON(w, Setting{
|
||
Settings: s.settings,
|
||
Meta: map[string]interface{}{
|
||
"version": "0.9.0",
|
||
"build": "mock-20260823",
|
||
},
|
||
Plugins: []string{"core", "remotedevice", "webui", "knowledge"},
|
||
PluginMeta: map[string]interface{}{
|
||
"core": map[string]interface{}{"version": "1.0.0"},
|
||
"remotedevice": map[string]interface{}{"version": "0.9.0"},
|
||
"webui": map[string]interface{}{"version": "0.9.0"},
|
||
"knowledge": map[string]interface{}{"version": "0.5.0"},
|
||
},
|
||
DisabledPlugins: []string{},
|
||
})
|
||
}
|
||
|
||
func (s *MockServer) handlePlugins(w http.ResponseWriter, r *http.Request) {
|
||
// 获取路径中的插件名
|
||
path := strings.TrimPrefix(r.URL.Path, "/api/v1/plugins")
|
||
path = strings.TrimSuffix(path, "/")
|
||
|
||
if path == "/reload" && r.Method == "POST" {
|
||
writeJSON(w, map[string]string{"status": "reloaded"})
|
||
return
|
||
}
|
||
|
||
if path == "" && r.Method == "GET" {
|
||
writeJSON(w, s.plugins)
|
||
return
|
||
}
|
||
|
||
if path == "" && r.Method == "POST" {
|
||
writeJSON(w, map[string]string{"status": "installed"})
|
||
return
|
||
}
|
||
|
||
// /api/v1/plugins/:name
|
||
if strings.Contains(path, "/") {
|
||
parts := strings.Split(strings.TrimPrefix(path, "/"), "/")
|
||
if len(parts) >= 1 {
|
||
name := parts[0]
|
||
if len(parts) >= 2 {
|
||
action := parts[1]
|
||
if action == "disable" && r.Method == "POST" {
|
||
s.mu.Lock()
|
||
for i := range s.plugins {
|
||
if s.plugins[i].Name == name {
|
||
s.plugins[i].Enabled = false
|
||
}
|
||
}
|
||
s.mu.Unlock()
|
||
writeJSON(w, map[string]string{"status": "disabled"})
|
||
return
|
||
}
|
||
if action == "enable" && r.Method == "POST" {
|
||
s.mu.Lock()
|
||
for i := range s.plugins {
|
||
if s.plugins[i].Name == name {
|
||
s.plugins[i].Enabled = true
|
||
}
|
||
}
|
||
s.mu.Unlock()
|
||
writeJSON(w, map[string]string{"status": "enabled"})
|
||
return
|
||
}
|
||
}
|
||
|
||
// GET /api/v1/plugins/:name
|
||
writeJSON(w, PluginInfo{
|
||
Name: name,
|
||
Description: name + " 插件描述",
|
||
Version: "0.9.0",
|
||
Enabled: true,
|
||
Builtin: true,
|
||
Tools: []PluginTool{
|
||
{Name: name + "_tool1", Description: name + " 工具1"},
|
||
{Name: name + "_tool2", Description: name + " 工具2"},
|
||
},
|
||
})
|
||
return
|
||
}
|
||
}
|
||
|
||
http.NotFound(w, r)
|
||
}
|
||
|
||
func (s *MockServer) handleChatHistory(w http.ResponseWriter, r *http.Request) {
|
||
writeJSON(w, []ChatMessage{
|
||
{Role: "user", Content: "你好"},
|
||
{Role: "assistant", Content: "你好!我是 HomeAgent,有什么可以帮你的?"},
|
||
{Role: "user", Content: "测试消息"},
|
||
{Role: "assistant", Content: "这是模拟后端的测试回复,GUI 连接正常 ✅"},
|
||
})
|
||
}
|
||
|
||
func (s *MockServer) handleChat(w http.ResponseWriter, r *http.Request) {
|
||
if r.Method == "POST" {
|
||
// 模拟后端接收消息,通过 SSE 推流
|
||
go func() {
|
||
time.Sleep(500 * time.Millisecond)
|
||
|
||
// agent_start
|
||
s.sse.Broadcast("agent_output", `{"type":"agent_start","payload":{"agent":"mock"}}`)
|
||
|
||
time.Sleep(300 * time.Millisecond)
|
||
|
||
// tool_call
|
||
s.sse.Broadcast("agent_output", `{"type":"tool_call","payload":{"tool":"mock_tool","args":{},"id":"call_001"}}`)
|
||
|
||
time.Sleep(500 * time.Millisecond)
|
||
|
||
// channel_output
|
||
s.sse.Broadcast("agent_output", `{"type":"channel_output","payload":{"kind":"channel_output","channel":"mock","content":"这是一条来自模拟后端的测试回复。\n\n- 模拟后端状态: running\n- 版本: 0.9.0\n- 连接测试: ✅ 成功\n\nGUI 所有功能验证正常!"}}`)
|
||
|
||
time.Sleep(300 * time.Millisecond)
|
||
|
||
// agent_end
|
||
s.sse.Broadcast("agent_output", `{"type":"agent_end","payload":{"agent":"mock"}}`)
|
||
}()
|
||
|
||
writeJSON(w, map[string]string{"status": "queued", "id": "mock_" + time.Now().Format("150405")})
|
||
return
|
||
}
|
||
http.Error(w, "method not allowed", 405)
|
||
}
|
||
|
||
func (s *MockServer) handleChatEvents(w http.ResponseWriter, r *http.Request) {
|
||
w.Header().Set("Content-Type", "text/event-stream")
|
||
w.Header().Set("Cache-Control", "no-cache")
|
||
w.Header().Set("Connection", "keep-alive")
|
||
|
||
ch := make(chan string, 100)
|
||
s.sse.Add(ch)
|
||
defer s.sse.Remove(ch)
|
||
|
||
// 发送初始连接成功事件
|
||
fmt.Fprintf(w, "event: connected\ndata: {\"status\":\"connected\"}\n\n")
|
||
w.(http.Flusher).Flush()
|
||
|
||
ctx := r.Context()
|
||
for {
|
||
select {
|
||
case <-ctx.Done():
|
||
return
|
||
case msg := <-ch:
|
||
fmt.Fprint(w, msg)
|
||
w.(http.Flusher).Flush()
|
||
}
|
||
}
|
||
}
|
||
|
||
func (s *MockServer) handleMemoryGraph(w http.ResponseWriter, r *http.Request) {
|
||
writeJSON(w, map[string]interface{}{
|
||
"nodes": []map[string]interface{}{
|
||
{"id": "1", "label": "HomeAgent", "group": "system"},
|
||
{"id": "2", "label": "GUI 测试", "group": "user"},
|
||
},
|
||
"edges": []map[string]interface{}{
|
||
{"from": "1", "to": "2", "label": "connected"},
|
||
},
|
||
})
|
||
}
|
||
|
||
func (s *MockServer) handleMemory(w http.ResponseWriter, r *http.Request) {
|
||
writeJSON(w, []MemoryItem{
|
||
{ID: "m1", Content: "这是模拟内存中的测试数据", Time: time.Now().Format(time.RFC3339)},
|
||
})
|
||
}
|
||
|
||
func (s *MockServer) handleMemoryContext(w http.ResponseWriter, r *http.Request) {
|
||
writeJSON(w, map[string]interface{}{
|
||
"context": "模拟上下文:用户正在测试 GUI 功能",
|
||
"items": []MemoryItem{},
|
||
})
|
||
}
|
||
|
||
func (s *MockServer) handleKnowledge(w http.ResponseWriter, r *http.Request) {
|
||
if r.Method == "POST" {
|
||
writeJSON(w, map[string]string{"status": "saved"})
|
||
return
|
||
}
|
||
writeJSON(w, []map[string]interface{}{
|
||
{"id": "k1", "title": "模拟知识条目1", "content": "这是模拟知识库的测试内容"},
|
||
{"id": "k2", "title": "模拟知识条目2", "content": "GUI 功能验证测试数据"},
|
||
})
|
||
}
|
||
|
||
func (s *MockServer) handleTerminals(w http.ResponseWriter, r *http.Request) {
|
||
writeJSON(w, []map[string]interface{}{
|
||
{"id": "t1", "name": "终端 1", "status": "running"},
|
||
{"id": "t2", "name": "终端 2", "status": "idle"},
|
||
})
|
||
}
|
||
|
||
func (s *MockServer) handleCmdHistory(w http.ResponseWriter, r *http.Request) {
|
||
writeJSON(w, []map[string]interface{}{
|
||
{"cmd": "echo hello", "time": time.Now().Add(-5 * time.Minute).Format(time.RFC3339)},
|
||
{"cmd": "ls -la", "time": time.Now().Add(-10 * time.Minute).Format(time.RFC3339)},
|
||
})
|
||
}
|
||
|
||
func (s *MockServer) handleDevices(w http.ResponseWriter, r *http.Request) {
|
||
path := strings.TrimPrefix(r.URL.Path, "/api/v1/device")
|
||
path = strings.TrimSuffix(path, "/")
|
||
|
||
switch {
|
||
case path == "/online" || path == "":
|
||
writeJSON(w, s.devices)
|
||
case path == "/auth" && r.Method == "POST":
|
||
var req struct {
|
||
DeviceID string `json:"device_id"`
|
||
Authorized bool `json:"authorize"`
|
||
}
|
||
json.NewDecoder(r.Body).Decode(&req)
|
||
s.mu.Lock()
|
||
for i := range s.devices {
|
||
if s.devices[i].DeviceID == req.DeviceID {
|
||
s.devices[i].Authorized = req.Authorized
|
||
}
|
||
}
|
||
s.mu.Unlock()
|
||
writeJSON(w, map[string]interface{}{
|
||
"authorized": true,
|
||
"device_id": req.DeviceID,
|
||
})
|
||
case path == "/push" && r.Method == "POST":
|
||
writeJSON(w, map[string]string{"status": "pushed"})
|
||
default:
|
||
http.NotFound(w, r)
|
||
}
|
||
}
|
||
|
||
func (s *MockServer) handleAdapters(w http.ResponseWriter, r *http.Request) {
|
||
path := strings.TrimPrefix(r.URL.Path, "/api/v1/adapters")
|
||
path = strings.TrimSuffix(path, "/")
|
||
|
||
switch {
|
||
case path == "" && r.Method == "GET":
|
||
writeJSON(w, s.adapters)
|
||
case path == "" && r.Method == "POST":
|
||
var a Adapter
|
||
if err := json.NewDecoder(r.Body).Decode(&a); err == nil {
|
||
s.mu.Lock()
|
||
s.adapters = append(s.adapters, a)
|
||
s.mu.Unlock()
|
||
}
|
||
writeJSON(w, map[string]string{"status": "added"})
|
||
case strings.Count(path, "/") == 1 && r.Method == "DELETE":
|
||
name := strings.TrimPrefix(path, "/")
|
||
s.mu.Lock()
|
||
for i := range s.adapters {
|
||
if s.adapters[i].Name == name {
|
||
s.adapters = append(s.adapters[:i], s.adapters[i+1:]...)
|
||
break
|
||
}
|
||
}
|
||
s.mu.Unlock()
|
||
writeJSON(w, map[string]string{"status": "deleted"})
|
||
default:
|
||
http.NotFound(w, r)
|
||
}
|
||
}
|
||
|
||
func (s *MockServer) handleWebSocket(w http.ResponseWriter, r *http.Request) {
|
||
// 简单返回 400,GUI 的 main.js 会尝试连接设备桥 WS
|
||
// 这里只验证 HTTP 路由可达
|
||
http.Error(w, "WebSocket upgrade required (mock server)", 400)
|
||
}
|
||
|
||
// ===== 路由注册 =====
|
||
|
||
func (s *MockServer) registerRoutes(mux *http.ServeMux) {
|
||
mux.HandleFunc("/api/v1/status", s.handleStatus)
|
||
mux.HandleFunc("/api/v1/kernel", s.handleKernel)
|
||
mux.HandleFunc("/api/v1/settings", s.handleSettings)
|
||
mux.HandleFunc("/api/v1/plugins", s.handlePlugins)
|
||
mux.HandleFunc("/api/v1/plugins/", s.handlePlugins)
|
||
mux.HandleFunc("/api/v1/chat/history", s.handleChatHistory)
|
||
mux.HandleFunc("/api/v1/chat", s.handleChat)
|
||
mux.HandleFunc("/api/v1/chat/events", s.handleChatEvents)
|
||
mux.HandleFunc("/api/v1/memory/graph", s.handleMemoryGraph)
|
||
mux.HandleFunc("/api/v1/memory", s.handleMemory)
|
||
mux.HandleFunc("/api/v1/memory/context", s.handleMemoryContext)
|
||
mux.HandleFunc("/api/v1/knowledge", s.handleKnowledge)
|
||
mux.HandleFunc("/api/v1/terminals", s.handleTerminals)
|
||
mux.HandleFunc("/api/v1/cmd/history", s.handleCmdHistory)
|
||
mux.HandleFunc("/api/v1/device", s.handleDevices)
|
||
mux.HandleFunc("/api/v1/device/", s.handleDevices)
|
||
mux.HandleFunc("/api/v1/adapters", s.handleAdapters)
|
||
mux.HandleFunc("/api/v1/adapters/", s.handleAdapters)
|
||
mux.HandleFunc("/api/v1/device/ws", s.handleDeviceWS)
|
||
}
|
||
|
||
func writeJSON(w http.ResponseWriter, v interface{}) {
|
||
w.Header().Set("Content-Type", "application/json")
|
||
json.NewEncoder(w).Encode(v)
|
||
}
|
||
|
||
func main() {
|
||
server := NewMockServer()
|
||
mux := http.NewServeMux()
|
||
server.registerRoutes(mux)
|
||
|
||
addr := ":9099"
|
||
log.Printf("=== HomeAgent Mock Server ====")
|
||
log.Printf("监听地址: http://0.0.0.0%s", addr)
|
||
log.Printf("API 基础路径: http://0.0.0.0%s/api/v1/", addr)
|
||
log.Printf("SSE 端点: http://0.0.0.0%s/api/v1/chat/events", addr)
|
||
log.Printf("设备桥 WS: ws://0.0.0.0%s/api/v1/device/ws", addr)
|
||
log.Printf("==============================")
|
||
log.Fatal(http.ListenAndServe(addr, server.middleware(mux)))
|
||
}
|