Files
HomeAgent/internal/agent/core/leakback_test.go
JianFeeeee 47afd67ca1 refactor(security): 删除三份包级单例,共享数据统一挂 kstate
## 用户裁定

> 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 ——
  半成品状态长期红的判据会被人习惯性忽略,那时它就等于不存在。
2026-11-04 11:57:48 +08:00

122 lines
3.8 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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
}