mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-05 16:57:32 +00:00
refactor(kernel): 统一挂载点 kstate + 插件声明式系统提示词段
## 起因（生产故障）
A2A 分诊助手（驻留子）把 terminal_create 当一次性命令执行器：
terminal_create(command='cd /usr/lib/node_modules/@deepseek-ai && ls -d */ | head -60 && …')
→ read /dev/ptmx: input/output error
→ 再开 term_7、term_8、term_9 …
链路拆开四层：
① cmd 插件 auto_start=false ⇒ 工具表里没有 cmd_run
② 需要 cmd-tools skill 说明"先 plugin_start cmd"
③ 但 skill 索引没进那个 agent 的提示词
④ 因为 skillIndex 只是根 agent 的字段、由 bootstrap 手工接线
④ 才是总根。而它之所以必须手工接线：agent/core 读不到内核的共享数据。
## 环的精确形状（实测，非推测）
kernelboot 因为持有 KernelState 而依赖 19 个业务包：
kernelboot ──▶ agent/core ──▶ …
──▶ plugin
──▶ security
──▶ memory / knowledge / text / coldcontext / …
而 kernelboot.go / scheduler.go / funcmodule.go / syncbus.go / lifecycle.go
**一行业务代码都不需要** —— 依赖全在 kernelstate.go 这一个数据文件里。
后果是四个底层包各自造通道：
core → Agent 字段（每种 agent 构造点都要记得传）
plugin → 12 个 SetXxx
sdk → SDKConfig 传参
security → 包级单例 Global() / RuntimeGlobal() / ConfigCodec()
四条通道是同一个根因的四个表现。
## 本次做的事
### 1. 抽出 internal/kstate（断环）
kernelstate.go / syncbus.go / lifecycle.go 搬出 kernelboot：
internal/kstate 纯数据 + 唯一挂载点（叶子，谁都能 import）
internal/kernelboot 装配引擎，零业务包
挂载点 API：Mount / Get（nil 安全）/ MountForTest（返回 restore，并行测试隔离）。
验证：core 现在能 import kstate（此前 import cycle not allowed）。
### 2. StageHost / Agent 字段存 any
它们是 core 自己的类型（core 是环的一极，这是真环）。按用户裁定的方向：
> 是其他包在kstate挂共享内容啊
存 any，消费方断言回具体类型 —— 与本仓既有的 PluginCatalog /
PluginScheduler / UpdateCapabilities 同型。
★ 其余字段保持**具体类型**，没有一律改 any。判据是"它会不会反向依赖
agent/core"：实测 plugin / security / sdk 都不依赖 core，所以它们作为
具体类型不构成环，而类型化字段让"拼错/取错类型"是编译错误（本结构体的
设计原则）。
### 3. 插件声明式系统提示词段
SDK 新增 SystemPromptAPI（见 submodule 提交）。内核侧：
kstate.State.PromptSections *promptsec.Registry ← 唯一事实来源
Agent.renderSystemPrompt() 每轮重建时读它
skillmgr 从"实现 SkillIndexProvider 让内核来问"改为"声明自己的段"：
DeclarePromptSection{Section:"skillmgr.skills", Order:100, Volatile:true}
并挂到全部变更点（启动全扫后、移交事件后、load/unload/create/install/
enable/disable 后、Stop 时撤销）。
### 4. 内核自身的提示词段也走同一管理器
按用户裁定「把现在内核所有 systemprompt 的相关注入都接入到这个统一的
systemprompt 管理器上」，把 buildSystemPrompt 里硬拼的十几块
（人格卡/任务提示词/记忆说明/输出规则/工具目录…）改为声明式：
kernelSections() 当轮计算 → 与插件段按 Order 合并渲染。
顺序由 Order 常量决定，改结构变成调常量而不是挪代码块。
## 判据（均经变异验证）
TestCoreCanImportKstate 真编译探针；环重现则红（实测）
TestKstateDoesNotDependOnCore 静态版，指向具体字段
TestKstateIsLeaf kstate 不得反依赖上层
TestRTChildSeesPromptSections 子 agent 能看到插件段
TestResidentSeesPromptSections 生产实际中招的那一类；变异后红（实测）
TestRootAgentSeesPromptSections 确认没改坏根路径
TestNoPromptSectionsMount 未装配时不 panic、不凭空出现段
TestDeclareTwiceRendersOnce ★ 回应"会不会多份"：声明 5 次渲染 1 份
TestSectionRemovalTakesEffect Stop 后段消失
TestRuntimeUpdateVisibleToExistingAgent 同一实例下一轮看到新内容
TestSectionOrderIsRespected Order 生效且稳定
## 验证
go build ./... PASS
go vet ./... PASS
gofmt -l internal/ cmd/ pkg/ 干净
go test ./... -count=1 63 包全过，0 FAIL
干净检出（git worktree） build + 4 包测试全绿
## 未做（见 kernelplan.md）
T3 security 三单例收敛（含 Store 复用 Codec 的惰性迁移）
T5 plugin Setter 收敛
T6 防腐判据（部分已随本次落地）
This commit is contained in:
JianFeeeee
@ -131,6 +131,7 @@ package all
|
||||
// 源码怎么组织都无所谓 —— 只认"装配起来之后发生了什么"。
|
||||
|
||||
import (
|
||||
"github.com/JianFeeeee/HologramAgent/internal/kstate"
|
||||
"go/ast"
|
||||
"go/parser"
|
||||
"go/token"
|
||||
@ -158,8 +159,8 @@ import (
|
||||
// machine 是一台**真实装配起来**的内核（全部模块都是 kernelmod 里的真货）。
|
||||
type machine struct {
|
||||
t *testing.T
|
||||
ks *kernelboot.KernelState
|
||||
bus *kernelboot.SyncBus
|
||||
ks *kstate.State
|
||||
bus *kstate.SyncBus
|
||||
// plan 是真实登记表算出的分层计划（启动图）。
|
||||
plan *kernelboot.Plan
|
||||
// res 是执行结果（层数 / 峰值并发 / 完成顺序）。
|
||||
@ -203,7 +204,7 @@ func bootMachine(t *testing.T) *machine {
|
||||
// （实测：3 轮后 goroutine 数 2→5，逐轮 +1，全部来自 database/sql）。
|
||||
// 关闭点放到 shutdown()（与生产的停机序列同处），并由 machine 保证只关一次。
|
||||
|
||||
ks := kernelboot.NewKernelState()
|
||||
ks := kstate.New()
|
||||
ks.CfgReg = reg
|
||||
ks.DataDir = dir
|
||||
ks.AgentWorkDir = filepath.Join(dir, "agentfs")
|
||||
@ -225,7 +226,7 @@ func bootMachine(t *testing.T) *machine {
|
||||
t.Fatalf("★ 真实登记表算不出启动图（漏挂模块 / 缺依赖 / 环）: %v", err)
|
||||
}
|
||||
|
||||
bus := kernelboot.NewSyncBus()
|
||||
bus := kstate.NewSyncBus()
|
||||
// 与生产 RunKernelModules 同序：先 MarkDeclared（让拼错校验有真相源），
|
||||
// 再 Run（Run 内部还会 MarkDeclared，幂等）。
|
||||
var declared []string
|
||||
@ -869,7 +870,7 @@ func removeAllWithRetry(dir string, tries int) error {
|
||||
// 只读反射（不 Set、不 Interface），用于把"关闭时挂订阅"这种泄漏
|
||||
// 变成可断言的数字。字段名/类型变化时本函数会 fatalf —— 那是判据
|
||||
// 失去观测点，必须显式修，不能静默变成 0。
|
||||
func countBusSubscribers(t *testing.T, bus *kernelboot.SyncBus) int {
|
||||
func countBusSubscribers(t *testing.T, bus *kstate.SyncBus) int {
|
||||
t.Helper()
|
||||
if bus == nil {
|
||||
return 0
|
||||
|
||||
@ -26,6 +26,7 @@ package all
|
||||
|
||||
import (
|
||||
"errors"
|
||||
"github.com/JianFeeeee/HologramAgent/internal/kstate"
|
||||
"path/filepath"
|
||||
"strings"
|
||||
"testing"
|
||||
@ -68,10 +69,10 @@ func layerNames(layer []kernelboot.Module) []string {
|
||||
// 变异，模块会真的跑到写盘那一行。不填的话 text-memory 会往**仓内**
|
||||
// 当前目录下的 memory/text 写（实测产生过 internal/kernelmod/all/memory/）。
|
||||
// 夹具不能往仓库里漏文件。
|
||||
func emptyState(t *testing.T) *kernelboot.KernelState {
|
||||
func emptyState(t *testing.T) *kstate.State {
|
||||
t.Helper()
|
||||
dir := t.TempDir()
|
||||
ks := kernelboot.NewKernelState()
|
||||
ks := kstate.New()
|
||||
ks.Cfg = &types.Config{}
|
||||
ks.Cfg.Daemon.DataDir = dir
|
||||
ks.Cfg.Plugin.Dir = filepath.Join(dir, "plugins")
|
||||
|
||||
@ -27,6 +27,9 @@ package all
|
||||
|
||||
import (
|
||||
"strings"
|
||||
|
||||
agentCore "github.com/JianFeeeee/HologramAgent/internal/agent/core"
|
||||
"github.com/JianFeeeee/HologramAgent/internal/kstate"
|
||||
"testing"
|
||||
|
||||
agentcore "github.com/JianFeeeee/HologramAgent/internal/agent/core"
|
||||
@ -118,7 +121,13 @@ func TestAgentAssemblyWiresSecurity(t *testing.T) {
|
||||
const deniedTool = "boot_probe_denied_tool"
|
||||
|
||||
// ① 先证明这个工具名**没被注册**（否则下面"not permitted"可能来自别处）。
|
||||
out, _ := ks.Agent.ExecuteTool(deniedTool, nil)
|
||||
// ks.Agent 在挂载点里存 any（kstate 不能依赖 agent/core，否则成环）。
|
||||
// 本判据要真实执行工具，断言回具体类型。
|
||||
agentImpl, _ := ks.Agent.(*agentCore.Agent)
|
||||
if agentImpl == nil {
|
||||
t.Fatal("ks.Agent 不是 *agentCore.Agent")
|
||||
}
|
||||
out, _ := agentImpl.ExecuteTool(deniedTool, nil)
|
||||
if strings.Contains(out, "not permitted") {
|
||||
t.Fatalf("前置不成立：未配黑名单时就已被拒（%q）—— 检查环境里的实际策略", out)
|
||||
}
|
||||
@ -127,7 +136,7 @@ func TestAgentAssemblyWiresSecurity(t *testing.T) {
|
||||
// 如果 Agent 里拿的是另一个实例（或 nil），它看不到这条 ⇒ 判据红。
|
||||
ks.Security.SetPolicy(security.Policy{ToolDeny: []string{deniedTool}})
|
||||
|
||||
out, _ = ks.Agent.ExecuteTool(deniedTool, nil)
|
||||
out, _ = agentImpl.ExecuteTool(deniedTool, nil)
|
||||
if !strings.Contains(out, "not permitted") {
|
||||
t.Fatalf("★ 已给 ks.Security 配 %q 黑名单，Agent 的执行链却没拦住（实际返回 %q）。\n"+
|
||||
" 可能原因（按概率）：\n"+
|
||||
@ -140,7 +149,7 @@ func TestAgentAssemblyWiresSecurity(t *testing.T) {
|
||||
|
||||
// ③ 反向：未命中的工具必须放行。
|
||||
// 否则是"全拒"型假绿（闸门写死了），而不是接线正确。
|
||||
if out, _ := ks.Agent.ExecuteTool("boot_probe_unlisted_tool", nil); strings.Contains(out, "not permitted") {
|
||||
if out, _ := agentImpl.ExecuteTool("boot_probe_unlisted_tool", nil); strings.Contains(out, "not permitted") {
|
||||
t.Fatalf("未命中黑名单的工具被误拒（%q）—— 判定逻辑坏了，不是接线问题", out)
|
||||
}
|
||||
}
|
||||
@ -182,7 +191,7 @@ func TestAgentAssemblyRefusesNilSecurity(t *testing.T) {
|
||||
//
|
||||
// 为什么这样做而不是直接用 base：Init 成功时会覆盖 base.Agent，
|
||||
// 破坏后续判据的上下文。新建一份是干净的。
|
||||
var probe kernelboot.KernelState
|
||||
var probe kstate.State
|
||||
probe.Cfg = base.Cfg
|
||||
probe.CfgReg = base.CfgReg
|
||||
probe.DataDir = base.DataDir
|
||||
|
||||
Reference in New Issue
Block a user