电脑上的命令

装好后 Pairfob 在后台跑。终端里直接敲 pairfob（后面不跟子命令）会打印一段人话状态：在不在跑、配了对几台、Herdr 开没开。

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

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

没在跑时会提示：安装后登录会启动，或在这个终端跑 pairfob。睡眠和注销会停掉登录服务，回到同一次会话后再起来。

日常命令

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

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

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

setup

pairfob setup 检查并按需启动 Herdr；未安装时询问是否安装固定版本。pairfob setup --install-herdr --non-interactive 明确允许补齐依赖且不询问。已安装的 Herdr 不会被自动升级或替换。doctor 保持只读。

doctor

Pairfob <version>

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

项	正常	不正常时
Running	yes	登录服务没起来，看 pairfob service status
Paired	≥ 1	还没配对，跑 pairfob pair
Herdr	ready	not installed / installed but not running / incompatible server / unavailable
P2P	on	off 表示这台电脑只用中继（PAIRFOB_P2P=0）；unknown 重启 Pairfob 后会恢复
Origin	pairfob.com	还没登记

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

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

服务

安装脚本默认会装用户服务。需要手调时：

pairfob service status
pairfob service restart
pairfob service stop
pairfob service start
pairfob service uninstall
pairfob service install

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

更新

pairfob update

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

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

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

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

进阶（日常帮助里不列）

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

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