需要时，获得一点帮助。

安装 App

从首页下载已签名并公证的 Mac DMG。打开后，将 AckPulse 拖入“应用程序”，推出磁盘映像，再从“应用程序”打开 AckPulse。不要直接在 DMG 内运行：Agent 集成需要稳定的安装路径。

iPhone App 开放后在 App Store 一次性付费下载，Apple Watch 可选。iPhone App 暂不在中国大陆和欧盟的 App Store 提供；可用性由你的 App Store 地区决定，与官网语言无关。

如果 macOS 提示 App 损坏或无法验证，请从首页重新下载。仍有提示时，请向支持邮箱提供完整提示、macOS 版本与 DMG 文件名。

配对与权限

让 iPhone 与 Mac 处于同一可信局域网。在 Mac 打开“设备 → 添加 iPhone”，点“生成配对码”；在 iPhone 扫描二维码，也可以选择手动连接，填写 Mac 显示的地址、端口和六位码。配对码过期或被拒绝时，请生成新码。

在 iPhone 允许“本地网络”访问，以便连接 Mac。相机权限可选，仅扫码时需要；拒绝后仍可手动配对。配对后按提示允许“通知”。这些权限均可在 iPhone 系统设置中调整。

在 Mac 的“项目”中添加项目，并在“集成”中启用 Claude Code 或 Codex。按提示修复连接或补齐配置；Codex Hook 更新后需在 Codex 中审阅并信任。在该项目中运行任务来验证提醒，App 没有独立的“测试通知”按钮。

网络、通知与审批

Mac 上的 AckPulse 需要保持运行。查看详情、活跃会话和发送审批决定，需要 iPhone 与配对 Mac 在同一可信局域网且能够互相连接。本地通信使用未加密 HTTP；访客 Wi-Fi、设备隔离、VPN 路由或防火墙可能阻止连接，即使两端显示相同的 Wi-Fi 名称。

通用提醒经 Apple 推送投递，需要互联网连接。iPhone App 在后台或锁屏时也可接收；提醒显示在哪台设备取决于设备状态、专注模式和通知设置，不保证 iPhone 与 Apple Watch 同时提醒。收到提醒时，本地详情与审批操作仍可能不可用。投递可能延迟或失败。

选择“允许一次”或“拒绝”前，请先检查请求。决定提交成功不代表 Agent 已完成操作，实际结果请在 Agent 及 Mac 设备上核对。对话、问题回复及未支持的操作仍在 Mac 上的 Agent 中完成。

恢复连接

无法连接时，先确认 Mac 上的 AckPulse 正在运行、iPhone 已允许本地网络访问，地址与实际端口和 Mac 当前配对信息一致。检查访客网络隔离、VPN 路由及防火墙后，在 iPhone 重新连接。不要为临时网络故障删除历史数据。

详情正常但收不到提醒时，检查 iPhone 通知与专注模式设置、互联网连接，以及 Mac“设备”页中该 iPhone 的推送登记状态。在 iPhone 打开 AckPulse 并重新连接以刷新登记；仍有问题时，将检查过的诊断信息发给支持邮箱。

如果配对已在 Mac 被移除，请生成新码重新配对。更换 Mac 时，尽量在旧 Mac 可访问时先移除配对。“在本机忘记旧 Mac 并继续”只清除 iPhone 本地配对；旧 Mac 恢复可用后，请在其“设备”页移除该 iPhone，否则仍可能收到残留的通用通知。

手动升级

AckPulse Mac 版目前没有自动更新器，推荐版本见首页。如果 iPhone 提示“Mac 上的 AckPulse 版本过旧”，点“下载 Mac 版 AckPulse”前往官网，下载推荐的 Mac DMG；如果提示更新 iPhone 上的 AckPulse，请在 App Store 更新。

先处理完等待中的审批，再在 Mac 选择“退出 AckPulse”；只关闭窗口不会退出服务。打开新版 DMG，替换“应用程序”中的 AckPulse，推出磁盘映像后重新打开已安装的 App。替换 App 不会主动删除配对、项目、偏好或历史。如果 Agent 仍指向另一份 AckPulse，请按集成页提示修复。更新后，在 iPhone 点“重新检查”。

1.x 两端支持混用，新功能受较旧一端能力限制。如果提示版本不兼容，请按提示更新对应设备上的 AckPulse；重新配对或清空数据不能解决版本不兼容。

已知限制

• 通知与本地连接尽力提供服务。审批过期、已在其他位置处理或结果不确定时，请回到 Mac 上的 Agent 核对。
• Agent 退出或中断后，活跃会话状态可能滞后；会话仍在列表中不代表它还在运行。
• AckPulse 提供状态、提醒和受支持的权限审批，不提供远程聊天或完整的 Mac 远程控制。
• Mac 与 iPhone 必需。Apple Watch 查看详情和审批还依赖与 iPhone 的连接，以及 Mac 的本地可达性。