ccman 2.1.3 → 2.1.4

package/docs/scripts-guide.md

@@ -1,221 +0,0 @@
-# Scripts 使用指南
-
-项目提供了多个发布和管理脚本，位于 `./scripts/` 目录下。现已升级为**模块化架构**，提供更灵活、专业的发布体验。
-
-## 📂 Scripts 目录结构
-
-### 🆕 模块化架构 (v3.0)
-
-```
-scripts/
-├── modules/                        # 独立功能模块
-│   ├── check-uncommitted.sh       # 智能未提交代码处理
-│   ├── version-bump.sh             # 智能版本提升选择
-│   ├── create-tag.sh               # 创建tag和提交
-│   └── monitor-release.sh          # 发布状态监控
-├── smart-release-v3.sh             # 🌟 主控智能发布脚本
-├── release.sh                      # 完整发布流程（经典版本）
-├── quick-release.sh                # 快速发布流程（经典版本）
-└── publish-local.sh                # 本地发布脚本（调试用）
-```
-
-## 🌟 模块化智能发布脚本（推荐）
-
-### `smart-release-v3.sh` - 主控智能发布脚本
-
-**🎯 完全按照专业发布流程设计**，实现四个独立步骤的完美组合：
-
-#### 📋 发布流程
-1. **检查工作目录状态** - 智能处理未提交代码
-2. **版本管理** - 可选择版本升级或使用现有版本
-3. **创建tag和提交** - 纯tag操作，触发GitHub Actions
-4. **监控发布状态** - 5分钟实时监控，自动确认成功
-
-#### 🚀 使用方法
-
-```bash
-# 完整智能发布流程
-./scripts/smart-release-v3.sh
-
-# 跳过版本升级，使用当前版本
-./scripts/smart-release-v3.sh --skip-version
-
-# 直接指定版本类型
-./scripts/smart-release-v3.sh --version-type minor
-
-# 不监控发布状态
-./scripts/smart-release-v3.sh --no-monitor
-
-# 查看帮助
-./scripts/smart-release-v3.sh --help
-```
-
-#### ✨ 智能特性
-
-- **智能未提交代码处理**: 3种处理选项（提交/暂存/取消）
-- **智能版本推荐**: 基于git提交历史分析推荐合适版本
-- **实时发布监控**: 监控GitHub Actions、NPM包、GitHub Release状态
-- **完整链接输出**: 自动生成所有相关监控和访问链接
-- **专业错误处理**: 每步都有错误检查和恢复提示
-
-## 🔧 独立模块脚本
-
-每个模块都可以独立运行，便于测试和调试：
-
-### 1. `modules/check-uncommitted.sh` - 代码状态检查
-
-```bash
-# 检查工作目录状态
-./scripts/modules/check-uncommitted.sh
-```
-
-**功能**:
-- 检测未提交的更改
-- 提供3种智能处理选项：提交、暂存、取消
-- 给出清晰的操作指导
-
-### 2. `modules/version-bump.sh` - 版本管理
-
-```bash
-# 交互式版本选择
-./scripts/modules/version-bump.sh
-
-# 直接指定版本类型
-./scripts/modules/version-bump.sh patch
-./scripts/modules/version-bump.sh minor
-./scripts/modules/version-bump.sh major
-
-# 测试模式（不执行实际升级）
-./scripts/modules/version-bump.sh test
-```
-
-**功能**:
-- 基于git提交历史的智能版本推荐
-- 5种版本选择：patch、minor、major、prerelease、custom
-- 版本预览和确认机制
-
-### 3. `modules/create-tag.sh` - Tag创建
-
-```bash
-# 根据当前package.json版本创建tag
-./scripts/modules/create-tag.sh
-```
-
-**功能**:
-- 根据package.json版本号创建tag
-- 不进行版本升级，纯tag操作
-- 自动提交和推送，触发GitHub Actions
-
-### 4. `modules/monitor-release.sh` - 发布监控
-
-```bash
-# 监控当前版本的发布状态
-./scripts/modules/monitor-release.sh
-```
-
-**功能**:
-- 5分钟超时的实时监控
-- 并行检查GitHub Actions、NPM包、GitHub Release
-- 输出完整的监控链接
-- 生成发布状态总结报告
-
-## 📊 经典发布脚本
-
-### 1. `quick-release.sh` - 快速发布
-
-**适用场景**: 日常开发中的小版本发布
-
-```bash
-# 交互式选择版本类型
-./scripts/quick-release.sh
-
-# 直接指定版本类型
-./scripts/quick-release.sh patch   # 修订版本
-./scripts/quick-release.sh minor   # 次版本
-./scripts/quick-release.sh major   # 主版本
-```
-
-### 2. `release.sh` - 完整发布流程
-
-**适用场景**: 重要版本发布，需要分支管理
-
-```bash
-# 启动完整发布流程
-./scripts/release.sh
-```
-
-**特点**:
-- 创建专用的release分支
-- 智能版本建议和详细changelog
-- 支持prerelease和自定义版本
-
-## 🆚 版本对比
-
-| 特性 | smart-release-v3.sh | 经典脚本 | 独立模块 |
-|------|---------------------|----------|----------|
-| **模块化设计** | ✅ | ❌ | ✅ |
-| **发布监控** | ✅ 5分钟实时监控 | ❌ 仅提供链接 | ✅ |
-| **智能代码处理** | ✅ 3种选项 | ❌ 直接拒绝 | ✅ |
-| **参数支持** | ✅ 丰富的选项 | 🟡 基本支持 | ✅ |
-| **错误恢复** | ✅ 专业级 | 🟡 基本 | ✅ |
-| **可测试性** | ✅ 高 | 🟡 中等 | ✅ |
-
-## 💡 使用建议
-
-### 🎯 推荐使用场景
-
-1. **日常发布**: 使用 `smart-release-v3.sh` - 最完整的智能体验
-2. **快速测试**: 使用 `smart-release-v3.sh --no-monitor` - 跳过监控
-3. **仅升级版本**: 使用 `modules/version-bump.sh` - 独立版本管理
-4. **调试监控**: 使用 `modules/monitor-release.sh` - 独立测试监控功能
-5. **传统发布**: 使用经典脚本作为备用方案
-
-### 🚀 最佳实践
-
-1. **首次使用**: 先运行 `smart-release-v3.sh --help` 了解选项
-2. **测试环境**: 使用 `--no-monitor` 跳过监控，节省时间  
-3. **版本规划**: 遵循[语义化版本](https://semver.org/lang/zh-CN/)规范
-4. **提交规范**: 使用[约定式提交](https://www.conventionalcommits.org/zh-hans/)，获得智能版本推荐
-5. **模块测试**: 单独测试各模块功能，确保环境正确
-
-## 🔗 NPM Scripts 快捷方式
-
-在package.json中的快捷方式：
-
-```bash
-# 智能发布（推荐）
-pnpm run release:smart      # = ./scripts/smart-release-v3.sh
-
-# 经典发布
-pnpm run release            # = ./scripts/release.sh
-pnpm run release:patch      # = ./scripts/quick-release.sh patch
-pnpm run release:minor      # = ./scripts/quick-release.sh minor
-pnpm run release:major      # = ./scripts/quick-release.sh major
-
-# 本地发布
-pnpm run publish:local      # = ./scripts/publish-local.sh
-```
-
-## ⚠️ 注意事项
-
-### 1. 环境要求
-- ✅ Node.js 和 pnpm 已安装
-- ✅ Git 仓库，工作目录相对干净
-- ✅ NPM_TOKEN 已在 GitHub Secrets 中配置
-- ✅ curl 已安装（用于发布状态监控）
-
-### 2. 权限设置
-```bash
-# 给脚本添加执行权限（首次使用）
-chmod +x scripts/**/*.sh
-```
-
-### 3. 故障排查
-- **模块未找到**: 检查 `scripts/modules/` 目录是否存在
-- **权限错误**: 运行 `chmod +x scripts/**/*.sh`
-- **监控超时**: 5分钟后超时是正常的，请手动检查链接
-- **版本冲突**: 检查 package.json 版本号是否正确
-
----
-
-🎉 **推荐**: 立即体验 `./scripts/smart-release-v3.sh` 获得最佳的智能发布体验！

package/docs/version-management.md

@@ -1,64 +0,0 @@
-# 版本管理
-
-## 🎯 版本工具
-
-项目使用独立的版本工具模块 `src/utils/version.ts`：
-
-```typescript
-import { getCurrentVersion } from './utils/version';
-
-// CLI 自动获取版本
-program.version(getCurrentVersion());
-```
-
-## 📦 发布脚本功能
-
-### 智能版本推荐
-脚本会分析最近的 git 提交，自动推荐合适的版本类型：
-- `feat`, `feature` → minor 版本
-- `breaking`, `major` → major 版本  
-- 其他 → patch 版本
-
-### 交互式界面
-```bash
-📦 版本升级选项:
-
-✨ [推荐] 1) 🔧 patch (修订版本)    0.0.1 → 0.0.2
-          2) ✨ minor (次版本)     0.0.1 → 0.1.0  
-          3) 🚀 major (主版本)     0.0.1 → 1.0.0
-
-请选择版本类型 (1-3, 回车默认选择推荐项):
-```
-
-## 🚀 使用方式
-
-### 快速发布
-```bash
-pnpm run release:patch      # 直接发布 patch 版本
-pnpm run release:minor      # 直接发布 minor 版本
-pnpm run release:major      # 直接发布 major 版本
-```
-
-### 交互式发布
-```bash
-pnpm run release:interactive  # 交互选择版本类型
-pnpm run release             # 完整发布流程
-```
-
-### 本地发布
-```bash
-pnpm run publish:local      # 绕过 GitHub Actions
-```
-
-## 🎯 版本管理最佳实践
-
-### 语义化版本
-- **patch (0.0.x)**: Bug 修复、小改进
-- **minor (0.x.0)**: 新功能、向后兼容
-- **major (x.0.0)**: 破坏性更改、重大重构
-
-### 工具特性
-- ✅ 版本号统一管理（package.json）
-- ✅ 智能推荐基于 git 提交分析
-- ✅ 交互式界面友好
-- ✅ 支持多种发布模式

package/jest.config.js

@@ -1,22 +0,0 @@
-module.exports = {
-  preset: 'ts-jest',
-  testEnvironment: 'node',
-  roots: ['<rootDir>/src'],
-  testMatch: [
-    '**/__tests__/**/*.ts',
-    '**/?(*.)+(spec|test).ts'
-  ],
-  transform: {
-    '^.+\\.ts$': 'ts-jest'
-  },
-  collectCoverageFrom: [
-    'src/**/*.ts',
-    '!src/**/*.d.ts',
-    '!src/index.ts',  // 简单的导出文件
-    '!src/cli.ts'     // CLI入口文件，主要是命令定义
-  ],
-  coverageDirectory: 'coverage',
-  coverageReporters: ['text', 'lcov', 'html'],
-  moduleFileExtensions: ['ts', 'js', 'json'],
-  testTimeout: 10000
-};

package/release-temp/README.md

@@ -1,394 +0,0 @@
-# CCM - Claude Code Manager v2.0
-
-A TypeScript-based command-line tool to manage multiple Claude Code API provider configurations with **direct settings.json integration** and **intelligent language support**.
-
-> **English Documentation** | [中文文档](./README_zh.md)
-
-## ✨ New in v2.0
-
-🌍 **Intelligent Language Support** - Auto-detects system language or guides first-run setup  
-🔧 **Direct Claude Integration** - Modifies `~/.claude/settings.json` directly, no shell variables  
-📁 **Provider Management** - Store and switch between multiple API provider configurations  
-🎯 **Interactive Menu System** - Continuous operation support with navigation options  
-⚡ **Zero-Config Experience** - Works out of the box with smart defaults  
-
-## 🚀 Quick Start
-
-### Installation
-
-```bash
-# Install from NPM
-npm install -g ccman
-
-# Or install dependencies for development
-npm install && npm run build
-```
-
-### First Run Experience
-
-```bash
-# Start CCM (first time)
-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 Chinese
-✓ You can change this later with: ccman lang set <zh|en|auto>
-```
-
-### Basic Usage
-
-```bash
-# Interactive main menu (recommended)
-ccman
-
-# List all providers
-ccman ls
-
-# Add provider directly  
-ccman add <id> <name> <baseUrl> [apiKey]
-
-# Switch provider
-ccman use <id>
-
-# Remove provider
-ccman rm <id>
-```
-
-## 🌐 Language Management
-
-### Language Commands
-```bash
-ccman lang                    # Show current language setting
-ccman lang set zh             # Set to Chinese
-ccman lang set en             # Set to English  
-ccman lang set auto           # Auto-detect based on system
-ccman lang reset              # Reset to first-run state
-```
-
-### Supported Languages
-- **Chinese (zh)** - 完整中文界面
-- **English (en)** - Full English interface
-- **Auto-detect** - Based on system `LANG` environment variable
-
-### Language Detection Logic
-- English environments (`en-*`) → English interface
-- Other environments (including `zh-*`, unset) → Chinese interface
-- Manual override available anytime
-
-## 📖 Commands Reference
-
-### Core Provider Management
-```bash
-ccman                              # Interactive menu (default)
-ccman add <id> <name> <url> [key]  # Add new provider
-ccman use <id>                     # Switch to provider
-ccman ls                           # List all providers
-ccman ls --current                 # Show current provider details
-ccman ls --brief                   # Brief provider list
-ccman rm <id>                      # Remove provider
-ccman clear                        # Remove ALL providers (destructive)
-```
-
-### Language Management
-```bash
-ccman lang                         # Show current language
-ccman lang set <zh|en|auto>        # Set language preference
-ccman lang reset                   # Reset to first-run state
-```
-
-## 🎯 Interactive Experience
-
-### Main Menu Navigation
-```bash
-$ ccman
-
-? What would you like to do?
-❯ Switch provider
-  Add new provider
-  Update provider  
-  Remove provider
-  Show detailed status
-  Exit
-
-# After each operation:
-? Would you like to perform another operation? (Y/n)
-```
-
-### Provider Addition Flow
-```bash
-$ ccman add
-
-? Provider ID: my-provider
-? Provider name: My Custom API
-? Description: My custom Claude API
-? Base URL: https://api.mycustom.com
-? API Key: ****************
-
-✓ Provider added successfully
-? Set "My Custom API" as current provider? (Y/n)
-✓ Provider switched successfully
-Claude Code configuration has been updated successfully!
-```
-
-## 🔧 Architecture Overview
-
-### Direct Claude Integration
-CCM v2.0 directly modifies your Claude Code settings file:
-
-**Before (CCM manages)**:
-```json
-{
-  "env": {
-    "ANTHROPIC_AUTH_TOKEN": "old-token",
-    "ANTHROPIC_BASE_URL": "https://old-api.com"
-  }
-}
-```
-
-**After (CCM updates)**:
-```json
-{
-  "env": {
-    "ANTHROPIC_AUTH_TOKEN": "new-token", 
-    "ANTHROPIC_BASE_URL": "https://new-api.com",
-    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
-  },
-  "permissions": {
-    "allow": [],
-    "deny": []
-  },
-  "apiKeyHelper": "echo 'new-token'"
-}
-```
-
-### Provider Storage Structure
-Providers are stored in `~/.ccman/providers/`:
-
-```
-~/.ccman/
-├── config.json          # Main CCM configuration
-├── providers/            # Individual provider configs
-│   ├── anthropic.json
-│   ├── my-provider.json
-│   └── staging.json
-```
-
-### Configuration Merging
-CCM only updates Claude-specific keys, preserving your existing settings:
-- ✅ Preserves: `mcpServers`, `model`, `customUserConfig`, etc.
-- 🔄 Updates: `env.ANTHROPIC_*`, `permissions`, `apiKeyHelper`
-
-## 📊 Provider Configuration
-
-### Provider 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
-    },
-    "permissions": { "allow": [], "deny": [] },
-    "apiKeyHelper": "echo 'your-token'"
-  },
-  "metadata": {
-    "createdAt": "2025-01-15T10:30:00.000Z",
-    "updatedAt": "2025-01-15T10:30:00.000Z", 
-    "usageCount": 5
-  }
-}
-```
-
-### Main Configuration
-```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.0.0",
-    "createdAt": "2025-01-15T10:00:00.000Z",
-    "updatedAt": "2025-01-15T10:30:00.000Z"
-  }
-}
-```
-
-## 💡 Usage Examples
-
-### Complete First-Time Setup
-```bash
-# First run - language selection
-ccman
-# → Language selection wizard
-# → No providers found, guided creation
-# → Automatic Claude settings update
-
-# Add additional providers
-ccman add staging "Staging API" https://staging-api.com
-ccman add dev "Development" https://dev-api.com
-
-# Switch between providers
-ccman use staging
-ccman use dev
-ccman use anthropic
-```
-
-### Multi-Provider Workflow
-```bash
-# List all providers with details
-ccman ls
-# * Anthropic Official (anthropic) - https://api.anthropic.com
-#   Staging API (staging) - https://staging-api.com  
-#   Development (dev) - https://dev-api.com
-
-# Switch to staging for testing
-ccman use staging
-# ✓ Provider switched successfully
-# ✓ Claude Code configuration has been updated successfully!
-
-# Check current provider
-ccman ls --current
-# Current provider: Staging API (staging)
-# Base URL: https://staging-api.com
-# Usage count: 3 times
-# Last updated: 2025-01-15 10:30:15
-```
-
-### Language Switching
-```bash
-# Check current language
-ccman lang
-# Current language: 中文 (Chinese)
-
-# Switch to English
-ccman lang set en
-# ✓ Language switched successfully
-# Current language: English
-
-# Set auto-detect
-ccman lang set auto
-# ✓ Language switched successfully  
-# Current language: Auto-detect
-# Auto-detected: English
-```
-
-## 🛠️ Development Setup
-
-### Development Environment
-CCM supports isolated development environments:
-
-```bash
-# Set development paths
-export CCM_CONFIG_DIR=".ccman-dev"
-export CLAUDE_CONFIG_PATH="$HOME/.claude/settings-dev.json"
-
-# Use development mode
-npm run dev
-
-# Build for production
-npm run build
-
-# Test built version
-npm start
-```
-
-### Development Commands
-```bash
-npm run dev                 # Development mode with tsx
-npm run build              # TypeScript compilation  
-npm run start              # Run built CLI
-npm run clean              # Remove dist/ directory
-npm run lint               # ESLint TypeScript files
-npm test                   # Run tests (passWithNoTests)
-```
-
-## 🔍 Troubleshooting
-
-### Provider Issues
-```bash
-# Provider not working?
-ccman ls --current         # Check current provider details
-ccman use <provider-id>    # Re-apply provider configuration
-
-# Settings not applied?
-# Check ~/.claude/settings.json for updates
-cat ~/.claude/settings.json | grep ANTHROPIC
-```
-
-### Language Issues  
-```bash
-# Language not switching?
-ccman lang                 # Check current setting
-ccman lang set zh          # Force Chinese
-ccman lang set en          # Force English
-
-# First-run issues?
-ccman lang reset           # Reset to first-run state
-ccman                      # Restart for language selection
-```
-
-### Configuration Issues
-```bash  
-# Corrupt configuration?
-ccman clear                # Remove all (with confirmation)
-ccman                      # Fresh start
-
-# Development isolation
-export CCM_CONFIG_DIR=".ccman-dev"  # Separate dev config
-```
-
-## 📋 Requirements
-
-- **Node.js** >= 16.0.0
-- **Claude Code** installed with settings.json support
-- **Operating Systems**: Linux, macOS, Windows (WSL)
-
-## 📄 License
-
-MIT License - see LICENSE file for details.
-
----
-
-## 🚀 Migration from v1.x
-
-CCM v2.0 uses a completely different architecture:
-
-### v1.x (Shell Integration)
-- Modified shell configuration files
-- Used environment variables
-- Complex shell integration
-
-### v2.0 (Direct Integration)  
-- Modifies `~/.claude/settings.json` directly
-- Provider-based configuration
-- Language support
-- Simplified, safer approach
-
-**Migration**: v1.x and v2.x are incompatible. Start fresh with `ccman clear` if upgrading.
-
----
-
-*CCM v2.0 - Intelligent, multilingual, and seamless Claude Code provider management.*