Wox AI 命令完全指南：把保存的 Prompt 变成可复用的查询命令-北京尧图网络

桌面应用AI 应用插件系统【免费下载链接】WoxA cross-platform launcher that simply works项目地址https://gitcode.com/gh_mirrors/wo/Wox点击查看免费下载导读Wox 的 AI 命令AI Command把一段保存好的 prompt 变成可重复使用的查询命令改写选中文本、总结 diff、翻译一段话、解释报错……只要在设置里定义一次之后就能像用普通命令一样随时调用。本文以官方文档为主线结合 AI 命令插件源码深入讲解创建步骤、prompt 变量、默认动作、静默执行与快捷键组合让你能搭建一套属于自己的文本处理工作流。前置要求AI 命令依赖 AI provider。请先完成 AI 设置在设置 - AI中添加 API provider 或已安装的 CLI provider填写名称、凭据/CLI 信息、模型及可选的自定义 host并确认该 provider 已被启用且被 AI 命令功能选中。什么是 AI 命令AI 命令的本质是「保存的 prompt 可复用的触发词」。它的适用场景非常明确——你经常把同一类文本发给模型改写选中文本润色、纠错、调整语气总结一段 diff翻译一段话解释一个报错从源码看AI 命令插件是 Wox 的一个内置系统插件注册的触发关键字是ai支持 Windows、macOS、Linux 三平台并声明了QuerySelection读取选区、AI调用 AI与QueryEnv读取活动窗口信息三类能力见 wox.core/plugin/system/ai_command.go#L131-L266。插件的设置项是一个表格commands每一行就是一条命令存有名称、查询关键字、模型、思考模式、prompt、默认动作和 Vision 开关。创建你的第一条 AI 命令创建步骤很简单打开设置 - 插件 - AI 命令。打开命令列表。添加命令填写名称、查询关键字、模型和 prompt。在 prompt 里用%s表示 Wox 要插入的输入。创建完成后在 Wox 查询框输入ai 查询关键字输入即可触发。例如定义了一条查询关键字为translate的命令后输入ai translate hello worldWox 就会把hello world作为输入送进模型。命令列表为空或找不到关键字时插件会在结果区显示对应提示无命令、命令未找到、prompt 为空等见 wox.core/plugin/system/ai_command.go#L849-L952。命令设置字段在设置表格中每条命令可配置的字段如下字段定义见 wox.core/plugin/system/ai_command.go#L56-L64字段说明名称Name命令的显示名称也会作为结果标题与 overlay 窗口标题命令Command查询关键字ai之后输入的第一个词模型Model该命令使用的模型可选择已配置 provider 下的具体模型思考模式Thinking ModeProvider 默认/思考/不思考默认跟随 providerPrompt发送给模型的核心文本必填Vision是否与视觉/图片输入交互选择文件选区时才会列出启用 Vision 的命令默认动作Default Action运行/运行并显示/运行并粘贴回车时的首选动作Prompt 中的输入占位符Wox 支持两种向 prompt 注入输入的方式实现见 wox.core/plugin/system/ai_command.go#L333-L343%s最常用的占位符运行时会被替换为你输入的文本。prompt 中存在%s时源码通过fmt.Sprintf(prompt, inputText)完成替换。{wox:input_text}等效的显式变量包含它时会执行strings.ReplaceAll替换适合 prompt 中文本包含%等格式化字符的场景。此外当命令需要读取当前选区时可以在查询文本而非 prompt里插入查询变量{wox:selected_text}它代表 Wox 获得焦点前捕获的选中文本该变量同样被网页搜索等插件使用见网页搜索文档。选中文本或文件后触发 Wox插件会列出全部命令供你选择选区查询的过滤逻辑见 wox.core/plugin/system/ai_command.go#L793-L847选中文本时只显示 Vision 关闭的命令选中文件/图片时只显示 Vision 开启的命令并把图片作为视觉输入一起发送。多轮对话支持prompt 中可以插入{wox:new_ai_conversation}作为消息分隔符源码用strings.Split按该标记切分 prompt奇数段作为用户消息、偶数段作为助手消息交替拼成多轮对话见 wox.core/plugin/system/ai_command.go#L313-L331。这让一个 prompt 可以携带少量 few-shot 示例引导模型输出格式。示例根据 diff 写提交说明官方文档提供了一个完整可用的实战示例——把git diff交给模型生成规范的 commit message。命令设置字段值名称git commit msg查询commitVisionNoPromptWrite a Git commit message for this diff. Rules: - First line: imperative mood, 50 characters or fewer. - Then a blank line. - Then 2-3 bullet points explaining the concrete changes. - Output only the commit message. Diff: %s为了在终端里直接使用再加一个 macOS shell 辅助函数利用 Wox 的深度链接协议把管道输入转换成查询commit() { local input input$(cat) python3 -c import sys, urllib.parse; print(wox://query?qai%20commit%20 urllib.parse.quote(sys.stdin.read())) $input | xargs open }在 Git 仓库里这样用git diff | commit原理拆解git diff的输出经管道进入函数python3脚本把它 URL 编码后拼进wox://query?qai%20commit%20...深度链接open命令交给 Wox 打开并执行ai commit diff内容查询。深度链接的格式约定为wox://query?qurl-encoded-query空格需编码为%20详见深度链接文档。在 Windows 上可用Start-Process wox://query?q...Linux 上可用xdg-open实现同样效果。提示不要把密钥放进深度链接——URL 可能被 shell、浏览器或自动化日志记录。三种执行动作运行 / 运行并显示 / 运行并粘贴AI 命令的每条结果都提供动作其中「默认动作」决定直接回车时的行为。三种动作的源码实现见 wox.core/plugin/system/ai_command.go#L615-L709运行Run在启动器结果区原位启动模型请求并实时更新预览流式输出、耗时、错误都会反映到结果上结束后提供复制动作。这是最通用的默认值旧版命令记录没有 defaultAction 字段时会被归为运行以保持兼容见 wox.core/plugin/system/ai_command.go#L95-L107。运行并显示Run And Show隐藏查询框在鼠标附近弹出一个可拖动的浮层窗口流式展示结果窗口跟随滚动、支持一键复制、Esc 关闭。浮层有 80ms 的最小刷新间隔以降低闪烁见 wox.core/plugin/system/ai_command.go#L413-L460。运行并粘贴Run And Paste完全静默地等待模型返回最终完整答案然后把答案写入剪贴板并模拟粘贴回 Wox 打开前记录的活动窗口。它绝不会粘贴 streaming 过程中的半成品失败、空结果或粘贴失败都会通过系统通知报错见 wox.core/plugin/system/ai_command.go#L667-L706。注意该动作要求命令关闭 Vision且需要QueryEnv提供的活动窗口名称与 PID。另外命令的执行是懒加载的输入ai 关键字内容时结果区预览显示的只是即将发送的文本模型请求要等你选择动作后才真正发起避免每次输入刷新都产生昂贵的请求见 wox.core/plugin/system/ai_command.go#L904-L973。静默命令用快捷键直接执行只把 AI 命令当作启动器内的查询还不够高效——更接近日常文本处理工具的用法是绑定快捷键。打开设置 - 常规 - 快捷键查询新增一行并选择静默执行预设把快捷键绑定到类似ai commit或ai translate {wox:selected_text}的查询即可不打开启动器直接执行预设说明见快捷键文档。四种预设的差异预设用途普通查询显示启动器并执行查询预览查询隐藏查询框和工具栏适合 WebView 面板和文件预览静默执行只有一个明确动作时不显示启动器直接执行自定义保留预设默认值再覆盖位置、宽度、结果数或界面元素一个经典的组合是「静默翻译选中文本」先创建 AI 命令名称翻译为中文、命令translate、promptTranslate the following text to Chinese. Return only the translated text: %s、默认动作选运行并粘贴。再新增快捷键查询预设静默执行快捷键任意如ctrlshiftt查询写ai translate {wox:selected_text}。完整流程在其他应用里选中文本 → 按快捷键 → Wox 捕获选区并发送给模型 → 鼠标附近显示轻量「思考中」浮层 → 模型返回后用翻译结果替换原选区参考博客文章。关键点是静默执行本身不含粘贴语义它只是不打开启动器直接运行 AI 命令的默认动作要「翻译后直接替换选区」必须把命令的默认动作显式设为运行并粘贴。同样的模式也适用于语法修正、语气调整、摘要、格式清理等一切文本改写。如果想先检查结果再决定是否使用就把默认动作保留为运行。另外浮层的加载与结果展示依赖鼠标位置后端平台不支持时只会跳过浮层、保留通知见 wox.core/plugin/system/ai_command.go#L387-L411。怎样写更好的 prompt说清楚输出应该是什么例如「只输出 commit message」「只返回翻译结果」明确格式与边界。说清楚不要包含什么列出禁止出现的解释、前缀或额外内容。把可复用规则保存在 prompt 里运行时只传入会变化的输入规则如 50 字符、祈使句写死%s只放 diff、待翻译文本等变化部分。不要把私密内容发给在线 providerprompt、选区、剪贴板内容都会发送给所选模型只有当你的工作流确实需要时才这样做。付费 provider 可能对每次请求计费包括 AI 命令只使用可信的自定义 host见 AI 设置文档。小结AI 命令把「保存 prompt 查询关键字模型」封装成 Wox 的一等公民从启动器查询、选区菜单到静默快捷键三个入口共享同一套命令配置。掌握%s/{wox:input_text}占位符、{wox:selected_text}查询变量、三种执行动作与快捷键查询的组合就能把反复手动粘贴到 AI 对话里的工作流固化为一键触发的系统级文本处理管线。相关实现可继续阅读 AI 命令插件源码与 AI 设置文档。赞分享桌面应用AI 应用插件系统【免费下载链接】WoxA cross-platform launcher that simply works项目地址https://gitcode.com/gh_mirrors/wo/Wox点击查看免费下载相关推荐Mermaid Live Editor为什么这款在线图表工具能让你的工作效率翻倍Mermaid Live Editor为什么这款在线图表工具能让你的工作效率翻倍你是否曾为制作技术文档中的流程图而烦恼或者需要快速绘制项目时间线却找不到桌面应用AI 应用插件系统Graphify 实战指南用一条 /graphify 命令把代码库变成可查询的知识图谱Graphify 实战指南用一条 /graphify 命令把代码库变成可查询的知识图谱本文以 graphify 仓库的意大利语 README docs/t人工智能知识图谱RAGAI 技能开发工具MCP 服务Wox 查询完全指南全局搜索、触发关键字、命令与查询提示的实战用法Wox 查询完全指南全局搜索、触发关键字、命令与查询提示的实战用法打开 Wox 输入内容、从结果中执行动作是这款跨平台启动器最核心的交互方式。本文以官方查桌面应用AI 应用插件系统上一篇Android Sunflower终极指南Jetpack Compose响应式UI开发完整教程下一篇AtlasOS终极指南开源透明的高性能Windows系统优化方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Wox AI 命令完全指南：把保存的 Prompt 变成可复用的查询命令

相关推荐

三个问题定下 YOLO 多目标跟踪部署：BoxMOT 完整跟踪部署实践

R2R本地部署教程：一条命令跑起你的私有AI文档系统

Biome Markdown 格式化器行内图片（Inline Image）格式化规范与实现解析

更多资讯

web3.js 仓库 CHANGELOG 规范与实践：基于 Keep a Changelog 与 SemVer 的自动化维护指南

ANTLR 4 入门 FAQ 实战指南：安装、运行简单语法与解析器“挂起“问题排查

oh-my-openagent Team Mailbox Fallback Wake：团队消息递送失败时的确定性唤醒回退机制解析

四款AI编程助手与个人Agent横评：OpenClaw、Hermes、Claude Code与Codex CLI对比

基于Dex与Claude AI的个人操作系统：MCP协议部署与工作流实战

SN 29500-12失效率预计：2008英文原版可复制PDF为何是工程刚需

今日更新

深入解析Transformer多头注意力机制与工程优化

OpenClaw 的 Skills 跑学习任务，模型通道改到 TaoToken 通道行不行？

ChatGPT报错Oops, an error occurred! 全链路排查指南

本周精选

深入解析Transformer多头注意力机制与工程优化

OpenClaw 的 Skills 跑学习任务，模型通道改到 TaoToken 通道行不行？

ChatGPT报错Oops, an error occurred! 全链路排查指南

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？