Enum QueryResponse 

pub enum QueryResponse {
    List {
        results: Vec<ListItem>,
    },
    CustomPanel {
        panel_type: String,
        data: Value,
        actions: Vec<ResultAction>,
        keep_search_bar: bool,
    },
    Empty,
    InlineParam {
        candidate_id: CandidateId,
        trigger_keyword: String,
        user_arg_count: usize,
    },
}

插件查询响应 —— 一次查询的展示结果契约（跨 IPC 序列化，字段键名与前端 BridgeQueryResponse.mode 词表对齐）。

由 Plugin::query / 宿主流程返回，经 SessionDispatcher 路由后包装为 BridgeQueryResponse 下发前端；四种变体对应前端不同的展示形态。

Variants

List

候选列表结果 —— 默认搜索与插件均可返回，前端按列表渲染。

空列表即空结果（前端映射 mode “search” + 空数组，展示形态层面 不区分 List/Empty）。

Fields

results: Vec<ListItem>

排序后的候选项列表（含动作、占位符统计、触发关键词等展示元数据）。

CustomPanel

插件自定义面板 —— 触发式插件接管会话时的渲染结果。

keep_search_bar 决定面板形态：true 为行内面板（保留搜索栏，前端 mode “plugin_panel”），false 为全页面接管（mode “plugin_immersive”）。

Fields

panel_type: String

面板类型标识，前端按此选择面板组件渲染。

data: Value

面板数据（自由 JSON，面板自行定义结构）。

actions: Vec<ResultAction>

面板动作列表（供 Enter 执行默认动作 / 面板内动作切换）。

keep_search_bar: bool

是否保留搜索栏（true = 行内面板；false = 全页面接管）。

Empty

空结果 —— 无任何展示内容。

前端映射 mode “search” + 空数组（与 List 空列表行为一致）。 注意：插件命中触发词后即使返回 Empty 也是「已处理」， 不得继续 fallback 到默认搜索。

InlineParam

行内参数模式：后端检测到触发关键词+空格后自动进入。 前端据此清空搜索栏并展示参数输入 UI。

Fields

candidate_id: CandidateId

目标候选项 ID（确认时回传执行）。

trigger_keyword: String

命中的触发关键词（前端展示 + 退出判定镜像使用）。

user_arg_count: usize

该候选项要求的用户参数个数（前端据此校验输入完整性）。

Trait Implementations

impl Clone for QueryResponse

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for QueryResponse

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for QueryResponse

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for QueryResponse

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.