@hileeon/mcc 0.1.0

package/dist/shared/provider-preset-catalog.js

@@ -0,0 +1,299 @@
+"use strict";
+/**
+ * Shared provider preset catalog for CLI + Dashboard.
+ *
+ * Keep this file runtime-agnostic (no Node/browser APIs) so both
+ * backend and UI can import the same source of truth.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROVIDER_PRESET_DEFINITIONS = exports.PROVIDER_PRESET_ALIASES = exports.OPENROUTER_BASE_URL = exports.PROVIDER_PRESET_IDS = void 0;
+exports.createProviderPresetDefinitions = createProviderPresetDefinitions;
+exports.normalizeProviderPresetId = normalizeProviderPresetId;
+exports.PROVIDER_PRESET_IDS = [
+    'openrouter',
+    'alibaba-coding-plan',
+    'huggingface',
+    'ollama',
+    'llamacpp',
+    'anthropic',
+    'glm',
+    'km',
+    'foundry',
+    'mm',
+    'deepseek',
+    'qwen',
+    'ollama-cloud',
+    'novita',
+];
+exports.OPENROUTER_BASE_URL = 'https://openrouter.ai/api/v1';
+/**
+ * Legacy aliases mapped to canonical preset IDs.
+ * Keep this minimal and explicit to avoid hidden implicit behavior.
+ */
+exports.PROVIDER_PRESET_ALIASES = Object.freeze({
+    glmt: 'glm',
+    kimi: 'km',
+    alibaba: 'alibaba-coding-plan',
+    acp: 'alibaba-coding-plan',
+    hf: 'huggingface',
+});
+const RAW_PROVIDER_PRESET_DEFINITIONS = [
+    {
+        id: 'openrouter',
+        name: 'OpenRouter',
+        description: '349+ models from OpenAI, Anthropic, Google, Meta',
+        baseUrl: exports.OPENROUTER_BASE_URL,
+        defaultProfileName: 'openrouter',
+        defaultModel: 'anthropic/claude-opus-4.5',
+        apiKeyPlaceholder: 'sk-or-...',
+        apiKeyHint: 'Get your API key at openrouter.ai/keys',
+        category: 'recommended',
+        requiresApiKey: true,
+        badge: '349+ models',
+        featured: true,
+        icon: '/icons/openrouter.svg',
+    },
+    {
+        id: 'alibaba-coding-plan',
+        name: 'Alibaba Coding Plan',
+        description: 'Alibaba Cloud Coding Plan via Anthropic-compatible endpoint',
+        baseUrl: 'https://coding-intl.dashscope.aliyuncs.com/apps/anthropic',
+        defaultProfileName: 'albb',
+        defaultModel: 'qwen3-coder-plus',
+        apiKeyPlaceholder: 'sk-sp-...',
+        apiKeyHint: 'Get your Coding Plan key from Alibaba Cloud Model Studio',
+        category: 'recommended',
+        requiresApiKey: true,
+        badge: 'Coding Plan',
+        featured: true,
+        icon: '/assets/providers/alibabacloud-color.svg',
+    },
+    {
+        id: 'ollama',
+        name: 'Ollama (Local)',
+        description: 'Local open-source models via Ollama (32K+ context)',
+        baseUrl: 'http://localhost:11434',
+        defaultProfileName: 'ollama',
+        defaultModel: 'qwen3-coder',
+        apiKeyPlaceholder: 'ollama',
+        apiKeyHint: 'Install Ollama from ollama.com - no API key needed for local',
+        category: 'recommended',
+        requiresApiKey: false,
+        badge: 'Local',
+        featured: true,
+        icon: '/icons/ollama.svg',
+    },
+    {
+        id: 'llamacpp',
+        name: 'llama.cpp (Local)',
+        description: 'Local inference via llama.cpp (LLaMA models)',
+        baseUrl: 'http://127.0.0.1:8080',
+        defaultProfileName: 'llamacpp',
+        defaultModel: 'llama3-8b',
+        apiKeyPlaceholder: 'llamacpp',
+        apiKeyHint: 'Run llama.cpp server: ./server --host 0.0.0.0 --port 8080 -m model.gguf',
+        category: 'recommended',
+        requiresApiKey: false,
+        badge: 'Local',
+        featured: true,
+        icon: '/assets/providers/llama-cpp.svg',
+    },
+    {
+        id: 'anthropic',
+        name: 'Anthropic (Direct API)',
+        description: 'Use your own Anthropic API key (sk-ant-...)',
+        baseUrl: '',
+        defaultProfileName: 'anthropic',
+        defaultModel: 'claude-sonnet-4-5-20250929',
+        apiKeyPlaceholder: 'sk-ant-api03-...',
+        apiKeyHint: 'Get key at console.anthropic.com/settings/keys',
+        category: 'recommended',
+        requiresApiKey: true,
+        badge: 'Direct',
+        featured: true,
+        icon: '/assets/providers/claude.svg',
+    },
+    {
+        id: 'huggingface',
+        name: 'Hugging Face',
+        description: 'Inference Providers router via OpenAI-compatible chat completions',
+        baseUrl: 'https://router.huggingface.co/v1',
+        defaultProfileName: 'hf',
+        defaultModel: 'openai/gpt-oss-120b:fastest',
+        apiKeyPlaceholder: 'hf_...',
+        apiKeyHint: 'Create a User Access Token at hf.co/settings/tokens',
+        category: 'alternative',
+        requiresApiKey: true,
+        defaultTarget: 'droid',
+        badge: 'Router',
+    },
+    {
+        id: 'glm',
+        name: 'GLM',
+        description: 'Direct Z.AI Anthropic-compatible API profile',
+        baseUrl: 'https://api.z.ai/api/anthropic',
+        defaultProfileName: 'glm',
+        defaultModel: 'glm-5',
+        apiKeyPlaceholder: 'ghp_...',
+        apiKeyHint: 'Get your API key from Z.AI',
+        category: 'alternative',
+        requiresApiKey: true,
+        badge: 'Z.AI',
+        icon: '/icons/zai.svg',
+    },
+    {
+        id: 'km',
+        name: 'Kimi',
+        description: 'Moonshot AI - Fast reasoning model',
+        baseUrl: 'https://api.kimi.com/coding/',
+        defaultProfileName: 'km',
+        defaultModel: 'kimi-k2-thinking-turbo',
+        apiKeyPlaceholder: 'sk-...',
+        apiKeyHint: 'Get your API key from Moonshot AI',
+        category: 'alternative',
+        requiresApiKey: true,
+        alwaysThinkingEnabled: true,
+        badge: 'Reasoning',
+        icon: '/icons/kimi.svg',
+    },
+    {
+        id: 'foundry',
+        name: 'Azure Foundry',
+        description: 'Claude via Microsoft Azure AI Foundry',
+        baseUrl: 'https://<your-resource>.services.ai.azure.com/api/anthropic',
+        defaultProfileName: 'foundry',
+        defaultModel: 'claude-sonnet-4-5',
+        apiKeyPlaceholder: 'YOUR_AZURE_API_KEY',
+        apiKeyHint: 'Create resource at ai.azure.com, get API key from Keys tab',
+        category: 'alternative',
+        requiresApiKey: true,
+        badge: 'Azure',
+        icon: '/icons/azure.svg',
+    },
+    {
+        id: 'mm',
+        name: 'Minimax',
+        description: 'M2.1/M2.1-lightning/M2 - multilang coding (1M context)',
+        baseUrl: 'https://api.minimax.io/anthropic',
+        defaultProfileName: 'mm',
+        defaultModel: 'MiniMax-M2.1',
+        apiKeyPlaceholder: 'YOUR_MINIMAX_API_KEY_HERE',
+        apiKeyHint: 'Get your API key at platform.minimax.io',
+        category: 'alternative',
+        requiresApiKey: true,
+        badge: '1M context',
+        icon: '/icons/minimax.svg',
+    },
+    {
+        id: 'deepseek',
+        name: 'DeepSeek',
+        description: 'V3.2 and R1 reasoning model (128K context)',
+        baseUrl: 'https://api.deepseek.com/anthropic',
+        defaultProfileName: 'deepseek',
+        defaultModel: 'deepseek-chat',
+        apiKeyPlaceholder: 'sk-...',
+        apiKeyHint: 'Get your API key at platform.deepseek.com',
+        category: 'alternative',
+        requiresApiKey: true,
+        badge: 'Reasoning',
+        icon: '/icons/deepseek.svg',
+    },
+    {
+        id: 'qwen',
+        name: 'Qwen',
+        description: 'Alibaba Cloud - Qwen3 models (256K-1M context, thinking support)',
+        baseUrl: 'https://dashscope-intl.aliyuncs.com/apps/anthropic',
+        defaultProfileName: 'qwen-api',
+        defaultModel: 'qwen3-coder-plus',
+        apiKeyPlaceholder: 'sk-...',
+        apiKeyHint: 'Get your API key from Alibaba Cloud Model Studio',
+        category: 'alternative',
+        requiresApiKey: true,
+        badge: 'Alibaba',
+        icon: '/assets/providers/qwen-color.svg',
+    },
+    {
+        id: 'ollama-cloud',
+        name: 'Ollama Cloud',
+        description: 'Ollama cloud models via direct API (glm-5:cloud, minimax-m2.1:cloud)',
+        baseUrl: 'https://ollama.com',
+        defaultProfileName: 'ollama-cloud',
+        defaultModel: 'glm-5:cloud',
+        apiKeyPlaceholder: 'YOUR_OLLAMA_CLOUD_API_KEY',
+        apiKeyHint: 'Get your API key at ollama.com',
+        category: 'alternative',
+        requiresApiKey: true,
+        badge: 'Cloud',
+        icon: '/icons/ollama.svg',
+    },
+    {
+        id: 'novita',
+        name: 'Novita AI',
+        description: 'Anthropic-compatible API for Claude Code and CCS profiles',
+        baseUrl: 'https://api.novita.ai/anthropic',
+        defaultProfileName: 'novita',
+        defaultModel: 'deepseek/deepseek-v3.2',
+        apiKeyPlaceholder: 'YOUR_NOVITA_API_KEY',
+        apiKeyHint: 'Get your API key at novita.ai',
+        category: 'alternative',
+        requiresApiKey: true,
+        badge: 'Anthropic-compatible',
+        icon: '/icons/novita.svg',
+    },
+];
+function clonePresetDefinition(preset) {
+    return {
+        ...preset,
+        extraEnv: preset.extraEnv ? { ...preset.extraEnv } : undefined,
+    };
+}
+function freezePresetDefinition(preset) {
+    const cloned = clonePresetDefinition(preset);
+    if (cloned.extraEnv) {
+        Object.freeze(cloned.extraEnv);
+    }
+    return Object.freeze(cloned);
+}
+function assertProviderPresetCatalogIntegrity(definitions, aliases) {
+    const presetIdSet = new Set();
+    for (const definition of definitions) {
+        const normalizedId = definition.id.trim().toLowerCase();
+        if (definition.id !== normalizedId) {
+            throw new Error(`Preset ID must be normalized: "${definition.id}"`);
+        }
+        if (presetIdSet.has(definition.id)) {
+            throw new Error(`Duplicate preset ID detected: "${definition.id}"`);
+        }
+        presetIdSet.add(definition.id);
+    }
+    const normalizedAliasSet = new Set();
+    for (const [alias, target] of Object.entries(aliases)) {
+        const normalizedAlias = alias.trim().toLowerCase();
+        if (!normalizedAlias) {
+            throw new Error('Preset alias keys cannot be empty');
+        }
+        if (alias !== normalizedAlias) {
+            throw new Error(`Preset alias must be normalized: "${alias}"`);
+        }
+        if (normalizedAliasSet.has(normalizedAlias)) {
+            throw new Error(`Duplicate normalized preset alias detected: "${alias}"`);
+        }
+        normalizedAliasSet.add(normalizedAlias);
+        if (!presetIdSet.has(target)) {
+            throw new Error(`Preset alias "${alias}" points to unknown target "${target}"`);
+        }
+        if (presetIdSet.has(normalizedAlias)) {
+            throw new Error(`Preset alias "${alias}" collides with canonical preset ID "${normalizedAlias}"`);
+        }
+    }
+}
+assertProviderPresetCatalogIntegrity(RAW_PROVIDER_PRESET_DEFINITIONS, exports.PROVIDER_PRESET_ALIASES);
+exports.PROVIDER_PRESET_DEFINITIONS = Object.freeze(RAW_PROVIDER_PRESET_DEFINITIONS.map(freezePresetDefinition));
+function createProviderPresetDefinitions() {
+    return exports.PROVIDER_PRESET_DEFINITIONS.map(clonePresetDefinition);
+}
+function normalizeProviderPresetId(id) {
+    const normalized = id.trim().toLowerCase();
+    return exports.PROVIDER_PRESET_ALIASES[normalized] || normalized;
+}
+//# sourceMappingURL=provider-preset-catalog.js.map

package/dist/shared/provider-preset-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-preset-catalog.js","sourceRoot":"","sources":["../../src/shared/provider-preset-catalog.ts"],"names":[],"mappings":"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"}

package/docs/decisions.md

@@ -0,0 +1,33 @@
+# 技术决策记录
+
+本文件追加记录本项目的重大技术决策。新决策追加到文件末尾；历史条目不修改；如某决策被推翻，新建条目并引用被推翻的条目（例如 "Supersedes 2026-01-15 14:30:45 +08:00 的条目"）。所有条目标题必须带 24 小时制时分秒与时区，详见「时间戳规范」章节。
+
+---
+
+## 2026-05-14 17:37:50 +08:00: TypeScript + CommonJS + tsc，不引入 bundler
+
+**背景**: 项目是 Node.js CLI 工具，需要编译到 JS 后通过 `node dist/mcc.js` 运行。
+
+**选项**:
+- esbuild / tsx 等快速工具：开发体验好但多一个依赖
+- tsc：零额外依赖，TypeScript 自带
+
+**选择**: `tsc` + CommonJS（`module: "commonjs"`）+ ES2020 target。`npm run build` 即 `tsc`，`npm run dev` 直接 `node dist/mcc.js`。
+
+**代价**: 放弃了 esbuild 的 sub-second 编译速度和 ESM 生态。后续如果编译时间明显影响开发体验可重新评估。
+
+---
+
+## 2026-05-14 17:37:50 +08:00: KISS direct-API 路线——不做 OAuth、不做本地 proxy
+
+**背景**: 现有工具 CCS 已经覆盖了 OAuth + local proxy + 多 runtime 的完整场景。MCC 的定位是极简替代——给只需要 API key 切换的用户一个更轻的选择。
+
+**选项**:
+- 沿用 CCS 架构（OAuth + proxy）：功能完整但复杂度高
+- 纯 CLI wrapper：直接设 env 然后 spawn Claude Code
+
+**选择**: 纯 env-based direct API。`buildDirectApiEnv()` 返回 `ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_MODEL`，`cmdUse()` 拼上 `CLAUDE_CONFIG_DIR` 后 `spawn('claude', ...)`。
+
+**代价**: 不支持 OAuth provider（Codex、Kiro 等），不支持 `profile:model` 运行时路由。这些场景留给 CCS。
+
+---

package/docs/lessons.md

@@ -0,0 +1,8 @@
+# 踩过的坑与学到的教训
+
+本文件记录"代码里看不出的东西"：诡异 bug 的根因、反直觉的行为、重构中学到的教训。被修复的条目可以剪枝删除，但能长期留作警示的坑建议保留。
+
+---
+
+<!-- 尚无记录 -->
+

package/docs/product.md

@@ -0,0 +1,37 @@
+# Product
+
+## 是什么
+
+MCC（My Cloud Code）是一个轻量级 CLI 工具，用于在多个 Claude Code 账号（不同 API Provider）之间快速切换。不走 OAuth——直接设置环境变量后 `spawn` Claude Code。
+
+支持两种协议模式：
+- **Anthropic 直接模式**：profile 的 `baseUrl` 直接对接 Anthropic 兼容 API
+- **OpenAI 兼容模式**（`protocol: 'openai'`）：自动启动本地翻译 proxy，把 Claude Code 的 Anthropic 请求转换为 OpenAI chat/completions 格式，转发给 upstream provider
+
+## 为谁做 / 解决什么问题
+
+为需要频繁在多个 AI provider（deepseek、qwen、glm、kimi、minimax、anthropic 等）之间切换的开发者，省去每次手动改 config、改环境变量的机械劳动。
+
+## 当前核心功能
+
+- **多 profile 管理**：`mcc profile add/list/remove/default`，元数据存 `~/.mcc/profiles.json`，API key 存 `~/.mcc/profiles/<name>/.key`
+- **一键切换**：`mcc <profile>` 设置 `ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_MODEL` / `CLAUDE_CONFIG_DIR` 后直接启动 Claude Code
+- **实例隔离**：每个 profile 对应独立的 `CLAUDE_CONFIG_DIR`（`~/.mcc/instances/<name>/`），session 历史、MCP 配置互不干扰
+- **OpenAI 兼容 + 翻译 proxy**：`protocol: 'openai'` 时自动在 `127.0.0.1:43456-43555` 范围内启动 proxy，支持所有 OpenAI-compatible provider（MiniMax 等）
+- **Tiered model**：profile 支持 `opusModel`/`sonnetModel`/`haikuModel`，Claude Code 运行时根据任务级别自动选用
+- **内置 MCP**：`mcc-websearch`（多源 web 搜索）和 `mcc-image-analysis`（图片/PDF 分析），自动安装到 instance 的 `.claude.json`
+- **外部 MCP registry**：通过 `mcc mcp add` 注册第三方 MCP server，API key 通过 `${MCC_PROVIDER_KEY:<providerId>}` 引用 `~/.mcc/mcp-config.json` 中的配置
+- **MCP provider 配置系统**：`~/.mcc/mcp-config.json` 统一管理 WebSearch（duckduckgo/exa/tavily/brave）和 ImageAnalysis（ali/kimi/minimax/deepseek）的 provider 开关和 API key
+- **跨 instance 共享**：skills、commands、agents、plugins、settings.json 通过 symlink 在所有 instance 间共享（`~/.claude/` → `~/.mcc/instances/<name>/<item>`）
+- **Session 日志**：每次启动生成独立 session 日志（`~/.mcc/logs/<profile>/<sessionId>/mcc.log`），自动 logrotate
+- **Web Dashboard**：Express + 静态文件，提供 profile/MCP/模型配置的管理界面（`npm run dashboard`，端口 3000）
+
+## 明确不做什么
+
+- 不做 OAuth 登录流程（账号靠 API key）
+- 不做 Codex CLI / Factory Droid 等 runtime 桥接（只支持 Claude Code）
+- 不做 quota 监控 / cost tracking
+
+## 待规划
+
+- 多个 Claude Code 官方账号切换