# @fro\.bot/opencode-plugin 中文文档

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

版本：0\.1\.0
npm 元数据更新时间：2026-10-29T01:23:59.817Z
中文译文更新时间：2026-11-15T16:59:37.110Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：88.4 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：0 个
- peer 依赖：effect ^4\.0\.0，@opencode/plugin ^2\.2\.0
- 首次发布：2026-10-29T01:09:49.869Z
- 最新版本发布：2026-10-29T01:23:59.456Z
- 近 30 天下载量：2160（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

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

## 安装

```sh
npm install @fro.bot/opencode-plugin
```

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

## README

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

Fro Bot 插件用于 [打开代码](https://opencode.ai/) 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 配置中列出软件包 :

```sh
opencode plugin add @fro.bot/opencode-plugin@<version>
```

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

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

## 开发

```sh
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`](https://npmcn.com/package/%40fro.bot/opencode-plugin/BOOTSTRAP.md) 为一次性设置.

## 常见问题

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