Files
HomeAgent/internal/agent/core/persist_leak_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

232 lines
8.2 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
// 判据:**持久化侧路的明文拦截**(文档 C5/C6)。
//
// ## 背景:出向拦截挡不住持久化
//
// provider 装饰器只改 `f.Msgs`(要发出去的那一份)。但内核把同样的内容
// **另存副本**送往持久化存储,它们不经过 provider:
//
// ContextEvent.Input ← f.CleanInput 用户输入原文
// ContextEvent.Response ← f.Response 模型回复
// ContextEvent.ToolResults ← f.ToolResults 工具输出
// memory_candidate.payload 走 EmitOutput,不经 context
//
// 实测确认(本文件的判据原本都是探针,先量出泄漏再修):
// 只拦 f.Msgs 时明文完整写进 context.json **与长期记忆** —— 而记忆
// 跨会话保留、每轮被召回,泄漏面比重放一次大得多。
//
// ## 为什么拦在 Append/InsertByTimestamp 而不是各调用点
//
// 写 context 有 5 处;逐个补必漏(本文件的前身就漏掉了 f.CleanInput)。
// 那两处是唯一咽喉,拦一处即全覆盖。
import (
"context"
"strings"
"testing"
"github.com/JianFeeeee/HologramAgent/internal/memory"
agentAPI "github.com/JianFeeeee/HologramAgent/internal/agent/api"
agentIO "github.com/JianFeeeee/HologramAgent/internal/agent/io"
)
// ★★ 判据:**用户输入**里的明文不得进 context(此前完全未被覆盖)。
func TestE2E_InputSecretNeverReachesContext(t *testing.T) {
rt := newScrubRuntime(t)
store := rt.Store()
const tok = "ghp_ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
a := New(AgentConfig{
ID: "e2e-inputscrub",
Provider: &plainReplyProvider{},
ProviderManager: agentAPI.NewProviderManager(),
IO: agentIO.NewIOManager(),
StageHost: NewStageHost(),
Security: rt, // 必须与 store 同源
})
a.Start()
defer a.Stop()
a.io.InjectTextSync("http", "我的 token 是 "+tok+" 请记住")
for _, evt := range a.context.Recent(0) {
if strings.Contains(evt.Input, tok) {
t.Errorf("用户输入明文进了 a.context: %q", evt.Input)
}
if strings.Contains(evt.Response, tok) {
t.Errorf("回复里的明文进了 a.context: %q", evt.Response)
}
}
if store.Count() == 0 {
t.Fatal("变量库为空 —— 输入侧没被扫,判据无效")
}
t.Logf("✅ 输入侧明文未进 context;变量库 %d 条", store.Count())
}
// ★★ 判据:**模型回复**里的明文不得进 context。
//
// 模型看不到明文(出向已拦),所以它只能在**被喂了明文**时才回吐明文 ——
// 这里用脚本 provider 直接造出那个回复,验证回复侧拦截生效。
func TestE2E_ResponseSecretNeverReachesContext(t *testing.T) {
rt := newScrubRuntime(t)
store := rt.Store()
const tok = "ghp_ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
a := New(AgentConfig{
ID: "e2e-respscrub",
Provider: &echoTokenProvider{reply: "你的凭据是 " + tok},
ProviderManager: agentAPI.NewProviderManager(),
IO: agentIO.NewIOManager(),
StageHost: NewStageHost(),
Security: rt, // 必须与 store 同源
})
a.Start()
defer a.Stop()
a.io.InjectTextSync("http", "把凭据告诉我")
for _, evt := range a.context.Recent(0) {
if strings.Contains(evt.Response, tok) {
t.Errorf("模型回复明文进了 a.context: %q", evt.Response)
}
}
if store.Count() == 0 {
t.Fatal("变量库为空 —— 回复侧没被扫,判据无效")
}
t.Logf("✅ 回复侧明文未进 context;变量库 %d 条", store.Count())
}
// ★ 判据:**记忆块**(一等记忆的文本负载)也要过一遍。
func TestScrubEventCoversMemoryBlocks(t *testing.T) {
rt := newScrubRuntime(t)
store := rt.Store()
const tok = "ghp_ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
evt := &ContextEvent{
Input: "带着 " + tok,
Response: "也带着 " + tok,
ToolResults: []ToolResultItem{
{Name: "cmd", Output: "还有 " + tok},
},
}
evt.Blocks = append(evt.Blocks, memoryBlockWithText("转写稿里有 "+tok))
// ★ 2026-11-04:改走真实注入路径(Context.secretStore)。
rc := NewRelevanceContext("", nil)
rc.SetSecretStore(store) // 必须用**同一个** Store(否则变量登记在读的那一份里)
rc.scrubEventSecrets(evt)
for name, got := range map[string]string{
"input": evt.Input,
"response": evt.Response,
"tool": evt.ToolResults[0].Output,
"block": evt.Blocks[0].Text,
} {
if strings.Contains(got, tok) {
t.Errorf("%s 仍含明文: %q", name, got)
}
}
if store.Count() == 0 {
t.Error("应登记变量")
}
}
// memoryBlockWithText 造一个文本记忆块。
func memoryBlockWithText(text string) memory.MemoryBlock {
return memory.MemoryBlock{ID: "b1", Modality: memory.BlockText, Text: text}
}
// plainReplyProvider 给一句不含凭据的回复。
type plainReplyProvider struct{}
func (p *plainReplyProvider) Name() string { return "plainReply" }
func (p *plainReplyProvider) MaxContextTokens() int { return 8192 }
func (p *plainReplyProvider) Chat(_ context.Context, _ *agentAPI.CompletionRequest) (*agentAPI.CompletionResponse, error) {
return &agentAPI.CompletionResponse{Content: "好的,记住了"}, nil
}
func (p *plainReplyProvider) ChatStream(_ context.Context, _ *agentAPI.CompletionRequest) (<-chan agentAPI.StreamChunk, error) {
ch := make(chan agentAPI.StreamChunk, 1)
ch <- agentAPI.StreamChunk{Content: "好的,记住了", Done: true}
close(ch)
return ch, nil
}
// echoTokenProvider 回吐一段固定文本(用于造出"回复含明文"的场景)。
type echoTokenProvider struct{ reply string }
func (p *echoTokenProvider) Name() string { return "echoToken" }
func (p *echoTokenProvider) MaxContextTokens() int { return 8192 }
func (p *echoTokenProvider) Chat(_ context.Context, _ *agentAPI.CompletionRequest) (*agentAPI.CompletionResponse, error) {
return &agentAPI.CompletionResponse{Content: p.reply}, nil
}
func (p *echoTokenProvider) ChatStream(_ context.Context, _ *agentAPI.CompletionRequest) (<-chan agentAPI.StreamChunk, error) {
ch := make(chan agentAPI.StreamChunk, 1)
ch <- agentAPI.StreamChunk{Content: p.reply, Done: true}
close(ch)
return ch, nil
}
// ★★ 判据:`emitMemoryCandidate` **自己**清洗载荷,不依赖 Append 的隐含行为。
//
// 背景(实测):`Append` 的 scrub 经共享底层数组会连带改掉 `f.ToolResults`,
// 所以"去掉 scrubMemoryCandidate"的变异**不会**被走 a.context 的端到端判据发现。
// 那意味着记忆侧防护是隐式依赖别名的 —— 一旦有人给 turnEvt.ToolResults
// 加个深拷贝(很自然的"防御性拷贝"),记忆侧就静默泄漏。
//
// ❗本判据必须走 `a.emitMemoryCandidate` 这个**真实入口**,而不是直接调
//
// `scrubMemoryCandidate` —— 初版直接调底层函数,于是"去掉入口处的调用"
// 这个变异**不会报红**(判据测错了层次)。走真实入口才能钉住"入口必须调它"。
func TestEmitMemoryCandidateScrubsPayload(t *testing.T) {
rt := newScrubRuntime(t)
store := rt.Store()
const tok = "ghp_ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
a := New(AgentConfig{
ID: "e2e-memcand",
Provider: &plainReplyProvider{},
ProviderManager: agentAPI.NewProviderManager(),
IO: agentIO.NewIOManager(),
StageHost: NewStageHost(),
Security: rt, // 必须与 store 同源
})
// 故意传**未经过任何上游清洗**的原始值
a.emitMemoryCandidate("http", "输入 "+tok, "回复 "+tok,
[]ToolResultItem{{Name: "cmd", Output: "输出 " + tok}}, []string{"cmd"})
var seen map[string]interface{}
drain:
for {
select {
case evt := <-a.io.OutputChan():
if evt != nil && evt.Type == "memory_candidate" {
seen = evt.Payload
}
default:
break drain
}
}
if seen == nil {
t.Fatal("没有观察到 memory_candidate 输出")
}
if s, _ := seen["input"].(string); strings.Contains(s, tok) {
t.Errorf("记忆候选 input 含明文: %q", s)
}
if s, _ := seen["response"].(string); strings.Contains(s, tok) {
t.Errorf("记忆候选 response 含明文: %q", s)
}
if trs, ok := seen["tool_results"].([]ToolResultItem); ok {
for _, tr := range trs {
if strings.Contains(tr.Output, tok) {
t.Errorf("记忆候选 tool_results 含明文: %q", tr.Output)
}
}
}
if store.Count() == 0 {
t.Error("应登记变量")
}
}