桌面应用AI 应用插件系统【免费下载链接】WoxA cross-platform launcher that simply works项目地址https://gitcode.com/gh_mirrors/wo/Wox点击查看免费下载本篇技术指南围绕 Wox 的AI 命令与快捷键查询Query Hotkey组合讲解如何实现「在任意应用中选中文本 → 按下快捷键 → AI 静默翻译 → 结果自动粘贴回原选区」的完整工作流。读完本文你将掌握 AI 命令默认动作运行/运行并粘贴的配置语义、静默执行预设的正确用法以及{wox:selected_text}查询变量的底层捕获原理可复用到语法修正、语气调整、摘要等各类文本改写场景。AI 命令在启动器之外的使用方式AI 命令本身可以在启动器里使用输入ai command 输入即可触发命令在 Wox 的结果区展示 AI 流式返回的答案。但如果只停留在启动器里它仍然是一次先唤起启动器 → 再手动搬运文本的操作。把 AI 命令和快捷键查询组合起来后场景就发生了质变在任意应用里选中文本按一个快捷键让 AI 翻译最后由 Wox 把最终结果直接粘贴回原来的选区。整个过程不再需要 Wox 窗口参与确认更接近一个纯粹的日常文本处理工具。整套配置的关键点是给 AI 命令配置明确的默认动作。默认动作决定了命令被触发后 Wox 如何处理 AI 的最终答案——是停留在结果区展示、以浮层展示还是直接替换原文本。第一步配置带默认动作的翻译 AI 命令在 AI 命令插件系统内置插件触发关键词为ai的设置里新增或编辑一个翻译命令按下面的示例值填写AI 命令字段示例值名称翻译为中文命令translate提示词Translate the following text to Chinese. Return only the translated text: %s默认动作运行并粘贴命令字段的完整含义从源码中的commandSetting结构可以看到AI 命令实际持久化的字段比界面上看到的更多wox.core/plugin/system/ai_command.go 定义了name、command、model、thinkingMode、prompt、defaultAction、vision七个字段。结合GetMetadata中的表格列定义ai_command.go各字段说明如下名称name命令的人类可读名称必填会显示在结果标题与浮层标题中命令command触发命令的关键词必填例如translate用于ai translate 输入这样的查询模型model选择使用哪个 AI 模型必填存储的是序列化后的模型配置AIModel()负责反序列化思考模式thinkingModeprovider_default/thinking/non_thinking三选一未设置时回退为provider_defaultNormalizedThinkingMode处理见 ai_command.go提示词prompt必填支持%s或{wox:input_text}占位符注入输入文本视觉vision是否面向图片输入的命令默认动作defaultAction命令被触发后的默认行为取值为run/run_and_show/run_and_paste之一。默认动作的三种取值源码中明确定义了三个动作常量ai_command.go默认动作源码常量行为运行run在启动器结果区展示流式答案保持结果可见运行并展示run_and_show隐藏启动器在鼠标附近的浮层中展示流式答案运行并粘贴run_and_paste等待 AI 返回最终结果后把最终文本写入剪贴板并模拟粘贴回 Wox 打开前记录的活动窗口NormalizedDefaultActionai_command.go还有一个向后兼容逻辑旧版本保存的命令没有defaultAction字段此时会回退到run保证既有命令维持原有的在 Wox 中展示结果的安全行为不会因为新字段的引入而突然变成自动粘贴。提示词的渲染规则renderAICommandPromptai_command.go按以下优先级渲染提示词如果提示词包含{wox:input_text}直接替换为输入文本否则如果包含%s用fmt.Sprintf格式化两者都不包含时提示词原样发送。因此文档示例里的Translate the following text to Chinese. Return only the translated text: %s会被替换成...: 选中文本。此外提示词还支持用{wox:new_ai_conversation}分隔符构造多轮对话见buildAICommandConversationsai_command.go奇数段为 user 消息、偶数段为 assistant 消息。第二步用「静默执行」预设创建快捷键查询接着在快捷键设置中新增一个快捷键查询选择静默执行预设并把它绑定到刚才的翻译命令快捷键查询字段示例值预设静默执行快捷键任意可用快捷键例如ctrlshiftt查询ai translate {wox:selected_text}可选调整只有在你需要覆盖显示行为时再切到自定义继续修改静默执行预设做了什么快捷键查询在设置中的字段定义见 wox.core/ui/launcher/hotkey_settings.go包含Name、Hotkey、Query、Position、HideQueryBox、HideToolbar、Width、MaxResultCount、IsSilentExecution、Disabled等列。预设机制在 wox.core/ui/launcher/form_table.go 中定义为四种normal常规、web-panel网页面板、silent静默、custom自定义。选择静默执行时applyQueryHotkeyPresetform_table.go会做两件事把IsSilentExecution置为true即静默执行开关清空被该预设隐藏的其他显示字段。因此大多数情况下选择静默执行预设后只需要填写快捷键和查询两项不必逐个调整显示参数。这里有一个容易混淆的点原文档特意强调静默执行这个预设本身不包含隐藏的粘贴语义。它只是让 Wox 在执行查询时隐藏启动器界面、不打扰用户在这个配置里静默执行只是运行 AI 命令的默认动作的触发方式而粘贴行为来自你显式设置的默认动作运行并粘贴。两者是独立的概念静默执行控制 UI 是否出现运行并粘贴控制结果如何处理。{wox:selected_text}查询变量查询字符串ai translate {wox:selected_text}中的{wox:selected_text}是 Wox 的查询变量之一定义于 wox.core/plugin/query_variables.go。同类变量还包括{wox:clipboard_text}剪贴板文本{wox:selected_file}选中的文件{wox:active_browser_url}当前浏览器地址{wox:file_explorer_path}文件管理器路径resolveTextQueryVariablesquery_variables.go实现了这些变量的捕获只在查询模板引用到对应变量时才去读取并且在 Wox 激活前完成——因为选区检索可能触发模拟复制Copy所以实现里刻意先读剪贴板再读选区保证时序正确。捕获发生在源应用仍持有焦点时这正是粘贴回原应用能够成立的先决条件。完整流程从选中文本到替换完成配置完成后实际运行时的完整流程是在其他应用里选中文本按下快捷键查询Wox 把选中文本发送给 AI 命令{wox:selected_text}在 Wox 打开前已被替换为真实选区Wox 在鼠标附近显示一个很轻的思考提示AI 返回最终答案后Wox 用翻译结果替换原来的选中文本。源码视角运行并粘贴动作的完整链路在 AI 命令插件中buildAICommandActionsai_command.go为每个命令构造动作列表其中run_and_paste分支ai_command.go的实现清晰地展示了不粘贴半成品的保证等待最终答案final : -c.startAICommandStream(...)在ChatStreamStatusFinished事件到达之前finalCh不会收到结果见 ai_command.go因此流式过程中的中间文本永远不会进入剪贴板流式启动后显示轻量浮层通过onStreamingStarted回调在鼠标位置附近弹出思考中提示showAICommandLoadingOverlayai_command.go浮层使用textoverlay原生组件偏移 18px、最小宽度 128px靠近触发位置暗示隐藏的 AI 动作正在运行校验最终结果出错或答案为空时通过通知notifyAICommandActionError告知用户不会执行粘贴先关闭浮层再激活目标窗口注释明确说明必须先关掉进度浮层避免模拟粘贴时浮层悬浮在目标应用之上写入剪贴板并模拟粘贴调用pasteTextToActiveWindowwox.core/plugin/system/util.go先clipboard.WriteText(text)写入最终答案然后window.ActivateWindowByPid激活 Wox 打开前记录的活动窗口等待 150ms 让窗口就绪最后keyboard.SimulatePaste()模拟系统粘贴。注意第 5 步依赖的Wox 打开前的活动窗口信息并非凭空可得AI 命令插件的元数据声明了requireActiveWindowName/requireActiveWindowPid/requireActiveWindowIcon三个 QueryEnv 参数ai_command.go保证静默模式下也能拿到正确的目标窗口身份。视觉命令与粘贴动作的边界还有一个细节allowRunAndPaste : !command.Visionai_command.go。当命令启用了视觉vision字段时运行并粘贴动作不会被加入动作列表因为图片类命令的输出不适合直接替换选区文本此时默认动作会退化为run。静默执行与「运行并粘贴」的分工边界综合前文可以把两个核心概念的关系总结为一张对照表概念所属设置作用关键点静默执行快捷键查询IsSilentExecution隐藏启动器 UI不弹确认窗口不含粘贴语义只控制界面是否打扰运行并粘贴AI 命令defaultAction等待最终答案 → 写剪贴板 → 模拟粘贴回原窗口粘贴的是最终结果不是流式半成品运行AI 命令defaultAction在启动器结果区展示答案适合需要先人工确认结果的场景当两者组合时快捷键触发的静默查询执行 AI 命令的默认动作而这个默认动作被你显式设置成了运行并粘贴于是形成无确认窗口 直接替换原文的完整静默翻译体验。原文档有一句非常准确的总结在这个配置里静默执行只是运行 AI 命令的默认动作——理解这一点就不会在排查问题时把粘贴行为误归因于静默执行开关。同一模式的其他应用场景这套「快捷键查询 静默执行 运行并粘贴」的组合不限于翻译凡是选中文本 → AI 改写 → 替换原文的文本处理都能复用语法修正提示词要求只返回修正后的文本语气调整改为正式 / 口语化 / 简洁风格摘要把长段落压缩为要点格式清理去重空行、统一标点、转 Markdown 等。设计上的唯一分界线是如果你希望先检查结果再决定是否采用就把默认动作设为运行结果留在启动器内可手动复制只有当这个命令足够适合直接替换选中文本时再使用运行并粘贴。因为运行并粘贴是不可撤销的即时替换提示词里Return only the translated text这类约束非常重要——任何多余的说明性文字都会一并粘贴进原文。仓库中还提供了演示视频 screenshots/ai_command_run_paste_query_hotkey.mp4 与命令模板界面截图 screenshots/ai_command_templates.png可以直观对照本文的配置步骤本主题的原始文档位于 www/docs/zh/blog/did-you-know-ai-command-silent-translation-query-hotkey.md相关实现可继续深入阅读 wox.core/plugin/system/ai_command.go 与 wox.core/plugin/system/util.go。赞分享桌面应用AI 应用插件系统【免费下载链接】WoxA cross-platform launcher that simply works项目地址https://gitcode.com/gh_mirrors/wo/Wox点击查看免费下载相关推荐Wox 快捷键总览插件Hotkey Overview一条命令查看所有已注册快捷键Wox 快捷键总览插件Hotkey Overview一条命令查看所有已注册快捷键 本指南以 Wox 内置的「快捷键总览」Hotkey Overview桌面应用AI 应用插件系统Wox 快捷键完全指南主热键、快捷键查询、托盘查询与全屏策略详解Wox 快捷键完全指南主热键、快捷键查询、托盘查询与全屏策略详解 Wox 的快捷键体系远不止一个启动热键通过「快捷键查询」可以把任意一段查询如 webvi桌面应用AI 应用插件系统Wox 快捷键总览插件用 hotkeys 命令查看与检索全部已注册快捷键Wox 快捷键总览插件用 hotkeys 命令查看与检索全部已注册快捷键 导读 Wox 的快捷键总览Hotkey Overview是一个内置系统插件它把桌面应用AI 应用插件系统上一篇突破本地AI算力瓶颈Apple Silicon设备上基于LM Studio与R2R的推理加速方案下一篇终极指南深度配置Realtek R8125 2.5GbE网卡驱动性能优化实战创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
