mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-10-04 00:03:59 +00:00
fix(proc): 子进程崩溃自愈 + 集中台账 + 注册面摘除
根因:子进程插件被 kill 后,内核只发了一个无人订阅的事件, 工具/stage handler/IO 通道全留在注册表里指向死进程, 模型继续调用只吃 ErrProcessExited,没有任何路径把插件拉回来。 ## 四层修复 ### 1. 专职 waitLoop(进程收割) - 每个子进程配一根 waitLoop goroutine,是 cmd.Wait() 的唯一调用点 - 不再依赖 stdout EOF 判定死亡(孙子进程继承 stdout 时 EOF 永不到来) - 手工 os.Pipe 替代 cmd.StdinPipe/StdoutPipe,避免 waitLoop 与 os/exec 的内部关闭竞争 - host.go: Host.Supervisor(),Host.Close() 先 StopAll 再拆段 ### 2. 集中台账 Supervisor - proc/supervisor.go: 插件 Spawn 握手成功即 track,进程退出即 untrack - StopAll: 并发发 plugin.stop 走优雅路径,到期仍在的一律 Kill - 关停后才完成握手的进程被立即结束,不会活过内核 - 消除「孤儿进程持共享段映射 → SIGBUS」的隐患 ### 3. 注册面摘除(detachPlugin) - 新增 StageHost.UnregisterPluginStages:摘除指定插件的全部 stage handler - 新增 Registry.pluginChannels 台账:记录每个插件注册的 IO 通道 - 三条路径统一走 detachPlugin:Disable / ReloadOne / RemovePlugin - StopAndUnload 漏了 IO 通道也一并补上 ### 4. 自动重启 - onProcCrash 从「只发事件」改为「摘注册面 → 从注册表移除 → 异步排重启」 - scheduleProcRestart: 窗口 5 分钟内最多 3 次,线性退避 1s/2s/3s - 超限停手留日志;重启前复核是否已被 Disable 或被其他路径加载 - 崩溃计数窗口过期自动归零 ### 5. 主动停止 vs 崩溃的区分 - proc.Plugin 新增 stopping 标志:Stop()/Close() 里 Set(true) - handleExit 读 stopping 标志,主动停止不上报 onCrash - 防止重载/禁用/卸载被误判为崩溃触发多余重启 ### 6. Linux Pdeathsig 兜底 - procattr_linux.go: SysProcAttr.Pdeathsig = SIGKILL - 兜 homed 自身被 SIGKILL/OOM 时子进程变孤儿的场景 - macOS/Windows 无等价物,空实现 ### 7. pluginmgr 升级 - PluginManager 接口新增 PluginRuntime / ListPluginRuntimes - plugin_list 输出运行态:loaded / alive / pid / crash_count / channel - 新增 plugin_status: 全量运行期快照 + dead/unhealthy 汇总 - 新增 plugin_restart: 无条件重启单个插件(plgreload 不动未改二进制的插件) ### 测试 - process_test.go: 3 例(grandchild stdout 感知 / Supervisor track-untrack / StopAll 无孤儿) - crash_recovery_test.go: 8 例(detach 三项齐全 / 通道重注册 / 崩溃不阻塞 / 退避阈值 / 窗口过期 / 关停中跳过 / PluginRuntime 通道识别) - stages_plugin_test.go: 4 例(stage 按插件摘除 / 空 stage 清理 / 空名 no-op / 工具+stage 双摘后可重新注册同名)
This commit is contained in:
@ -65,6 +65,34 @@ type PluginMeta struct {
|
||||
NameEn string `json:"name_en"`
|
||||
}
|
||||
|
||||
// PluginRuntimeInfo 是插件的**运行期**状态,与 plugin.json 里的静态元数据相对。
|
||||
//
|
||||
// 为何需要:子进程插件的进程可能已经死了而注册表里还有条目(或反过来,
|
||||
// 崩溃摘除后注册表已无条目但目录还在)。此前 plugin_list / GET /plugins
|
||||
// 只读 plugin.json,无论插件死活都返回同一份内容——WebUI 与模型都看不出
|
||||
// 「已安装」与「正在运行」的区别,插件被 kill 后只表现为工具静默失败。
|
||||
type PluginRuntimeInfo struct {
|
||||
Name string `json:"name"`
|
||||
// Loaded 表示注册表中存在该插件实例。
|
||||
Loaded bool `json:"loaded"`
|
||||
// Disabled 表示插件被显式禁用(不该运行)。
|
||||
Disabled bool `json:"disabled"`
|
||||
// Builtin 表示编译期内置插件(无独立进程)。
|
||||
Builtin bool `json:"builtin"`
|
||||
// Channel 是加载通道:proc(子进程)/ lua / builtin。
|
||||
Channel string `json:"channel"`
|
||||
// PID 是子进程插件的进程号;非子进程或已退出为 0。
|
||||
PID int `json:"pid"`
|
||||
// Alive 表示子进程仍存活;非子进程插件与 Loaded 同值。
|
||||
Alive bool `json:"alive"`
|
||||
// CrashCount 是最近窗口内的崩溃次数(0 表示健康)。
|
||||
CrashCount int `json:"crash_count"`
|
||||
// AutoRestart 表示崩溃后内核是否会自动拉起。
|
||||
AutoRestart bool `json:"auto_restart"`
|
||||
// Tools 是该插件当前注册在内核里的工具名。
|
||||
Tools []string `json:"tools,omitempty"`
|
||||
}
|
||||
|
||||
type PluginManager interface {
|
||||
ListLoadedPlugins() []string
|
||||
ListDisabledPlugins() []DisabledPluginInfo
|
||||
@ -86,6 +114,11 @@ type PluginManager interface {
|
||||
ReloadOne(name string) error
|
||||
PluginMetas() map[string]PluginMeta
|
||||
PluginDir() string
|
||||
// PluginRuntime 返回单个插件的运行期状态(进程存活 / PID / 崩溃计数)。
|
||||
// 未安装的插件返回零值 + false。
|
||||
PluginRuntime(name string) (PluginRuntimeInfo, bool)
|
||||
// ListPluginRuntimes 返回全部已加载插件的运行期状态。
|
||||
ListPluginRuntimes() []PluginRuntimeInfo
|
||||
}
|
||||
|
||||
type PluginSDK struct {
|
||||
|
||||
Reference in New Issue
Block a user