事件（Events）¶
订阅内核事件。注意：外部分布式插件的事件订阅不走 Events()（该接口在外部插件路径上未被注入，恒为 nil），而是由 hmapdev 生成的运行时通过 events.subscribe 完成。详见下方说明。
EventSubscriber¶
EventSubscriber allows plugins to subscribe to kernel events. This is a restricted interface: plugins can subscribe but the kernel controls which events are delivered.
| 方法 | 说明 |
|---|---|
Subscribe |
EventSubscriber.Subscribe¶
仅内核内置插件可用
plugin.go:526
EventsAPI¶
EventsAPI 是插件可见的事件总线。
它不是 *events.Bus 的投影：这是一个有边界、有审查的接口。
| 方法 | 说明 |
|---|---|
AllowedPublish |
AllowedPublish 返回当前可发布的事件类型（白名单 + 自己的命名空间前缀）。 |
AllowedSubscribe |
AllowedSubscribe 返回当前可订阅的事件类型。 |
Publish |
Publish 发布一个事件。 |
Subscribe |
Subscribe 订阅一个白名单内的事件（只读面）。 |
EventsAPI.AllowedPublish¶
AllowedPublish 返回当前可发布的事件类型（白名单 + 自己的命名空间前缀）。
events.go:43
EventsAPI.AllowedSubscribe¶
AllowedSubscribe 返回当前可订阅的事件类型。
events.go:46
EventsAPI.Publish¶
Publish 发布一个事件。
eventType 必须在白名单内（见 AllowedPublish），或形如 "plugin.<本插件名>.<后缀>"。载荷大小与键数有上限。
events.go:34
EventsAPI.Subscribe¶
Subscribe(eventType string, handler func(payload map[string]interface{})) (cancel func(), err error)
Subscribe 订阅一个白名单内的事件（只读面）。
返回的 cancel 在插件 Stop 时调用可解除订阅；宿主卸载插件时也会自动解除。 handler 的 panic 会被总线隔离，不影响其他订阅者。
events.go:40
Event¶
type Event struct { Type EventType `json:"type"` Source string `json:"source"` Payload map[string]interface{} `json:"payload"` T …
Event represents a system event published by the kernel.
plugin.go:512
EventHandler¶
EventHandler processes a system event.
plugin.go:520
EventNameDeviceReady¶
EventNameDeviceReady：工具/设备数据面就绪（只读订阅）。
events.go:65
EventNameSecurityReady¶
EventNameSecurityReady：安全闸门装配完成（只读订阅）。
events.go:63
EventNameSkillDetected¶
EventNameSkillDetected：兼容层把发现的纯 SKILL 条目交给 skillmgr 接管。 （职责链交接，不是执行指令）
events.go:59
EventNameToolsReady¶
EventNameToolsReady：全部插件加载完、工具注册齐（只读订阅）。
events.go:61
EventType¶
EventType identifies the kind of system event.
plugin.go:494
PluginSDK.Events¶
仅内核内置插件可用
实测全仓 SetEventSubscriber 只有定义、无任何调用点（grep -rn SetEventSubscriber --include=*.go 仅命中 sdk/plugin.go 的定义与 lua_plugin.go 的一句注释）。外部插件拿到的 Events() 恒为 nil。外部插件订阅事件走的是桥接运行时的 events.subscribe RPC（proc_main.go.tmpl:1421 在插件侧分发、内核 protocol.go MethodEventsSubscribe），Lua 插件则走内部 SDK 的 Subscribe。这正是 PLUGIN_DEV.md 里没有说清的一处。
Events returns the event subscriber for listening to kernel events (may be nil if not available).
plugin.go:750