Peek

使用支持

从第一次连接,到偶尔遇到的问题。

联系开发者

张梓浩 · 2120230154@mail.nankai.edu.cn

可通过邮件咨询安装、反馈问题或提出隐私请求。请写明 Peek 版本、设备与系统版本,以及复现步骤。

截图请遮住任务内容、项目名称和目录。不要发送密钥、配对二维码、钥匙串数据或原始会话日志。

安装与连接

Mac 版当前的下载状态见 下载页面。以下步骤适用于正式安装包开放后。

  1. 安装 Mac 版

    在 Mac 上从 Peek 下载页面获取已签名并经过 Apple 公证的安装包,将 PeekMac 拖入「应用程序」后打开。Peek 位于屏幕顶部菜单栏,点击三条横线图标进入。需要 macOS 13 或更新版本;iPhone 需要 iOS 17 或更新版本。

  2. 选择日志目录

    在 Mac 的 Peek 设置中,分别选择 Codex 的 .codex/sessions 或 Claude Code 的 .claude/projects 文件夹。文件选择窗口支持显示隐藏文件,也可按 ⇧⌘G 输入路径。Peek 只读日志,不需要 Agent 密码、API 密钥或额外 hook。

  3. 配对 iPhone

    保持两台设备蓝牙开启。在 Mac 菜单中选择「配对新 iPhone…」,用 Peek 扫描二维码。也可选择数字比对,并在两端核对、确认相同的六位数。配对完成后,在 Agent 中运行一个任务以检查同步。

常见问题

无法连接

检查 Mac 与 iPhone 蓝牙是否开启,保持设备靠近并让 Mac 处于唤醒状态。打开两端 Peek 后等待重连;仍不能恢复时,在两端移除配对记录,再重新扫码。不要分享配对二维码。

列表为空或状态未知

在 Mac 设置中检查日志目录是否显示可读,并在 Codex 或 Claude Code 中启动一个新任务。Peek 依据日志判断,普通工具等待、日志长时间未更新或缺少明确结束信号时,可能显示未知;这不代表任务失败。

通知或锁屏没有更新

检查 Peek 与系统的通知、锁屏活动权限及专注模式。更新依赖蓝牙连接和系统后台调度;强制退出 App、Mac 休眠或离开蓝牙范围可能暂停更新。返回 App 查看连接状态后再试。

可以在手机上运行或批准任务吗?

不可以。Peek 用于查看任务状态,实际命令、批准和后续操作仍需回到 Mac 上的 Agent 完成。

如何停止同步或清除数据?

在 iPhone 设置中「忘记这台 Mac」会清除本机配对记录、内存任务和提醒记录;Mac 设置中可移除已配对 iPhone。设备离线时应分别在两端移除。Mac「移除授权」停止读取该目录,关闭「缓存日志游标」会清除游标缓存。Peek 不删除你的原始 Agent 日志。

如何更新 Mac 版?

从下载页面获取新版本,退出 Peek,以新版本替换「应用程序」中的 PeekMac,再重新打开。本版不会自动更新。