电脑上的命令

remote 和 pairfob 是同一个程序；本站的安装脚本会在 pairfob 旁边加上 remote。下面每条命令用哪个名字都行。

装好后 Remote 在后台跑。终端里直接敲 remote（后面不跟子命令）会打印状态并退出：在不在跑、配了对几台、Herdr 开没开。没在跑时会打印恢复建议，并以非零状态退出。

Remote is running.
1 device paired.
Herdr is on.

  remote pair     pair a device
  remote list     what's paired
  remote doctor   full check

没在跑时，按提示执行对应的服务命令，或用 remote run 在前台运行。睡眠和注销会停掉登录服务，回到同一次会话后再起来。

日常命令

remote pair      # 配对手机、平板或另一台电脑
remote list      # 已经配对的设备
remote forget 1  # 解除第 1 台（序号来自 list）
remote doctor    # 本机检查
remote run       # 在前台运行 daemon
remote update    # 换成最新版本并重启用户服务
remote version
remote help

forget 也可以写设备名；重名时必须用序号。unpair 是 forget 的别名。

remote machine list 列出这台电脑上 Herdr 保存的 SSH 机器，remote machine link 名字 让设备和其中一台配对。见 Herdr 通过 SSH 连接的机器。

setup

remote setup 自动安装缺少的最新稳定版 Herdr，按需启动并验证接口。--no-install-herdr 禁止下载；--non-interactive 不会禁止补齐依赖。已有安装直接复用。doctor 只诊断。Remote 管理的运行组件使用 remote setup --update-herdr 更新，见 Herdr 更新。

doctor

Remote <version>

  Installed   <version>
  Process     <version> (PID 1234)
  Running     yes
  Paired      1
  Herdr       ready (0.8.2, protocol 20)
  P2P         on
  Origin      remote.tmts.ca

项	正常	不正常时
Running	yes	service not installed → remote service install；service stopped → remote service start；service running but not answering → remote service restart；状态查询失败 → remote service status
Paired	≥ 1	还没配对，跑 remote pair
Herdr	ready	not installed / installed but not running / incompatible server / unavailable
P2P	on	off 表示这台电脑只用中继（PAIRFOB_P2P=0）；unknown 重启 Remote 后会恢复
Origin	remote.tmts.ca	还没登记

doctor 在 Running 或 Herdr 不正常时会以失败退出，方便脚本检测。

Installed 是当前命令的版本，Process 是实际响应本机请求的后台进程版本。两者不一致时执行 remote service restart。很旧的 daemon 无法报告真实版本，手机会显示版本未知，不再把旧接口固定返回的 0.1.0 当成发行版本。

服务

安装脚本默认会装用户服务。doctor 和未运行状态会建议对应的 install、start、restart 或 status 命令，保持服务不变。需要前台运行时使用 remote run。在终端直接输入 pairfob 只显示状态；登录服务仍按原来的方式启动 daemon。需要手调服务时：

remote service status
remote service restart
remote service stop
remote service start
remote service uninstall
remote service install

推送相关的环境变量不会自动写进服务文件，需要的话见 通知。

更新

remote update

换成最新版本并重启已安装的用户服务。不要把 install.sh 再跑一遍当更新。托管的二进制用 SemVer（remote version）；网站构建号是另一套日期戳。

即使文件已经最新，更新命令也会核对后台进程的版本、程序文件与用户服务 PID。安装和重启同样等待对应进程稳定就绪后才报告成功。独立运行的旧进程只有在所属用户、可执行文件和状态目录都能核实时才会被接管，否则会指出冲突，要求明确处理该进程。已有配对会保留。

下载会显示已接收字节数，临时失败后重试一次。每次最多十分钟，连续 45 秒没有进展则中止；替换文件前仍校验 SHA-256。如果代理反复卡住下载，需要检查当前终端的代理配置，更新命令不会自行修改代理设置。

手机会检查电脑端新版本并显示更新提醒。设置页中，支持的用户服务安装会提供写明新版本号的“更新到 v…”按钮。确认后连接会短暂中断，校验过的新二进制启动后自动重连；只有确认运行版本后才显示完成。新版本启动失败时可恢复旧二进制。旧 daemon 需要先手动执行一次 remote update 才能启用此流程。应用不会自动安装更新。

进阶（日常帮助里不列）

这些仍然可用，主要给自动化和排障：

命令	用途
remote pair new	只开配对、打印码，不进入交互确认
remote pair accept / deny	不按 Enter、用命令确认或拒绝
remote enroll	再登记一次。安装脚本已经做过
remote relay rekey	轮换重连凭据
remote device revoke <id>	按设备 id 吊销（forget N 更常用）