43 lines
1.2 KiB
Python
43 lines
1.2 KiB
Python
"""插件契约与注册表。
|
|
|
|
一切能力插件化（docs/architecture/lingtai-runtime.md §4）：插件只通过订阅瀑布节点
|
|
与提供能力参与运行，彼此不直接调用。M0 只需注册表与装配骨架，首个真实插件（司命
|
|
占位裁决器）随 M5 落地；禁域挂载点在 Kernel，不在插件。
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Protocol, runtime_checkable
|
|
|
|
from app.runtime.bus import WaterfallBus
|
|
|
|
|
|
@runtime_checkable
|
|
class Plugin(Protocol):
|
|
"""插件契约：稳定标识 + 版本 + 注册入口。"""
|
|
|
|
@property
|
|
def name(self) -> str: ...
|
|
|
|
@property
|
|
def version(self) -> str: ...
|
|
|
|
def register(self, bus: WaterfallBus) -> None: ...
|
|
|
|
|
|
class PluginRegistry:
|
|
"""按注册序持有插件；同名插件后注册覆盖前注册（Profile 层叠语义）。"""
|
|
|
|
def __init__(self) -> None:
|
|
self._plugins: dict[str, Plugin] = {}
|
|
|
|
def register(self, plugin: Plugin) -> None:
|
|
self._plugins[plugin.name] = plugin
|
|
|
|
def bootstrap(self, bus: WaterfallBus) -> None:
|
|
for plugin in list(self._plugins.values()):
|
|
plugin.register(bus)
|
|
|
|
def names(self) -> list[str]:
|
|
return list(self._plugins)
|