Struct HostProxy 

pub struct HostProxy { /* private fields */ }

Proxy for calling host-side APIs from a plugin subprocess. Does NOT access stdin/stdout directly — uses channel-based I/O.

Implementations

impl HostProxy

pub fn new( pending: Arc<DashMap<u64, Sender<Result<Value, JsonRpcError>>>>, outbound_tx: Sender<Vec<u8>>, ) -> Self

pub async fn log(&self, level: &str, message: &str) -> Result<(), String>

pub fn log_no_wait(&self, level: &str, message: &str)

发送 host/log 请求但不等待响应（fire-and-forget）。

pending 条目在宿主响应到达时由 read_task 自动清理。 若 outbound 通道已满，日志被静默丢弃并从 pending 中移除， 避免阻塞调用者（通常来自 tracing subscriber 的回调）。

pub async fn shell_open(&self, target: &str) -> Result<(), String>

pub async fn get_icon(&self, path: &str) -> Result<String, String>

获取图标字节（base64 字符串）。 返回：图标字节的 base64（WebP，回退可能为 PNG）；失败为空字符串。

pub async fn shell_execute_command(&self, cmd: &str) -> Result<(), String>

pub async fn shell_open_folder(&self, path: &str) -> Result<(), String>

pub async fn shell_execute_elevation(&self, path: &str) -> Result<(), String>

pub async fn notify(&self, title: &str, message: &str) -> Result<(), String>

pub async fn get_locale(&self) -> Result<String, String>

获取宿主当前界面语言（如 “zh-Hans”），供插件生成本地化文本。

pub async fn get_theme(&self) -> Result<String, String>

查询宿主当前实际生效主题，返回 light 或 dark。

pub async fn model_list(&self) -> Result<Vec<ModelInfo>, String>

全网模型清单（聚合所有提供方）。

pub async fn model_chat( &self, req: ModelChatRequest, ) -> Result<ModelChatResponse, String>

按 model_id 调用文本生成。

pub async fn model_embedding( &self, req: ModelEmbeddingRequest, ) -> Result<ModelEmbeddingResponse, String>

按 model_id 调用文本向量化（task_type 必填，宿主对缺失/未知值返回错误）。

pub async fn model_similarity( &self, req: ModelSimilarityRequest, ) -> Result<ModelSimilarityResponse, String>

按 model_id 计算查询向量与多个目标向量的相似度。

pub async fn enumerate_apps(&self) -> Result<Value, String>

pub async fn resolve_path(&self, kind: &str) -> Result<String, String>

pub async fn resource_upload( &self, resource_id: &str, file_path: &str, max_size: Option<u64>, ) -> Result<String, String>

上传插件本地文件到宿主资源空间。 直接传递文件路径，由宿主负责读取。

pub async fn resource_get(&self, resource_id: &str) -> Result<Vec<u8>, String>

pub async fn resource_put( &self, resource_id: &str, data: &[u8], ) -> Result<(), String>

直接写入资源字节数据（无需临时文件），base64 编解码由 SDK 内部处理。

pub async fn resource_delete(&self, resource_id: &str) -> Result<(), String>

删除资源文件。

pub async fn resource_list(&self) -> Result<Vec<String>, String>

列出本插件的所有资源标识符。