Module plugin_handle 

Structs

PluginHandle

插件服务句柄（插件接口层）。 绑定插件身份（plugin_id）、配置（PluginSdkConfig）与能力集，并持有宿主操作契约 Arc<dyn PluginHost>；所有服务操作委托宿主执行，宿主内部再决定直接处理或 转发平台实现。插件通过 HostApi::register() 获取此句柄。

Functions

build_cache_path

构建本地缓存文件路径：<cache_root>/<plugin_id>/<domain>/<key>。 校验 domain 与 key（拒绝空串、“.”、“..” 与路径穿越），策略同 build_resource_path。 缓存根目录为宿主 app data 下的 plugin-cache/，不经 StorageService。 供宿主实现 PluginHost 缓存操作时使用。

build_resource_path

构建资源存储路径，校验文件名防止路径遍历攻击。 使用 PathBuf 确保路径构建的安全性。 返回 Unix 风格路径（存储后端约定）。 供宿主实现 PluginHost 资源操作时使用。