jianf/HomeAgent
1
0
Fork 0
mirror of https://gitcode.com/JianFeeeee/HomeAgent.git synced 2026-11-06 01:07:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

refactor(kernel): 统一挂载点 kstate + 插件声明式系统提示词段

Browse Source 
## 起因（生产故障）

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
2026-11-04 11:23:05 +08:00
parent 387ae945df
commit cc0eb51286
63 changed files with 1734 additions and 494 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
internal/kernelmod/agent/mod.go
View File

@ -13,6 +13,7 @@ package agent
import (
"fmt"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"log"
"path/filepath"
"strings"
@ -21,7 +22,6 @@ import (
agentCore "github.com/JianFeeeee/HologramAgent/internal/agent/core"
"github.com/JianFeeeee/HologramAgent/internal/config"
"github.com/JianFeeeee/HologramAgent/internal/events"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/memory"
"github.com/JianFeeeee/HologramAgent/pkg/types"
@ -58,7 +58,7 @@ func (Module) Requires() []string {
}
func (Module) Provides() []string { return []string{kernelmod.FacAgent} }
func (Module) Init(k *kernelboot.KernelState) error {
func (Module) Init(k *kstate.State) error {
if k.Memory == nil {
return errMissing("agent", kernelmod.FacMemory)
}
@ -99,7 +99,7 @@ Answer only from what the tools actually return. If something could not be retri
Reply in natural language, like a person talking: do not enumerate which tools you called, their parameters, or timings unless the user explicitly asks. For how to address the user and what tone to use, see [Persona].`
func buildAgent(k *kernelboot.KernelState) *agentCore.Agent {
func buildAgent(k *kstate.State) *agentCore.Agent {
cfg := k.Cfg
cfgReg := k.CfgReg
provider := k.LLMProvider
@ -117,7 +117,9 @@ func buildAgent(k *kernelboot.KernelState) *agentCore.Agent {
multimodalSpace := k.MultimodalSpace
mmProviderName := k.MultimodalProviderName
mmErr := k.MultimodalErr
stageHost := k.StageHost
// StageHost 在挂载点里存 any（kstate 不能依赖 agent/core，否则成环），
// 取用处断言回具体类型。装配顺序由依赖图保证（FacStageHost）。
stageHost, _ := k.StageHost.(*agentCore.StageHost)
evBus := k.EventBus
secRT := k.Security
@ -308,8 +310,12 @@ func buildAgent(k *kernelboot.KernelState) *agentCore.Agent {
// pluginhost 同时可能正在加载插件（buildSDK 读 status）⇒ 写读依然并发。
// 所以 registry 侧 Set*/读侧的锁是**真正的修复**，去重只是消除了一处
// 无意义的重复写。两件事都做，缺一不可。
func wirePluginSDK(k *kernelboot.KernelState) {
k.PluginRegistry.SetStatusProvider(k.Agent)
func wirePluginSDK(k *kstate.State) {
// Agent 是本包自己的类型，构造期已知；不走挂载点断言。
a, _ := k.Agent.(*agentCore.Agent)
if a != nil {
k.PluginRegistry.SetStatusProvider(a)
}
}
// loadPersonality 载入人格（原 cmd/homed 的整块平移）。

11
internal/kernelmod/all/bootgraph_test.go
View File

@ -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

5
internal/kernelmod/all/runtime_dep_test.go
View File

@ -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")

17
internal/kernelmod/all/security_wiring_test.go
View File

@ -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

4
internal/kernelmod/config/mod.go
View File

@ -18,8 +18,8 @@ package config
import (
"fmt"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
)
// Module 提供配置快照。
@ -29,7 +29,7 @@ func (Module) Name() string { return "config" }
func (Module) Requires() []string { return nil } // 前提由 Group 0 保证
func (Module) Provides() []string { return []string{kernelmod.FacConfig} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
// ★ 检查而不是假设（用户说的"nil 加读取前检查"）：
// ks.Cfg 为 nil 说明 Group 0 段没跑或顺序错了。响亮报错远好于让后续
// 模块拿到 nil —— 那会在很远的地方变成"模型没有配置"之类的模糊症状。

21
internal/kernelmod/device/mod.go
View File

@ -30,8 +30,8 @@ import (
"github.com/JianFeeeee/HologramAgent/internal/agent/api"
"github.com/JianFeeeee/HologramAgent/internal/events"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
sec "github.com/JianFeeeee/HologramAgent/internal/security"
)
@ -46,9 +46,12 @@ func (Module) Requires() []string {
func (Module) Provides() []string { return []string{kernelmod.FacDevice} }
func (Module) Init(ks *kernelboot.KernelState) error {
if ks.Agent == nil {
return fmt.Errorf("device module: ks.Agent is nil (requires %s)", kernelmod.FacAgent)
func (Module) Init(ks *kstate.State) error {
// Agent 在挂载点里存 any（kstate 不能依赖 agent/core，否则成环）。
// 这里断言成**最小接口**而不是具体类型：device 只需要"能挂数据面"。
host, ok := ks.Agent.(api.DeviceMounter)
if !ok || host == nil {
return fmt.Errorf("device module: ks.Agent is not a DeviceMounter (requires %s)", kernelmod.FacAgent)
}
if ks.Security == nil {
// 安全模块必须已装配（配置关闭时是 Disabled Runtime，**不是** nil）。
@ -57,9 +60,15 @@ func (Module) Init(ks *kernelboot.KernelState) error {
"assembled first (when disabled it installs a Disabled Runtime, not nil)")
}
rt := New(ks.Agent, ks.Security)
// ExecuteTool 面：ToolHost 与 DeviceMounter 是两个不同用途的接口
// （执行 vs 装配），此处两个断言都要成功。
toolHost, ok := ks.Agent.(api.ToolHost)
if !ok || toolHost == nil {
return fmt.Errorf("device module: ks.Agent is not a ToolHost (requires %s)", kernelmod.FacAgent)
}
rt := New(toolHost, ks.Security)
ks.Device = rt
ks.Agent.MountDevice(rt)
host.MountDevice(rt)
if ks.EventBus != nil {
ks.EventBus.Publish(&events.Event{

4
internal/kernelmod/docstore/mod.go
View File

@ -7,8 +7,8 @@ import (
"log"
"path/filepath"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"github.com/JianFeeeee/HologramAgent/internal/memory"
"github.com/JianFeeeee/HologramAgent/internal/memory/coldcontext"
)
@ -20,7 +20,7 @@ func (Module) Name() string { return "doc-store" }
func (Module) Requires() []string { return []string{kernelmod.FacConfig} }
func (Module) Provides() []string { return []string{kernelmod.FacDocStore} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
coldcontextStore := coldcontext.NewStore(
filepath.Join(ks.Cfg.Daemon.DataDir, "memory", "documents"), memory.TokenizeWords)
if err := coldcontextStore.Start(); err != nil {

4
internal/kernelmod/kernelapi/mod.go
View File

@ -12,8 +12,8 @@ import (
agentIO "github.com/JianFeeeee/HologramAgent/internal/agent/io"
"github.com/JianFeeeee/HologramAgent/internal/events"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
)
// Module 提供 IO 抽象层与事件总线。
@ -23,7 +23,7 @@ func (Module) Name() string { return "kernel-api" }
func (Module) Requires() []string { return nil }
func (Module) Provides() []string { return []string{kernelmod.FacKernelIO} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
iom := agentIO.NewIOManager()
evBus := events.NewBus()
log.Printf("[homed] kernel API ready: IOManager + EventBus")

4
internal/kernelmod/knowledge/migration.go
View File

@ -16,8 +16,8 @@ package knowledge
import (
"path/filepath"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
)
// MigrationModule 做知识库目录改名迁移。
@ -27,7 +27,7 @@ func (MigrationModule) Name() string { return "knowledge-migration" }
func (MigrationModule) Requires() []string { return []string{kernelmod.FacConfig} }
func (MigrationModule) Provides() []string { return []string{kernelmod.FacMigrated} }
func (MigrationModule) Init(ks *kernelboot.KernelState) error {
func (MigrationModule) Init(ks *kstate.State) error {
root := filepath.Join(ks.Cfg.Daemon.DataDir, "knowledge")
runKnowledgeMigration(root)
return nil

4
internal/kernelmod/knowledge/store.go
View File

@ -5,9 +5,9 @@ import (
"log"
"path/filepath"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/knowledge"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
)
// StoreModule 提供知识库。
@ -20,7 +20,7 @@ func (StoreModule) Requires() []string {
}
func (StoreModule) Provides() []string { return []string{kernelmod.FacKnowledge} }
func (StoreModule) Init(ks *kernelboot.KernelState) error {
func (StoreModule) Init(ks *kstate.State) error {
ks.Knowledge = knowledge.NewStore(filepath.Join(ks.Cfg.Daemon.DataDir, "knowledge"))
if err := ks.Knowledge.Start(); err != nil {
log.Printf("[homed] warning: knowledge store: %v", err)

4
internal/kernelmod/llm/mod.go
View File

@ -8,8 +8,8 @@ import (
"os"
"github.com/JianFeeeee/HologramAgent/internal/agent/api"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
luapkg "github.com/JianFeeeee/HologramAgent/internal/lua"
"github.com/JianFeeeee/HologramAgent/pkg/types"
)
@ -21,7 +21,7 @@ func (Module) Name() string { return "llm" }
func (Module) Requires() []string { return []string{kernelmod.FacConfig, kernelmod.FacLua} }
func (Module) Provides() []string { return []string{kernelmod.FacLLM} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
// ★ 敏感信息防火模块的装配点。
//
// 原 main 注释："必须在任何 provider 注册之前装配"—— provider 的出向

4
internal/kernelmod/lua/mod.go
View File

@ -7,8 +7,8 @@ import (
"log"
"path/filepath"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
luapkg "github.com/JianFeeeee/HologramAgent/internal/lua"
)
@ -19,7 +19,7 @@ func (Module) Name() string { return "lua" }
func (Module) Requires() []string { return []string{kernelmod.FacConfig} }
func (Module) Provides() []string { return []string{kernelmod.FacLua} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
luaVM := luapkg.NewVM(filepath.Join(ks.Cfg.Daemon.DataDir, "adapters"))
if err := luaVM.Start(); err != nil {
log.Printf("[homed] warning: lua vm init failed: %v", err)

6
internal/kernelmod/memory/distiller_wiring_test.go
View File

@ -20,12 +20,12 @@ package memory
// 判据改为直接跑真实模块（经 kernelboot.Run），确保测的是**真实入口**。
import (
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"os"
"path/filepath"
"testing"
internalConfig "github.com/JianFeeeee/HologramAgent/internal/config"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
)
// ★★★ 判据：模块 Init 返回后蒸馏器**仍在运行**（无 defer Stop 残留）。
@ -38,7 +38,7 @@ func TestMemoryModuleKeepsDistillerRunning(t *testing.T) {
// 而它对 nil 会现在**明确报错**（而不是 panic 在 strings.Split）。
reg := internalConfig.NewConfigRegistry(filepath.Join(dir, "config.db"))
defer reg.Close()
ks := &kernelboot.KernelState{DataDir: dir, CfgReg: reg}
ks := &kstate.State{DataDir: dir, CfgReg: reg}
if err := (Module{}).Init(ks); err != nil {
t.Fatalf("memory 模块 Init: %v", err)
@ -73,7 +73,7 @@ func TestMemoryModuleRegistersCloser(t *testing.T) {
os.MkdirAll(filepath.Join(dir, "memory"), 0o755)
reg := internalConfig.NewConfigRegistry(filepath.Join(dir, "config.db"))
defer reg.Close()
ks := &kernelboot.KernelState{DataDir: dir, CfgReg: reg}
ks := &kstate.State{DataDir: dir, CfgReg: reg}
if err := (Module{}).Init(ks); err != nil {
t.Fatal(err)
}

6
internal/kernelmod/memory/mod.go
View File

@ -18,8 +18,8 @@ import (
"time"
"github.com/JianFeeeee/HologramAgent/internal/config"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"github.com/JianFeeeee/HologramAgent/internal/memory"
"github.com/JianFeeeee/HologramAgent/internal/memory/distill"
"github.com/JianFeeeee/HologramAgent/internal/memory/pipeline"
@ -34,7 +34,7 @@ func (Module) Name() string { return "memory" }
func (Module) Requires() []string { return []string{kernelmod.FacKernelIO} }
func (Module) Provides() []string { return []string{kernelmod.FacMemory} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
// ★ 读取前检查（用户指定的做法："结构体成员初始置 nil 加读取前检查"）。
//
// 为何要检查 CfgReg：它是 **Group 0** 的产物（不由任何调度模块提供），
@ -78,7 +78,7 @@ func (Module) Init(ks *kernelboot.KernelState) error {
distiller.Start()
}
ks.Memory = &kernelboot.MemoryBundle{
ks.Memory = &kstate.MemoryBundle{
DB: memDB,
Indexer: memIdx,
Social: socialStore,

6
internal/kernelmod/memory/nilcheck_test.go
View File

@ -21,13 +21,13 @@ import (
"testing"
internalConfig "github.com/JianFeeeee/HologramAgent/internal/config"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
)
// ★★★ 判据：**CfgReg 为 nil 时给可操作错误，而不是 panic**。
func TestMemoryModuleRejectsNilCfgReg(t *testing.T) {
dir := t.TempDir()
ks := &kernelboot.KernelState{DataDir: dir} // CfgReg 故意为 nil
ks := &kstate.State{DataDir: dir} // CfgReg 故意为 nil
defer func() {
if r := recover(); r != nil {
@ -54,7 +54,7 @@ func TestMemoryModuleRejectsNilCfgReg(t *testing.T) {
func TestMemoryModuleRejectsEmptyDataDir(t *testing.T) {
dir := t.TempDir()
reg := newTestReg(t, dir)
ks := &kernelboot.KernelState{CfgReg: reg} // DataDir 空
ks := &kstate.State{CfgReg: reg} // DataDir 空
err := (Module{}).Init(ks)
if err == nil {

4
internal/kernelmod/migration/mod.go
View File

@ -31,8 +31,8 @@ import (
"sort"
"syscall"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"github.com/JianFeeeee/HologramAgent/internal/systemd"
)
@ -68,7 +68,7 @@ type DirInfo struct {
Kind string `json:"kind"` // data | runtime | optional | mount
}
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
// 体检结果放在 KernelState 上，供工具/WebUI 读（可选能力，nil 安全）
ks.MigrationPreflight = func(target string) (interface{}, error) {
return Preflight(ks.DataDir, target)

4
internal/kernelmod/multimodal/mod.go
View File

@ -7,8 +7,8 @@ import (
"log"
"strings"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"github.com/JianFeeeee/HologramAgent/internal/memory/vector"
"github.com/JianFeeeee/HologramAgent/pkg/embedding"
)
@ -20,7 +20,7 @@ func (Module) Name() string { return "multimodal" }
func (Module) Requires() []string { return []string{kernelmod.FacConfig} }
func (Module) Provides() []string { return []string{kernelmod.FacMultimodal} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
cfgReg := ks.CfgReg
var multimodalSpace vector.MultimodalEmbedder
// 这两个值只用于状态报告（healthcheck_kernel 的 onnx 段）：

4
internal/kernelmod/onnx/mod.go
View File

@ -17,8 +17,8 @@ import (
"log"
"path/filepath"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"github.com/JianFeeeee/HologramAgent/internal/nlp"
)
@ -29,7 +29,7 @@ func (Module) Name() string { return "onnx-parser" }
func (Module) Requires() []string { return []string{kernelmod.FacConfig} }
func (Module) Provides() []string { return []string{kernelmod.FacONNX} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
modelPath := ks.CfgReg.GetString("core.agent.onnx_model_path", "")
onnxParser, err := nlp.NewONNXParser(nlp.ONNXConfig{
ModelPath: modelPath,

7
internal/kernelmod/pluginhost/catalog_test.go
View File

@ -12,6 +12,7 @@ package pluginhost
// ④ 关键顺序：failback 白名单必须在插件拉起前生效
import (
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"go/ast"
"go/parser"
"go/token"
@ -311,8 +312,8 @@ func TestCatalogConcurrentRead(t *testing.T) {
// ⇒ 判据：把 typed-nil 传给 Scheduler 前必须已被拦截。
// 这里直接验证**拦截逻辑本身**（不依赖 produciton 装配）。
func TestNilSyncBusDoesNotPanic(t *testing.T) {
var nb *kernelboot.SyncBus // typed-nil
var iface kernelboot.SyncState = nb
var nb *kstate.SyncBus // typed-nil
var iface kstate.SyncState = nb
if iface == nil {
t.Skip("接口就是 nil（不会有陷阱）—— 与本判据的前提不符")
}
@ -378,7 +379,7 @@ func TestUndeclaredPluginsWaitForKernelComplete(t *testing.T) {
t.Fatalf("两个自动启动插件都应进调度器（含**未声明**的），实际 %d 个", len(specs))
}
bus := kernelboot.NewSyncBus()
bus := kstate.NewSyncBus()
bus.MarkDeclared([]string{"config", "agent"})
bus.MarkReady("config")

32
internal/kernelmod/pluginhost/mod.go
View File

@ -2,6 +2,8 @@ package pluginhost
import (
"fmt"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
sdk "github.com/JianFeeeee/HologramAgent/internal/sdk"
"log"
"os"
"path/filepath"
@ -44,7 +46,7 @@ func (Module) Requires() []string {
func (Module) Provides() []string { return []string{FacPlugins} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
// ── 前置检查（用户要求："nil 加读取前检查"）──
if ks.PluginRegistry == nil || ks.StageHost == nil {
return fmt.Errorf("plugin-host：ks.PluginRegistry/StageHost 为 nil —— " +
@ -111,8 +113,8 @@ func (Module) Init(ks *kernelboot.KernelState) error {
//
// 这样声明的插件仍在依赖就绪时尽早启动（本步的核心收益不变），
// 而未声明的**恢复原行为**（等内核完全初始化）。
var bus kernelboot.SyncState
var busConcrete *kernelboot.SyncBus // 保留具体类型以便订阅 OnUpdate
var bus kstate.SyncState
var busConcrete *kstate.SyncBus // 保留具体类型以便订阅 OnUpdate
if ks.SyncBus != nil {
bus = ks.SyncBus
busConcrete = ks.SyncBus
@ -122,7 +124,7 @@ func (Module) Init(ks *kernelboot.KernelState) error {
// 所以这里必须显式判 `!= nil` 再赋给接口变量。
log.Printf("[pluginhost] warning: SyncBus is nil -- non-production assembly path, " +
"退化为立即加载（依赖未就绪的插件在 Start 时自行处理）")
fallback := kernelboot.NewSyncBus()
fallback := kstate.NewSyncBus()
fallback.MarkKernelComplete()
bus = fallback
busConcrete = fallback
@ -172,7 +174,7 @@ func (Module) Init(ks *kernelboot.KernelState) error {
// 不在 catalog 里，只有 LoadSkipping 的工厂分支能加载它们）。
skip := buildSkipSet(catalog, groups)
var loadOnce sync.Once
loadRest := func(st kernelboot.SyncState) {
loadRest := func(st kstate.SyncState) {
if !st.KernelComplete() {
return
}
@ -296,7 +298,7 @@ func buildSkipSet(c *PluginCatalog, g formGroups) map[string]bool {
// ★ 这里**刻意不做** SetStatusProvider —— 它依赖 agent，
// 由 agent 模块**后补注入**（见其注释）。这不是遗漏，是有意的分层：
// 让插件加载不必等 agent 那 35 秒。
func injectBaseDeps(ks *kernelboot.KernelState) {
func injectBaseDeps(ks *kstate.State) {
reg := ks.PluginRegistry
reg.SetLuaVM(ks.LuaVM)
reg.SetBaseAPIKey(ks.BaseAPIKey)
@ -305,7 +307,17 @@ func injectBaseDeps(ks *kernelboot.KernelState) {
}
reg.SetTracker(ks.Tracker)
reg.SetConfig(ks.Cfg)
reg.SetStageHost(ks.StageHost)
// StageHost 在挂载点里存 any（kstate 不依赖 agent/core，否则成环）。
// 断言成 sdk.ToolSource（plugin 真正需要的只读工具视图）。
//
// 断言失败时**不静默跳过**：SetStageHost 不设的后果是插件加载后
// 工具表为空，而那与"插件没注册工具"无法区分。所以这里响亮记录。
// （Init 里已检查过 StageHost != nil，此处失败是类型不合约，属装配缺陷。）
if ts, ok := ks.StageHost.(sdk.ToolSource); ok && ts != nil {
reg.SetStageHost(ts)
} else {
log.Printf("[plugin-host] WARNING: ks.StageHost 未实现 sdk.ToolSource —— 插件工具将不可见")
}
if ks.Memory != nil {
reg.SetIndexer(ks.Memory.Indexer)
@ -350,7 +362,7 @@ func classify(c *PluginCatalog) formGroups {
}
// loadOne 加载单个插件（走既有 LoadOneDir 路径，不绕过任何机制）。
func loadOne(ks *kernelboot.KernelState, dir, name string) (bool, error) {
func loadOne(ks *kstate.State, dir, name string) (bool, error) {
if err := ks.PluginRegistry.LoadOneDir(filepath.Join(dir, name), name); err != nil {
return false, err
}
@ -358,7 +370,7 @@ func loadOne(ks *kernelboot.KernelState, dir, name string) (bool, error) {
}
// planCatalog 取元数据缓存（类型断言集中一处，便于排查"缓存没建起来"）。
func planCatalog(ks *kernelboot.KernelState) *PluginCatalog {
func planCatalog(ks *kstate.State) *PluginCatalog {
c, _ := ks.PluginCatalog.(*PluginCatalog)
return c
}
@ -368,7 +380,7 @@ func planCatalog(ks *kernelboot.KernelState) *PluginCatalog {
// 失败只记日志、不阻断：系统本身仍可正常接受输入，只是依赖本事件的
// 订阅者（如 seq 的开机序列）不会自动执行。**必须可见** ——
// 静默失败会让"为什么开机序列没跑"完全无从查起。
func publishToolsReady(ks *kernelboot.KernelState) {
func publishToolsReady(ks *kstate.State) {
if ks == nil || ks.EventBus == nil {
log.Printf("[pluginhost] tools_ready NOT published: EventBus is nil " +
"(subscribers such as seq boot sequences will not run)")

6
internal/kernelmod/pluginhost/toolsready_test.go
View File

@ -14,7 +14,7 @@ import (
"testing"
"github.com/JianFeeeee/HologramAgent/internal/events"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
)
// 没有 EventBus 时必须**响亮报错而不是静默返回** ——
@ -26,7 +26,7 @@ func TestPublishToolsReadyWithoutBusDoesNotPanic(t *testing.T) {
}
}()
publishToolsReady(nil)
publishToolsReady(&kernelboot.KernelState{})
publishToolsReady(&kstate.State{})
}
// 有 EventBus 时必须真的发布一条 tools_ready，且带 plugin_count。
@ -35,7 +35,7 @@ func TestPublishToolsReadyPublishes(t *testing.T) {
var got []*events.Event
bus.Subscribe(events.EventToolsReady, func(e *events.Event) { got = append(got, e) })
ks := &kernelboot.KernelState{EventBus: bus}
ks := &kstate.State{EventBus: bus}
publishToolsReady(ks)
if len(got) != 1 {

4
internal/kernelmod/security/mod.go
View File

@ -39,8 +39,8 @@ import (
"github.com/JianFeeeee/HologramAgent/internal/config"
"github.com/JianFeeeee/HologramAgent/internal/events"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
sec "github.com/JianFeeeee/HologramAgent/internal/security"
)
@ -51,7 +51,7 @@ func (Module) Name() string { return "security" }
func (Module) Requires() []string { return []string{kernelmod.FacConfig} }
func (Module) Provides() []string { return []string{kernelmod.FacSecurity} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
if ks.DataDir == "" {
return fmt.Errorf("security module: ks.DataDir is empty - Group 0 must set the data dir first")
}

12
internal/kernelmod/stagehost/mod.go
View File

@ -16,11 +16,12 @@ import (
"github.com/JianFeeeee/HologramAgent/internal/config"
agentCore "github.com/JianFeeeee/HologramAgent/internal/agent/core"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"github.com/JianFeeeee/HologramAgent/internal/plugin"
cli "github.com/JianFeeeee/HologramAgent/internal/plugins/cli"
webui "github.com/JianFeeeee/HologramAgent/internal/plugins/webui"
"github.com/JianFeeeee/HologramAgent/internal/promptsec"
"github.com/JianFeeeee/HologramAgent/internal/sdk"
)
@ -34,9 +35,16 @@ func (Module) Requires() []string {
}
func (Module) Provides() []string { return []string{kernelmod.FacStageHost} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
stageHost := agentCore.NewStageHost()
// 插件声明式系统提示词段的注册表：本模块产出，挂到内核挂载点。
//
// ★ 不往下传参：读方（agent 模块、SDK）自己去 ks 取 ——
// 与 StageHost / PluginRegistry 完全同型。往构造点传指针会让
// "记得接这一根线"成为每种 agent 类型的义务（那正是之前的老毛病）。
ks.PromptSections = promptsec.NewRegistry()
pluginReg := plugin.NewRegistry()
pluginReg.SetIOManager(ks.IO)
pluginReg.SetEventBus(ks.EventBus)

4
internal/kernelmod/supervisor/mod.go
View File

@ -8,8 +8,8 @@ package supervisor
import (
"log"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"github.com/JianFeeeee/HologramAgent/internal/supervisor"
)
@ -20,7 +20,7 @@ func (Module) Name() string { return "supervisor" }
func (Module) Requires() []string { return []string{kernelmod.FacConfig} }
func (Module) Provides() []string { return []string{kernelmod.FacSupervisor} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
sup := supervisor.New(ks.Cfg)
if err := sup.Start(); err != nil {
log.Fatalf("start supervisor: %v", err)

4
internal/kernelmod/textmem/mod.go
View File

@ -24,8 +24,8 @@ import (
"log"
"path/filepath"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"github.com/JianFeeeee/HologramAgent/internal/memory/text"
)
@ -40,7 +40,7 @@ func (Module) Requires() []string {
}
func (Module) Provides() []string { return []string{kernelmod.FacTextMem} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
textMem := text.New(filepath.Join(ks.Cfg.Daemon.DataDir, "memory", "text"))
if err := textMem.Start(); err != nil {
log.Printf("[homed] warning: text memory start: %v", err)

4
internal/kernelmod/tracker/mod.go
View File

@ -8,8 +8,8 @@ import (
"log"
"time"
"github.com/JianFeeeee/HologramAgent/internal/kernelboot"
"github.com/JianFeeeee/HologramAgent/internal/kernelmod"
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"github.com/JianFeeeee/HologramAgent/internal/tracker"
)
@ -20,7 +20,7 @@ func (Module) Name() string { return "tracker" }
func (Module) Requires() []string { return []string{kernelmod.FacConfig} }
func (Module) Provides() []string { return []string{kernelmod.FacTracker} }
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
trk := tracker.NewTracker(ks.Cfg.Daemon.DataDir, ks.AgentWorkDir,
tracker.WithKeepChangesets(100),
tracker.WithMaxChangesetAge(30*24*time.Hour),

3
internal/kernelmod/update/mod.go
View File

@ -18,6 +18,7 @@
package update
import (
"github.com/JianFeeeee/HologramAgent/internal/kstate"
"log"
"path/filepath"
@ -41,7 +42,7 @@ func (Module) Requires() []string { return nil } // 第 0 层：不依赖任何
func (Module) Provides() []string { return []string{FacilityVersion} }
// Init 执行版本自检，必要时回滚上一次升级。
func (Module) Init(ks *kernelboot.KernelState) error {
func (Module) Init(ks *kstate.State) error {
// ⓪ 把内核**真实**的 dataDir 注入 update 包。
//
// 必须最先做：pending 标记/备份/回滚验全都靠它。进程内调用方