@fro.bot/harness

中文文档
1.19.5-harness.bf7f7dfe发布于 2026/11/07MITES Module零依赖构建来源已验证近 30 天下载 1983

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

中文使用文档
文档目录10 节
  1. 图标
  2. harness
  3. opencode
  4. 安装
  5. 安装提醒
  6. 二进制是如何找到的
  7. 升级
  8. 信号和退出代码
  9. 开发结账
  10. 许可证

@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)获得补丁构建.

安装

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

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

软件包平台
@fro.bot/harness-linux-x64Linux x64 函数
@fro.bot/harness-linux-arm64Linux arm64 (英语)
@fro.bot/harness-darwin-x64macOS 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 从未更新它 。 用您安装的工具更新软件包 :

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 给本地的二进制:

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

许可证

麻省理工学院. 嵌入层 皮质外科/orw集成方法并重新分配修改过的 打开代码 构建; 见 LICENSE。 。 。 .

版本与发布记录

@fro.bot/harness 共发布 29 个版本,首次发布于 2026/06/05;过去 12 个月发布了 29 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.19.5-harness.bf7f7dfelatest2026/11/078 天前
1.19.4-harness.5bde26352026/10/2719 天前
1.19.0-harness.caa472722026/10/121 个月前
1.18.34-harness.6546eb642026/10/061 个月前
1.18.30-harness.7c4794292026/09/102 个月前
1.18.30-harness.770cf62d2026/09/102 个月前

关于 @fro.bot/harness 的常见问题

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