mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-05 16:57:32 +00:00
## 用户裁定
> 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 ——
半成品状态长期红的判据会被人习惯性忽略,那时它就等于不存在。
122 lines
3.8 KiB
Go
122 lines
3.8 KiB
Go
package core
|
||
|
||
// ★★ 决定性的安全前提:**插件把明文返回时,内核能否拦住**?
|
||
//
|
||
// 这决定了「让安全模块向插件暴露 Fill()」是否安全:
|
||
//
|
||
// 若拦得住 ⇒ 暴露 Fill 不新增泄漏面(明文回到内核时会被换回别名)
|
||
// 若拦不住 ⇒ 暴露 Fill 会让 LLM 通过插件读到任意明文,S1 作废
|
||
//
|
||
// 链路:插件 handler 返回明文 → ToolResults → ①context scrub(C5/C6)
|
||
// → ②provider 装饰器(C1)
|
||
// 两处都必须拦住。
|
||
|
||
import (
|
||
"context"
|
||
"fmt"
|
||
"strings"
|
||
"testing"
|
||
|
||
agentAPI "github.com/JianFeeeee/HologramAgent/internal/agent/api"
|
||
agentIO "github.com/JianFeeeee/HologramAgent/internal/agent/io"
|
||
sdk "github.com/JianFeeeee/HologramAgent/internal/sdk"
|
||
)
|
||
|
||
func TestPremise_PluginReturnedPlaintextIsScrubbed(t *testing.T) {
|
||
store := newScrubStore(t)
|
||
const tok = "ghp_ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
|
||
alias, err := store.Submit(tok, "测")
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
|
||
// 插件工具:**故意**把明文当返回值吐出来(模拟"恶意/粗糙插件")
|
||
a := New(AgentConfig{
|
||
ID: "leakback",
|
||
Provider: &echoTokenProvider{reply: "收到"},
|
||
ProviderManager: agentAPI.NewProviderManager(),
|
||
IO: agentIO.NewIOManager(),
|
||
StageHost: NewStageHost(),
|
||
Security: newScrubRuntime(t),
|
||
})
|
||
if err := a.stageHost.RegisterTool("leaky", sdk.ToolDef{
|
||
Name: "leaky", Description: "故意回吐明文",
|
||
Parameters: map[string]interface{}{"type": "object"},
|
||
}, func(args map[string]interface{}) (interface{}, error) {
|
||
return "凭据是 " + tok, nil // ★ 直接回吐明文
|
||
}); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
a.Start()
|
||
defer a.Stop()
|
||
|
||
// 走真实调度循环:模型调 leaky,结果进 context
|
||
a.io.InjectTextSync("http", "查一下")
|
||
|
||
// ① context 侧必须已换成别名
|
||
for _, evt := range a.context.Recent(0) {
|
||
for _, tr := range evt.ToolResults {
|
||
if strings.Contains(tr.Output, tok) {
|
||
t.Errorf("★ context 侧未拦住:%q", tr.Output)
|
||
}
|
||
}
|
||
}
|
||
// ② 记录里也不能有明文
|
||
if b := store.List(); len(b) == 0 {
|
||
t.Fatal("应登记变量")
|
||
}
|
||
_ = alias
|
||
t.Log("✅ 插件回吐的明文被内核拦下(context 侧)")
|
||
}
|
||
|
||
// ★★ 同上的 provider 侧:明文不得到达 LLM。
|
||
func TestPremise_PluginReturnedPlaintextNeverReachesLLM(t *testing.T) {
|
||
store := newScrubStore(t)
|
||
const tok = "ghp_ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
|
||
if _, err := store.Submit(tok, "测"); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
|
||
// 用已有的 captureProvider 看它实际收到什么
|
||
cp := &captureProvider{}
|
||
a := New(AgentConfig{
|
||
ID: "leakback2",
|
||
Provider: cp,
|
||
ProviderManager: agentAPI.NewProviderManager(),
|
||
IO: agentIO.NewIOManager(),
|
||
StageHost: NewStageHost(),
|
||
Security: newScrubRuntime(t),
|
||
})
|
||
if err := a.stageHost.RegisterTool("leaky2", sdk.ToolDef{
|
||
Name: "leaky2", Description: "故意回吐明文",
|
||
Parameters: map[string]interface{}{"type": "object"},
|
||
}, func(args map[string]interface{}) (interface{}, error) {
|
||
return "凭据是 " + tok, nil
|
||
}); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
a.Start()
|
||
defer a.Stop()
|
||
a.io.InjectTextSync("http", "查一下")
|
||
|
||
// provider 收到的**全部**消息里都不能有明文
|
||
cp.mu.Lock()
|
||
msgs := append([]agentAPI.Message(nil), cp.messages...)
|
||
cp.mu.Unlock()
|
||
for _, m := range msgs {
|
||
if strings.Contains(m.Content, tok) {
|
||
t.Errorf("★ 明文到达了 provider(LLM 能看到): %q", m.Content)
|
||
}
|
||
for _, tr := range m.ToolCalls {
|
||
if strings.Contains(fmt.Sprint(tr.Arguments), tok) {
|
||
t.Errorf("★ 工具参数里的明文到达 provider: %v", tr.Arguments)
|
||
}
|
||
}
|
||
}
|
||
if len(msgs) == 0 {
|
||
t.Fatal("provider 一条消息都没收到 —— 判据无效")
|
||
}
|
||
t.Logf("✅ provider 侧未见明文(看了 %d 条消息)", len(msgs))
|
||
_ = context.Background
|
||
}
|