ccman 2.1.4 → 2.1.6

package/README_en.md

@@ -28,12 +28,54 @@
 
 ## 🚀 Quick Start
 
-### Installation
+### Installation Methods
+
+#### Method 1: npm Installation (Recommended)
 
 ```bash
+# Global installation
 npm install -g ccman
+
+# Or use pnpm
+pnpm add -g ccman
+
+# Or use yarn
+yarn global add ccman
+```
+
+#### Method 2: npx Direct Run (No Installation Required)
+
+```bash
+# Run directly without global installation
+npx ccman
+
+# Run specific commands
+npx ccman ls
+npx ccman add anthropic "Anthropic Official" https://api.anthropic.com
+```
+
+#### Method 3: Install from Source
+
+```bash
+# Clone repository
+git clone https://github.com/2ue/ccman.git
+cd ccman
+
+# Install dependencies
+pnpm install
+
+# Link globally (development mode)
+npm link
+
+# Or build and run
+pnpm build
+node dist/cli.js
 ```
 
+#### Method 4: Download Pre-built Version
+
+Visit [GitHub Releases](https://github.com/2ue/ccman/releases) to download pre-built versions for your platform (if available)
+
 ### First Run
 
 ```bash
@@ -109,7 +151,7 @@ $ ccman
 
 CCM directly manages the `~/.claude/settings.json` file with these safety measures:
 
-### 1. Selective Updates
+### Selective Updates
 
 Only modifies CCM-managed configuration items:
 - `env.ANTHROPIC_AUTH_TOKEN`
@@ -118,13 +160,9 @@ Only modifies CCM-managed configuration items:
 - `env.CLAUDE_CODE_MAX_OUTPUT_TOKENS`
 - `permissions.allow` / `permissions.deny`
 
-### 2. Configuration Protection
-
-Preserves all other user configuration items:
-- ✅ Preserves: `mcpServers`, `model`, `customUserConfig`, etc.
-- 🔄 Updates: Only the CCM-managed configuration items listed above
+**Preserves all other user configuration items** (such as `mcpServers`, `model`, `customUserConfig`, etc.)
 
-### 3. Automatic Backups
+### Automatic Backups
 
 Automatically backs up current configuration to `~/.ccman/backups/` before each switch
 
@@ -140,57 +178,6 @@ Automatically backs up current configuration to `~/.ccman/backups/` before each
 └── backups/                # Configuration backup directory (auto-created)
 ```
 
-### Provider Configuration File Structure
-
-```json
-{
-  "name": "Anthropic Official",
-  "description": "Official Anthropic API Configuration",
-  "config": {
-    "env": {
-      "ANTHROPIC_AUTH_TOKEN": "your-token",
-      "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
-      "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
-      "CLAUDE_CODE_MAX_OUTPUT_TOKENS": 32000
-    },
-    "permissions": {
-      "allow": [],
-      "deny": []
-    }
-  },
-  "metadata": {
-    "createdAt": "2025-01-15T10:30:00.000Z",
-    "updatedAt": "2025-01-15T10:30:00.000Z",
-    "usageCount": 5
-  }
-}
-```
-
-### Main CCM Configuration File Structure
-
-```json
-{
-  "currentProvider": "anthropic",
-  "claudeConfigPath": "/Users/user/.claude/settings.json",
-  "providers": {
-    "anthropic": {
-      "name": "Anthropic Official",
-      "configFile": "anthropic.json",
-      "lastUsed": "2025-01-15T10:30:00.000Z"
-    }
-  },
-  "settings": {
-    "language": "zh",
-    "firstRun": false
-  },
-  "metadata": {
-    "version": "2.1.3",
-    "createdAt": "2025-01-15T10:00:00.000Z",
-    "updatedAt": "2025-01-15T10:30:00.000Z"
-  }
-}
-```
-
 ## 🌐 Language Support
 
 ### Supported Languages
@@ -205,88 +192,6 @@ Automatically backs up current configuration to `~/.ccman/backups/` before each
 - Other environments (including `zh-*`, unset, etc.) → Automatically uses Chinese interface
 - Users can manually override language settings at any time
 
-### First-Run Experience
-
-```bash
-$ ccman
-
-🌍 Welcome to CCM! / 欢迎使用 CCM!
-
-This is your first time running CCM.
-这是您首次运行 CCM。
-
-? Please choose your preferred language:
-? 请选择您偏好的语言：
-❯ 🇨🇳 中文 (Chinese)
-  🇺🇸 English
-  🌐 Auto-detect based on system
-
-✓ Language set to English
-✓ You can change this later with: ccman lang set <zh|en|auto>
-```
-
-## 🛠️ Development
-
-### Environment Setup
-
-```bash
-# Clone repository
-git clone https://github.com/2ue/ccman.git
-cd ccman
-
-# Install dependencies
-pnpm install
-```
-
-### Development Commands
-
-```bash
-pnpm run dev                 # Development mode (using tsx)
-pnpm run build               # TypeScript compilation
-pnpm run start               # Run compiled CLI
-pnpm run clean               # Clean dist/ directory
-pnpm run lint                # ESLint code check
-pnpm test                    # Run tests
-```
-
-### Development Environment Isolation
-
-CCM supports development environment configuration isolation to avoid affecting production configurations:
-
-```bash
-# Set development environment configuration paths
-export CCM_CONFIG_DIR=".ccman-dev"
-export CLAUDE_CONFIG_PATH="$HOME/.claude/settings-dev.json"
-
-# Run in isolated environment
-pnpm run dev
-```
-
-### Project Structure
-
-```
-src/
-├── types/                    # TypeScript type definitions
-│   └── index.ts             # Core type interfaces
-├── core/                     # Core modules
-│   ├── CCMConfigManager.ts  # CCM configuration manager
-│   └── ClaudeConfigManager.ts # Claude configuration manager
-├── providers/                # Provider management
-│   └── ProviderManager.ts   # Provider business logic
-├── commands/                 # Command handling
-│   └── lang.ts              # Language command processing
-├── i18n/                     # Internationalization
-│   ├── LanguageManager.ts   # Language manager
-│   └── messages.ts          # Multi-language messages
-├── utils/                    # Utility functions
-│   ├── env-config.ts        # Environment configuration
-│   └── version.ts           # Version information
-├── config/                   # Configuration files
-│   └── static-env.ts        # Static environment configuration
-├── cli.ts                    # CLI entry point
-└── index.ts                 # Module exports
-```
-
 ## 📋 System Requirements
 
 - **Node.js** >= 16.0.0
@@ -307,9 +212,6 @@ ccman use <provider-id>
 
 # 3. Check Claude configuration file
 cat ~/.claude/settings.json | grep ANTHROPIC
-
-# 4. View complete configuration
-cat ~/.claude/settings.json | jq .
 ```
 
 ### Language Switching Issues
@@ -321,9 +223,6 @@ ccman lang
 # Force set to Chinese
 ccman lang set zh
 
-# Force set to English
-ccman lang set en
-
 # Reset to first-run state (re-select language)
 ccman lang reset
 ccman
@@ -339,61 +238,12 @@ ccman clear
 ccman
 ```
 
-### Development Environment Issues
-
-```bash
-# Use isolated development environment
-export CCM_CONFIG_DIR=".ccman-dev"
-pnpm run dev
-
-# Clean and rebuild
-pnpm run clean
-pnpm run build
-```
-
-## 📝 Changelog
-
-### v2.1.3 (2025-09-24)
-- ✨ Added `CLAUDE_CODE_MAX_OUTPUT_TOKENS` configuration support
-- 🐛 Fixed TypeScript compilation errors, completely removed apiKeyHelper configuration
-- 🎨 Optimized interactive menu experience
-- 📦 Updated dependency package versions
-
-### v2.1.2
-- 🎨 Simplified provider configuration, removed manual ID setting
-- ✨ Optimized first-run experience
-
-### v2.0.0
-- 🎉 New architecture: Direct configuration integration without shell integration
-- 🌍 Intelligent multilingual support (Chinese/English/Auto-detect)
-- 🎯 Interactive menu system
-- 📁 Multi-provider management
-- 🔒 Automatic backups and configuration protection
-
-### v1.x
-- Legacy architecture: Based on shell environment variable integration (deprecated)
-
-## 🚀 Migration from v1.x
-
-CCM v2.0 uses a completely different architecture and is incompatible with v1.x:
-
-### v1.x (Deprecated)
-- ❌ Modified shell configuration files (.bashrc, .zshrc, etc.)
-- ❌ Used environment variables
-- ❌ Complex shell integration and reloading
-
-### v2.x (Current Version)
-- ✅ Directly modifies `~/.claude/settings.json`
-- ✅ Provider-based configuration management
-- ✅ Intelligent language support
-- ✅ Simplified, secure implementation
-
-**Migration Steps**:
+## 📚 Development Documentation
 
-1. Uninstall v1.x version
-2. Clean up related content from shell configuration files
-3. Install v2.x version: `npm install -g ccman`
-4. Run `ccman` to reconfigure
+- [开发指南 (中文)](./docs/DEVELOPMENT.md)
+- [Development Guide (English)](./docs/DEVELOPMENT_en.md)
+- [Release Guide](./docs/release-guide.md)
+- [Scripts Guide](./docs/scripts-guide.md)
 
 ## 🤝 Contributing
 

package/dist/cli.js

@@ -1,5 +1,38 @@
 #!/usr/bin/env node
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -12,6 +45,7 @@ const LanguageManager_1 = require("./i18n/LanguageManager");
 const lang_1 = require("./commands/lang");
 const version_1 = require("./utils/version");
 const default_providers_1 = require("./config/default-providers");
+const EnvironmentManager_1 = require("./core/EnvironmentManager");
 const program = new commander_1.Command();
 const providerManager = new ProviderManager_1.ProviderManager();
 const languageManager = new LanguageManager_1.LanguageManager();
@@ -162,6 +196,10 @@ async function showInteractiveMenu() {
                         { name: messages.mainMenuOptions.updateProvider, value: 'update' },
                         { name: messages.mainMenuOptions.removeProvider, value: 'remove' },
                         { name: messages.mainMenuOptions.showStatus, value: 'status' },
+                        new inquirer_1.default.Separator(),
+                        { name: messages.mainMenuOptions.doctor, value: 'doctor' },
+                        { name: messages.mainMenuOptions.setup, value: 'setup' },
+                        new inquirer_1.default.Separator(),
                         { name: messages.mainMenuOptions.exit, value: 'exit' }
                     ]
                 }
@@ -367,6 +405,187 @@ async function showInteractiveMenu() {
                     shouldContinue = await askToContinue();
                     break;
                 }
+                case 'doctor': {
+                    const envManager = new EnvironmentManager_1.EnvironmentManager();
+                    const checkResult = await envManager.checkEnvironment();
+                    console.log();
+                    console.log(chalk_1.default.blue(`🔍 ${messages.environment.checkTitle}`));
+                    console.log();
+                    // Claude Code 状态
+                    if (checkResult.claudeCode.installed) {
+                        console.log(chalk_1.default.green(`${messages.environment.claudeCode}: ✓ ${messages.environment.installed}`));
+                        if (checkResult.claudeCode.version) {
+                            console.log(`  ${messages.environment.version}: ${checkResult.claudeCode.version}`);
+                        }
+                        if (checkResult.claudeCode.path) {
+                            console.log(`  ${messages.environment.path}: ${checkResult.claudeCode.path}`);
+                        }
+                    }
+                    else {
+                        console.log(chalk_1.default.red(`${messages.environment.claudeCode}: ✗ ${messages.environment.notInstalled}`));
+                    }
+                    console.log();
+                    // Node.js 状态
+                    if (checkResult.node.installed) {
+                        const versionStatus = checkResult.node.versionValid ? chalk_1.default.green('✓') : chalk_1.default.yellow('⚠️');
+                        console.log(`${chalk_1.default.green(messages.environment.nodeJs + ':')} ${versionStatus} ${messages.environment.installed}`);
+                        console.log(`  ${messages.environment.version}: ${checkResult.node.version}`);
+                        console.log(`  ${messages.environment.required}: ${checkResult.requirements.nodeVersion}`);
+                        if (checkResult.node.path) {
+                            console.log(`  ${messages.environment.path}: ${checkResult.node.path}`);
+                        }
+                    }
+                    else {
+                        console.log(chalk_1.default.red(`${messages.environment.nodeJs}: ✗ ${messages.environment.notInstalled}`));
+                    }
+                    console.log();
+                    // npm 状态
+                    if (checkResult.npm.installed) {
+                        console.log(chalk_1.default.green(`${messages.environment.npm}: ✓ ${messages.environment.installed}`));
+                        if (checkResult.npm.version) {
+                            console.log(`  ${messages.environment.version}: ${checkResult.npm.version}`);
+                        }
+                        if (checkResult.npm.path) {
+                            console.log(`  ${messages.environment.path}: ${checkResult.npm.path}`);
+                        }
+                    }
+                    else {
+                        console.log(chalk_1.default.yellow(`${messages.environment.npm}: ✗ ${messages.environment.notInstalled}`));
+                    }
+                    console.log();
+                    // 版本管理器
+                    const managers = [];
+                    if (checkResult.versionManagers.volta)
+                        managers.push('volta');
+                    if (checkResult.versionManagers.nvm)
+                        managers.push('nvm');
+                    if (managers.length > 0) {
+                        console.log(chalk_1.default.blue(`${messages.environment.versionManagers}:`));
+                        managers.forEach(m => console.log(`  ✓ ${m}`));
+                        console.log();
+                    }
+                    // 问题列表
+                    if (checkResult.issues.length > 0) {
+                        console.log(chalk_1.default.yellow(`⚠️  ${messages.environment.issues}:`));
+                        checkResult.issues.forEach(issue => console.log(`  - ${issue}`));
+                        console.log();
+                    }
+                    // 建议
+                    if (checkResult.suggestions.length > 0) {
+                        console.log(chalk_1.default.cyan(`💡 ${messages.environment.suggestions}:`));
+                        checkResult.suggestions.forEach(suggestion => console.log(`  - ${suggestion}`));
+                        console.log();
+                    }
+                    // 总体状态
+                    if (checkResult.status === 'ready') {
+                        console.log(chalk_1.default.green(`✅ ${messages.environment.ready}`));
+                    }
+                    else if (checkResult.status === 'warning') {
+                        console.log(chalk_1.default.yellow(`⚠️  ${messages.environment.hasWarnings}`));
+                    }
+                    else {
+                        console.log(chalk_1.default.red(`❌ ${messages.environment.notReady}`));
+                    }
+                    console.log();
+                    console.log();
+                    shouldContinue = await askToContinue();
+                    break;
+                }
+                case 'setup': {
+                    const envManager = new EnvironmentManager_1.EnvironmentManager();
+                    console.log(chalk_1.default.blue(`🔍 ${messages.environment.checkingEnvironment}`));
+                    const checkResult = await envManager.checkEnvironment();
+                    console.log();
+                    console.log(`${messages.environment.environmentStatus}:`);
+                    console.log(`  ${messages.environment.claudeCode}: ${checkResult.claudeCode.installed ? '✓' : '✗'}`);
+                    console.log(`  ${messages.environment.nodeJs}: ${checkResult.node.installed && checkResult.node.versionValid ? '✓' : '✗'}`);
+                    console.log();
+                    if (checkResult.status === 'ready') {
+                        console.log(chalk_1.default.green(`✅ ${messages.environment.ready}!`));
+                        console.log(messages.environment.noSetupNeeded);
+                    }
+                    else {
+                        const plan = await envManager.generateInstallPlan(checkResult);
+                        if (plan.needsNode) {
+                            console.log(chalk_1.default.yellow(`⚠️  ${messages.environment.nodeJs} ${messages.environment.needsInstallOrUpgrade}`));
+                            console.log();
+                            console.log(`${messages.environment.availableOptions}:`);
+                            console.log();
+                            const optionChoices = plan.nodeOptions.map((opt, idx) => ({
+                                name: `${idx + 1}. ${opt.name}${opt.reason ? ` (${opt.reason})` : ''}`,
+                                value: idx,
+                                short: opt.name
+                            }));
+                            const optionAnswer = await inquirer_1.default.prompt([
+                                {
+                                    type: 'list',
+                                    name: 'option',
+                                    message: messages.environment.selectMethod + ':',
+                                    choices: optionChoices
+                                }
+                            ]);
+                            const selectedOption = plan.nodeOptions[optionAnswer.option];
+                            console.log();
+                            console.log(chalk_1.default.cyan(`${messages.environment.selected}: ${selectedOption.name}`));
+                            if (selectedOption.description) {
+                                console.log(chalk_1.default.gray(`  ${selectedOption.description}`));
+                            }
+                            console.log();
+                            console.log(chalk_1.default.blue(`${messages.environment.installSteps}:`));
+                            selectedOption.steps.forEach((step, idx) => {
+                                console.log(`  ${idx + 1}. ${step.description}`);
+                                console.log(chalk_1.default.gray(`     $ ${step.command}`));
+                            });
+                            console.log();
+                            const confirmAnswer = await inquirer_1.default.prompt([
+                                {
+                                    type: 'confirm',
+                                    name: 'confirm',
+                                    message: messages.environment.proceedInstall,
+                                    default: true
+                                }
+                            ]);
+                            if (confirmAnswer.confirm) {
+                                const { Installer } = await Promise.resolve().then(() => __importStar(require('./setup/installer')));
+                                const installer = new Installer({ dryRun: true });
+                                await installer.executeSteps(selectedOption.steps);
+                            }
+                            else {
+                                console.log(chalk_1.default.yellow(messages.environment.installCancelled));
+                            }
+                        }
+                        if (plan.needsClaudeCode) {
+                            console.log();
+                            console.log(chalk_1.default.yellow(`⚠️  ${messages.environment.claudeCode} ${messages.environment.needsInstallOrUpgrade}`));
+                            console.log();
+                            console.log(chalk_1.default.blue(`${messages.environment.installSteps}:`));
+                            plan.claudeCodeSteps.forEach((step, idx) => {
+                                console.log(`  ${idx + 1}. ${step.description}`);
+                                console.log(chalk_1.default.gray(`     $ ${step.command}`));
+                            });
+                            console.log();
+                            const confirmAnswer = await inquirer_1.default.prompt([
+                                {
+                                    type: 'confirm',
+                                    name: 'confirm',
+                                    message: messages.environment.proceedInstall,
+                                    default: true
+                                }
+                            ]);
+                            if (confirmAnswer.confirm) {
+                                const { Installer } = await Promise.resolve().then(() => __importStar(require('./setup/installer')));
+                                const installer = new Installer({ dryRun: true });
+                                await installer.executeSteps(plan.claudeCodeSteps);
+                            }
+                            else {
+                                console.log(chalk_1.default.yellow(messages.environment.installCancelled));
+                            }
+                        }
+                    }
+                    console.log();
+                    shouldContinue = await askToContinue();
+                    break;
+                }
             }
         } // while 循环结束
     }