# hub-runner 中文文档

规范地址：https://npmcn.com/package/hub-runner/

版本：0\.2\.3
npm 元数据更新时间：2026-11-03T18:14:44.274Z
中文译文更新时间：2026-11-03T21:01:17.249Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/hub-runner
原文对照：https://npmcn.com/package/hub-runner/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：294 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：0 个
- 首次发布：2026-10-29T05:51:06.504Z
- 最新版本发布：2026-11-03T18:14:44.090Z
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

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

## 安装

```sh
npm install hub-runner
```

也可以使用：`pnpm add hub-runner`、`yarn add hub-runner`、`bun add hub-runner`

## README

# 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 是什么？

在这台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 和提交记录判断。