@marscore-archi/opencode-provider

OpenCode 插件：启动时自动从 Archi 模型网关同步最新的 provider 配置，无需手动维护 opencode.json。

安装

1. 安装插件

cd .opencode && npm install @marscore-archi/opencode-provider

2. 声明插件

opencode v1（≥1.18.29）在 opencode.json 中添加：

{
  "plugin": ["@marscore-archi/opencode-provider"]
}

opencode v2 在 opencode.jsonc 中添加：

{
  "plugins": ["@marscore-archi/opencode-provider"]
}

3. 配置环境变量

将以下内容添加到 ~/.zshrc 或 ~/.bashrc：

export ARCHI_API_KEY_OPENAI="你的 OpenAI 协议 Key"
export ARCHI_API_KEY_ANTHROPIC="你的 Anthropic 协议 Key"

然后执行 source ~/.zshrc 使其生效。API Key 请从 Archi 侧边栏 - API 密钥 申请。

4. 启动 OpenCode

opencode

首次启动后，Archi provider（archi-anthropic / archi-openai）将自动出现在模型切换菜单中。

工作原理

每次启动
  │
  ├─ 从 https://archi.marscore.net/guide/opencode-model-provider.json 拉取最新配置
  ├─ 自动解析 {env:XXX} 环境变量占位符
  ├─ 合并到用户配置（远程覆盖同名 provider）
  ├─ 本地缓存兜底（网络不可达时使用）
  └─ 尊重 disabled_providers 设置

自定义配置

如果你有自己的 provider 配置，它们会被保留。与 Archi provider 同名则以远程配置为准。

如需禁用某个 Archi provider：

{
  "disabled_providers": ["archi-anthropic"]
}

许可证

UNLICENSED - 内部使用

兼容性

该插件同时兼容 opencode v1 与 v2，同一发布包无需按版本选择：

• opencode v1（≥1.18.29）：使用 "plugin" 配置字段，插件通过 server() 入口加载。
• opencode v2：使用 "plugins" 配置字段（v2 配置规范化，opencode 会自动迁移），插件通过 setup() 入口加载。
• 插件 package.json 不声明任何 peerDependency——v1 路径不引用 opencode 包，v2 路径以动态 import() 延迟加载 @opencode/plugin，因此任一版本的宿主环境均可安装而不报缺失。
• v2 下若插件加载或 provider 注入失败，插件会向 console 输出含插件 id 的警告（v2 加载器默认静默丢弃失败插件，故插件自行告警）。