PasteWand 文档
安装、配置 AI 接口，并了解 PasteWand macOS 客户端的捕获、审阅与写回流程。
最近更新: 2026 年 8 月 7 日
安装
PasteWand 支持 macOS 13 及以上，同时兼容 Apple Silicon 和 Intel Mac。
- 从下载页面获取签名安装包。
- 首次启动时，应用常驻菜单栏，并会请求辅助功能权限，以便在捕获时读取当前选中内容。
- 首次启动会显示安全提示。PasteWand 只基于临时副本工作，任何修改都会先展示给你，确认后才写回。
PasteWand 已面向所有人开放。如果还没有下载链接，可以在下载页面注册账号。
配置 AI 接口
点击菜单栏图标，选择 设置。无需账号也能使用：可以直接连接模型，也可以在不想配置时选择 PasteWand Cloud。
使用自己的模型
选择内置服务商，或填写自定义 OpenAI-compatible 地址。请求直接从你的 Mac 发往该服务商，不经过 PasteWand 的服务器。
| 服务商 | Base URL | 模型示例 |
|---|---|---|
| OpenAI | https://api.openai.com/v1 | gpt-4o、gpt-4.1 |
| Anthropic | https://api.anthropic.com/v1 | Claude 系列模型 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta | Gemini 系列模型 |
| DeepSeek | https://api.deepseek.com/v1 | deepseek-chat |
| OpenRouter | https://openrouter.ai/api/v1 | provider/model 名称 |
| Groq | https://api.groq.com/openai/v1 | Groq 系列模型 |
| Mistral | https://api.mistral.ai/v1 | Mistral 系列模型 |
任意 OpenAI-compatible 网关，选择 自定义 OpenAI-compatible 并填写接口地址：
Provider: 自定义 OpenAI-compatible
Base URL: https://your-gateway.example.com/v1
Model: your-model-name
API key: your-key
- API Key 只保存在 macOS 钥匙串（或 Windows 凭据管理器），并与对应接口绑定。
- 模型必须支持工具调用；PasteWand 依赖它读取文件和运行命令。
PasteWand Cloud
PasteWand Cloud 是基于账号额度的可选托管服务。桌面端的一切仍在本机运行，只有模型请求会经过 PasteWand 网关。
捕获内容
按全局快捷键（默认 ⌘ ⇧ Space），PasteWand 会读取当前选中内容。
- 任意应用的纯文本，上限 128 KiB。
- 访达中的文件或目录：最多 100 个根、20,000 个普通文件或 1 GiB 输入。
- 符号链接和特殊文件会被拒绝。
单纯的复制不会触发任何请求。只有打开命令窗口时，PasteWand 才会读取剪贴板。
提出要求、审阅、写回
- 提出要求 - 输入指令，或使用预设（改善表达、让表述更清晰、缩短、翻译成英文）。
- 检查 - 逐个查看修改文件及本地生成的行级、词级 Diff；继续提要求时沿用同一工作区。
- 写回 - 写入前重新校验每个源文件 Hash；任何冲突都会停止整组写入，成功的写回会作为一个加密撤销组记录。
在你点击写回之前，原文件始终不变；如果无法自动写回，结果会保留在剪贴板作为兜底。
安全模型
- AI 在一次性虚拟机内运行，使用你授权范围的私有副本。它只在虚拟机内拥有 root、Shell、网络和安装软件包的权限。
- 主机原文件、系统凭据库以及私有副本之外的路径不会被挂载。
- 任务结束后，虚拟机、暂存文件和任务目录都会被销毁。
键盘快捷键
| 操作 | 快捷键 |
|---|---|
| 打开命令窗口 | ⌘ ⇧ Space（默认） |
| 可选快捷键 | ⌘ ⇧ K、⌥ ⇧ Space |
| 打开设置 | 菜单栏图标 → 设置 |
你可以在设置中修改全局快捷键。
常见问题排查
- 认证错误（401） - 检查 API Key 与 Base URL 是否和服务商一致，并确认密钥与接口是同一组配置。
- 提示模型不可用 - 模型必须支持工具调用；自定义接口请填写网关暴露的准确模型 ID。
- 写回因冲突停止 - 捕获后某个原文件发生了变化，Hash 校验拒绝了整组写入。重新捕获后再试。
- 富文本格式丢失 - 首版按纯文本写回，粗体、链接等格式可能无法保留。
- Windows 支持 - Windows 10 和 11 会在 macOS 版之后推出。
反馈
受邀测试者可以将产品与安全反馈发送到 support@pastewand.com。