hub-runner

中文文档
0.2.3发布于 2026/11/04Apache-2.0ES Module零依赖

在这台Mac上运行hub工作区的Mac bots,无需任何应用程序。

中文使用文档

hub-runner

在这台Mac上运行hub工作区的Mac bots。它在启动状态下运行,所以不需要打开任何应用程序。

npm i -g hub-runner --min-release-age=0
hub-runner login
hub-runner start

login 登录Vercel,询问这台Mac在哪个工作区运行机器人,并存储跑步者自己的会话 ~/.hub/local/credentials.json. 一旦集线器拥有会话,Vercel令牌就会被撤销。

命令它是做什么的
hub-runner start [--take-over]启动已启动的跑者(~/Library/LaunchAgents/dev.hub.runner.plist). 它在每次登录时重新启动,并且在崩溃后不重新启动:run start 再一次。 --take-over 从另一台Mac手中夺取Mac插槽。
hub-runner stop停止它。
hub-runner restart让开放的转弯结束,然后重新开始。
hub-runner status运行程序的状态、pid、版本、bots以及是否已加载。当它不运行时退出1。
hub-runner logs [-f]日志, ~/.hub/local/runner.log。
hub-runner logout停止它并删除存储的会话。

更新

npm i -g hub-runner@latest --min-release-age=0 && hub-runner restart

restart 让转弯现在开完,这样就不会被切断。

--min-release-age=0 当你的NPM配置让包延迟几天时,让最新的版本安装(min-release-age). 它适用于这个安装,hub-runner没有依赖项,所以没有其他东西可以跳过等待。

笔记

  • Node 24或更高版本,以及 pnpm 当你跑步时,在你的路径上 start跑步者使用两者来设置机器人。
  • 中心是 https://hosted-hub.playground-vercel.tools;集 HUB_URL 当你奔跑 login 另一个。
  • HubHosted应用程序只显示跑步者的状态。退出、退出或更换应用程序不会影响跑步者。
  • 如果跑步者没有起跑, hub-runner status 和 hub-runner logs 说为什么。

版本与发布记录

hub-runner 共发布 8 个版本,首次发布于 2026/10/29;过去 12 个月发布了 8 个版本。

版本发布日期距今
0.2.3latest2026/11/041 天前
0.2.22026/11/032 天前
0.2.12026/11/023 天前
0.2.02026/10/315 天前
0.1.22026/10/315 天前
0.1.12026/10/315 天前

关于 hub-runner 的常见问题

hub-runner 是什么?

在这台Mac上运行hub工作区的Mac bots,无需任何应用程序。

如何安装 hub-runner?

在项目目录运行 npm install hub-runner,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 hub-runner,可以用 npx hub-runner 直接运行。

hub-runner 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/hub-runner 是否存在。

hub-runner 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

hub-runner 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

hub-runner 可以商用吗?

hub-runner 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

hub-runner 还在维护吗?

最新版本 0.2.3 发布于 2026/11/04(1 天前);至今共发布 8 个版本,其中过去 12 个月发布了 8 个;首次发布于 2026/10/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。