开始使用

本项目的官方实例是 https://remote.tmts.ca。电脑必须能打开本机 Herdr。目前支持 macOS 和 Linux，Windows 还不支持。

做完这四步，就可以在另一台设备上看到电脑上的会话：确认使用条件 → 安装 Remote（缺少 Herdr 时一并安装）→ 配对 → 点进列表。

你需要什么

需要	说明
一台 macOS 或 Linux 电脑	pairfob 跑在这里，agent 也跑在这里
Herdr 0.8 或更高	Remote 不自带 agent，也不代替 Herdr
curl	安装脚本用来下载
另一台设备的浏览器	手机、平板，或另一台电脑都可以

1. 确认电脑的使用条件

用手机接着操作时，macOS 或 Linux 电脑必须保持唤醒并联网。安装器会自动补齐缺少的最新稳定版 Herdr，无交互终端时也一样。已有兼容安装会复用，不自动升级。需要禁止安装依赖时使用 --no-install-herdr。

Remote 不代替 Herdr。agent 仍在这台电脑上跑，但安装 Remote 前不需要先打开 Herdr。pairfob 启动时发现 Herdr 不在线，就会自己拉起它。你之后照常运行 herdr，会接到同一个地方，手机上已经打开的会话不会变成副本。

如果自动启动失败，手机会明确提示 Herdr 没有运行；在电脑执行一次 herdr 后会自动恢复，不用重启 Remote 或重新配对。不必为 Remote 做一个额外的「远程模式」。

2. 安装 pairfob

curl -fsSL https://remote.tmts.ca/install.sh | sh -s -- --origin https://remote.tmts.ca

这会下载 pairfob、检查 Herdr 并按需启动、向官方实例 https://remote.tmts.ca 登记，并装上登录即启动的用户服务。

这是登录后启动，不是开机就活。合盖睡眠或注销会停掉，回到同一次图形会话后再起来。

第二台电脑也是这条命令，然后在手机上 设置 → 切换电脑 → 添加电脑。

参数、安装位置、如何卸载见 安装。

装好后直接敲 pairfob（后面不跟子命令），它会用一段人话告诉你：在不在跑、配了对几台、Herdr 开没开。更完整的检查用 remote doctor。

3. 配对

在跑 pairfob 的那台电脑的终端里：

remote pair

它会优先画出二维码，并保留一串给手输用的码。另一台设备打开 remote.tmts.ca/pair：

• 能扫码：直接扫，开始配对
• 不能扫：展开手输。必须是 8 位配对码 + 6 位定位码（可以一次粘贴 14 个字符）
• 桌面浏览器：页面直接给输入框，把这串码输入或粘贴进去

电脑提示对端已经验证之后，在终端里按一次 Enter。这是授权，不是账号登录。两边都不会显示安全词。

细节、过期和报错见 配对。

4. 点进去

还没有会话时，点 创建，输入所连接电脑上项目的绝对路径（在项目目录运行 pwd 后复制），再选择 Agent 类型或终端。类型列表表示支持哪些 Agent；所选 Agent 仍需先在那台电脑安装并登录。

Herdr 里的会话会出现在 Remote 列表里。点一张卡片，打开的是电脑上那个会话，不是副本。

状态是「等你」时，提示留在终端画面里，不会替你盲发 Enter。用按键垫的 ↑/↓ 选择，再按 Enter 确认。对话模式里，编号选项可以在 需要你确认 卡上选一项再发送（发送前会核对终端画面没变），或点 去终端处理 切到控制。底部输入框用系统键盘，听写和自动更正都还在。发出去的字进的是电脑上那个会话。

界面说明见 界面怎么用。出门再打开、坐回来不用同步，见 出门和回来。

加到主屏幕

Remote 是网页应用，可以加到主屏幕，下次少一层浏览器地址栏。

iOS / iPadOS（Safari）

1. 打开 remote.tmts.ca/pair（已配对后会直接进列表）
2. 分享 → 添加到主屏幕
3. 以后从图标打开

iOS 建议走主屏幕；只停在 Safari 标签里也能用，但通知和全屏会受限。

Android（Chrome）

浏览器可能会提示「安装应用」，也可以菜单 → 安装应用 / 添加到主屏幕。

凭证在这台设备的这个浏览器配置里。换浏览器、清站点数据、或 iOS 上用「无痕」等于要重新配对。

怎样算成功

在电脑上	在手机上
remote doctor 里 Running / Herdr / Origin 都正常	打开就能看到同一份会话列表
remote list 能看到这台设备	点进「等你」的卡片，提示在画面里；用按键垫选择再按 Enter
电脑 Herdr 窗口还在	打的字出现在电脑那个会话里

下一步可以看 多台设备、通知，或先把 常见问题 扫一遍。

在电脑上使用

电脑浏览器同样打开 配对页，可以与本机配对，无需先配手机。本地终端运行 herdr 可进入同一批默认会话；命名会话使用 herdr --session 名称。直接运行 pairfob 查看状态。关闭网页不停止任务；停止 Remote 不会停止 Herdr。电脑睡眠或注销时远程连接不可用。