开始使用
本项目的官方实例是 https://pairfob.com。电脑必须能打开本机 Herdr。目前支持 macOS 和 Linux，Windows 还不支持。
做完这四步，就可以在另一台设备上看到电脑上的会话：安装 Herdr → 安装 Pairfob → 配对 → 点进列表。
你需要什么
| 需要 | 说明 |
|---|---|
| 一台 macOS 或 Linux 电脑 | pairfob 跑在这里，agent 也跑在这里 |
| Herdr 0.8 或更高 | Pairfob 不自带 agent，也不代替 Herdr |
curl | 安装脚本用来下载 |
| 另一台设备的浏览器 | 手机、平板，或另一台电脑都可以 |
1. 电脑上装好 Herdr
Pairfob 不代替 Herdr。agent 仍在这台电脑上跑，但安装 Pairfob 前不需要先打开 Herdr。pairfob 启动时发现 Herdr 不在线，就会自己拉起它。你之后照常运行 herdr，会接到同一个地方，手机上已经打开的会话不会变成副本。
如果自动启动失败，手机会明确提示 Herdr 没有运行；在电脑执行一次 herdr 后会自动恢复，不用重启 Pairfob 或重新配对。不必为 Pairfob 做一个额外的「远程模式」。
2. 安装 pairfob
curl -fsSL https://pairfob.com/install.sh | sh这会下载 pairfob、向官方实例 https://pairfob.com 登记，并装上登录即启动的用户服务。
这是登录后启动，不是开机就活。合盖睡眠或注销会停掉，回到同一次图形会话后再起来。
第二台电脑也是这条命令，然后在手机上 设置 → 切换电脑 → 添加电脑。
参数、安装位置、如何卸载见 安装。
装好后直接敲 pairfob（后面不跟子命令），它会用一段人话告诉你：在不在跑、配了对几台、Herdr 开没开。更完整的检查用 pairfob doctor。
3. 配对
在跑 pairfob 的那台电脑的终端里：
pairfob pair它会优先画出二维码，并保留一串给手输用的码。另一台设备打开 pairfob.com/pair：
- 能扫码：直接扫，开始配对
- 不能扫：展开手输。必须是 8 位配对码 + 6 位定位码（可以一次粘贴 14 个字符）
电脑提示对端已经验证之后，在终端里按一次 Enter。这是授权，不是账号登录。两边都不会显示安全词。
细节、过期和报错见 配对。
4. 点进去
Herdr 里的会话会出现在 Pairfob 列表里。点一张卡片，打开的是电脑上那个会话，不是副本。
状态是「等你」时，提示留在终端画面里，不会替你盲发 Enter。用按键垫的 ↑/↓ 选择，再按 Enter 确认。对话模式里，编号选项可以在 需要你确认 卡上选一项再发送（发送前会核对终端画面没变），或点 去终端处理 切到控制。底部输入框用系统键盘，听写和自动更正都还在。发出去的字进的是电脑上那个会话。
界面说明见 手机上怎么用。出门再打开、坐回来不用同步，见 出门和回来。
加到主屏幕
Pairfob 是网页应用，可以加到主屏幕，下次少一层浏览器地址栏。
iOS / iPadOS（Safari）
- 打开 pairfob.com/pair（已配对后会直接进列表）
- 分享 → 添加到主屏幕
- 以后从图标打开
iOS 建议走主屏幕；只停在 Safari 标签里也能用，但通知和全屏会受限。
Android（Chrome）
浏览器可能会提示「安装应用」，也可以菜单 → 安装应用 / 添加到主屏幕。
凭证在这台设备的这个浏览器配置里。换浏览器、清站点数据、或 iOS 上用「无痕」等于要重新配对。
怎样算成功
| 在电脑上 | 在手机上 |
|---|---|
pairfob doctor 里 Running / Herdr / Origin 都正常 | 打开就能看到同一份会话列表 |
pairfob list 能看到这台设备 | 点进「等你」的卡片，提示在画面里；用按键垫选择再按 Enter |
| 电脑 Herdr 窗口还在 | 打的字出现在电脑那个会话里 |