@kkmila/cpc 1.0.1 → 1.0.5

package/README.md

@@ -36,6 +36,7 @@ cpc install
 | `cpc export [name]` | 导出提供商配置 |
 | `cpc import <file>` | 导入提供商配置 |
 | `cpc list-installed` | 列出已安装的提供商 |
+| `cpc doctor` | 检查配置和运行状态 |
 
 ## 使用示例
 
@@ -57,6 +58,29 @@ cpc add
 cpc install openai --agent pi
 ```
 
+### 安装到 Codex Agent（全局默认 provider）
+
+Codex 一次只能使用一个模型（写入 `~/.codex/config.toml` 顶层的 `model` + `model_provider`）。
+`cpc install` 会把 API key 跨平台落地到一个环境变量，并在 `[model_providers.<name>]` 段用 `env_key` 引用它，
+装完直接 `codex` 即走该 provider，无需 `--profile`。
+
+```bash
+# 非交互：直接指定单模型 + wire_api
+cpc install tele_home --agent codex --model qwen3.6-plus --wire-api responses
+
+# 交互：多模型时会弹单选让你挑一个作为默认
+# 并询问 wire_api（responses = Codex Responses 原生协议；chat_completions = 标准 OpenAI 兼容）
+cpc install tele_home --agent codex
+```
+
+可选 `--reasoning-effort minimal|low|medium|high` 一并写入 `model_reasoning_effort`。
+
+行为说明：
+- 原始 `config.toml` 会先备份为 `config.toml.cpc.bak`。
+- 只 upsert 顶层 `model_provider` / `model`（及可选 `model_reasoning_effort`）和 `[model_providers.<name>]` 段内字段，
+  不会误伤 `model_personality` 等同前缀 key，也不会破坏 `[features]` / `[mcp_servers.*]` / `[desktop]` 等段。
+- `cpc list-installed --agent codex` 可查看当前 provider、model、wire_api、env_key。
+
 ### 测试连接
 
 ```bash
@@ -73,6 +97,18 @@ cpc test openai
 - omp
 - mimo-code
 - cursor
+- opencode
+
+### Codex 的特殊性
+
+- 一次只能用一个模型：`cpc install --agent codex` 会把选中的模型设为全局默认，
+  多模型时强制让用户挑一个；不像 pi/openclaw 能一次装多个。
+- provider 的 API key 通过 **环境变量** 引用（`env_key`），cpc 跨平台落地：
+  - Linux / macOS：按 `$SHELL` 写入 `~/.zshrc` 或 `~/.bashrc`（幂等，已存在则替换值）
+  - Windows：用 `setx` 写入用户环境变量
+  - 环境变量名规范为 `CPC_<NAME>_API_KEY`（大写、非字母数字转 `_`）
+- 装完新开终端自动加载；当前终端需 `source ~/.bashrc`（或对应 rc 文件）。
+  `cpc install` 输出会明确提示该路径。
 
 ## 配置文件
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kkmila/cpc",
-  "version": "1.0.1",
+  "version": "1.0.5",
   "description": "Custom Provider CLI for managing model providers",
   "type": "module",
   "bin": {
@@ -10,6 +10,10 @@
   "exports": {
     ".": "./src/commands/provider.mjs"
   },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "files": [
     "bin",
     "src",
@@ -18,7 +22,7 @@
   ],
   "scripts": {
     "dev": "node bin/cpc.mjs",
-    "test": "node --test src/**/*.test.mjs"
+    "test": "node --test 'src/**/*.test.mjs'"
   },
   "keywords": [
     "cli",

package/registry.yaml

@@ -20,6 +20,7 @@ agents:
   codex:
     name: Codex
     home: ~/.codex
+    home_env: CODEX_HOME
     description: "OpenAI Codex agent"
 
   openclaw:
@@ -41,3 +42,8 @@ agents:
     name: Cursor
     home: .
     description: "Cursor editor (project-level config)"
+
+  opencode:
+    name: OpenCode
+    home: ~/.config/opencode
+    description: "OpenCode AI coding assistant"