PasteWand

PasteWand 文档

在 macOS 或 Windows 上安装 PasteWand、配置 AI 接口，并了解捕获、审阅与写回流程。

最近更新: 2026 年 8 月 7 日

安装

当前下载版本： macOS 13 或更高版本 · 仅 Apple 芯片（M 系列）；Windows 10 2004（内部版本 19041）或更高版本 · x64 · 需要 WSL 2。目前不提供 Intel Mac 安装包。

  • 从下载页面获取安装包。
  • macOS 正式版经过代码签名与 Apple 公证。网站提供的 Windows 安装程序未使用 Authenticode 签名，可能触发 SmartScreen 提示。自动更新使用独立的签名更新渠道。
  • 首次启动后，应用常驻 macOS 菜单栏或 Windows 系统托盘，并会请求读取当前选中内容所需的系统权限。
  • 首次启动会显示安全提示。PasteWand 只基于临时副本工作，任何修改都会先展示给你，确认后才写回。

PasteWand 已面向所有人开放。如果还没有下载链接，可以在下载页面注册账号。

配置 AI 接口

点击菜单栏或系统托盘图标，选择 设置。无需账号也能使用：可以直接连接模型，也可以在不想配置时选择 PasteWand Cloud。

使用自己的模型

选择内置服务商，或填写自定义 OpenAI-compatible 地址。请求直接从你的电脑发往该服务商，不经过 PasteWand 的服务器。

服务商Base URL模型示例
OpenAIhttps://api.openai.com/v1gpt-4o、gpt-4.1
Anthropichttps://api.anthropic.com/v1Claude 系列模型
Google Geminihttps://generativelanguage.googleapis.com/v1betaGemini 系列模型
DeepSeekhttps://api.deepseek.com/v1deepseek-chat
OpenRouterhttps://openrouter.ai/api/v1provider/model 名称
Groqhttps://api.groq.com/openai/v1Groq 系列模型
Mistralhttps://api.mistral.ai/v1Mistral 系列模型

任意 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 网关。

捕获内容

按全局快捷键（macOS 默认 ⌘ ⇧ Space，Windows 默认 Ctrl ⇧ Space），PasteWand 会读取当前选中内容。

  • 任意应用的纯文本，上限 128 KiB。
  • 访达或文件资源管理器中的文件或目录：最多 100 个根、20,000 个普通文件或 1 GiB 输入。
  • 符号链接和特殊文件会被拒绝。

单纯的复制不会触发任何请求。只有打开命令窗口时，PasteWand 才会读取剪贴板。

提出要求、审阅、写回

  1. 提出要求 - 输入指令，或使用预设（改善表达、让表述更清晰、缩短、翻译成英文）。
  2. 检查 - 文本使用本地行级、词级 Diff，图片可直接预览，文档可打开独立副本检查；继续提要求时沿用同一工作区。
  3. 写回 - 写入前重新校验每个源文件 Hash；任何冲突都会停止整组写入，成功的写回会作为一个加密撤销组记录。

在你点击写回之前，原文件始终不变；如果无法自动写回，结果会保留在剪贴板作为兜底。

处理已复制文本时，复制结果只更新剪贴板；替换原选区会先校验原应用和选区，再执行替换。处理文件时，可以选择部分修改写回，其余修改会保留，供你继续检查和应用。

应用修改后，可以在结果区点击撤销，撤销当前任务最近一次已应用的操作。如果文件后来被修改，撤销会停止以保护现有内容；文本选区的原始内容会复制到剪贴板，供你手动粘贴。

安全模型

  • AI 在一次性虚拟机内运行，使用你授权范围的私有副本。它只在虚拟机内拥有 root、Shell、网络和安装软件包的权限。
  • 主机原文件、系统凭据库以及私有副本之外的路径不会被挂载。
  • 任务结束后，虚拟机、暂存文件和任务目录都会被销毁。

键盘快捷键

操作macOSWindows
打开命令窗口⌘ ⇧ Space（默认）Ctrl ⇧ Space（默认）
可选快捷键⌘ ⇧ KCtrl ⇧ K
打开设置菜单栏图标 → 设置系统托盘图标 → 设置

你可以在设置中修改全局快捷键。

常见问题排查

  • 认证错误（401） - 检查 API Key 与 Base URL 是否和服务商一致，并确认密钥与接口是同一组配置。
  • 提示模型不可用 - 模型必须支持工具调用；自定义接口请填写网关暴露的准确模型 ID。
  • 写回因冲突停止 - 捕获后某个原文件发生了变化，Hash 校验拒绝了整组写入。重新捕获后再试。
  • 富文本格式丢失 - 首版按纯文本写回，粗体、链接等格式可能无法保留。

反馈

受邀测试者可以将产品与安全反馈发送到 support@pastewand.com。

检查与导出结果

文档、表格、演示文稿和图片可以通过 打开原始副本 和 打开结果副本，在默认应用中检查独立副本。编辑副本不会更新任务结果。另存副本 使用新文件名保存，不会覆盖已有文件。审阅副本支持单文件最大 256 MiB，属于临时文件；开始新任务或清理缓存前，请另存需要保留的内容。