mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-05 16:57:32 +00:00
47afd67ca1
## 用户裁定
> secutiry 的实现也是错误的，所有共享数据统一挂载一个 kernel 提供的
> 挂载点上暴露。
> store也应该调用security的加密能力！
## 缺陷
security 包原有**三份**独立包级单例，各自被 InitXxx/SetXxx 装入、
各自有访问器，三份都绕开了内核统一挂载点 kstate.State：
global *Store 变量库（凭据别名） Global()
runtime *Runtime 安全防火墙 RuntimeGlobal()
globalCodec *Codec 配置落盘加密 ConfigCodec()
## 为什么单例是错的（不是"多一个全局变量"）
本 agent 的 a.security 与 security.Global() 是**两个独立变量**。
正常装配下它们恰好指向同一份数据，但"恰好"不是保证：
· 测试替身：测试装单例、被测代码用 agent 字段 ⇒ 测的与跑的不是同一份
· 多 Runtime：两个内核实例/热重载时单例只有一份，另一方被覆盖
· 装配顺序：单例装晚了，先注册的 provider 就没被装饰
第三条**曾真实存在**：ProviderManager.Register 在注册时读单例套装饰器，
而 llm 模块原本不声明 FacSecurity 依赖 —— 顺序正确纯属巧合。
改动过程中判据如实报红 640 次泄漏。
## 本次做的（T3.1 + T3.3）
### 删 global *Store → 注入
变量库的唯一来源是 security 模块产出的 Runtime，经注入面分发：
AgentConfig.Security → a.security.Store() → a.secretStore()
ProviderManager.SetSecretStore
plugin.Registry.SetSecretStore → sdk.NewSecretsAPI(store)
core 的 4 处 security.Global()（output/toolcall/tooldefs/secret_tools）
改为 a.secretStore()；context 与 stageHost 改为注入字段；
provider 装饰器改为读注入的 Store。
### 删 runtime *Runtime → 注入
plugin.Registry.SetSecurityRuntime → sdk.NewSecurityAPI(name, rt)
→ sdk.newEventsAPI(name, bus, rt)
Prepare 的幂等缓存改为 kernelmod/security 私有变量 ——
装配器私有，不再是任何包都能取的公开访问器。
### 顺带删死代码
security.FillToolArgs / FillPayload 生产调用者为 0（StageHost 已自己
用注入的 Store 做同一件事），连同只测它们的判据一起删除。
### llm 模块补 FacSecurity 依赖
这是**真实存在**的依赖：注册 provider 时要套出向装饰器，而装饰器需要
变量库。此前靠"单例先装了"掩盖了顺序错误。
## 判据（均经变异验证）
TestNoPackageLevelSingletons 源码扫描；加回 var global ⇒ 红（实测）
TestMustStoreDoesNotRegisterGlobally 两次 MustStore 必须得到不同实例
TestStoreEncryptsWithOwnKey 落盘无明文 + 重载可解
## 验证
go build ./... PASS
go vet ./... PASS
gofmt -l 干净
go test ./... -count=1 63 包全过，0 FAIL
干净检出（git worktree） build + 3 包测试全绿
## 未做（见 kernelplan.md T3.2）
globalCodec 收敛 + Store 复用 Codec
还牵涉 config 的 6 处调用点与**存量密文惰性迁移**，单独一步做。
TestNoPackageLevelSingletons 的禁表暂不含 globalCodec ——
半成品状态长期红的判据会被人习惯性忽略，那时它就等于不存在。
70 lines
3.2 KiB
Go
70 lines
3.2 KiB
Go
package security
|
||
|
||
// 进程级单例与两个入向填充入口。
|
||
//
|
||
// ## 依赖方向（重要）
|
||
//
|
||
// internal/security ← 纯逻辑，不 import 任何 agent 包
|
||
// ↑
|
||
// internal/agent/api provider 装饰器（出向改写）
|
||
// internal/agent/core 工具参数/载荷填充（入向回填）
|
||
//
|
||
// 是 DAG，**没有 import 环**。所以装饰器可以直接用内核的 Provider 接口，
|
||
// 不必做接口投影。（初版误以为会成环而写了一层投影接口，已删除。）
|
||
//
|
||
// ## 为何单例必须是进程级
|
||
//
|
||
// 已核：主 / 子 / 驻留子 agent 共享同一个 ProviderManager
|
||
//（`resident.go:185`；manager 全进程只建一份 `bootstrap.go:249`）。
|
||
// 所以变量库挂在 provider 层天然就是进程级 —— **不需要跨 agent 同步**。
|
||
|
||
import ()
|
||
|
||
// ★ 2026-11-04：进程级单例 `global *Store` 已删除。
|
||
//
|
||
// ## 为什么删
|
||
//
|
||
// 它绕开了内核的**统一挂载点**（`kstate.State.Security`）。变量库只有一个
|
||
// 事实来源：security 模块产出的 Runtime，经 Assembly 传进
|
||
// `AgentConfig.Security` / `ProviderManager.SetSecretStore` /
|
||
// `plugin.Registry.SetSecretStore`，各消费方从自己的注入面取。
|
||
//
|
||
// ## 单例的危害（不是"多一个全局变量"这么轻）
|
||
//
|
||
// 本 agent 的 `a.security` 与 `security.Global()` 是**两个独立变量**。
|
||
// 正常装配下它们恰好指向同一份数据，但"恰好"不是保证：
|
||
//
|
||
// · 测试替身：测试装单例、被测代码用 agent 字段 ⇒ 测试测的是单例
|
||
// · 多 Runtime：两个内核实例（或热重载）时单例只有一份，另一方被覆盖
|
||
// · 装配顺序：单例装晚了，先注册的 provider 就没被装饰（静默漏一条出网路径）
|
||
//
|
||
// 最后一条曾真实存在：`ProviderManager.Register` 在注册时读单例套装饰器，
|
||
// 而 llm 模块原本**不声明** FacSecurity 依赖 —— 顺序正确纯属巧合。
|
||
// 现在 llm 模块声明了 FacSecurity，且注入必须早于 Register。
|
||
|
||
// ---------------- 入向填充（插件无感知的关键） ----------------
|
||
|
||
// ★ 2026-11-04：`FillToolArgs` / `FillPayload` 已删除（死代码）。
|
||
//
|
||
// 它们读 `Global()` 单例做入向回填，但**生产调用者为 0**：
|
||
// `core.StageHost.ExecuteToolCtx` 已直接用注入的 Store 做同一件事
|
||
// （见 stages.go 的 `h.secretStore().FillMap(args)`）。
|
||
//
|
||
// 只留一个测试调用它们 ⇒ 测的是没人用的代码路径，绿了也不代表任何
|
||
// 生产行为正确（engineering-lessons §1.1「判据要钉真实路径」）。
|
||
|
||
// MustStore 构造并加载一个变量库（装配/测试用），失败直接返回 error。
|
||
//
|
||
// ★ 存在的理由（2026-11-04）：包级单例删除后，"New + Load" 这对操作在
|
||
// 装配代码与十几个测试里重复出现。抽成函数让调用点保持一行，
|
||
// 也避免各人各写一遍（漏 Load 的症状是"库看起来在、但读不到已有条目"）。
|
||
//
|
||
// 注意：本函数**不**注册任何全局单例 —— 返回值由调用方持有并注入。
|
||
func MustStore(opt Options) (*Store, error) {
|
||
s := New(opt)
|
||
if err := s.Load(); err != nil {
|
||
return nil, err
|
||
}
|
||
return s, nil
|
||
}
|