Struct Cap 

pub struct Cap;

Capability Registry 全局 facade，对齐 Ai facade 模式。

使用 OnceLock<CapInstance> 全局单例，所有静态方法通过 instance() 获取后委托给内部 CapabilityRegistry。

使用方式

use sz_rust_capability::Cap;

Cap::init().ok(); // 初始化（仅需一次）
let metrics = Cap::metrics().unwrap();

Implementations

impl Cap

pub fn init_with(registry: Arc<CapabilityRegistry>) -> CapResult<()>

使用外部 registry 初始化全局 facade（与调用方共享同一实例）

业务应用（如 sz300）持有自己的 Arc<CapabilityRegistry> 用于注入 AppState 时，应使用本方法而非 Cap::init——否则全局 facade 与 应用局部 registry 是两个独立实例，Cap::register 注册的能力 无法被业务 handler 访问（2026-08-15 双实例缺陷修复）。

pub fn init() -> CapResult<()>

pub fn is_initialized() -> bool

pub fn register( cap: Arc<dyn Capability>, ) -> CapResult<Option<Arc<dyn Capability>>>

pub fn unregister(name: &str) -> CapResult<Option<Arc<dyn Capability>>>

pub fn get(name: &str) -> CapResult<Option<Arc<dyn Capability>>>

pub fn find_by_tags( tags: &[&str], source: Option<CapabilitySource>, ) -> CapResult<Vec<Arc<dyn Capability>>>

pub fn search(query: &str) -> CapResult<Vec<Arc<dyn Capability>>>

pub fn list_all() -> CapResult<Vec<Arc<dyn Capability>>>

pub fn list_by_source( source: CapabilitySource, ) -> CapResult<Vec<Arc<dyn Capability>>>

pub async fn call(name: &str, args: Value) -> CapResult<Value>

pub async fn call_with_tenant( name: &str, args: Value, tenant_id: i64, ) -> CapResult<Value>

调用能力，携带租户上下文用于权限检查。

pub fn set_permission_checker( checker: Arc<dyn PermissionChecker>, ) -> CapResult<()>

设置权限检查器。

pub fn metrics() -> CapResult<CapMetrics>

pub fn len() -> CapResult<usize>

pub fn is_empty() -> CapResult<bool>