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 ——
半成品状态长期红的判据会被人习惯性忽略,那时它就等于不存在。
232 lines
8.2 KiB
Go
232 lines
8.2 KiB
Go
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("应登记变量")
|
||
}
|
||
}
|