2 Commits

Author	SHA1	Message	Date
JianFeeeee	6547506704	feat(memory): 新增可声明的召回轴 RecallPolicy（与 prune 正交） ... 问题：召回（把 L2/L3 相关记忆注入本轮）此前不可声明、也不受任何 SDK 字段 控制——它只在任务开始时对 f.Input 无条件跑一次。于是 qq_get_message 取回 真实正文后只触发 Prune（裁剪），从不触发召回；而中断通知的 meta 文本反而 会去召回（词不对题，命中一堆泛实体）。 改动： - SDK 新增 RecallPolicy(none|auto) 轴，落在 InjectOptions / ChannelDef / ToolDef 三个声明面，与 ContextPolicy 正交（裁剪 vs 召回）。默认值与 prune 刻意相反：输入/注入默认 auto（保持既有「每条输入都召回」）， 工具默认 none（工具输出多为噪声，按需声明）。 - 内核：recallDeclared 按 注入点 > 通道 > 默认auto 解析；输入侧用它决定 是否注入记忆索引；工具侧 ContextPolicy/RecallPolicy 共用同一份清洗后 query，一次相关性过程分别 prune / recall；召回以 system 消息挂到消息 末尾（同任务内替换而非累加）。 - 管线：proc RPC（inject/register + 校验）、lua 键、io payload 全量透传。 - QQ 插件：中断与 qq 通道声明 RecallPolicy=none（meta 不是内容）； qq_get_message 声明 RecallPolicy=auto（取回正文后据正文召回）。 测试：新增 recallpolicy_test.go（core）与 proc 校验用例； go build ./... 通过，go test ./internal/... 全通过，SDK 模块与 qq 插件测试通过。	2026-09-14 23:14:38 +08:00
JianFeeeee	f868975c0e	feat(core): 注入行为的记忆/裁剪标志位落地 + jieba 词库内嵌 + Windows 改走 WSL ... 配套 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/...	2026-09-11 20:31:50 +08:00