@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-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。 。 。 .
二进制是如何找到的
按顺序排列:
OPENCODE_PATH—— 一条通往本土二进制的明确路径(建议一条绝对路径),而不是脚本或像 mise shim这样的调度器. 赤裸或相对值与当前目录相对并不存在PATH。 。 。 .- 平台软件包 —— 说
@fro.bot/harness-<os>-<arch>,用安装的绳子解决. 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>