Update docs: architecture + plugin guide for v0.2.1 enhancements

2026-06-10 13:09:52 +08:00
parent 1cbe52174d
commit 5e23778d90
2 changed files with 90 additions and 2 deletions
@@ -395,4 +395,33 @@ SenSu框架是一个设计精良、功能完整的Python后端框架，具有以
 - 插件化应用的核心引擎
 - 学习和研究现代Python框架设计的优秀案例

-对于想要基于此框架进行开发的开发者，建议从`example_plugin`入手，逐步理解框架的各个组件，然后根据业务需求开发定制插件。
+对于想要基于此框架进行开发的开发者，建议从`example_plugin`入手，逐步理解框架的各个组件，然后根据业务需求开发定制插件。
+---
+
+## 九、v0.2.1 新增：插件系统增强
+
+### 9.1 PluginStatus 枚举 (`fmfuncs/plugin_status.py`)
+统一的插件生命周期状态：
+- `UNLOADED` → `LOADING` → `LOADED` → `INITIALIZING` → `RUNNING`
+- 异常路径: `ERROR`, `STOPPING`, `STOPPED`, `UNLOADING`
+
+### 9.2 PluginError 异常层级 (`fmfuncs/plugin_error.py`)
+```
+PluginError (基础)
+├── PluginLoadError       (加载失败)
+├── PluginConfigError     (配置错误)
+├── PluginPermissionError (权限不足)
+├── PluginCommandError    (命令执行错误)
+└── PluginNetworkError    (网络操作错误)
+```
+
+### 9.3 PluginBridge 新方法
+- `subscribe_plugin(topic, handler, plugin_name)` — 便捷订阅，同时注册到 CoreBridge 和插件订阅表
+
+### 9.4 PluginNetworkBridge 新方法
+- `setup_data_transfer(event_type, handler)` — 跨插件数据传输通道
+- `send_data(target_plugin, event_type, data)` — 向其他插件发送数据
+
+### 9.5 PluginService 增强
+- 配置验证：加载时检查 `name`、`version` 必需字段
+- 状态追踪：`plugin_status` 字典跟踪每个插件的 `PluginStatus`