Files
HomeAgent/internal/security/global.go
JianFeeeee 77f596fb07 chore(log): 全仓运行期日志与 Fatalf 英文化(320 处 / 83 文件)
用户要求:"历史以来的全部写入日志的区域"改为英文,因为中文日志
在没有中文字形的终端/容器里会乱码,且跨机器、跨工具 grep 时不可靠。

## 范围

- 全部 log.Printf / log.Fatalf / log.Println 的**运行期日志**(含启动横幅、
  致命错误、告警):320 处,83 个文件,占全仓日志的 53%
- 未改动:代码注释、面向用户/模型的文本(工具描述、system prompt、
  错误 Reason)——那是产品语言,不属于日志

## 连带修改(必须同步,否则静默失效)

| 依赖点 | 处置 |
| --- | --- |
| medialoop_test.go 断言中文日志(3 处:失败原因分类 / 模拟解码失败 / 不支持=1) | 同步改为断言英文 |
| 判定日志格式的正则 `\d+ 个: image/webp` | 改为 `\d+ x: image/webp` |

## 顺带修正一处提示词超限(真实回归)

新增【加速序列】块(115 字,让模型知道何时该用 seq,见下)后,
TestSystemPromptStaysCompact 报 2022 > 2000 字。

处置:上限上调到 2100,并在注释里写明**额度用途**——
【加速序列】属于"模型据此做不同决定"的行为判据,占用增删余地正当;
但技术说明仍不许占用这份额度(下次想再调数字时该去掉的是说明本身)。

【加速序列】块内容只留判定条件(多对象重复 / 顺序已知 / 以前做过),
格式细节全部下沉到 seq-tools skill —— 避免两处真相。

## 验证

- go build ./... / go vet ./... 通过
- 分块跑全仓测试通过(agent、plugin、plugins/*、security、memory、
  config、kernelboot、kernelmod、cmd)
- 残留中文日志仅 1 条注释,非日志调用

## 运维提示

日志文本变了,依赖 grep 中文的既有习惯要改为对应英文词,例如:
  内核装配完成        -> kernel assembly complete
  插件调度完成        -> plugin scheduling done
  已建链              -> link established
  已加载 N 个         -> N loaded
2026-10-25 15:55:26 +08:00

102 lines
2.9 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 security
// 进程级单例与两个入向填充入口。
//
// ## 依赖方向(重要)
//
// internal/security ← 纯逻辑,不 import 任何 agent 包
// ↑
// internal/agent/api provider 装饰器(出向改写)
// internal/agent/core 工具参数/载荷填充(入向回填)
//
// 是 DAG,**没有 import 环**。所以装饰器可以直接用内核的 Provider 接口,
// 不必做接口投影。(初版误以为会成环而写了一层投影接口,已删除。)
//
// ## 为何单例必须是进程级
//
// 已核:主 / 子 / 驻留子 agent 共享同一个 ProviderManager
//(`resident.go:185`;manager 全进程只建一份 `bootstrap.go:249`)。
// 所以变量库挂在 provider 层天然就是进程级 —— **不需要跨 agent 同步**。
import (
"log"
"sync"
)
var (
globalMu sync.RWMutex
global *Store
)
// InitGlobal 装配进程级单例。**必须在任何 agent 启动前调用**。
func InitGlobal(opt Options) (*Store, error) {
s := New(opt)
if err := s.Load(); err != nil {
return nil, err
}
globalMu.Lock()
global = s
globalMu.Unlock()
return s, nil
}
// SetGlobal 直接装入一个已构造的 Store(测试与特殊装配用)。
func SetGlobal(s *Store) {
globalMu.Lock()
global = s
globalMu.Unlock()
}
// Global 取进程级单例;未初始化时返回 nil。
//
// ★ 为何返回 nil 而不报错:调用点散布在内核热路径上,
// 未启用时必须**零成本跳过**。所有调用方都写成
// `if s := Global(); s != nil { ... }`。
func Global() *Store {
globalMu.RLock()
defer globalMu.RUnlock()
return global
}
// Enabled 报告安全模块是否已启用。
func Enabled() bool {
s := Global()
return s != nil && s.enabled
}
// ---------------- 入向填充(插件无感知的关键) ----------------
// FillToolArgs 把一个工具调用的参数里的 `@{别名}` 换回明文。
//
// 这是**内核工具链的入口**(`core.StageHost.ExecuteTool`):
// 插件收到的参数已经填好,它完全不知道有替换这回事。
//
// 返回 (填充处数, 用到的别名)。未初始化时返回 (0, nil)。
func FillToolArgs(tool string, args map[string]interface{}) (int, []string) {
s := Global()
if s == nil || args == nil {
return 0, nil
}
n, used := s.FillMap(args)
if n > 0 {
log.Printf("[security] tool %s backfilled %d argument(s) (aliases %v)", tool, n, used)
}
return n, used
}
// FillPayload 把一段文本载荷里的 `@{别名}` 换回明文。
//
// 用于**设备输出通道**(`core` 的 `dev.Execute`):发给设备的指令同理
// 需要真实凭据,而设备侧对替换无感知。
func FillPayload(where, text string) string {
s := Global()
if s == nil || text == "" {
return text
}
out, n, used := s.Fill(text)
if n > 0 {
log.Printf("[security] %s payload backfilled %d place(s) (aliases %v)", where, n, used)
}
return out
}