把这台 mac 接入 AI 调度系统

装一个小程序（runner），这台 mac 就能领取并执行 AI 任务（在本机跑 claude）。整个过程 1 分钟，仅限 macOS（Apple 芯片 / Intel 都支持）。

⚠️ 开始前先做这一步：拿到你的「接入令牌」

安装到一半会要你粘贴一个接入令牌，临时去找会手忙脚乱。先把它准备好：

管理员发给你的那一串令牌（64 位字符），先复制到手；
或你自己是管理员 → 登录网页「接入令牌」页点「生成令牌」，从框里复制（只显示一次，关掉就没了）。

1确认前提

系统是 macOS。
这台机已装好并登录 claude CLI。没有它也能连上，但任务会执行失败。
手里有接入令牌（见上面那一步）。

2运行安装命令

打开「终端」(Terminal)，粘贴运行：

curl -fsSL https://lab.bogufa.com/runner/install-runner.sh | bash

它会自动下载程序、配置、并提示你 粘贴令牌 —— 把刚才准备好的令牌粘进去，回车。

看到 ✅ 已连上 Server 就装好了。

装的时候弹"允许访问文件夹"？ 这是 macOS 的隐私保护，点「允许」即可。只能你本人点，安装脚本没权限代你授权。一次允许之后就不再弹。

3验证 & 日常操作

看它在不在跑（第一列是数字 = 正在运行）：

launchctl list | grep dispatch-runner

看运行日志：

tail -f ~/.dispatch-runner/runner.log

停 / 起 / 彻底卸载：

# 停
launchctl unload ~/Library/LaunchAgents/com.bogufa.dispatch-runner.plist
# 起
launchctl load -w ~/Library/LaunchAgents/com.bogufa.dispatch-runner.plist
# 彻底卸载
launchctl unload ~/Library/LaunchAgents/com.bogufa.dispatch-runner.plist
rm -f ~/Library/LaunchAgents/com.bogufa.dispatch-runner.plist
rm -rf ~/.dispatch-runner ~/dispatch-tasks

4关于令牌（重要）

一个令牌同时只能一台机器在线用。 别把同一个令牌装到两台机器——后登录的会把先前那台顶下线（旧机自动停止、不再重连）。一台机配一个令牌。
令牌只在生成那一刻显示一次，关掉就看不到了。丢了只能让管理员吊销重发。
不想让某台机器再接入 → 管理员在网页吊销对应令牌，那台机立刻断开。

5常见问题

装完没看到「已连上」/ 连不上？: 多半是：令牌粘错了、令牌被吊销了、或这个令牌已被别的机器占用（一令牌一机）。换/确认令牌后重装。也可 tail ~/.dispatch-runner/runner.log 看报错。
任务跑起来就失败？: 这台机的 claude CLI 没装好或没登录。装好并登录 claude 后再试。
关机 / 注销后还跑吗？: 不跑。它是登录后常驻，关机/注销期间任务会排队，等你下次登录这台机再继续。
令牌从哪拿？: 管理员在调度系统网页「接入令牌」页生成后发给你；你若是管理员可自己生成。