OpenWand

---

为什么选择 OpenWand

OpenWand 让 AI 提示词成为工作流中自然而流畅的一部分，助你保持高效。

并排使用 AI 提示词

常见的 AI 聊天——8 个步骤	OpenWand——少至 2 步
1. 查找并复制第一段上下文。 2. 切换到 AI 聊天。 3. 粘贴内容。 4. 重复以上步骤，直到模型获得所需的全部信息。 5. 输入提示词。 6. 发送请求。 7. 等待回复。 8. 阅读回复，然后切回工作界面。	1. 按下快捷键打开 OpenWand。 2. 运行预设提示词。

系统会自动收集你选中的文本，以及你在设置中启用的上下文来源。如有需要，只需单击一下即可启用上下文来源。然后选择预设提示词，或输入自定义提示词。

OpenWand 的工作原理

OpenWand 让你可以在桌面任意位置使用 AI。可随手调用的可复用提示词、自动收集的上下文，以及一键访问其他来源的功能，让每次请求都能减少操作步骤。

向 AI 输入提示词

你： 按下快捷键 → (添加上下文) → 选择可复用提示词或自定义提示词

OpenWand： 收集并预览上下文 → (检查隐私和提示词注入) → 向你选择的模型提问 → 显示答案

让 AI 在原位置改写

你： 选中文本 → 按下改写快捷键 → (添加上下文) → 选择改写方式 → 接受

OpenWand： 捕获选区 → (检查隐私和提示词注入) → 撰写答案 → 显示预览 → 粘贴回原处

括号中的操作为可选项。

亮点

• 跳过设置，直接输入提示词。 — 随时随地输入提示词，无需担心上下文。
• 答案呈现更出色 — 每条回复都会在本地转换为精美的 HTML 和 CSS，无需额外调用模型或产生费用。
• 集成 Codex 和 Claude — 通过 OpenWand 直接运行任一 Agent。
• 隐私模式 — 可选启用敏感上下文警告和内容脱敏。
• 高度可自定义 — 自定义快捷键、提示词、上下文、模型、语音、回贴方式和界面。
• 功能强大，易于上手 — OpenWand 让模型、隐私、记忆和上下文都易于掌控。
• 一键掌控上下文 — OpenWand 会自动处理上下文，也可以通过一次点击来处理。
• 无需打字 — 说出提示词并听取答案。
• 询问屏幕上的任何内容 — 框选一个区域，即可立即将其转化为视觉上下文。
• 原地改写 — 改写选中的文本，检查结果，并将其粘贴回原处。
• 使用任意模型 — 支持许多热门云服务提供商、本地模型，以及任何兼容 OpenAI 的服务。
• 由你掌控的记忆 — 可选择在本地保留短期和长期记忆，并可查看或删除。
• 扩展一切功能 — 通过插件和 MCP 添加新的提示词、操作、快捷键、钩子和模型工具。
• 轻松开展多 Agent 协作 — 通过可视化界面和通俗易懂的引导组建团队，然后跟进进度并查看结果。

演示

跨应用上下文：将当前选中的内容与已启用的浏览器和应用上下文结合，为模型提供所需材料，无需手动复制粘贴。

视觉截取：当视觉上下文至关重要时，可使用截取流程。Ctrl+Alt+Q 可让你框选一个区域，仅将该裁剪图发送给视觉模型，并在浮层中查看答案，无需切换应用。

原地改写：仅改写选中的文本，检查建议措辞，并将接受的结果粘贴回调用 OpenWand 时处于活动状态的输入框。

感知应用的操作：使用当前聚焦应用的上下文来分析当前工作或执行操作；结果清晰明了，并会在未更改任何文档单元格时明确确认。

Agent 团队：将较耗时的工作区任务委派给协调者、构建者和审查者角色。团队可以检查项目文件、进行有针对性的修改、运行检查，并留下最终报告和可供审查的产物，同时你仍可继续使用 OpenWand。

工作流

你要做的事	OpenWand 的操作
高亮文本、选择上下文或框选区域	仅捕获所选内容或已启用的上下文
按下调用快捷键并选择操作或自定义提示词	根据你的提示词和所选上下文构建模型请求
发送请求	将请求直接发送到你配置的模型服务提供商
等待答案	将回复流式传输到气泡中，并可选择自动语音朗读（TTS）
留存有用信息以供日后使用	仅在启用记忆功能时将记忆存储在本地

常用快捷操作

当你想要……	使用 OpenWand
理解选中的文本	选中文本，打开 OpenWand，然后选择 What is this? 或 Explain simply。
改写文本，无需复制粘贴	选中文本，选择改写方式，检查结果，然后将接受的版本粘贴回原处。
提出自己的问题	输入自定义提示词。已启用的上下文会自动附加；只需单击一下即可添加其他来源。
询问屏幕上的任何内容	按 Ctrl+Alt+Q，圈出相关区域，然后发送给视觉模型。
无需打字即可输入提示词	按 F9 并讲话。OpenWand 会转录你的请求并发送给模型。
向任意应用口述内容	按 F8 并讲话。你的话语会直接出现在当前活动的文本字段中。

快速开始

下载应用

1. 从 GitHub Releases 下载最新版本。
2. 解压并启动 OpenWand。
3. 打开设置并连接模型。

你可以先安装 OpenWand，再选择模型连接方式。如果你还没有可用的连接方式，可以从 20 多个免费和试用 API 来源开始，或连接本地模型。

Windows	macOS	Linux
OpenWand.exe	OpenWand.app	OpenWand

从源代码运行

OpenWand 需要 Python 3.12。

git clone https://github.com/SunnyLich/OpenWand.git
cd OpenWand

运行适用于你平台的启动器：

Windows	macOS	Linux
Start OpenWand.bat	Start OpenWand.command	Start OpenWand.sh

首次启动时会配置 Python 环境并安装依赖项。之后启动时会直接进入应用。

如需自行打包 OpenWand，请参阅构建 EXE。

系统要求

级别	要求	适用场景
最低配置	Windows 10+、macOS 13+ 或 Linux X11；4 GB RAM；2 GB 可用磁盘空间	搭配云端或免费 API 使用核心浮层功能
推荐配置	8 GB+ RAM；6 GB+ 可用磁盘空间；使用语音功能时需要麦克风	本地语音、可选的 2.8 GB 高级隐私过滤器，以及更充裕的工作空间

本地 AI 模型可能需要多得多的 RAM、VRAM 和存储空间，具体取决于模型。使用屏幕捕获、全局热键、粘贴回原处和语音功能时，系统可能会请求相应的操作系统权限。

配置

常规设置请使用“设置”窗口。.env.example 仅供高级来源配置参考。

1. 打开 设置。
2. 选择对话引擎。
3. 连接你的提供商或账户。
4. 自定义上下文、热键、语音、隐私和记忆。
5. 运行 设置检查。

选择运行框架

运行框架	行为
OpenWand	使用在 OpenWand 中配置的大模型提供商和模型。
ChatGPT	使用已安装的 Codex CLI 和你的 ChatGPT/Codex 账户。
Claude Agent	使用 Claude Agent 和你的 Claude Code 账户。

Agent 控制

• 连续性 — 在 OpenWand 中继续对话，或通过 ChatGPT 或 Claude 恢复对话。
• 实时进度 — 查看回复、计划、工具活动、文件状态和审批请求。
• 权限 — 在更改前询问、允许更改项目，或使用只读计划模式。
• 项目范围 — Agent 只能在所选项目内写入；切换项目会开始新会话。
• 历史记录 — 导入、选择性同步或导出 ChatGPT/Codex 和 Claude 对话。

注意事项

• 提供商密钥和 OAuth 令牌存储在操作系统的密钥链中，而非纯文本配置文件中。
• 高级来源设置请参阅 .env.example 中的文档。
• 如需了解更多信息，请参阅实时 Agent 指南，或浏览免费模型 API 来源。

默认快捷键

快捷键	操作
Windows 上为 Ctrl+Q，macOS/Linux 上为 Ctrl+Alt+Space	打开通用操作选择器
Windows 上为 Ctrl+Shift+Q，macOS/Linux 上为 Ctrl+Alt+Shift+Space	打开改写/粘贴操作选择器
Ctrl+Alt+Q	截取屏幕区域以供视觉分析
Alt+Q	将当前选区添加到上下文缓冲区
Alt+W	清空上下文缓冲区
F7	朗读选中的文本
按住 F9	录制语音、转录并发起查询
按住 F8	直接听写到当前获得焦点的文本字段
W / A / D	触发内置操作行
S	自定义提示词模式
Esc	取消选择器

每个调用方、快捷键、标签、提示词、上下文来源、粘贴回填设置和 UI 尺寸都可以在设置中配置。

扩展

OpenWand 通过扩展实现深度可扩展性，带来新功能、新工作流和新可能性。每个扩展都会声明其作者以及激活前请求的 OpenWand 访问权限；只有在更新扩大访问权限时，才会再次请求确认。扩展在独立的 Python 进程中运行，发布者声明的程序包会保留在专用虚拟环境中。完整代码扩展仍会以你的常规用户权限运行，因此只安装你信任的扩展。

在便携式打包版本中，如果 OpenWand.exe 旁边的 addons 文件夹可写，OpenWand 会在该处创建此文件夹。 或者，使用 Addon Manager -> Open addons folder 打开备用的、用户可写的扩展 目录。

扩展可以在多个环节接入 OpenWand：

• 上下文 - 在发送查询前读取或改写提示词和上下文。
• 工具 - 注册模型可调用的工具，供模型在回答过程中调用。
• 响应 - 观察已完成的响应，以便记录、保存或转发。
• 操作和快捷键 - 添加自定义提示词对应的操作行和全局快捷键。
• UI - 提供托盘操作、设置字段和通知。
• 大模型操作 - 从钩子或快捷键运行受限的模型调用。

扩展能做什么： 扩展可以注入上下文、提供工具并响应结果，因此可扩展的范围很广。以下是几个示例及其使用的钩子：

你想要……	钩子	清单要求
自动将你的 git 差异、日历或打开的工单加入提示词	上下文（before_query）	query = "modify"
为模型提供一个工具，用于搜索内部 wiki、查询数据库、调用天气或股票 API，或切换智能家居设备	工具（get_tools）	tools = true（以及任何程序包对应的 [dependencies]）
为满足合规要求，在敏感上下文发出前对其进行脱敏或标记	上下文（before_query）	query = "modify"
将每个回答追加到每日日志，或推送到 Notion 或 Slack	响应（after_response）	response = "read"
添加一个一键操作，使用自带提示词按团队风格改写文本	操作和快捷键	[[intents]] / [[hotkeys]]，hotkeys = true

只要能用 Python 编写，且符合上述某个钩子环节，就可以将其接入你已在使用的、由快捷键驱动的同一浮层中。

MCP 客户端和服务端

MCP 客户端：在 OpenWand 中使用外部服务

OpenWand 附带一个 MCP bridge 扩展（addons/mcp_bridge），它充当 MCP 客户端：在其 servers.json 中列出任意 Model Context Protocol 服务，OpenWand 就会将这些服务的全部工具集作为 OpenWand 工具提供给模型。这样一来，浮层就能使用外部 MCP 功能，而无需离开桌面工作流。完整的清单和钩子约定请参阅扩展指南，或查看扩展文档。

MCP 服务端：OpenWand 上下文服务

OpenWand 还附带一个本地的 MCP stdio 服务，名为 OpenWand Context Server。Claude Desktop、Cursor 和 Codex 等可信 MCP 客户端可以启动它来读取实时桌面上下文；OpenWand 应用本身无需保持打开状态。

工具

OpenWand Context Server 提供五个只读工具：

• get_selected_text — 桌面上当前选中的文本。
• get_clipboard — 剪贴板中的文本。
• get_active_window — 当前活动的应用、窗口标题，以及可用时的浏览器 URL。
• read_browser_page — 可见浏览器页面中的文本。
• take_screen_snip — 主显示器的屏幕截图。

连接客户端

启动一次 OpenWand，然后将 addons/mcp_bridge/claude_config_snippet.json 中的 mcpServers 条目复制到 MCP 客户端的配置中。OpenWand 会生成此代码片段，其中包含其自身 Python 解释器和 addons/mcp_bridge/context_server.py 的正确本地路径；请勿替换为系统 Python。平台说明和故障排除方法请参阅 MCP Bridge 服务设置指南。

只向你信任的客户端注册此服务：工具结果可能包含桌面上的选中文本、剪贴板内容、浏览器内容和屏幕截图。

隐私与控制

OpenWand 没有托管存储层。

区域	处理方式
本地数据	设置、聊天记录、记忆、隐私报告和配置均保留在你的设备上。
模型请求	你的提示词和已启用的上下文会直接发送到你选择的提供商或本地服务。
凭据	提供商密钥和 OAuth 令牌存储在操作系统的密钥链中。
上下文预览	来源和令牌估算会在本地检查，不会发送或保存。
权限	上下文来源和模型工具由不同设置控制；可选功能在配置前保持关闭。
插件	每个插件都在隔离进程中运行，并声明所需的访问权限。

隐私模式

模式	保护措施
关闭	发送你选择的上下文，不进行隐私信息脱敏。
内置	在本地检测凭据、令牌和支付详情等结构化机密信息。
高级	添加可选的本地 OpenAI Privacy Filter，用于检测姓名、地址、私有 URL、账户详情及其他敏感信息。

高级模式是一个约 2.8 GB 的可选下载，可能需要一段时间预热。它可以减少意外泄露，但无法保证检测到所有敏感信息。

提示词注入防护

启用后，OpenWand 会检查捕获的文本中是否存在试图覆盖模型指令的内容，并允许你在发送前继续或取消。

如需了解安全漏洞，请阅读安全策略。请勿在公开问题中包含漏洞详情、凭据、捕获的上下文或私有日志。

平台状态

平台	状态
Windows 10+	支持
macOS 13+	支持*
Linux X11	支持
Linux Wayland	进行中 - 目前正在开发 Wayland 支持

*此应用仅在为期两周的主要开发期间于 macOS 上进行过测试。由于硬件访问受限，之后我无法继续测试。如果你在 macOS 上发现错误，请在此仓库中创建问题，我会尽力修复。更好的做法是，如果你能提供解决方案，请创建拉取请求。

帮助与反馈

• 排查常见问题
• 报告错误
• 提出安装或使用方面的问题
• 提出功能建议

报告错误时，请提供你的操作系统版本、启动器、日志以及触发错误的操作。日志可能包含捕获的文本，因此分享前请删除凭据和个人信息。

我们目前正在开发对 Linux Wayland 的支持，欢迎协助测试或改进。也欢迎测试 macOS 支持；这些平台在原生集成方面有较多边缘情况，因此来自不同机器、桌面环境和权限状态的实际使用报告能让 OpenWand 变得更好。

如果你想支持这个项目及其更广泛的使命，可以直接参与开发，也可以在此捐款。

贡献者文档

• 开发者 README - 安装、运行时入口、检查和调试说明。
• 代码概览 - 子系统职责和运行时边界。
• 插件指南 - 插件清单、权限、钩子、工具、快捷键和打包。
• 构建 EXE - Windows 打包说明。

免费模型 API 来源

通过免费 API 或本地托管模型，免费开始使用 OpenWand。请查看我们的指南，了解 20 多种免费和试用 API 来源以及本地选项。

浏览免费模型指南 →

许可证

MIT