fix(security): 工具输出与参数会原样写进日志 —— 落盘前脱敏

## 缺陷

两处日志把工具内容原样打印,没有经过 security.Replace:

	task.go:1038  log.Printf("[agent] tool %s result: %s", ..., truncateStr(result, 100))
	task.go:967   log.Printf("[agent] tool %s raw_arguments: %s", ..., truncateStr(tc.RawArguments, 300))

实测场景:enc_shell 跑 curl 拿到 200,响应体里带着上游 key 的完整值
(`{"key":"sk-..."}`),这一行直接写进 /home/newqqagent/log/homed_*.log。

## 为什么日志泄漏比上下文泄漏更严重

	模型上下文  短期——一轮结束就不再发送
	日志        长期——每天一个文件、从不自动清理,systemd journal 另存一份,
	                   排查问题时还会被贴进 issue

一次落盘就是永久泄漏。凭据轮换前,任何拿到日志的人都能直接用。

## 改动

 · 新增 scrubForLog(text, where):唯一入口,空安全(Global()==nil 时原样返回)
 · 两处日志调用点都改为先 scrubForLog 再落盘
 · 拦截本身记一笔(只记模式与长度,不记原文),便于事后发现"哪个工具常吐凭据"

## 判据(4 条)

 · 明文被换成别名(真 Store,不用 mock)
 · 普通文本不被改动(不误伤)
 · Global() 为 nil 时不 panic(安全模块未启用是常态)
 · **接线**:两处调用点确实走了 scrubForLog(只测函数不测接线会漏掉原缺陷)

变异:scrubForLog 直接返回原文 → 咬;工具结果日志去掉 scrubForLog → 咬。
This commit is contained in:
JianFeeeee
2026-10-18 13:20:54 +08:00
parent d9c2e51f61
commit 59f7001932
4 changed files with 200 additions and 2 deletions

View File

@ -14,6 +14,7 @@ import (
"github.com/JianFeeeee/HomeAgent/internal/memory/document"
"github.com/JianFeeeee/HomeAgent/internal/memory/text"
sdk "github.com/JianFeeeee/HomeAgent/internal/sdk"
"github.com/JianFeeeee/HomeAgent/internal/security"
)
// 工具执行超时的默认值与硬上限。
@ -154,6 +155,43 @@ func (a *Agent) executeToolCallOutcome(tc agentAPI.ToolCall, channel string, tur
"这是工具自身故障(不是你的参数问题),请勿原样重试;可换用其他工具或告知用户。")
out = toolOutcome{Text: te.Error(), Raw: te}
}
// ★★ 出向脱敏(2026-10-18 补):工具返回值在交给模型**之前**必须清洗。
//
// ## 原缺陷
//
// 安全模块只做了**入向**回填(StageHost.ExecuteTool 里 FillMap,
// 把别名换成真凭据给插件用),**从不处理出向**。于是:
//
// 模型调 enc_shell 跑 curl → 服务端把 key 回显在响应体里
// → 工具原样返回 → f.CurResult → f.Msgs(role=tool)
// → **明文 key 直接进了模型上下文**
//
// 实测证据(2026-10-18 08:48,/home/newqqagent/log):
// `[security] 工具 enc_shell 参数回填 1 处(别名 [sec_...])` ← 入向有
// 紧随其后 `tool enc_shell result: {...}` ← 出向无
//
// ## 为什么 scrubbing 已有却不管用
//
// `scrubEventSecrets` 只在 `RelevanceContext.Append`(写上下文/记忆)
// 时运行 —— 那是**工具结果已经发出去之后**。同一轮里模型看到的是
// 未清洗的 f.Msgs。记忆侧干净、当轮泄漏,是最坏的组合:事后查不到。
//
// ## 为什么放在这个 defer 里
//
// executeToolCallOutcome 有多个 return 出口(插件工具、io 工具、
// 设备授权拒绝、不存在、panic),逐个加必然漏。defer 是唯一
// 能覆盖全部分支的位置,且 panic 路径也一起覆盖。
if out.Text != "" {
if st := security.Global(); st != nil {
if clean, evts := st.Replace(out.Text, "tool_out:"+tc.Name, security.Patterns); len(evts) > 0 {
out.Text = clean
for _, e := range evts {
log.Printf("[security] 工具输出 %s 拦截 %s(模式 %s,%d 字节)",
tc.Name, e.Alias, e.Kind, e.Len)
}
}
}
}
}()
done := make(chan toolOutcome, 1)