mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-06 17:27:31 +00:00
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:
32
third_party/homeagent-sdk/meta/meta.go
vendored
32
third_party/homeagent-sdk/meta/meta.go
vendored
@ -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"
|
||||
|
||||
65
third_party/homeagent-sdk/meta/meta_module_test.go
vendored
Normal file
65
third_party/homeagent-sdk/meta/meta_module_test.go
vendored
Normal file
@ -0,0 +1,65 @@
|
||||
package meta
|
||||
|
||||
// SDKModule 与 go.mod 的一致性命中判据。
|
||||
//
|
||||
// ## 为什么必须有(2026-10-29 实测缺陷,代价是"模板工程开箱编不出")
|
||||
//
|
||||
// 事实经过:
|
||||
//
|
||||
// go.mod: module github.com/JianFeeeee/hologramagentsdk ← 已改名
|
||||
// meta.SDKModule = "github.com/JianFeeeee/homeagentsdk" ← 停在中间名
|
||||
//
|
||||
// 两者不一致时,`hmapdev init` 生成的工程会**同时**出现两个模块名:
|
||||
//
|
||||
// require github.com/JianFeeeee/homeagentsdk v1.4.0 (来自本常量)
|
||||
// 而 z_proc_gen.go 里 import .../hologramagentsdk/sdk (来自 SDK 真实模块名)
|
||||
//
|
||||
// 结果 `hmapdev build` 报
|
||||
//
|
||||
// no required module provides package github.com/JianFeeeee/hologramagentsdk/sdk
|
||||
//
|
||||
// 而用户照提示执行 `go get` 只会**再拉一份** SDK —— 两个模块名并存,
|
||||
// 问题原样保留。这类故障的恶劣之处:报错指向 import,真因在 meta.go。
|
||||
//
|
||||
// 所以本判据钉死"生成用的模块名 == go.mod 的模块名"。
|
||||
|
||||
import (
|
||||
"os"
|
||||
"path/filepath"
|
||||
"strings"
|
||||
"testing"
|
||||
)
|
||||
|
||||
func TestSDKModuleMatchesGoMod(t *testing.T) {
|
||||
// meta/ 的上一级就是 SDK 仓根。
|
||||
data, err := os.ReadFile(filepath.Join("..", "go.mod"))
|
||||
if err != nil {
|
||||
t.Fatalf("读 SDK go.mod 失败: %v", err)
|
||||
}
|
||||
|
||||
var mod string
|
||||
for _, line := range strings.Split(string(data), "\n") {
|
||||
line = strings.TrimSpace(line)
|
||||
if strings.HasPrefix(line, "module ") {
|
||||
mod = strings.TrimSpace(line[len("module "):])
|
||||
break
|
||||
}
|
||||
}
|
||||
if mod == "" {
|
||||
t.Fatal("SDK go.mod 里没有 module 行")
|
||||
}
|
||||
|
||||
if SDKModule != mod {
|
||||
t.Fatalf("★ meta.SDKModule 与 go.mod 不一致:\n"+
|
||||
" meta.SDKModule = %q\n"+
|
||||
" go.mod module = %q\n"+
|
||||
"两者不一致会让 hmapdev 生成的插件工程同时依赖两个 SDK 模块名,"+
|
||||
"表现为 `no required module provides package .../sdk`。"+
|
||||
"改 module 名时必须同时改这两处。", SDKModule, mod)
|
||||
}
|
||||
|
||||
// 反向保护:LegacySDKModule 不得与当前名相同(否则"识别旧名"失去意义)。
|
||||
if LegacySDKModule == SDKModule {
|
||||
t.Fatal("LegacySDKModule 与 SDKModule 相同 —— 迁移前的名字应当不同")
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user