mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-21 09:28:14 +00:00
配套 SDK 提交:homeagent-sdk ba49dfd(公开 API 纯追加,无签名变更)。
本仓第三方的库镜像同步至该版本,以保证全新 clone 能编译。
## 1. 注入标志位(内核侧)
- 7 条注入路径(排队/中断/同步 × 纯文本/带媒体 + 旧 NoMem 变体)解析并转发
no_memory / context_policy / cleaner_name;策略在入口**校验**,
非法值报错而不是静默降级成 none(降级会让调用方以为自己声明的裁剪在生效)。
- 新增 validateContextPolicy(与 tool.register 同一套规则)与 pubSdkInjectOpts。
- input.register 不再手写字段白名单重建 ChannelDef,改为整体传递 + 补 ContextPolicy。
- io 层:applyInjectOpts 把标志位写进事件 payload,仅非零时写
(零值与旧 payload 逐字节一致,事件订阅方与旧内核都不受影响)。
- ioAdapter / procCore / internal-sdk 别名补齐六个 *Opts 实现。
## 2. 修掉「输入无条件裁剪」这个真缺陷
eventloop 此前对**每条非中断输入**都调 `context.Prune(...)`:破坏性(低相关事件被
归档移出上下文)且无法从调用点看出是谁触发的。改为 pruneOnInput/pruneDeclared:
优先级:注入点声明(payload.context_policy)> 通道声明(ChannelDef.ContextPolicy)
> 默认**不裁剪**
查询向量仍取清洗后的内容;新增 cleanInputFor 解析清洗文本,优先级为
注入点声明的 cleaner(cleaner_name)> 按 source 查到的通道 cleaner > 原文,
名字查不到时**记日志再回退**(注入是 fire-and-forget,插件看不到错误,
至少要在内核日志留下「你声明的清洗没生效」的痕迹)。
## 3. jieba 词库内嵌(修「猜 GOMODCACHE → 静默失效」)
原 jiebaDictDir() 去猜 GOMODCACHE/GOPATH/~/go/pkg/mod,部署机上通常没有 Go 模块
缓存 → GetJieba() 返回 nil → 分词/关键词提取/NLP 依存解析(进而 doc→graph 三元组
抽取)/静态词向量 tokenizer **一律静默返回空列表**,只有一行日志。本机看起来正常
只因开发机与生产机重合、恰好有那份缓存。
现在词库随二进制分发:internal/memory/jiebadict/ 5 文件约 11.6MB + go:embed,
按**内容哈希**命名缓存目录落盘(词库升级不复用旧文件),已齐全则跳过写入。
模块缓存降为兜底。homed 体积 32MB。
顺带确认(并有测试佐证):gojieba 的 Tag() 不需要 pos_dict/ 目录——
cppjieba 的 PosTagger 从主词典每行的词性列取 tag。
## 4. homed 放弃 Windows 原生,改走 WSL2
插件体系依赖「继承的 fd」+「统一共享内存区的段内偏移解引用」,Windows 既无 fd
继承语义,其句柄模型也无法表达后者;强行适配等于再维护一套平台专属 ABI
(C ABI 时代三套 ABI 并存曾导致改写型插件在某平台静默失效)。
- cmd/homed/platform_{windows,other}.go:原生 Windows 启动即拒绝并打印 WSL2 指引。
- internal/plugin/proc/shmalloc_windows.go:allocShm 直接返回「请用 WSL2」,
**不返回半可用的段**(与 shmalloc_other.go 同风格:未支持平台显式报错);
procEnvForShm 返回 nil。顺手修掉两处长期编译错误
(cryptorand→rand、h.evData→h.unified.evtData),使 GOOS=windows 至少能编译。
注:homed 本就编不出 Windows——internal/memory 依赖 cgo-only 的 gojieba。
- deploy/packaging/installer.nsi:不再安装 homed.exe/initconfig.exe,改为携带
**linux payload** 并调用新的 install-via-wsl.ps1;退出码 20/21 表示
「需先装 WSL/发行版」,走指引而非报错。
- deploy/packaging/windows/install-via-wsl.ps1(新):检测 WSL → 引导安装 →
确保 WSL2 → 送包进发行版 → 在 WSL 内按 Linux 方式安装。**复用 Linux 包与
linux/setup.sh**,不另写一套安装逻辑;落点与 deb 布局统一
(/usr/bin/homed + /usr/lib/homeagent/setup.sh)。
- deploy/packaging/linux/setup.sh:API Key 允许 HOMEAGENT_API_KEY 覆盖
(否则安装器界面显示一份、config.db 里另一份 → 登录不上)。
- deploy/packaging/build.sh:windows 目标只构建 waiter + gui,并新增
stage_linux_payload 把 Linux 包暂存给安装器;homed/initconfig 在 windows
目标下明确拒绝。
## 5. 插件调用点统一写明意图
- webui 的 OpenAI 兼容端点(固定提示词模板)→ InjectTextSyncNoMemory。
- agentcli 的 5 处纯状态通知(已启动/超时/执行结束/进程退出/读取结束)→ NoMemory;
**带输出**的 2 处(定时反馈、有新输出)刻意保留记忆并注明理由。
- timer 的定时提醒 → NoMemory(中断本来也隐含 NoMemory,这里是写明意图)。
## 6. 版本
meta.Version 仍为 1.2.0(main 是下一个未发布中版本);
SDKCompatibleVersion 1.1.0 → **1.2.0**(本内核已实现 SDK 1.2.0 全部新增方法)。
## 测试
- core:默认不裁剪(无声明/none/空)、通道 opt-in、注入点双向覆盖通道、
nil context/io 安全、cleaner 优先级与未知名回退。
- io:零值 opts 与历史 payload 逐键相同;text/中断/媒体三类注入标志位都落到
payload;旧方法仍生效。
- proc:validateContextPolicy 只接受 ""/none/prune,报错含位置与实际值;
**跨进程** e2e——testdata 插件经 io.injectText 送出三个标志位,断言它们穿过 RPC
到达内核。
- memory:模块缓存不可见时内嵌词库仍可用(分词与 POS 内容词均非空)、
落盘幂等、内容哈希稳定。
验证:go build ./... / go vet ./... / go vet -tags onnxruntime ./...
go test -short ./internal/memory/... ./internal/nlp/... ./internal/plugin/...
./internal/agent/{core,io}/... ./pkg/...
99 lines
3.0 KiB
Go
99 lines
3.0 KiB
Go
package memory
|
||
|
||
import (
|
||
"os"
|
||
"path/filepath"
|
||
"sync"
|
||
"testing"
|
||
)
|
||
|
||
// 内嵌词库必须自足:把 GOMODCACHE/GOPATH/HOME 全部指向不存在的路径,
|
||
// 分词与关键词提取仍然要工作。
|
||
//
|
||
// 这正是修复前的故障场景:原实现只去猜 Go 模块缓存,部署机上没有那份缓存时
|
||
// GetJieba() 返回 nil,四个函数静默返回空列表——关键词提取、文档 TF-IDF 分词、
|
||
// NLP 依存解析(进而 doc→graph 三元组抽取)一起失效,且只有一行日志。
|
||
func TestEmbeddedJiebaDictIsSelfContained(t *testing.T) {
|
||
t.Setenv("GOMODCACHE", filepath.Join(t.TempDir(), "nonexistent"))
|
||
t.Setenv("GOPATH", filepath.Join(t.TempDir(), "nonexistent"))
|
||
t.Setenv("HOME", filepath.Join(t.TempDir(), "nonexistent"))
|
||
// 清掉可能已被其它测试初始化过的单例。
|
||
jiebaOnce = sync.Once{}
|
||
jiebaInst = nil
|
||
t.Cleanup(func() {
|
||
jiebaOnce = sync.Once{}
|
||
jiebaInst = nil
|
||
})
|
||
|
||
if x := GetJieba(); x == nil {
|
||
t.Fatal("模块缓存不可见时 jieba 必须仍能初始化(词库应来自内嵌副本)")
|
||
}
|
||
|
||
words := TokenizeWords("今天天气很好,我们去公园散步")
|
||
if len(words) == 0 {
|
||
t.Fatal("分词结果为空:内嵌词库没有真正生效")
|
||
}
|
||
t.Logf("分词结果: %v", words)
|
||
|
||
// 内容词(名词/动词/形容词)——依赖词典里的词性列,顺便验证 Tag 路径可用。
|
||
content := TokenizeContentWords("北京是中国的首都,这里有很多历史建筑")
|
||
if len(content) == 0 {
|
||
t.Fatal("内容词为空:Tag(词性标注)路径失效")
|
||
}
|
||
t.Logf("内容词: %v", content)
|
||
|
||
if kw := ExtractKeywords("机器学习模型训练需要大量数据和算力"); len(kw) == 0 {
|
||
t.Fatal("关键词为空")
|
||
}
|
||
}
|
||
|
||
// 落盘目录必须幂等:第二次调用不应重写文件(正常启动只做几次 stat)。
|
||
func TestMaterializeJiebaDictIsIdempotent(t *testing.T) {
|
||
dir, err := materializeJiebaDict()
|
||
if err != nil {
|
||
t.Fatalf("materializeJiebaDict: %v", err)
|
||
}
|
||
for _, name := range jiebaDictFiles {
|
||
p := filepath.Join(dir, name)
|
||
fi, err := os.Stat(p)
|
||
if err != nil {
|
||
t.Fatalf("缺少词库文件 %s: %v", name, err)
|
||
}
|
||
if fi.Size() == 0 {
|
||
t.Fatalf("词库文件 %s 为空", name)
|
||
}
|
||
}
|
||
|
||
// 记下 mtime,再调一次,必须完全没动过。
|
||
before, _ := os.Stat(filepath.Join(dir, "jieba.dict.utf8"))
|
||
dir2, err := materializeJiebaDict()
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if dir2 != dir {
|
||
t.Fatalf("目录名不稳定:%s vs %s(会导致每次启动重建词库)", dir, dir2)
|
||
}
|
||
after, _ := os.Stat(filepath.Join(dir, "jieba.dict.utf8"))
|
||
if !before.ModTime().Equal(after.ModTime()) {
|
||
t.Fatal("已存在完整词库时不应重写文件")
|
||
}
|
||
}
|
||
|
||
// 词库内容哈希必须稳定:否则目录名每次都变,等于每次启动都重建。
|
||
func TestJiebaDictDigestStable(t *testing.T) {
|
||
a, err := jiebaDictDigest()
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
b, err := jiebaDictDigest()
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if a != b {
|
||
t.Fatalf("哈希不稳定: %s vs %s", a, b)
|
||
}
|
||
if len(a) != 16 {
|
||
t.Fatalf("哈希长度异常: %q", a)
|
||
}
|
||
}
|