oreo 使用说明
你需要什么
- 一台 macOS 电脑（Apple Silicon 或 Intel），上面跑着 herdr，你的编码 Agent（如 Claude Code）在 herdr 会话里工作。
- 一台 iOS 17+ 的 iPhone，装了 oreo App （TestFlight 邀请制，在首页申请）。
- 首次配对时，手机和电脑在同一个 Wi-Fi。
安装（一条命令）
curl -fsSL https://relay.debuglee.com/install.sh | sh
脚本会下载校验主机端，然后直接在终端里出一张二维码：
打开 oreo App → 添加主机 → 扫码；看到「配对成功」后按 Ctrl-C——
脚本接着自动装成常驻服务（开机自启、崩溃自动拉起），全程不用再敲别的命令。
扫不了码？也可以在 App 里选「添加主机 → 内网发现」，输入屏幕上的「配对短码」。
到这里，内网使用已经完整——手机和电脑同一个 Wi-Fi 时， 打开 App 就能看到你的 Agent。以后更新也是重跑这同一条命令：已配过对的机器不会再出码， 换完二进制自动重启常驻服务。
云端中继（在外面也能连）
出了家门想连，需要云端令牌：在首页申请内测， 审批通过后令牌会发到你邮箱。
推荐：在 App 里一贴即通。手机和电脑在同一个 Wi-Fi、App 连着主机时， 打开 oreo → 设置 → 连接 → 「云端令牌」粘贴框，粘贴令牌 → 点「下发到主机」。 几秒后云端和推送就好了——电脑那头零操作，配置由主机自己存着，以后更新也不用重配。
不方便用手机配的话，命令行也行（效果一样）：
export HERDBRIDGE_RELAY_TOKEN='<你的令牌>' herdbridge install \ --relay wss://relay.debuglee.com/ws \ --relay-key '1CtGBiMZqlEZt0ulnIGpAmOylOke2+SlPzrX/7cUwEM='
用命令行方式配的，装完后手机要先在 Wi-Fi 下连一次 （App 会从主机学到中继地址），之后切蜂窝才有路可走（粘贴框方式配的天然满足——粘贴那一刻就连着）。 中继只转发端到端加密的密文，看不到你的终端内容。
配了云端后，推送通知（Agent 卡住等你时手机响一声）自动可用： 通知经中继代发到 Apple，你的机器上不需要任何 Apple 凭据；通知正文是端到端加密的， 中继与 Apple 都看不到你在做什么。
日常
- 看板：Agent 按状态分组，「需要你」永远在最上面；顶部是 Claude Code 的账号额度和这台机器的累计花费。
- 点开任何一个 Agent：直接进入那个会话的全屏终端。键盘默认收着， 点终端内容或按键区的键盘开关打字；上滑翻历史；长按选中复制。
- 终端 Tab：整个 herdr 工作台（多 tab / 多 pane），和桌面上是同一个会话。
- 右上角徽章：显示走内网还是云端；开着云端时点它可手动切换。
更新
重跑安装那一条命令就行（配对不用重来，脚本认得出这台机器已配过对， 换完二进制自动重启常驻服务）：
curl -fsSL https://relay.debuglee.com/install.sh | sh
在 App 里贴过令牌的，云端配置自动保留；早期用命令行方式配过云端的，
脚本会提示你带上原来那三行参数重跑 herdbridge install。
再配一台手机 / 重新出码
重跑安装那一条命令，看到「这台机器已配过对」的提示时输入 p 回车—— 脚本会自动停掉常驻服务、出码（二维码 + 配对短码）、扫完 Ctrl-C 后再自动装回去， 全程不用手敲别的命令：
curl -fsSL https://relay.debuglee.com/install.sh | sh
（早期用命令行方式配过云端的机器不走这个流程，脚本会给出对应指引。）
卸载
herdbridge uninstall rm ~/.local/bin/herdbridge
故障排查
- App 说「局域网里没有找到任何正在运行的 herdbridge」/「搜索中」转个不停：
在电脑上跑一条命令，三句话里有下一步：
~/.local/bin/herdbridge status
「没装」= 安装时脚本没走完（比如扫完码直接关了终端）——重跑一遍安装命令即可， 已配对的机器会自动装好常驻服务、不再出码。「装了但没在跑」= 看它指给你的日志， 发给我们。「在跑」= 问题在网络：确认两端同一个 Wi-Fi（访客网络/AP 隔离会挡住发现）。 日志在~/Library/Logs/herdbridge/err.log。 - 「herdr 未运行」：主机连上了，但它上游的 herdr 没在跑。去电脑上把 herdr 起来。
- 看板上没有额度/花费：这份数据来自 Claude Code 落在本机的缓存， Agent 至少跑过一轮之后才有。
- 云端连不上：最省事的修法是在 App 设置页重新粘贴一次令牌
（主机自存的配置会被更新，优先于装机参数）。用命令行方式装的，确认重跑
herdbridge install时环境里有HERDBRIDGE_RELAY_TOKEN； 被吊销的令牌会静默连不上，联系我们确认。 - 推送通知收不到：推送要求配了云端令牌（经中继代发，主机上不需要任何 Apple 凭据）。确认配过云端（App 里贴过令牌，或装机带过那三行参数）；iPhone 的设置里允许 oreo 通知； 人正开着 App 盯着看板时按设计不推（你已经在看了）。