# @coool/opencode-adaptive 中文文档

规范地址：https://npmcn.com/package/%40coool/opencode-adaptive/

版本：1\.6\.3
npm 元数据更新时间：2026-11-11T14:31:57.100Z
中文译文更新时间：2026-11-14T09:47:38.435Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1 MB，19 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.19\.0
- 运行依赖：2 个
- peer 依赖：@opencode/plugin \>=2\.2\.1 \<3
- 首次发布：2026-11-03T08:25:06.401Z
- 最新版本发布：2026-11-11T14:31:56.858Z
- 近 30 天下载量：2089（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

OpenCode v2的执行主管插件:能力级路由,结构化-证据升级,水平故障恢复,以及资源健康跟踪.

## 安装

```sh
npm install @coool/opencode-adaptive
```

也可以使用：`pnpm add @coool/opencode-adaptive`、`yarn add @coool/opencode-adaptive`、`bun add @coool/opencode-adaptive`

## README

# @ cooool/ opencode- 适应性

[![npm version](https://img.shields.io/npm/v/@coool/opencode-adaptive)](https://www.npmjs.com/package/@coool/opencode-adaptive) [![npm downloads](https://img.shields.io/npm/dt/@coool/opencode-adaptive)](https://www.npmjs.com/package/@coool/opencode-adaptive)

自动模式倒置和路由 [打开代码](https://opencode.ai/)。 。 。 .

您按偏好顺序列出您的模型 。 适应性在第一个工作上运行每个任务. 当一个模型达到配额,税率限制或停用时,工作会转移到下一个. 首选型号回放时,再次被使用.

它完全从 `/adaptive` 菜单。 没有配置文件可以编辑,也没有模式ID可以输入.

## 你能用它做什么吗

**先用订阅,再用现收现付.** 将您的订阅模式置于列表的首位, 并将 OpenRouter 等 API 提供商置于下方 。 你从你已经付出的钱里得到的最多 API只在订阅额出出定额时才接手,而订阅额一旦重置,就再次被使用.

**对小活儿采用廉价模型.** 为快速、标准、高级工作保留单独的清单。 Typo修补不需要你最强的模型.

**离开长跑无人照顾.** 如果一个模型失败了中途任务,则继续工作在阶梯中的下个准备好的模型,在下个任务中会再次使用首选的模型——完成的工具调用不重复,甚至会跨OpenCode重启. A 类 `/goal` 运行是一系列的任务,所以它自己进行.

## 特征

-   **菜单设置.** 模型、顺序和模式设置在 `/adaptive` 与模式搜索。 没有配置文件 .
-   **几层.** 快速,标准而先进的工作各自会得到自己的列表,失败会留在工作需要的层次内. 经纪人可以要求与 `adaptive_tier` 工具。 运行遵循固定规则,而不是模型可能或不服从的即时.
-   **定额意识.** 它读取了提供者响应头的用法. 当一个订阅几乎用完了(剩下的大约10%)时,新的任务会转到第一层的下个已准备好的模型,并且在提供者报告一个时的重置时间之后再次被使用.
-   **在重启后幸存的恢复 .** 如果工作被打断,并且因为其分级的模型还没有准备好而不能马上继续,那么在第一个返回时(例如当一个配额重置时),它会被自己保存并恢复,没有新的即时和重复完成的工具呼叫——甚至在OpenCode重启之后. 同时脚印显示 `Adaptive · waiting · resumes 18:42`。 。 。 .
-   **干跑动.** 单位 `observe` 模式它记录它会做什么, 有原因,在它改变任何事情之前。 一个会话可以有自己的模式.
-   **手动控制.** 在您知道冷却过后, 标记一个健康的模型, 并恢复或取消会话本身的停放工作 —— 没有即时更新, 没有重复的工具呼叫 .
-   **医生.** 一份报告`/adaptive` → **医生**标出空阶,已丢失或丢失工具支持的模型,有限的资源和已停放的工作,下一步要做什么.
-   **唯取出证相.** 断电从来不会把工作送到更昂贵的级别。 向上移动需要上层环境、政策拒绝或代理人的明确要求.

## 安装

```sh
opencode plugin add @coool/opencode-adaptive
```

需要 OpenCode 2.2.1 或更新 .

## 设置

1.  启动 OpenCode并运行 `/adaptive`。 。 。 .
2.  打开 **模型**选择 **添加模型..**。搜索一个模型并选择它。 重复,最好先说 如果任务需要的级别是空的, OpenCode 自己的模型会运行它.
3.  打开 **模式** 选择 `active`。 。 。 .

新安装开始于 `observe` 模式 : 适应性记录它会做什么但不会改变任何东西。 看着 **收款** 然后切换到 `active`。 。 。 .

| 模式 | 发生什么事 |
| --- | --- |
| `off` | 没什么. |
| `observe` | 决定记录在案,不予适用。 这是默认. |
| `active` | 决定适用。 一个任务改变模型只有在其模型失败时才会发生. |

任何会话都可以覆盖全局模式: 打开 `/adaptive` 在会话中选择 **这届..**。 。 。 .

要重新排序或删除一个模型,请在分级列表中选择它. **状态** 显示每个模型的状态,包括订阅用法(`used 72%, resets 18:42`当提供商报告.

所有东西都生活在 `/adaptive` 菜单 :

| 条目 | 目的 |
| --- | --- |
| **状态** | 分级,资源健康,能力证据. |
| **模型** | 编辑命令等级成员 . |
| **模式** | `off`, (中文(简体) ), `observe` 或者说 `active`全球或本届会议. |
| **级别** | 此会话的分级请求 . |
| **键** | 平一型号. |
| **收款** | 每一个路线决定,都有原因. |
| **卫生** | 在冷却或配额重置后,再次标出健康的模型. |
| **停车工作** | 恢复本次会话的停放工作(通过放弃预算),否则取消. |
| **医生** | 请检查date=中的日期值 (帮助) 分级,模型可用性,工具支持,健康和停放工作. |

## 等级

级是命令的模型列表. 命令是你的政策 适应性永远不会改变它.

-   **快点** 为小的,机械的工作.
-   **标准** 为了其他一切 这是默认.
-   **高级** 为了努力工作.

一个模型可以分为多个层次.

一项任务的级别是适用于下列的第一级:

1.  被钉住的模型(`/adaptive` → **键**) (中文(简体) ).
2.  分层次的会话请求: 代理人可以向 `adaptive_tier` 工具,或设置在会话中 `/adaptive` → **级别**。 。 。 .
3.  从 `agentTiers` 设置(仅限RPC).
4.  `standard`。 。 。 .

背景请求如标题和摘要被观察到,但不在v1中单独路由——它们保留了OpenCode自己的模型.

没有涉及语言模型或关键字匹配 。 如果一个模型是未知的或不符合上下文,则跳出,收据会说明原因. 适应性只使用你添加的模型.

## 当模型失败时

-   **费率限制、配额、超时、停用:** 如果错误是清晰的,而且同一层次的另一模型已经准备好,任务就切换到它,从本届会议开始继续。 您的提示不怨恨, 完成的工具呼叫不再重复 。 如果错误不明确或者没有其他模型准备,OpenCode的正常重试继续进行.
-   **模式多次失败 :** 它被暂停一个冷却, 然后尝试一次。 如果成功的话,就回来了.
-   **等级中的每个模型都会被屏蔽** OpenCode的自有型号运行,决定被记录为带理由的收据. 无法恢复的任务会保存, 当模型返回时会恢复 .
-   **各级的每个模式都用完了配额的中期任务:** 任务等待,然后继续按任何模式重排。 脚步芯片(和GUI作曲药丸)说时间. 自己来或自己选模特儿 都结束了等待.
-   **您取消了 :** 没有被重审或切换.
-   **认证错误或未知模型 :** 该模型无法标记并跳过.

断电从不提高工作水平。 工作只针对真实证据进行:上下文溢出、内容政策拒绝或代理商打电话 `adaptive_escalate` 有原因和证据 每次任务最多发生两次.

## 限制

-   各级之间不得借入. 如果一个分级被耗尽,任务会运行在OpenCode自己的模型上,而不是另一个分级的模型上. 要让一个模型服务两个层次, 把它加到两个层次.
-   升上一层楼的任务就在这里 下一个任务从头开始再次被选中 .
-   使用数字来自响应头,是最佳努力。 使用WebSockets的供应商不会曝光.
-   浏览器/桌面设置页面是实验性的. 尚未发布 OpenCode 载入, 因此使用 `/adaptive`。 。 。 .
-   在网络用户界面(包括移动)类型 `/web-adaptive` 模式和模式状态,或 `/web-adaptive on`, (中文(简体) ), `off`, (中文(简体) ), `observe`, (中文(简体) ), `active` 以切换模式。 这是一个服务器命令,网络应用程序在作曲家的斜线菜单中列出了它.

## 解决问题

-   **没有什么变化.** 你进来了 `observe` 模式。 切换到 `active` 内 `/adaptive` → **模式**。 。 。 .
-   **模特从不选.** 它的提供者必须在 OpenCode 中连接.
-   **收据显示 `park` 新的任务.** 任务开始时,其分层的每个模型都被屏蔽了,因此运行在OpenCode自己的模型上. 收据上写着为什么 检查 `/adaptive` → **状态** 为了冷却.
-   **模式虽然重新设定了配额,但仍受到限制.** 供应商尚未报告重置情况 。 如果你更清楚的话, `/adaptive` → **卫生** 标志它健康.
-   **为什么它选那个模型?** `/adaptive` → **收款**。 。 。 .
-   **"吐司失败".** 插件没有加载 。 更新为 `opencode plugin update`,或删除并再次添加.

## 隐私

没有东西离开你的机器。 没有遥测,没有自己的网络通话,没有设置,收据或日志中的秘密. 收据保留了最新的200个条目,从未添加到提示中.

## 常见问题

### @coool/opencode-adaptive 是什么？

OpenCode v2的执行主管插件:能力级路由,结构化-证据升级,水平故障恢复,以及资源健康跟踪\.

### 如何安装 @coool/opencode-adaptive？

在项目目录运行 npm install @coool/opencode-adaptive，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@opencode/plugin（\>=2\.2\.1 \<3）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @coool/opencode-adaptive 支持 TypeScript 吗？

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

### @coool/opencode-adaptive 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @coool/opencode-adaptive 需要什么版本的 Node\.js？

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

### @coool/opencode-adaptive 可以商用吗？

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

### @coool/opencode-adaptive 的下载量有多少？

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

### @coool/opencode-adaptive 还在维护吗？

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