AstrBot/openspec/changes/abp-plugin-loader/tasks.md

1. PluginLoader Trait & Python 聚合层

架构边界：核心加载逻辑在 Rust FFI，Python 胶水层仅做类型转换和聚合

• 1.1 Define PluginLoader abstract base class in astrbot/_internal/protocols/abp/loader.py
• 1.2 Define PluginInstance dataclass (plugin_id, instance, metadata)
• 1.3 Define PluginRegistry class in astrbot/_internal/protocols/abp/registry.py (Python 聚合层，调用 Rust FFI)
• 1.4 Add register() and unregister() methods to PluginRegistry
• 1.5 Add load_plugin() / unload_plugin() wrapper calling Rust FFI

2. Tool Discovery & Registry

架构边界：tool_router.rs 核心在 Rust，Python 层仅做聚合和转发

• 2.1 Create astrbot/_internal/protocols/abp/tool_registry.py
• 2.2 Implement ToolDef dataclass (name, description, parameters schema)
• 2.3 Implement ToolRegistry.register(plugin_id, tools) with Schema validation (Python)
• 2.4 Implement ToolRegistry.list_tools() (aggregate all plugins via Rust FFI list_tools())
• 2.5 Implement ToolRegistry.call_tool(tool_name, args) (delegate to Rust FFI route_tool_call())
• 2.6 Implement tools/list JSON-RPC endpoint in plugin base class
• 2.7 Add JSON Schema Draft-07 validation (jsonschema library)

3. FFI Bindings

⚠️ 禁止使用 ctypes：所有 FFI 必须通过 PyO3 绑定（rust-ffi.md 规范）

• 3.1 Audit existing _core.pyi for missing ABP types
• 3.2 Add plugin_loader_* FFI function signatures to rust-ffi.md (if missing)
• 3.3 Implement Python → Rust plugin loader calls via PyO3 binding
• 3.4 Add async wrapper using run_in_executor for PyO3 FFI calls
• 3.5 Update astrbot/_internal/protocols/abp/manager.py to use FFI bindings

4. Configuration Integration

• 4.1 Define plugins section in config.yaml schema
• 4.2 Implement PluginConfig dataclass parsing
• 4.3 Integrate PluginRegistry initialization into AstrBot startup
• 4.4 Add connection pooling for Unix Socket transport
• 4.5 Write integration test for config → plugin loading flow

5. Testing

• 5.1 Write unit tests for PluginLoader trait
• 5.2 Write unit tests for Python PluginRegistry (mock Rust FFI)
• 5.3 Write unit tests for ToolRegistry
• 5.4 Write integration tests for plugin loading (requires Rust FFI stub)
• 5.5 Write integration tests for tools/list + tools/call flow
• 5.6 Run ruff check . and ruff format .
• 5.7 Run uvx ty check for type validation