@herouucn/opencode-commandcode 0.1.1 → 0.1.4

package/README.md

@@ -1,21 +1,117 @@
 # opencode-commandcode
 
 [![CI](https://img.shields.io/github/actions/workflow/status/herouu/opencode-commandcode/ci.yml?branch=main&label=CI)](https://github.com/herouu/opencode-commandcode/actions)
+[![npm version](https://img.shields.io/npm/v/@herouucn/opencode-commandcode)](https://www.npmjs.com/package/@herouucn/opencode-commandcode)
+[![npm downloads/month](https://img.shields.io/npm/dm/@herouucn/opencode-commandcode)](https://www.npmjs.com/package/@herouucn/opencode-commandcode)
+[![npm downloads/week](https://img.shields.io/npm/dw/@herouucn/opencode-commandcode)](https://www.npmjs.com/package/@herouucn/opencode-commandcode)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/@herouucn/opencode-commandcode)](https://bundlephobia.com/package/@herouucn/opencode-commandcode)
+[![node version](https://img.shields.io/node/v/@herouucn/opencode-commandcode)](https://www.npmjs.com/package/@herouucn/opencode-commandcode)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-[Command Code](https://commandcode.ai) API provider for [opencode](https://opencode.ai) —— 通过一个 API key 使用 Claude、GPT、Gemini、DeepSeek、Qwen、Kimi、GLM、MiniMax、Step 等 50+ 模型。
-
-本仓库是 [BrainerVirus/opencode-commandcode](https://github.com/BrainerVirus/opencode-commandcode) v0.7.54 的**自用 fork**，核心差异：**不发布 npm 包**。模型目录由本仓库 CI 自动同步并直推 `models.json`，插件运行时从 raw URL 拉取——模型列表与插件版本彻底解耦，永远拿最新，无需升级。
+[Command Code](https://commandcode.ai) API provider for [opencode](https://opencode.ai) —— 通过一个 API key 使用 Claude、GPT、Gemini、DeepSeek、Qwen、Kimi、GLM、MiniMax、Step 等 70+ 模型。
 
 ## 特性
 
 | 特性 | 说明 |
 |---|---|
-| 单 key 多模型 | 通过 Command Code Provider API 聚合 50+ 模型 |
+| 单 key 多模型 | 通过 Command Code Provider API 聚合 70+ 模型 |
 | 运行时目录拉取 | 每次启动拉取远端 `models.json`，新模型即时生效 |
 | 离线兜底 | 拉取失败自动回退包内静态目录 → 本地缓存 |
 | 目录自同步 | CI 每 6 小时检测上游新版本并直推 `main` |
-| 数据安全护栏 | 提取失败 / 模型数跌破阈值时开 `catalog-break` issue，绝不推送坏数据 |
+| 安全发布 | 基于 GitHub OIDC Trusted Publishing，无需 long-lived token |
+
+## 演示
+
+安装插件并查看模型列表：
+
+[![asciinema demo](https://asciinema.org/a/ePh5yVrpNatwEQKT.svg)](https://asciinema.org/a/ePh5yVrpNatwEQKT)
+
+安装后运行 opencode，输入 `/models` 即可看到 Command Code 提供的 70+ 模型：
+
+```
+commandcode/claude-fable-5
+commandcode/claude-fable-5-1
+commandcode/claude-haiku-4-5-20251001
+commandcode/claude-opus-4-7
+commandcode/claude-opus-4-8
+commandcode/claude-opus-5
+commandcode/claude-sonnet-4-6
+commandcode/claude-sonnet-5
+commandcode/deepseek-v4-flash
+commandcode/deepseek-v4-flash-fast
+commandcode/deepseek-v4-pro
+commandcode/gemini-3.5-flash
+commandcode/gemini-3.6-flash
+commandcode/gemini-3.7-flash
+commandcode/gemini-3.8-flash
+commandcode/gpt-5.4
+commandcode/gpt-5.4-mini
+commandcode/gpt-5.5
+commandcode/gpt-5.6-luna
+commandcode/gpt-5.6-sol
+commandcode/gpt-5.6-terra
+commandcode/qwen3.7-max
+commandcode/qwen3.7-plus
+commandcode/qwen3.8-max
+... 共 70+ 模型
+```
+
+选择模型后直接对话，无需额外配置。
+
+## 安装
+
+### 方式一：opencode plugin（推荐）
+
+```bash
+opencode plugin @herouucn/opencode-commandcode
+```
+
+opencode 自动完成：
+1. 安装 npm 包到缓存目录
+2. 更新 `~/.config/opencode/opencode.json`，追加 plugin 和 provider 配置
+
+重启 opencode 即可使用。
+
+### 方式二：npm 包
+
+```bash
+npm install @herouucn/opencode-commandcode
+# 或
+bun add @herouucn/opencode-commandcode
+```
+
+然后在 `opencode.json` 中声明：
+
+```jsonc
+// opencode.json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@herouucn/opencode-commandcode"],
+  "provider": {
+    "commandcode": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "commandcode",
+      "env": ["COMMANDCODE_API_KEY"],
+      "options": {
+        "baseURL": "https://api.commandcode.ai/provider/v1/"
+      }
+    }
+  }
+}
+```
+
+### 方式三：本地路径（开发用）
+
+```bash
+git clone https://github.com/herouu/opencode-commandcode.git
+```
+
+```jsonc
+// opencode.json
+{
+  "plugin": ["file:///absolute/path/to/opencode-commandcode"]
+}
+```
 
 ## 工作原理
 
@@ -60,33 +156,6 @@ sequenceDiagram
 2. **运行时解耦**：插件每次启动 fetch 本仓库 raw `models.json`，不再依赖 npm 发版。
 3. **质量护栏**：模型数跌破保护线时触发 `catalog-break` issue 并回滚，坏数据不落库。
 
-## 快速开始
-
-```bash
-# 1. 克隆本仓库
-git clone https://github.com/herouu/opencode-commandcode.git
-```
-
-```jsonc
-// opencode.json（推荐 file: 引用本地 checkout，或填你的 git 地址）
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["file:///absolute/path/to/opencode-commandcode"],
-  "provider": {
-    "commandcode": {
-      "npm": "@ai-sdk/openai-compatible",
-      "name": "Command Code",
-      "env": ["COMMANDCODE_API_KEY"],
-      "options": {
-        "baseURL": "https://api.commandcode.ai/provider/v1"
-      }
-    }
-  }
-}
-```
-
-插件只负责注入 `provider.commandcode.models` 元数据，transport 仍由 `@ai-sdk/openai-compatible` 提供。
-
 ## 配置
 
 ### API key（三选一）
@@ -124,6 +193,27 @@ export COMMANDCODE_CATALOG_URL="https://raw.githubusercontent.com/herouu/opencod
 
 opencode 内运行 `/models` 选择（如 `commandcode/deepseek-v4-flash`）。
 
+## 发布
+
+本仓库使用 **GitHub OIDC Trusted Publishing**，无需 long-lived npm token。
+
+**触发方式**：
+
+```bash
+# 1. 修改版本号
+npm version patch   # 或 minor / major
+
+# 2. 推送 tag 触发发布
+git push origin main --tags
+```
+
+发布流程：
+1. push `v*` tag → 触发 `release.yml`
+2. `check` job：lint + format + typecheck + unit test
+3. `publish` job：`npm publish --provenance`（OIDC 自动认证，生成 provenance 签名）
+
+**npm 包**：[@herouucn/opencode-commandcode](https://www.npmjs.com/package/@herouucn/opencode-commandcode)
+
 ## 开发与维护
 
 ```bash
@@ -139,6 +229,7 @@ CI 一览：
 
 - **`ci.yml`** — 4 个 check（test / typecheck / lint / format），push 与 PR 触发。
 - **`catalog-sync.yml`** — 每 6 小时 + 手动 dispatch，直推 main（不经 PR、不发版）。
+- **`release.yml`** — push `v*` tag 或手动 dispatch，check + trusted publishing 发布。
 
 ## 常见问题
 
@@ -151,13 +242,13 @@ CI 一览：
 **catalog-break issue 是什么？**
 CI 提取失败或模型数异常时自动创建的告警 issue，表示最近一次同步被护栏拦截，正在使用上一份完好目录。
 
-**为什么不再发布 npm？**
-自用场景下 npm 发版是纯负担——模型目录经 raw URL 直推，升级插件包没有任何收益。
+**为什么 Trusted Publishing 而不是 long-lived token？**
+Trusted Publishing 使用 OIDC 短期 token，每次发布自动轮换，无需手动管理 token，无泄露风险。
 
 ## 致谢
 
-源自 [FanFan4204/opencode-commandcode-provider](https://github.com/FanFan4204/opencode-commandcode-provider) → [brent-weatherall/opencode-commandcode-provider](https://github.com/brent-weatherall/opencode-commandcode-provider)（[Brent Weatherall](https://github.com/brent-weatherall) 原始实现）。
+源自 [BrainerVirus/opencode-commandcode](https://github.com/BrainerVirus/opencode-commandcode) v0.7.54（[Brent Weatherall](https://github.com/brent-weatherall) 原始实现）。
 
 ## 许可证
 
-MIT — 见 [LICENSE](LICENSE)。原始版权归 [Brent Weatherall](https://github.com/brent-weatherall)。
+MIT — 见 [LICENSE](LICENSE)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herouucn/opencode-commandcode",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "description": "Inject Command Code API provider into opencode — access Claude, GPT, Gemini, DeepSeek, Qwen, Kimi, GLM, MiniMax & Step via unified Command Code API. / 将 Command Code API provider 注入 opencode —— 通过统一的 Command Code API 使用 Claude、GPT、Gemini、DeepSeek、Qwen、Kimi、GLM、MiniMax 和 Step 模型。",
   "keywords": [
     "ai",

package/plugin.ts

@@ -230,7 +230,7 @@ export default async function commandcodePlugin() {
             if (typeof rawKey !== "string") return { type: "failed" as const };
             const key = rawKey.trim();
             if (!key) return { type: "failed" as const };
-            return { type: "success" as const, key };
+            return { type: "api" as const, key };
           },
         },
       ],