# @fro\.bot/harness 中文文档

规范地址：https://npmcn.com/package/%40fro.bot/harness/

版本：1\.19\.5-harness\.bf7f7dfe
npm 元数据更新时间：2026-11-07T03:01:44.564Z
中文译文更新时间：2026-11-16T00:09:16.665Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fro.bot/harness
原文对照：https://npmcn.com/package/%40fro.bot/harness/?lang=original
项目主页：https://github.com/fro-bot/agent#readme
源码仓库：https://github.com/fro-bot/agent

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

- 包体积（解压后）：391 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：0 个
- 首次发布：2026-06-04T20:38:35.962Z
- 最新版本发布：2026-11-07T03:01:44.200Z
- 近 30 天下载量：1983（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 29 个）

## 中文简介

已发布有 orw- 嵌入 LLM- 并存集成的补丁- OpenCode 二进制—— Fro Bot 默认的 OpenCode

## 安装

```sh
npm install @fro.bot/harness
```

也可以使用：`pnpm add @fro.bot/harness`、`yarn add @fro.bot/harness`、`bun add @fro.bot/harness`

## README

# @fro.bot/harness (法语)

补丁的"OpenCode"构建了"Fro Bot"运行. 安装此软件包会给您两个命令 `PATH`数字 :

-   **`harness`** ——补丁的"OpenCode"外加几个自带子命令.
-   **`opencode`** ——补丁的"OpenCode"等.

## 图标

### `harness`

| 命令 | 对 |
| --- | --- |
| `harness info` | 打印出处:基版、集成参考、构建 SHA |
| `harness patches` | 列出上游上方的整合参考文献 |
| `harness doctor` | 检查解析二进制是否存在, 可运行, 以及正确的构建 |
| `harness integrate` | 运行集成管道( 维护者) |
| `harness --help` | 打印使用情况 |
| `harness --version` | 打印带子出处版本 |

其他一切通到补丁二进制: `harness run ...` 行为就像 `opencode run ...`。 。 。 .

### `opencode`

纯粹的传球 它没有保留子命令: 每个参数, 包括 `--version`, (中文(简体) ), `info`, (中文(简体) ), `doctor`,以及 `upgrade`,到补丁二进制不变。 外观工具 `opencode` 按名称(编辑器,脚本,OpenCode SDK)获得补丁构建.

## 安装

```bash
npm i -g @fro.bot/harness
bun add -g @fro.bot/harness
mise use -g npm:@fro.bot/harness
```

安装者作为可选依赖性而拉入的每个平台包中的本土二进制船:

| 软件包 | 平台 |
| --- | --- |
| `@fro.bot/harness-linux-x64` | Linux x64 函数 |
| `@fro.bot/harness-linux-arm64` | Linux arm64 (英语) |
| `@fro.bot/harness-darwin-x64` | macOS x64 |
| `@fro.bot/harness-darwin-arm64` | 马可斯臂64 |

不支持视窗 。 当平台软件包缺失时安装不会失败;然后命令随消息退出,直到提供二进制(见下文).

### 安装提醒

两个命令共享名称 `opencode` 与库存 `opencode-ai` 软件包,所以两者要竞争同一个垃圾箱。 打开代码 2's `@opencode/cli` (也声明 `opencode2`声明 `opencode` 垃圾桶和碰撞同样的方式。 遗产 `opencode-ai` 财务报告和审定财务报表 `@opencode-ai/sdk` 包留在1.x线上.

-   **无 :** 若为 `opencode-ai` 在全球安装,安装吊带失败 `EEXIST` 因为那个包已经拥有了 `opencode` 宾. `npm i -g --force @fro.bot/harness` 覆盖了垃圾桶。 卸下吊带,然后取出 `opencode` ; 重新安装 `opencode-ai` 如果你想要 股票命令回来.
-   **包子 :** 一个全局安装静态覆盖现有的 `opencode` 宾.
-   **错误 :** 哪个 `opencode` 运行取决于 `PATH` 工具 mise 管理之间的顺序。 检查 `which opencode`。 。 。 .

## 二进制是如何找到的

按顺序排列:

1.  **`OPENCODE_PATH`** —— 一条通往本土二进制的明确路径(建议一条绝对路径),而不是脚本或像 mise shim这样的调度器. 赤裸或相对值与当前目录相对并不存在 `PATH`。 。 。 .
2.  **平台软件包** —— 说 `@fro.bot/harness-<os>-<arch>`,用安装的绳子解决.
3.  **`HARNESS_ALLOW_PATH_FALLBACK=1`** - 搜索 `PATH` 当地人 `opencode`. 只用于发展.

分辨率从不运行二进制检查 。 候选人在下列情况下被拒绝而不是被处决:

-   不是一个本地二进制(无法证明脚本或调度器是补丁构建);
-   非可执行文件;
-   绳子本身的入门点之一 将永远重演 这个检查比较了真实的路径和inode,因此与shim的同音和硬链接被捕获. shim的复制品是一个不同的文件,不被确认为一个文件.

`harness doctor` 是例外: 它以 `--version` 并将它与预期的建筑相比较。 还印出二进制 `opencode` 命令将运行( c)`opencode command:`如果解析失败,即使探测器通过,则退出非零.

## 升级

`opencode upgrade` 无法支持一个带子安装, OpenCode 从未更新它 。 用您安装的工具更新软件包 :

```bash
npm i -g @fro.bot/harness@latest
bun add -g @fro.bot/harness@latest
mise upgrade
```

不运行 `opencode upgrade --method <pm>`: 安装库存 `opencode-ai` 从包管理器,而不是绳子. `opencode upgrade --major --method <pm>` 更糟糕的是:它消除了全球 `opencode-ai` 软件包和安装 OpenCode 2 (`@opencode/cli`而不是绳子.

自1.19起,OpenCode从未自动安装更新 `autoupdate` 设置只控制更新通知。 互动的TUI在启动后不久和每10分钟检查一次更新发布,并可能显示更新通知或"OpenCode 2"通知. 设定 `autoupdate: false` 或者说 `OPENCODE_DISABLE_AUTOUPDATE` 关闭支票. `opencode serve` 从来没有运行检查。 支票是最新的 `opencode-ai` 从 npm 登记册中释放每个安装方法( Homebrew Core 是例外: 它的公式是 OpenCode 2, 所以检查报告没有更新) 。 只有更新的 1.x 发布算作更新,在比较时忽略已安装的版本的构建元数据,所以 `<base>+harness.<sha>` 年龄不大于 `<base>`。 。 。 .

通过询问每个软件包管理器是否检测到安装方法 `opencode-ai` 全球安装( 二进制 `.opencode/bin` 或者说 `.local/bin` 算作卷轴安装). 绳子安装没有匹配,所以它的方法是 `unknown`,并应用来自 `/update`, (中文(简体) ), `opencode upgrade`,或 `opencode upgrade --major` 失败 : TUI 报告“ 安装方法找不到 ” , CLI 报告一种未知的安装方法 (`opencode upgrade` 先问“反正还是安装”,默认为“否”.

如果库存 `opencode-ai` 也安装在一个被检测到的软件包管理器下,该方法被检测为该管理器,以及一个应用的更新目标,代之以安装库存.

## 信号和退出代码

Shim作为一个直接的孩子运行二进制,拥有被继承的stdio,并停留在您终端的前缘组中,因此终端输入,Ctrl-C,窗口再调整大小的行为就像他们为股票OpenCode所做的那样.

-   **信号 :** `SIGINT`, (中文(简体) ), `SIGTERM`, (中文(简体) ), `SIGHUP`, (中文(简体) ), `SIGQUIT`, (中文(简体) ), `SIGUSR1`,以及 `SIGUSR2` 转交儿童。 因此,发送到整个前景组的信号,如Ctrl-C或终端挂起,可能会两次到达孩子.
-   **无法转交的案件:** `SIGKILL` 发送到shim,或其中未发现错误,可以让服务器运行.
-   **吊车保护不能通过吊车:** 节点重置继承的信号在启动时忽略, 所以 `nohup opencode serve` 财务报告和审定财务报表 `trap '' HUP` 不保护运行在shim的服务器。 为了让服务器在悬架上活着,直接引用本地二进制,而不是通过shim: `nohup "$OPENCODE_PATH" serve` 与 `OPENCODE_PATH` 设置为本地二进制,或平台软件包 `bin/opencode`(安排工作) `OPENCODE_PATH` 单枪匹马仍通过闪电发射

退出代码 :

| 代码 | 含义 |
| --- | --- |
| 儿童代码 | 未经更改通过 |
| 信号死亡 | `SIGINT`, (中文(简体) ), `SIGTERM`, (中文(简体) ), `SIGHUP`, (中文(简体) ), `SIGQUIT` 在shim上重新提升; 任何其他信号出口 `128+n` |
| `127` | 未找到二进制、 被决议拒绝或自引用 |
| `126` | 二进制存在但无法执行 |
| `1` | 任何其它的产卵故障, 或者一个意外的错误在shim |

## 开发结账

在检查这个寄存器时, `bun install` 链接 `node_modules/.bin/opencode` 对工作空间shim,所以 `opencode` 内部 `bun run` 脚本决定了它。 工作空间没有平台软件包, 所以设置 `OPENCODE_PATH` 给本地的二进制:

```bash
OPENCODE_PATH=/path/to/native/opencode bun run <script>
```

## 许可证

麻省理工学院. 嵌入层 [皮质外科/orw](https://github.com/cortexkit/orw)集成方法并重新分配修改过的 [打开代码](https://github.com/anomalyco/opencode) 构建; 见 `LICENSE`。 。 。 .

## 常见问题

### @fro\.bot/harness 是什么？

已发布有 orw- 嵌入 LLM- 并存集成的补丁- OpenCode 二进制—— Fro Bot 默认的 OpenCode

### 如何安装 @fro\.bot/harness？

在项目目录运行 npm install @fro\.bot/harness，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 harness、opencode，可以用 npx harness 直接运行。

### @fro\.bot/harness 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fro\.bot\_\_harness 是否存在。

### @fro\.bot/harness 支持 ESM 还是 CommonJS？

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

### @fro\.bot/harness 需要什么版本的 Node\.js？

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

### @fro\.bot/harness 可以商用吗？

@fro\.bot/harness 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fro\.bot/harness 的下载量有多少？

根据 npm 官方下载统计，@fro\.bot/harness 在 2026/10/16 – 2026/11/14 这 30 天内被下载 1,983 次，日均约 66 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fro\.bot/harness 还在维护吗？

最新版本 1\.19\.5-harness\.bf7f7dfe 发布于 2026/11/07（8 天前）；至今共发布 29 个版本，其中过去 12 个月发布了 29 个；首次发布于 2026/06/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

