feat: 段页式记忆流转、coldcontext 重命名与安全治理

记忆层:
- MemoryBlock 承载 FrameTS/PageSeq/PageKind/BlockRole/CallID
- coldcontext 归档与回填按完整页传递,工具调用参数和配对键不丢失
- 召回先估算总 token,超预算时按全局页相似度标记 inactive
- inactive 仅是 context 渲染期状态,不落盘、不进入 coldcontext,Prune 后重置
- Peek/确认/Remove 两阶段召回,失败保留冷上下文副本
- stablemem 记录 last_recalled_at,删块连带清理边

命名:
- internal/memory/document → internal/memory/coldcontext
- Doc/DocEvent/DocHit → ColdDoc/ColdEvent/ColdHit
- ContextToColdContext/RecentColdContexts/FindColdContexts
- 保留既有 JSON 标签、doc_ 文件前缀与 doc_count 状态键,兼容存量数据

安全治理:
- 工具策略门禁、安全配置、事件总线发布者身份与入站脱敏
- 声明式 SecurityAPI 与 QQ owner/guest profile
- 日志保留策略与相关 e2e/回归判据

验证:go build ./...、go vet ./...、go test ./...(62 包);
生产副本 e2e:7013 块迁移后 ID/向量/指纹 0 变化、0 缺失。
This commit is contained in:
JianFeeeee
2026-10-29 23:53:48 +08:00
parent a3e50b395f
commit b850feaef2
113 changed files with 6512 additions and 790 deletions

View File

@ -59,17 +59,31 @@ var (
// SDKName 是 SDK 名称。
SDKName = "HologramAgent SDK"
// SDKModule 是本 SDK 仓当前的 Go module path。
// SDKModule 是本 SDK 仓**当前**的 Go module path。
//
// ★ 2026-10-08 随托管地迁移:`gitcode.com/JianFeeeee/homeagent-sdk`
// → `github.com/JianFeeeee/homeagentsdk`(仓库迁到 GitHub)。
// ★ 演进史(三次):`gitcode.com/JianFeeeee/homeagent-sdk`
// → `github.com/JianFeeeee/homeagentsdk`(迁到 GitHub)
// → `github.com/JianFeeeee/hologramagentsdk`(与仓名统一,2026-10)
//
// ❗已有插件的 go.mod 里写的仍是旧路径(本机实测 qq/vanblog/mcquery/
// fileproc/mail-bridge 五个插件工作区全是 gitcode.com/...)。
// 因此凡是要「识别 SDK 模块」的判定必须**两种都接受**
// (见 hmapdev 的 sdkModulePath 助手),不能只认新名——
// 只认新名会让旧插件被当成「不是 SDK 模块」而静默走错分支。
SDKModule = "github.com/JianFeeeee/homeagentsdk"
// ★★ 本常量**必须与 go.mod 的 module 行逐字一致**(2026-10-29 实测缺陷):
//
// 它此前停在中间名 `github.com/JianFeeeee/homeagentsdk`,而 go.mod 已
// 推进到 `...hologramagentsdk`。后果不是"显示错",而是**模板工程编不出**:
//
// · hmapdev 用本常量生成插件 go.mod 的 require/replace
// · 而 SDK 内部(如 proc_main 运行时模板)引用的是 go.mod 的真名
// ⇒ 两个模块名并存,`go build` 报
// "no required module provides package .../sdk"
// ⇒ 用户照提示 `go get` 只会**再拉一份** SDK,问题依旧。
//
// 因此凡改 module 名,必须同时改 go.mod 与本常量。判据见
// `meta/meta_module_test.go`(钉住"与 go.mod 一致",仅认改名后的新名)。
//
// ❗存量插件的 go.mod 里仍可能是更早的名字,所以「识别 SDK 模块」的判定
// 必须**所有历史名都接受**(见 hmapdev 的 sdkModuleNames)——
// 只认最新名会让旧插件被当成「不是 SDK 模块」而静默走错分支。
// 注意区分:**识别**要宽容,**生成**要精确(就是本常量)。
SDKModule = "github.com/JianFeeeee/hologramagentsdk"
// LegacySDKModule 是迁移前的 SDK module path,仍需被识别。
LegacySDKModule = "gitcode.com/JianFeeeee/homeagent-sdk"