@fro.bot/opencode-plugin

中文文档
0.1.0发布于 2026/10/29MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 2160

Fro Bot 的 OpenCode V2 插件: 会话历史工具和子代理会话- 重复使用守护

中文使用文档
文档目录3 节
  1. 使用
  2. 开发
  3. 释放

@fro.bot/ opencode- plugin (英语)

Fro Bot 插件用于 打开代码 V2(v2.2.0及后为 2.x线). 它给了特工两件事:

  • 会话历史工具. session_list, (中文(简体) ), session_read, (中文(简体) ), session_search 财务报告和审定财务报表 session_info 读取当前工作空间的会话. session_read 财务报告和审定财务报表 session_search 覆盖会话的活跃上下文窗口:自其上次收缩以来的信息,加上收缩摘要。 托多来自最后完成的 todowrite 呼叫窗户.
  • 副剂再用后卫. A 类 subagent 电话里有 sessionID 在运行前被拒绝,并带有一个没有身份证明的固定消息。 每一个副代理开始一个新鲜的孩子会话.

插件 id 是 fro-bot.opencode-plugin。OpenCode V2 跳过一个无法加载并持续服务的插件,所以任何依赖于此插件的插件都应该检查 GET /api/plugin 身份证明 active。 。 。 .

使用

安装精确版本, 然后在 OpenCode 配置中列出软件包 :

opencode plugin add @fro.bot/opencode-plugin@<version>
{"plugins": ["@fro.bot/opencode-plugin@<version>"]}

effect 财务报告和审定财务报表 @opencode/plugin 是同伴的依赖关系。 OpenCode在负载时间同时提供两者,因此捆绑从不携带自己的副本.

开发

bun run --filter @fro.bot/opencode-plugin test        # unit tests
bun run --filter @fro.bot/opencode-plugin build       # bundle to dist/

src/integration.test.ts 将已建的捆绑装入真实的 OpenCode 二进制。 除非 dist/index.mjs 已存在,且 FRO_BOT_OPENCODE_V2_BIN 在 OpenCode v2.2.0 可执行文件上的点。 下载您平台的发布资产, 对照发布内容进行验证 SHA256SUMS,将其拆入临时目录,然后删除.

释放

调度 .github/workflows/opencode-plugin-release.yaml 与版本一起发布。 它与 npm 信任的出版(OIDC)一起出版. 见 BOOTSTRAP.md 为一次性设置.

版本与发布记录

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

版本发布日期距今
0.1.0latest2026/10/2917 天前
0.0.0bootstrap2026/10/2917 天前
0.0.0-stage2026/10/2917 天前

关于 @fro.bot/opencode-plugin 的常见问题

@fro.bot/opencode-plugin 是什么?

Fro Bot 的 OpenCode V2 插件: 会话历史工具和子代理会话- 重复使用守护

如何安装 @fro.bot/opencode-plugin?

在项目目录运行 npm install @fro.bot/opencode-plugin,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:effect(^4.0.0)、@opencode/plugin(^2.2.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@fro.bot/opencode-plugin 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@fro.bot/opencode-plugin 支持 ESM 还是 CommonJS?

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

@fro.bot/opencode-plugin 需要什么版本的 Node.js?

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

@fro.bot/opencode-plugin 可以商用吗?

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

@fro.bot/opencode-plugin 的下载量有多少?

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

@fro.bot/opencode-plugin 还在维护吗?

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