@kkmila/cpc 1.0.1 → 1.0.4

package/README.md

@@ -36,6 +36,7 @@ cpc install
 | `cpc export [name]` | 导出提供商配置 |
 | `cpc import <file>` | 导入提供商配置 |
 | `cpc list-installed` | 列出已安装的提供商 |
+| `cpc doctor` | 检查配置和运行状态 |
 
 ## 使用示例
 
@@ -73,6 +74,7 @@ cpc test openai
 - omp
 - mimo-code
 - cursor
+- opencode
 
 ## 配置文件
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kkmila/cpc",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "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

@@ -41,3 +41,8 @@ agents:
     name: Cursor
     home: .
     description: "Cursor editor (project-level config)"
+
+  opencode:
+    name: OpenCode
+    home: ~/.config/opencode
+    description: "OpenCode AI coding assistant"

package/src/commands/provider.mjs

@@ -5,6 +5,7 @@ import { resolve, join } from "node:path";
 import { homedir } from "node:os";
 import yaml from "js-yaml";
 import { loadRegistry, getAgents, resolveAgentPaths } from "../lib/agents.mjs";
+import { enrichModelWithBaseline } from "../lib/baseline-models.mjs";
 
 /**
  * Get the config directory path (~/.config/cpc)
@@ -387,6 +388,27 @@ function getAgentProviderConfig(agentId, provider) {
 				},
 			};
 
+		case "opencode":
+			return {
+				opencodeJson: {
+					provider: {
+						[provider.name]: {
+							models: provider.models.reduce((acc, m) => {
+								acc[m.id] = {
+									name: m.name || m.id,
+								};
+								return acc;
+							}, {}),
+							npm: "@ai-sdk/openai-compatible",
+							options: {
+								apiKey: provider.apiKey,
+								baseURL: provider.baseUrl,
+							},
+						},
+					},
+				},
+			};
+
 		default:
 			return null;
 	}
@@ -511,6 +533,22 @@ function installProviderToAgent(agentId, provider, agentHome) {
 				return true;
 			}
 
+			case "opencode": {
+				const configPath = join(agentHome, "opencode.json");
+				let configData = {};
+				if (existsSync(configPath)) {
+					configData = JSON.parse(readFileSync(configPath, "utf8"));
+				}
+				if (!configData.provider) configData.provider = {};
+				configData.provider = {
+					...configData.provider,
+					...config.opencodeJson.provider,
+				};
+				writeFileSync(configPath, JSON.stringify(configData, null, 2));
+				console.log(chalk.green(`  ✓ 更新 OpenCode opencode.json`));
+				return true;
+			}
+
 			default:
 				console.log(chalk.yellow(`  ⚠ 未知 agent: ${agentId}`));
 				return false;
@@ -521,6 +559,21 @@ function installProviderToAgent(agentId, provider, agentHome) {
 	}
 }
 
+/**
+ * Check if an agent is installed by looking at its home directory
+ */
+function isAgentInstalled(agentId, agents) {
+	const agent = agents[agentId];
+	if (!agent || !agent.home) return false;
+
+	// Expand ~ to home directory
+	const home = agent.home.replace(
+		/^~/,
+		process.env.HOME || process.env.USERPROFILE,
+	);
+	return existsSync(home);
+}
+
 export function registerProvider(program, repoRoot) {
 	// ── cpc add ──────────────────────────────────────────────────
 	program
@@ -647,14 +700,23 @@ export function registerProvider(program, repoRoot) {
 					for (const modelId of selected) {
 						const model = result.models.find((m) => m.id === modelId);
 						const defaults = getModelDefaults(modelId);
-						const configured = {
+						// 先用 baseline 字典补全 contextWindow / input / description,
+						// 未命中时回退到 API 响应与 MODEL_DEFAULTS
+						const configured = enrichModelWithBaseline({
 							id: modelId,
 							name: model?.name || modelId,
 							contextWindow: model?.contextWindow || defaults.contextWindow,
 							maxTokens: model?.maxTokens || defaults.maxTokens,
 							reasoning: model?.reasoning || defaults.reasoning,
 							input: model?.input || ["text"],
-						};
+						});
+						if (configured.description) {
+							console.log(
+								chalk.dim(
+									`  ↪ ${modelId}: 命中 baseline, 已注入 contextWindow=${configured.contextWindow}, input=[${configured.input.join(",")}]`,
+								),
+							);
+						}
 						models.push(configured);
 					}
 				} else {
@@ -976,14 +1038,23 @@ export function registerProvider(program, repoRoot) {
 			for (const modelId of selected) {
 				const model = result.models.find((m) => m.id === modelId);
 				const defaults = getModelDefaults(modelId);
-				const configured = {
+				// 先用 baseline 字典补全 contextWindow / input / description,
+				// 未命中时回退到 API 响应与 MODEL_DEFAULTS
+				const configured = enrichModelWithBaseline({
 					id: modelId,
 					name: model?.name || modelId,
 					contextWindow: model?.contextWindow || defaults.contextWindow,
 					maxTokens: model?.maxTokens || defaults.maxTokens,
 					reasoning: model?.reasoning || defaults.reasoning,
 					input: model?.input || ["text"],
-				};
+				});
+				if (configured.description) {
+					console.log(
+						chalk.dim(
+							`  ↪ ${modelId}: 命中 baseline, 已注入 contextWindow=${configured.contextWindow}, input=[${configured.input.join(",")}]`,
+						),
+					);
+				}
 
 				if (opts.merge) {
 					config.models = config.models || [];
@@ -1134,24 +1205,37 @@ export function registerProvider(program, repoRoot) {
 			}
 
 			// Step 3: Select agent(s)
-			let agentId;
+			let agentIds;
 			if (opts.agent) {
-				agentId = opts.agent;
+				agentIds = opts.agent === "all" ? Object.keys(agents) : [opts.agent];
 			} else {
-				agentId = await select({
-					message: "Select target agent:",
+				// Auto-detect installed agents
+				const selected = await checkbox({
+					message: "Select target agents (installed agents are pre-selected):",
 					choices: [
-						...Object.entries(agents).map(([id, a]) => ({
-							name: `${id.padEnd(14)} ${a.description || ""}`,
-							value: id,
-						})),
-						{ name: "─────────", value: "__separator__", disabled: true },
-						{ name: "all agents", value: "all" },
+						...Object.entries(agents).map(([id, a]) => {
+							const installed = isAgentInstalled(id, agents);
+							return {
+								name: `${id.padEnd(14)} ${a.description || ""}${installed ? " ✓" : ""}`,
+								value: id,
+								checked: installed,
+							};
+						}),
 					],
+					instructions: {
+						navigator: "↑↓ navigate",
+						select: "space select",
+						all: "a toggle all",
+					},
 				});
-			}
 
-			const agentIds = agentId === "all" ? Object.keys(agents) : [agentId];
+				if (selected.length === 0) {
+					console.log(chalk.yellow("No agents selected. Cancelled."));
+					return;
+				}
+
+				agentIds = selected;
+			}
 
 			// Step 4: Install provider to agents
 			console.log();
@@ -1563,6 +1647,29 @@ export function registerProvider(program, repoRoot) {
 							break;
 						}
 
+						case "opencode": {
+							const configPath = join(agent.home, "opencode.json");
+							if (existsSync(configPath)) {
+								const configData = JSON.parse(readFileSync(configPath, "utf8"));
+								if (configData.provider && Object.keys(configData.provider).length > 0) {
+									for (const [name, config] of Object.entries(
+										configData.provider,
+									)) {
+										console.log(`  ${chalk.blue(name)}`);
+										console.log(`    URL:    ${chalk.dim(config.options?.baseURL || "not set")}`);
+										console.log(
+											`    Models: ${chalk.dim(Object.keys(config.models || {}).length)}`,
+										);
+									}
+								} else {
+									console.log(chalk.dim("  No providers configured"));
+								}
+							} else {
+								console.log(chalk.dim("  Config file not found"));
+							}
+							break;
+						}
+
 						default:
 							console.log(chalk.dim("  Unsupported agent"));
 					}
@@ -1570,7 +1677,88 @@ export function registerProvider(program, repoRoot) {
 					console.log(chalk.red(`  Error reading config: ${err.message}`));
 				}
 
-				console.log();
+			console.log();
+		}
+	});
+
+	// ── cpc doctor ───────────────────────────────────────────────
+	program
+		.command("doctor")
+		.description("Check if cpc is properly configured and working")
+		.action(() => {
+			console.log(chalk.bold("\n🔍 CPC Doctor\n"));
+			
+			let issues = 0;
+			
+			// Check Node.js version
+			const nodeVersion = process.version;
+			const requiredVersion = "18.0.0";
+			const nodeOk = compareVersions(nodeVersion.slice(1), requiredVersion) >= 0;
+			console.log(`${nodeOk ? "✅" : "❌"} Node.js version: ${nodeVersion} (required: >=${requiredVersion})`);
+			if (!nodeOk) issues++;
+			
+			// Check registry.yaml
+			try {
+				const registry = loadRegistry(repoRoot);
+				const agents = getAgents(registry);
+				const agentCount = Object.keys(agents).length;
+				console.log(`✅ registry.yaml: ${agentCount} agents defined`);
+			} catch (err) {
+				console.log(`❌ registry.yaml: ${err.message}`);
+				issues++;
+			}
+			
+			// Check config directory
+			const configDir = getConfigDir();
+			if (existsSync(configDir)) {
+				console.log(`✅ Config directory: ${configDir}`);
+				
+				// Check providers.json
+				try {
+					const providers = loadProviders();
+					const providerCount = Object.keys(providers.providers).length;
+					console.log(`✅ providers.json: ${providerCount} provider(s) configured`);
+				} catch (err) {
+					console.log(`❌ providers.json: ${err.message}`);
+					issues++;
+				}
+			} else {
+				console.log(`⚠️  Config directory: ${configDir} (will be created on first use)`);
+			}
+			
+			// Check installed agents
+			console.log(chalk.bold("\nInstalled Agents:"));
+			try {
+				const registry = loadRegistry(repoRoot);
+				const agents = getAgents(registry);
+				for (const [id, agent] of Object.entries(agents)) {
+					const installed = isAgentInstalled(id, agents);
+					console.log(`${installed ? "✅" : "⬜"} ${id.padEnd(14)} ${agent.description || ""}`);
+				}
+			} catch (err) {
+				console.log(chalk.red(`  Error: ${err.message}`));
 			}
+			
+			// Summary
+			console.log(chalk.bold(`\n${"═".repeat(40)}`));
+			if (issues === 0) {
+				console.log(chalk.green.bold("✅ All checks passed! CPC is ready to use."));
+			} else {
+				console.log(chalk.red.bold(`❌ Found ${issues} issue(s). Please fix them before using CPC.`));
+			}
+			console.log();
 		});
 }
+
+/**
+ * Compare semver versions
+ */
+function compareVersions(a, b) {
+	const pa = a.split(".").map(Number);
+	const pb = b.split(".").map(Number);
+	for (let i = 0; i < 3; i++) {
+		if (pa[i] > pb[i]) return 1;
+		if (pa[i] < pb[i]) return -1;
+	}
+	return 0;
+}

package/src/lib/baseline-models.mjs

@@ -0,0 +1,286 @@
+/**
+ * 基础模型字典 (Baseline)
+ *
+ * 来源: providers-baseline.json
+ * 用途: 当从外部 API (/v1/models) 获取到模型 ID 后, 用本字典补全
+ *       - contextWindow: 模型上下文窗口
+ *       - input:         模型支持的输入类型 (text / image / ...)
+ *       - description:   模型中文描述
+ * 然后随 model 一起持久化到 ~/.config/cpc/providers.json
+ *
+ * 注意: 本字典不包含 maxTokens / reasoning, 仍由 src/commands/provider.mjs
+ *       中的 MODEL_DEFAULTS 处理. 安装到 Agent 时, 各 agent schema 不消费
+ *       description, 该字段仅作为 provider.json 内的元信息保留.
+ */
+
+export const BASELINE_MODELS = [
+	{
+		modelId: "mimo-v2-omni",
+		contextWindow: 32768,
+		input: ["text"],
+		description: "小米 MiMo V2 全模态旗舰，文本/图像/音频/视频统一理解与生成。",
+	},
+	{
+		modelId: "mimo-v2-pro",
+		contextWindow: 32768,
+		input: ["text"],
+		description: "小米 MiMo V2 推理增强版，强项为复杂推理与长程任务。",
+	},
+	{
+		modelId: "mimo-v2-tts",
+		contextWindow: 32768,
+		input: ["text"],
+		description: "小米 MiMo V2 文本转语音合成模型，多音色/多语种。",
+	},
+	{
+		modelId: "mimo-v2.5",
+		contextWindow: 32768,
+		input: ["text"],
+		description: "小米 MiMo V2.5 通用对话基座，性价比首选。",
+	},
+	{
+		modelId: "mimo-v2.5-asr",
+		contextWindow: 32768,
+		input: ["text"],
+		description: "小米 MiMo V2.5 语音识别模型，音频转文字。",
+	},
+	{
+		modelId: "mimo-v2.5-pro",
+		contextWindow: 32768,
+		input: ["text"],
+		description: "小米 MiMo V2.5 推理增强版，复杂任务与编程。",
+	},
+	{
+		modelId: "mimo-v2.5-tts",
+		contextWindow: 32768,
+		input: ["text"],
+		description: "小米 MiMo V2.5 文本转语音合成模型。",
+	},
+	{
+		modelId: "mimo-v2.5-tts-voiceclone",
+		contextWindow: 32768,
+		input: ["text"],
+		description: "小米 MiMo V2.5 声音克隆 TTS，参考音频复刻音色。",
+	},
+	{
+		modelId: "mimo-v2.5-tts-voicedesign",
+		contextWindow: 32768,
+		input: ["text"],
+		description: "小米 MiMo V2.5 声音设计 TTS，按描述/特征生成新音色。",
+	},
+	{
+		modelId: "gemma4:e4b",
+		contextWindow: 32768,
+		input: ["text"],
+		description:
+			"Google Gemma 4 边缘端模型（4.5B effective / 8B with embeddings），128K 上下文，支持文本+图像+音频。",
+	},
+	{
+		modelId: "qwen3.6:27b",
+		contextWindow: 32768,
+		input: ["text"],
+		description:
+			"Qwen3.5 架构的 27.8B dense 本地模型（Q4_K_M 17GB），本地多用途对话与编程。",
+	},
+	{
+		modelId: "qwen3.6-plus",
+		contextWindow: 1000000,
+		input: ["text", "image"],
+		description:
+			"阿里 Qwen3.6 旗舰 VL 模型，主打 Agentic Coding、Vibe Coding 与 1M 多模态长上下文。",
+	},
+	{
+		modelId: "qwen3-vl-plus",
+		contextWindow: 1000000,
+		input: ["text", "image"],
+		description:
+			"通义千问视觉旗舰，OS World 视觉 Agent SOTA，文档/视频/OCR 全能理解。",
+	},
+	{
+		modelId: "qwen3.5-122b-a10b",
+		contextWindow: 262144,
+		input: ["text", "image"],
+		description:
+			"Qwen3.5 开源 MoE 旗舰（122B 总参/10B 激活），262K 上下文，原生视觉语言模型。",
+	},
+	{
+		modelId: "qwen3-coder-plus",
+		contextWindow: 1000000,
+		input: ["text"],
+		description:
+			"通义千问编码专项旗舰，1M 仓库级上下文，强工具调用与多文件重构。",
+	},
+	{
+		modelId: "text-embedding-v4",
+		contextWindow: 32000,
+		input: ["text"],
+		description:
+			"阿里 Qwen3-Embedding 旗舰，MTEB 多语言榜单领先，支持 8 种向量维度的语义检索首选。",
+	},
+	{
+		modelId: "GLM-5.0",
+		contextWindow: 200000,
+		input: ["text"],
+		description:
+			"智谱基座旗舰 744B MoE，编程对齐 Claude Opus 4.5，复杂系统工程与长程 Agent 基座。",
+	},
+	{
+		modelId: "GLM-5.0-anthropic",
+		contextWindow: 200000,
+		input: ["text"],
+		description: "GLM-5.0 的 Anthropic 协议兼容封装。",
+	},
+	{
+		modelId: "glm-5.1",
+		contextWindow: 200000,
+		input: ["text"],
+		description:
+			"智谱长程任务旗舰，可单任务持续自主工作 8 小时，编程对齐 Claude Opus 4.6。",
+	},
+	{
+		modelId: "glm-5.1-anthropic",
+		contextWindow: 200000,
+		input: ["text"],
+		description: "glm-5.1 的 Anthropic 协议兼容封装。",
+	},
+	{
+		modelId: "deepseek-v4-pro",
+		contextWindow: 1000000,
+		input: ["text"],
+		description:
+			"DeepSeek V4 旗舰 1.6T MoE，开源 SOTA 世界知识与 Agent Coding，支持双思考模式。",
+	},
+	{
+		modelId: "deepseek-v4-pro-anthropic",
+		contextWindow: 1000000,
+		input: ["text"],
+		description: "DeepSeek V4-Pro 的 Anthropic 协议封装。",
+	},
+	{
+		modelId: "deepseek-v4-flash",
+		contextWindow: 1000000,
+		input: ["text"],
+		description:
+			"DeepSeek V4 轻量版（284B/13B 激活），1M 上下文，主打高吞吐低成本日常 Agent。",
+	},
+	{
+		modelId: "DeepSeek-V3.2",
+		contextWindow: 128000,
+		input: ["text"],
+		description:
+			"DeepSeek V3 末代 DSA 稀疏注意力版本，平衡推理深度与输出长度，适合日常问答与 Agent。",
+	},
+	{
+		modelId: "Doubao-Seed-2.0-Pro",
+		contextWindow: 256000,
+		input: ["text", "image"],
+		description:
+			"字节豆包 2.0 旗舰，多模态视觉推理/空间推理 SOTA，全面对标 GPT-5.2 / Gemini 3 Pro。",
+	},
+	{
+		modelId: "Doubao-Seed-2.0-Code",
+		contextWindow: 256000,
+		input: ["text", "image"],
+		description:
+			"字节豆包 2.0 编程专版，前端强、支持 UI-to-Code 视觉理解，与 TRAE 集成最佳。",
+	},
+	{
+		modelId: "Kimi-K2.5",
+		contextWindow: 256000,
+		input: ["text", "image"],
+		description:
+			"月之暗面原生多模态旗舰，文本+视觉联合优化，Agent Swarm 与视觉编程（UI/视频生成代码）。",
+	},
+	{
+		modelId: "kimi-k2.6",
+		contextWindow: 256000,
+		input: ["text", "image"],
+		description:
+			"月之暗面 K2.6，开源 SOTA 长程编码（13 小时不间断）+ Agent Swarm 300 子智能体。",
+	},
+	{
+		modelId: "kimi-k2.6-anthropic",
+		contextWindow: 256000,
+		input: ["text", "image"],
+		description: "kimi-k2.6 的 Anthropic 协议兼容封装。",
+	},
+	{
+		modelId: "minimax-m3",
+		contextWindow: 1000000,
+		input: ["text", "image"],
+		description:
+			"MiniMax 2026 旗舰，国内首个前沿 Coding + 1M 上下文 + 原生多模态三合一模型。",
+	},
+	{
+		modelId: "MiniMax-M2.7",
+		contextWindow: 204800,
+		input: ["text"],
+		description:
+			"MiniMax M2.7，模型自我进化路径，端到端软件工程交付与 Office 复杂编辑。",
+	},
+	{
+		modelId: "minimax-m2.7",
+		contextWindow: 204800,
+		input: ["text"],
+		description: "MiniMax M2.7 小写别名，与 MiniMax-M2.7 同款。",
+	},
+];
+
+/**
+ * 在 baseline 字典中查找模型
+ * 匹配规则:
+ *   1) 精确匹配 (大小写不敏感)
+ *   2) 包含匹配 (查询 ID 包含 baseline 的 modelId 或反之)
+ * @param {string} modelId
+ * @returns {object|null} 命中的 baseline 记录
+ */
+export function lookupBaselineModel(modelId) {
+	if (!modelId) return null;
+	const lower = String(modelId).toLowerCase();
+
+	// 1) 精确匹配
+	const exact = BASELINE_MODELS.find((m) => m.modelId.toLowerCase() === lower);
+	if (exact) return exact;
+
+	// 2) 包含匹配: baseline.modelId ⊆ query.id (适用 qwen3.6 / MiniMax 大小写差异)
+	const contains = BASELINE_MODELS.find((m) =>
+		lower.includes(m.modelId.toLowerCase()),
+	);
+	if (contains) return contains;
+
+	// 3) 反向包含: query.id ⊆ baseline.modelId (适用 minimax-m3 命中 MiniMax-M2.7 等)
+	const reverse = BASELINE_MODELS.find((m) =>
+		m.modelId.toLowerCase().includes(lower),
+	);
+	return reverse || null;
+}
+
+/**
+ * 用 baseline 字典补全 model 字段
+ * 命中时, baseline 的 contextWindow / input / description 会覆盖传入值
+ * 命不中则原样返回
+ * maxTokens / reasoning 不在 baseline 范围, 由调用方自己处理
+ * @param {object} model 至少有 { id }
+ * @returns {object} 增强后的 model
+ */
+export function enrichModelWithBaseline(model) {
+	if (!model || !model.id) return model;
+	const baseline = lookupBaselineModel(model.id);
+	if (!baseline) return model;
+
+	const enriched = { ...model };
+
+	if (typeof baseline.contextWindow === "number") {
+		enriched.contextWindow = baseline.contextWindow;
+	}
+
+	if (Array.isArray(baseline.input) && baseline.input.length > 0) {
+		enriched.input = [...baseline.input];
+	}
+
+	if (baseline.description) {
+		enriched.description = baseline.description;
+	}
+
+	return enriched;
+}