Files
HomeAgent/cmd/homed/plugins_scheduled.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

81 lines
3.3 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 main
// 按 syncbus 状态**分阶段**拉起插件(设计 §2.6)。
//
// ## 三条规则(按优先级)
//
// 未声明 requires_facilities ⇒ 等内核**完全**初始化 ← **现行为,零改动**
// 声明了且依赖全就绪 ⇒ 立即拉起(**尽早启动**)
// 声明了但依赖未齐 ⇒ 挂起,等 syncbus 更新
// 声明 auto_start=false ⇒ 不自动拉起,等 agent 显式启用
//
// ## ★ 兼容性硬约束(§2.6.5)
//
// 存量 42 个插件都不声明依赖 ⇒ 全部走第一条 ⇒ 启动时机**逐字不变**。
// 这不是"顺便兼容",而是硬约束:任何一个存量插件若因本设计改变启动时机,
// 就可能在不该动的时候动(如假设"我 Start 时 llm 已就绪")。
// **静默改变启动时机 = 静默引入竞态。**
import (
"log"
"strings"
internalConfig "github.com/JianFeeeee/HologramAgent/internal/config"
"github.com/JianFeeeee/HologramAgent/internal/plugin"
"github.com/JianFeeeee/HologramAgent/internal/recovery"
)
// resolveFailbackAllowlist 解析 failback 受限启动的插件白名单(装配**前**调用)。
//
// 返回 nil 表示非 failback 模式(普通启动不设白名单)。
func resolveFailbackAllowlist(cfgReg *internalConfig.ConfigRegistry,
bootMode, dataDir string) []string {
if bootMode != "failback" {
return nil
}
list := cfgReg.GetString("core.agent.failback_plugins", "webui,pluginmgr,recoverydiag")
// 优先使用 guard.yaml 经 recovery 任务下发的插件集(guard 是 failback 权威)
if task, terr := recovery.LoadTask(recovery.TaskPath(dataDir)); terr == nil && len(task.Plugins()) > 0 {
list = strings.Join(task.Plugins(), ",")
}
var names []string
for _, s := range strings.Split(list, ",") {
if s = strings.TrimSpace(s); s != "" {
names = append(names, s)
}
}
log.Printf("[homed] failback boot: plugin allowlist = %v (parsed before assembly)", names)
return names
}
// applyFailbackPluginAllowlist 在 **failback 受限启动**下设置插件白名单。
//
// ## ★ 必须在插件被拉起**之前**生效
//
// failback 是内核的受限恢复模式:只加载少量插件(webui/pluginmgr/recoverydiag)
// 以便直接产出恢复结论。白名单由 `guard.yaml` 的 recovery 任务或配置决定。
//
// 现在插件拉起由 plugin-host 模块负责,而它在装配期跑 ⇒ 本函数必须在
// **装配之前**被调用(main 里已如此安排)。
//
// 非 failback 模式:本函数什么都不做(普通启动不设白名单)。
func applyFailbackPluginAllowlist(cfgReg *internalConfig.ConfigRegistry,
pluginReg *plugin.Registry, bootMode, dataDir string) {
if bootMode != "failback" || pluginReg == nil {
return
}
list := cfgReg.GetString("core.agent.failback_plugins", "webui,pluginmgr,recoverydiag")
// 优先使用 guard.yaml 经 recovery 任务下发的插件集(guard 是 failback 权威)
if task, terr := recovery.LoadTask(recovery.TaskPath(dataDir)); terr == nil && len(task.Plugins()) > 0 {
list = strings.Join(task.Plugins(), ",")
}
var names []string
for _, s := range strings.Split(list, ",") {
if s = strings.TrimSpace(s); s != "" {
names = append(names, s)
}
}
pluginReg.SetLoadAllowlist(names)
log.Printf("[homed] failback boot: plugin allowlist = %v", names)
}