kilo-opencode-command-code

同时接入 Kilo 与 OpenCode 的 Command Code Provider API 插件。同一份文件，两端可用，零依赖。

快速开始

1. 安装

方式 A：命令行安装（最简单，一条命令，自动写入配置）

kilo plugin kilo-opencode-command-code -g       # Kilo
opencode plugin kilo-opencode-command-code -g   # OpenCode

方式 B：手动加一行配置

// Kilo：~/.config/kilo/kilo.jsonc
"plugin": ["kilo-opencode-command-code"]

// OpenCode：~/.config/opencode/opencode.json
"plugin": ["kilo-opencode-command-code"]

方式 C：克隆 + 一键脚本（无需 npm，Kilo 和 OpenCode 一起装）

git clone https://github.com/moyu-by/kilo-opencode-command-code.git
cd kilo-opencode-command-code
bash install.sh          # Windows: powershell -ExecutionPolicy Bypass -File .\install.ps1

2. 登录

Kilo 与 OpenCode 凭据库独立，需各登录一次：

kilo auth login -p cmdcode      # Kilo
opencode auth login             # OpenCode，选择 Command Code

不想登录，就用环境变量直接给 key。

macOS / Linux / Git-Bash：

CMD_API_KEY=sk-xxxx kilo
CMD_API_KEY=sk-xxxx opencode

Windows PowerShell：

$env:CMD_API_KEY = "sk-xxxx"; kilo
$env:CMD_API_KEY = "sk-xxxx"; opencode

Windows cmd：

set CMD_API_KEY=sk-xxxx && kilo
set CMD_API_KEY=sk-xxxx && opencode

重启客户端生效。

提示：模型按连接状态显示

• 未连接（没有 API key）时，/models 里不会出现任何 cmdcode 模型。
• 连接后需重启客户端一次，模型列表才会出现（插件的 config 钩子只在启动时运行；这一点与原生 provider 的即时刷新不同）。
• 启动时按此顺序找 key：环境变量 → 凭据库 ~/.local/share/kilo/auth.json / ~/.local/share/opencode/auth.json（Windows 上同样是 %USERPROFILE%\.local\share\...）。识别不出当前客户端时，会回退到另一个客户端的凭据库，避免“连了却不显示模型”。

3. 使用

• 选模型：打开 /models（或 ctrl+x m）→ 按 ctrl+a 打开 provider 列表 → 选 Command Code → 选模型
• 直接运行：kilo run -m cmdcode/deepseek/deepseek-v4.1-flash "你的问题"
• 思考档位：选模型后挑变体 low / medium / high；Claude 为 thinking-on / thinking-off
• 图片：视觉模型（如 cmdcode/deepseek/deepseek-v4.1-flash）可直接粘贴/上传

功能

• 双端兼容：同一份 index.js，Kilo 和 OpenCode 都能用
• 连接后才显示：未配置 API key（环境变量或登录）时，/models 里不会出现任何 cmdcode 模型；连接后才出现，避免列出用不了的模型
• 模型自动同步：启动时拉取 /provider/v1/models，断网走本地缓存，统一 cmdcode 入口
• 能力自动同步：从官方模型表抓取每个模型的 Text / Vision / Reasoning 标注，自动声明 modalities 与 reasoning
  • 视觉模型可正常接收图片（修复 "does not support image input"）
  • 非推理模型不生成思考档位变体
  • 缓存于 .capabilities.json，7 天有效期；失败时用旧缓存，仍无则退回关键词兜底
• Claude 自动路由：Claude 走 Anthropic Messages 端点，其余走 OpenAI Chat Completions
• 零配置即用：装好 + 登录一次即可；环境变量可免登录
• 可手动覆盖：按需覆盖单个模型的模态/参数，无需改插件

环境变量

变量	作用
CMD_API_KEY	直接提供 API key（优先级最高）
COMMANDCODE_API_KEY / COMMAND_CODE_API_KEY / CMDCODE_API_KEY	同上，别名
CMD_MODELS_DOCS_URL	覆盖能力表来源（默认官方模型表页）

优先级：环境变量 > 凭据库中登录保存的 key。两者都没有时，客户端会照常提示登录。

能力覆盖（一般不需要）

能力（Vision / Reasoning）默认从官方模型表自动同步，通常无需干预。若个别模型判错或想离线锁定，在配置文件里覆盖即可：

{
  "provider": {
    "cmdcode": {
      "models": {
        // 强制某个模型支持图片输入
        "some/vendor/model": {
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        }
        // 强制某个模型为纯文本
        // ,"another/model": {
        //   "modalities": { "input": ["text"], "output": ["text"] }
        // }
      }
    }
  }
}

也可以在 index.js 顶部改 VISION_HINTS / FORCE_TEXT_ONLY / FORCE_VISION（仅在文档同步失败、走关键词兜底时生效）。

换 Key

kilo auth login -p cmdcode
opencode auth login

文件结构

index.js            插件主文件（Kilo 与 OpenCode 共用）
install.sh          Linux/macOS/Git-Bash 安装脚本（同步到 OpenCode）
install.ps1         Windows PowerShell 安装脚本
test/               node:test 测试
.github/workflows/  CI 与发布流程
.cache.json         模型列表缓存（运行时自动生成，已 gitignore）
.capabilities.json  能力表缓存（运行时自动生成，7 天有效期，已 gitignore）

说明

• 插件零第三方依赖、纯 ESM；import.meta.dirname 不可用时自动回退 fileURLToPath，跨平台安全。
• 缓存文件生成在插件文件同目录，因此该目录需要可写。
• 行为与原生接入点的唯一差异：连接后需要重启客户端一次模型才会出现（见上文提示）。其余（未连接不显示、能力声明、Claude 路由、凭据按客户端隔离）均与原生一致。

License

MIT