@coool/opencode-adaptive

中文文档
1.6.3发布于 2026/11/11MITTypeScriptESM + CJS近 30 天下载 2089

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

中文使用文档
文档目录9 节
  1. 你能用它做什么吗
  2. 特征
  3. 安装
  4. 设置
  5. 等级
  6. 当模型失败时
  7. 限制
  8. 解决问题
  9. 隐私

@ cooool/ opencode- 适应性

npm version npm downloads

自动模式倒置和路由 打开代码。 。 。 .

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

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

你能用它做什么吗

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

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

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

特征

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

安装

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 共发布 15 个版本,首次发布于 2026/11/03;过去 12 个月发布了 15 个版本。

版本发布日期距今
1.6.3latest2026/11/112 天前
1.6.22026/11/113 天前
1.6.12026/11/103 天前
1.6.02026/11/104 天前
1.5.02026/11/086 天前
1.4.12026/11/068 天前

关于 @coool/opencode-adaptive 的常见问题

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