macOS 安装详解（桌面 App）

桌面 App 安装全程不碰终端：DMG → 拖入「应用程序」→ 双击打开 → 安装后台服务 → 登录核销 → 点「连接」出二维码。

一、下载与芯片选择

下载地址：官网下载页（macOS x64 DMG 已上线，Apple 公证签名，双击即开）。

按 Mac 芯片选包（文件名以实际发布版本为准）：

芯片	选哪个包	怎么看自己的芯片
Apple 芯片（M1/M2/M3/M4 系列）	`DevAnyWhere_x.x.x_arm64.dmg`【占位：arm64 包提供时间以实际发布为准】	屏幕左上角苹果菜单 → 关于本机 → 芯片
Intel	`DevAnyWhere_x.x.x_x64.dmg`	屏幕左上角苹果菜单 → 关于本机 → 处理器

二、安装

双击打开 DMG。
把 DevAnyWhere 拖进「应用程序」文件夹。

三、首次启动：双击即开（Apple 公证签名）

本软件自 0.9.9 起已通过 Apple Developer ID 签名 + notarize 公证（Developer ID Application: TanPinClub）。首次启动直接双击即可，不会被 Gatekeeper 拦截，无需右键打开。

四、安装后台服务（一次开机密码）

启动后菜单栏出现彩色圆点，主面板弹出。
点击「安装后台服务」，在系统密码框输入开机密码——用于安装常驻组网服务，只此一次。
装完后重启无感：后台服务开机自启，日常使用不需要再做任何操作。

五、登录 + 核销邀请码

主面板用发放方提供的邮箱 + 密码登录。
若账号未核销邀请码，App 会锁定在邀请码核销页——输入邀请码（形如 DVA-XXXX-XXXX）完成核销。
规则：先登录再核销；一人一码、一码一人。详见邀请码说明。

六、连接 + 手机扫码

主面板点「连接」，状态灯亮起后显示配对二维码。
用 Android App 扫码——扫码即登录、配对、连接一次完成。
二维码 120 秒内有效；过期或丢失时重新点「连接」获取（以实际版本为准）。

七、日常使用

状态灯： P2P 直连（深绿，最快）｜中继模式（浅绿，同样通畅，走转发）｜连接中（黄）｜未连接（灰）。
详情页：实时对端列表（对端 IP、P2P/中继、延迟）+ 中继「重新检测」（实测中继延迟）。
设置页：账号信息、已核销邀请码、遥测开关（默认关闭）。
主面板关闭后 App 驻留菜单栏，不影响已建立的连接。

八、替代方式：CLI 安装（习惯终端的用户）

要求：macOS、Node.js ≥ 22、本机 Claude Code 已登录。

npm i -g devanywhere        # 或：brew install Rocke1001feller/devanywhere/devanywhere
devanywhere login           # 邮箱 + 密码
devanywhere up              # 首次强制输入邀请码核销 → 自动组网 + 启动 CloudCLI（端口 3001）

up 末尾打印 dva2 配对二维码（120 秒有效；过期或丢失跑 devanywhere mobile 重新出码；dva1 离线配置码为降级通道）。
CloudCLI 管理员密码：首次 up 自动生成的 16 位随机串，只显示一次，存于 ~/.devanywhere/config.json（权限 0600）。

其他命令：

命令	作用
`devanywhere status`	查看组网与 CloudCLI 状态、接入 URL
`devanywhere logs [-f]`	查看 / 跟踪日志
`devanywhere mobile`	重新打印手机配对二维码
`devanywhere doctor`	自检并给出修复建议
`devanywhere down`	停止全部服务
`devanywhere reset`	清除配置（保留日志），回到未绑定态
`devanywhere logout`	退出登录

九、遇到问题（自查表）

现象	自查
双击提示「无法验证开发者」	0.9.9 起已 Apple 公证签名，正常不会出现；若看到，说明装的是旧包，到下载页取最新 DMG
主面板提示后台服务未安装	点「安装后台服务」并输入开机密码
登录后停在邀请码页	输入发放方提供的邀请码；没有则见邀请码说明
二维码过期	重新点「连接」；CLI 跑 `devanywhere mobile`
一直是浅绿（中继）	属预期，正常可用；多数场景几分钟后自动升级深绿 P2P
点「连接」报错	详情页 → 「重新检测」；CLI 跑 `devanywhere doctor`，把结果发给发放方

卸载见卸载指引。