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

@ -937,6 +937,65 @@ func (r *ConfigRegistry) seedCoreDefs(dataDir string, fresh bool) {
reg(ConfigDef{Key: "core.knowledge.path", Default: filepath.Join(dataDir, "knowledge"), Type: "string", DisplayName: "知识库路径", Description: "知识库存储目录", Category: "paths"})
reg(ConfigDef{Key: "core.log.path", Default: filepath.Join(dataDir, "log"), Type: "string", DisplayName: "日志目录", Description: "日志文件输出目录", Category: "paths"})
// ---- 日志保留策略(2026-10-29 补:此前两个键都没注册,策略一直在空转)----
//
// ## 曾经的缺陷
//
// `internal/log/manager.go` 读 `core.log.retention`,但注册表里**从未**有
// 这个键 ⇒ GetString 总是返回调用方传的兜底值 "forever" ⇒ 压缩照做、
// **永不清理**。生产实测:log/ 目录 590MB / 504 个文件,485 个是当月
// 未被归档的 homed_*.log。而 `core/log_scrub.go` 的注释还写着
// “每天一个文件,从不自动清理” —— 注释描述了 bug,代码没修。
//
// ## 为何默认 n_months 而不是 forever
//
// forever 让磁盘无界增长,而日志的价值随时间快速衰减(排障看最近几周)。
// 3 个月是一个既够事后回看、又不至于涨到不可控的默认。
regMeta(ConfigDef{Key: "core.log.retention", Default: "n_months", Type: "string", DisplayName: "日志保留策略",
Description: "归档后的日志保留多久:this_week(只留本周)/ this_month(只留本月)/ n_months(保留近 N 个月)/ forever(永不删除)。注意:本项影响的是**压缩归档**的清理,当月的原始 homed_*.log 在跨月归档前不会被删。", Category: "paths"})
regMeta(ConfigDef{Key: "core.log.retention_months", Default: "3", Type: "int", DisplayName: "日志保留月数",
Description: "当 core.log.retention=n_months 时保留的月数", Category: "paths"})
// ---- 安全策略(2026-10-29 补:此前只有 enabled 一个键被读)----
//
// ## 曾经的缺陷
//
// `security.Policy`(工具黑白名单 + 沙箱)机制完整且有 12 条判据,
// 但**没有任何配置入口**:`core.security.*` 全仓只读一个 `enabled`,
// `SetPolicy` 零调用方。运维即使想开沙箱也无从下手。
//
// ## 为何全部用 regMeta(只登记、不播种)
//
// 安全策略属于「默认关、要收紧的人自己开」。若给老安装注入默认值,
// 升级即悄悄改变其安全行为 —— 与 core.agent.offload_enabled 同一纪律。
//
// ★★ 重要语义(2026-10-29 实测确认,别被名字骗了):
//
// `regMeta` = **只登记、不播种**。而 `defDefault` 要求 `seeded[key]`
// 为真才回退到 `ConfigDef.Default` —— 因此 regMeta 的键在
// **全新安装上也读不到 Default**,GetXxx 会直接返回调用方传入的兜底值。
//
// 后果与要求:
// · WebUI 看得到这些键(ListDefs 遍历 r.defs)—— 这一半成立
// · 但“读不到 Default”⇒ **装配代码必须自己写兜底值**,
// 且兜底值必须与这里的 Default **逐字一致**,否则两边会静默分叉。
//
// 这就是为什么 `kernelmod/security/policy_config.go` 里每个 GetXxx
// 的兜底值都与本处 Default 相同,并由
// `TestPolicyConfigDefaultsMatchRegistry` 钉住两边不漂移。
regMeta(ConfigDef{Key: "core.security.tool_deny", Default: "", Type: "string", DisplayName: "工具黑名单",
Description: "明确禁止的工具名,逗号分隔,支持 `*` 后缀前缀匹配(如 cmd_*,files_write)。deny 永远优先于 allow。留空=不禁任何工具。改动需重启生效。", Category: "defaults"})
regMeta(ConfigDef{Key: "core.security.tool_allow", Default: "", Type: "string", DisplayName: "工具白名单",
Description: "只允许这些工具,逗号分隔,支持 `*` 后缀匹配。留空=不限制(默认)。非空时不在名单里的工具一律拒绝——白名单是“只有这些”的语义。改动需重启生效。", Category: "defaults"})
regMeta(ConfigDef{Key: "core.security.sandbox.enabled", Default: "false", Type: "bool", DisplayName: "启用沙箱约束",
Description: "启用后按读写根与网络开关约束工具执行。默认关闭(保持既有行为)。只放**可判定**的事实(路径前缀、是否允许网络),不做“看起来危险”的猜测式判定。改动需重启生效。", Category: "defaults"})
regMeta(ConfigDef{Key: "core.security.sandbox.read_roots", Default: "", Type: "string", DisplayName: "允许读取的路径根",
Description: "逗号分隔的路径前缀;留空=不限制读。启用沙箱后不在此列下的读取会被拒绝。", Category: "defaults"})
regMeta(ConfigDef{Key: "core.security.sandbox.write_roots", Default: "", Type: "string", DisplayName: "允许写入的路径根",
Description: "逗号分隔的路径前缀;留空=不限制写。拒绝 `..` 逃逸(先求绝对值再比前缀)。", Category: "defaults"})
regMeta(ConfigDef{Key: "core.security.sandbox.allow_network", Default: "true", Type: "bool", DisplayName: "允许网络访问",
Description: "启用沙箱后为 false 则拒绝带 URL/网络意图的调用。默认 true(不施加网络约束)。", Category: "defaults"})
reg(ConfigDef{Key: "core.agent.max_tool_turns", Default: "10", Type: "int", DisplayName: "最大工具轮次", Description: "单次请求允许的最大工具调用轮数", Category: "agent"})
reg(ConfigDef{Key: "core.agent.offload_enabled", Default: "false", Type: "bool", DisplayName: "积压任务自动转投", Description: "主 agent 长时间忙时,把积压任务自动转投给内核拉起的驻留子(需重启生效)", Category: "agent"})
// 1m 而非 5m:实测本机正常任务最长 1.2 分钟,5 分钟的阈值意味着