Struct RemoteComponent 

pub struct RemoteComponent {
    pub core: ComponentCore,
    pub client: Arc<JsonRpcClient>,
    pub kind: RemoteComponentKind,
    /* private fields */
}

Fields

core: ComponentCore

身份核心。内置插件与远程插件共享同一身份模型。

client: Arc<JsonRpcClient>

kind: RemoteComponentKind

Implementations

impl RemoteComponent

pub fn new( component_id: String, component_name: String, component_description: String, component_type: ComponentType, priority: u32, client: Arc<JsonRpcClient>, schema: Vec<SettingDefinition>, settings: Value, actions: Vec<ConfigActionDef>, default_enabled: bool, kind: RemoteComponentKind, ) -> Self

pub fn as_data_source(self: Arc<Self>) -> Option<Arc<dyn DataSource>>

将自身转换为 DataSource trait object，仅在 kind 为 DataSource 时成功。

pub fn as_action_executor(self: Arc<Self>) -> Option<Arc<dyn ActionExecutor>>

将自身转换为 ActionExecutor trait object，仅在 kind 为 ActionExecutor 时成功。

pub fn as_plugin(self: Arc<Self>) -> Option<Arc<dyn Plugin>>

将自身转换为 Plugin trait object，仅在 kind 为 Plugin 时成功。

pub fn as_search_engine(self: Arc<Self>) -> Option<Arc<dyn SearchEngine>>

将自身转换为 SearchEngine trait object，仅在 kind 为 SearchEngine 时成功。

pub fn as_score_booster(self: Arc<Self>) -> Option<Arc<dyn ScoreBooster>>

将自身转换为 ScoreBooster trait object，仅在 kind 为 ScoreBooster 时成功。

pub fn as_keyword_optimizer( self: Arc<Self>, ) -> Option<Arc<dyn KeywordOptimizer>>

将自身转换为 KeywordOptimizer trait object，仅在 kind 为 KeywordOptimizer 时成功。

pub fn as_keyword_injector(self: Arc<Self>) -> Option<Arc<dyn KeywordInjector>>

将自身转换为 KeywordInjector trait object，仅在 kind 为 KeywordInjector 时成功。

pub fn is_data_source(&self) -> bool

pub fn is_action_executor(&self) -> bool

pub fn is_plugin(&self) -> bool

pub fn is_search_engine(&self) -> bool

是否为搜索引擎组件。

pub fn is_score_booster(&self) -> bool

是否为分数增强器组件。

pub fn is_keyword_optimizer(&self) -> bool

是否为关键词优化器组件。

pub fn is_keyword_injector(&self) -> bool

是否为关键词注入器组件。

Trait Implementations

impl ActionExecutor for RemoteComponent

fn supported_target_types(&self) -> Vec<TargetType>

返回该 Executor 支持的目标类型集合

fn supported_actions(&self) -> Vec<ResultAction>

返回该 Executor 支持的动作列表

fn execute<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, ctx: &'life1 ExecutionContext, action_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<(), ExecutionError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

根据动作 ID 执行对应的操作 参数：ctx - 执行上下文；action_id - 动作 ID 返回：执行成功返回 Ok(())，失败返回 ExecutionError

impl Configurable for RemoteComponent

fn default_enabled(&self) -> bool

默认启用状态来自插件自声明（discover 时经 RPC 拉取），与内置组件一致。

fn core(&self) -> &ComponentCore

返回组件身份核心。

fn setting_schema(&self) -> Vec<SettingDefinition>

返回组件的设置项 schema 定义列表。

fn get_settings(&self) -> Value

获取组件当前的配置值（JSON 格式）。

fn config_actions(&self) -> Vec<ConfigActionDef>

返回该组件支持的配置动作定义列表。 配置动作用于在设置面板中提供一键式辅助操作（如自动检测浏览器）， 前端据此渲染操作按钮，用户点击后通过 execute_config_action 执行。

fn apply_settings<'life0, 'async_trait>( &'life0 self, settings: Value, ) -> Pin<Box<dyn Future<Output = Result<(), ConfigError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

应用配置到组件。 使用 &self 签名，组件内部通过 RwLock 等实现可变性。 async：远端插件（RemoteComponent）实现需经 RPC 下发配置到插件进程。

fn validate_settings<'life0, 'life1, 'async_trait>( &'life0 self, settings: &'life1 Value, ) -> Pin<Box<dyn Future<Output = Result<(), ConfigError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

校验一组配置值是否合法（不会实际应用）。 async：远端插件实现需经 RPC 委托插件进程补充业务校验。

fn execute_config_action<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, action: &'life1 str, params: &'life2 Value, ) -> Pin<Box<dyn Future<Output = Result<Value, String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

执行配置动作。 参数：action - 动作标识符，对应 ConfigActionDef.action。 params - 前端传递的附加参数（如书签文件路径）。 返回：动作执行结果（JSON 格式），由前端根据配置项类型解析并填充。

fn component_id(&self) -> &str

fn component_name(&self) -> &str

fn component_type(&self) -> ComponentType

fn priority(&self) -> u32

组件显示排序优先级，数值越小越靠前。

fn component_description(&self) -> &str

组件的功能描述文本，用于设置面板中向用户解释该组件的用途。

fn settings_contribution(&self) -> Result<SettingsContribution, ConfigError>

将 setting_schema() 的输出编译为 SettingsContribution。

fn get_default_settings(&self) -> Value

fn runtime_state(&self) -> Option<Value>

返回组件运行态快照（非用户配置：不写入 settings、不下发前端、不参与远端配置同步）。

fn restore_runtime_state(&self, state: Value)

从持久化的运行态恢复组件内部状态。

fn on_settings_changed(&self)

impl DataSource for RemoteComponent

fn fetch_candidates<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = CachedCandidateData> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

impl Debug for RemoteComponent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl KeywordInjector for RemoteComponent

fn inject_keywords<'life0, 'life1, 'async_trait>( &'life0 self, candidate: &'life1 SearchCandidate, ) -> Pin<Box<dyn Future<Output = Vec<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

根据候选项的完整上下文注入额外关键字。 与 KeywordOptimizer 不同，此方法可以访问候选项的 target、icon 等完整信息， 用于实现“基于候选身份的关键字注入“（如别名）。

impl KeywordOptimizer for RemoteComponent

fn optimize<'life0, 'life1, 'async_trait>( &'life0 self, keyword: &'life1 str, ) -> Pin<Box<dyn Future<Output = Vec<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn input_source(&self) -> KeywordInputSource

fn get_priority(&self) -> u32

impl Plugin for RemoteComponent

fn interaction_policy(&self) -> PanelInteraction

交互策略：返回查询时刷新的缓存值（与内置每次查询同步求值语义对齐）。 仅 Plugin 组件有策略（kind 已断言为 Plugin）。

fn match_query<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, raw_query: &'life1 str, declared_trigger_keywords: &'life2 [String], ) -> Pin<Box<dyn Future<Output = bool> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

查询匹配：经 RPC 询问插件是否接管当前输入（响应为布尔值）。

超时故意远小于常规 5s 约定——本方法在按键热路径上执行，慢判定直接等于输入延迟。

• 旧 SDK 未实现该方法（METHOD_NOT_FOUND）→ 用同一份框架关键词判定兜底（与改动前行为一致）；
• 其他错误/超时 → 按不命中处理并告警，不阻塞输入。

fn init<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 PluginContext, _handle: Option<Arc<PluginHandle>>, ) -> Pin<Box<dyn Future<Output = Result<(), PluginError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

插件初始化钩子。

fn query<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, ctx: &'life1 PluginContext, query: &'life2 Query, ) -> Pin<Box<dyn Future<Output = Result<QueryResponse, PluginError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

fn execute_action<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, ctx: &'life1 PluginContext, action_id: &'life2 str, payload: Value, ) -> Pin<Box<dyn Future<Output = Result<(), PluginError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

执行插件动作。 action_id 为插件在 ListItem.actions / CustomPanel.actions / 面板按键 绑定中声明的动作标识；payload 形状由触发通道决定（插件应两种都兼容）：

impl ScoreBooster for RemoteComponent

fn record<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, candidate_id: CandidateId, data: &'life1 CachedCandidateData, query: &'life2 str, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

fn boost<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, candidates: &'life1 mut Vec<ScoredCandidate>, data: &'life2 CachedCandidateData, query: &'life3 str, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

impl SearchEngine for RemoteComponent

fn calculate_scores<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, candidates: &'life1 CachedCandidateData, query: &'life2 str, ) -> Pin<Box<dyn Future<Output = Vec<ScoredCandidate>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,