桌面端#

waper 桌面端把你的 Mac 接给 Agent，还能把本地 Markdown 文件夹和空间同步、用快捷键收藏网页和剪藏文字、弹系统通知。主窗口就是 waper 本身，和网页版完全一样，随网页版一起更新。

目前只有 macOS 版，需要 macOS 13 或更新版本。服务器和没有界面的机器请用 命令行常驻程序。

安装#

从 waper.ai/download 下载，按你的 Mac 选择 Apple Silicon 版或 Intel 版（DMG）。打开 DMG，把 waper 拖进「应用程序」。

登录#

1. 第一次打开 waper 时，它会用系统浏览器打开确认页「在这台电脑上登录？」（浏览器里还没登录 waper 的话，先登录）。
2. 确认是你自己刚打开的桌面端后，点「在这台电脑上登录」，浏览器会把你带回桌面端。
3. 这台电脑自动接入，出现在 设置 → 电脑 里，名字是电脑名。

登录凭据加密保存在 macOS 钥匙串里。退出登录：点菜单栏图标里的「退出登录」，这台电脑的登录会同时在服务端失效。

菜单栏#

关掉窗口后，waper 会继续在菜单栏运行，这台电脑仍然可以被 Agent 使用。菜单里有：

• 状态：是否已连接，以及 Agent 正在这台电脑上做什么；
• 停止：逐个停止正在做的事，或者「全部停止」；
• 访问范围：Agent 能用整台电脑还是只限哪些文件夹（在 设置 → 电脑 里改，见 访问范围）；
• 快捷键收藏、剪藏和文件夹同步；
• 开机时启动：第一次运行时默认打开，可以在这里关掉；
• 登录、退出登录、退出 waper。

退出 waper 后这台电脑就离线了，Agent 用不了它。

让 Agent 用这台电脑#

在桌面端窗口里发起的对话会自动连上这台电脑；在网页或手机上发起时，Agent 需要本机就会自动选一台。Agent 能做什么、哪些要先问你、怎样限定文件夹，见 让 Agent 用电脑。

桌面端还会自动为这台 Mac 上的 Chromium 系浏览器登记 waper 的本机通道，装上扩展后 Agent 就能用你已经登录的浏览器，见 用你的浏览器。

系统通知#

简报准备好了、任务完成了、有事需要你决定时，桌面端会弹 macOS 通知，点一下就在 waper 窗口里打开对应页面。同一件事只保留一条通知。桌面端没在运行时不会补发，其他渠道（浏览器推送、Telegram、邮件）照常发，规则见 简报与通知。

文件夹同步#

把一个本地 Markdown 文件夹和一个空间的文档双向同步，适合习惯用自己的编辑器写东西的人。

• 开始：菜单栏图标 →「同步一个文件夹…」，选一个文件夹，再选和哪个空间同步。同一时间同步一个文件夹。
• 对应关系：空间里每个文档对应文件夹里的一个 .md 文件，可以放在子文件夹里。文件开头记着文档 ID 和标题，所以在本地改名、挪进子文件夹都不会断开。正文就是文档的 Markdown。
• 新建：在文件夹里新建的 .md 文件会成为空间里的新文档；空间里新建的文档会写成新文件。
• 跳过：以 . 开头的文件和文件夹（比如 .obsidian）不同步。
• 多快：本地的改动约 2 秒后同步，云端的改动每分钟拉取一次。
• 冲突：只有一边改了，就同步到另一边。两边都改了，两份都保留：文件换成云端的版本，你在本地的版本另存为「<名字> (conflict <日期>).md」，并作为新文档上传。不会悄悄覆盖任何一边，发生冲突时会弹通知。
• 删除：在本地删了、云端没改，就删掉云端文档，删之前把内容存进这台电脑上 waper 的回收区，保留 7 天；在云端删了、本地没改，本地文件移进回收区。另一边改过的话不删，而是重新上传或下载。
• 防误删：文件夹不见了（比如外接盘没插），或者一次要删掉超过一半（且多于 3 个）的文档时，这一轮不删任何东西，并弹通知请你检查文件夹。
• 停止：菜单栏图标 →「停止同步这个文件夹」。

快捷键收藏与剪藏#

在任何应用里都能用：

快捷键	做什么
⌥⌘S	收藏：收藏前台浏览器正在看的网页；前台不是浏览器时，收藏剪贴板里的链接
⌥⌘X	剪藏：剪下选中的文字。在浏览器里，收藏那个网页并把选中的文字作为笔记；在其他应用里，存成一个注明来源应用的 Markdown 文件

收藏的内容进资料库并自动选空间，和在网页上收藏一样，成功后会弹通知。能读取当前网页的浏览器有 Chrome、Edge、Brave、Arc 和 Safari。

需要的 macOS 权限：

• 自动化：收藏当前网页时要读浏览器的地址。第一次用时 macOS 会询问是否允许 waper 控制这个浏览器，点「好」。之前点过拒绝的话，到「系统设置 → 隐私与安全性 → 自动化」里给 waper 打开对应的浏览器。
• 辅助功能：剪藏要读取选中的文字，到「系统设置 → 隐私与安全性 → 辅助功能」里允许 waper。waper 会模拟一次复制来拿到选中的文字，之后把剪贴板恢复成原来的内容。

缺少权限、没有可收藏的内容，或者快捷键被其他应用占用时，通知里会说明原因。