ccman 2.1.3 → 2.1.5

package/CLAUDE.md

@@ -1,279 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-CCM (Claude Code Manager) 是一个 TypeScript 命令行工具，用于管理 Claude Code API 配置。新架构直接修改 `~/.claude/settings.json` 文件实现配置切换，无需 shell 集成。
-
-## 新架构设计 (v2.0.0)
-
-### 核心理念
-- **直接配置修改**: 直接修改 `~/.claude/settings.json` 实现配置切换
-- **多供应商支持**: 在 `~/.ccman/providers/` 目录存储多个供应商配置
-- **零 shell 依赖**: 无需修改 shell 配置文件，立即生效
-- **安全备份**: 每次切换前自动备份当前配置
-
-### 目录结构
-```
-~/.ccman/
-├── config.json              # CCM 主配置文件
-├── providers/               # 供应商配置目录
-│   ├── anthropic.json      # Anthropic 官方配置
-│   ├── packycode.json      # Packycode 配置
-│   └── custom.json         # 其他自定义配置
-└── backups/                # 配置备份目录（未来功能）
-```
-
-### 项目结构
-```
-src/
-├── types/                  # TypeScript 类型定义
-├── core/                   # 核心模块
-│   ├── CCMConfigManager.ts     # CCM 配置管理
-│   └── ClaudeConfigManager.ts  # Claude 配置管理
-├── providers/              # 供应商管理
-│   └── ProviderManager.ts      # 供应商业务逻辑
-├── cli.ts                  # CLI 入口点
-└── index.ts               # 模块导出
-```
-
-## 配置文件结构
-
-### CCM 主配置 (~/.ccman/config.json)
-```json
-{
-  "currentProvider": "anthropic",
-  "claudeConfigPath": "~/.claude/settings.json",
-  "providers": {
-    "anthropic": {
-      "name": "Anthropic Official",
-      "configFile": "anthropic.json",
-      "lastUsed": "2025-01-15T10:30:00.000Z"
-    }
-  },
-  "metadata": {
-    "version": "2.0.0",
-    "createdAt": "2025-01-10T08:00:00.000Z",
-    "updatedAt": "2025-01-15T10:30:00.000Z"
-  }
-}
-```
-
-### 供应商配置 (~/.ccman/providers/anthropic.json)
-```json
-{
-  "name": "Anthropic Official",
-  "description": "Official Anthropic API",
-  "config": {
-    "env": {
-      "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
-      "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
-      "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
-      "CLAUDE_CODE_MAX_OUTPUT_TOKENS": 32000
-    },
-    "permissions": {
-      "allow": [],
-      "deny": []
-    },
-    "apiKeyHelper": "echo 'sk-xxx'"
-  },
-  "metadata": {
-    "createdAt": "2025-01-10T08:00:00.000Z",
-    "updatedAt": "2025-01-15T10:30:00.000Z",
-    "usageCount": 25
-  }
-}
-```
-
-## 命令使用
-
-### 开发命令
-```bash
-npm run build         # 编译 TypeScript
-npm run dev           # 开发模式运行
-npm start             # 运行编译后的程序
-npm run clean         # 清理构建文件
-npm run lint          # 代码检查
-```
-
-### 基础使用（精简版）
-```bash
-# 核心命令（6个）
-ccman                             # 交互式菜单（默认入口）
-ccman ls                          # 智能列表显示（合并原status信息）
-ccman ls --current                # 显示当前供应商详情（替代原current）
-ccman ls --brief                  # 简洁模式显示
-ccman add <id> <name> <url> [key] # 添加供应商配置
-ccman use <id>                    # 切换到指定供应商
-ccman rm <id>                     # 删除供应商配置（别名：remove）
-ccman clear                       # 清除所有配置（别名：reset）
-```
-
-### 命令详解
-```bash
-# 默认交互模式 - 最直观的入口
-ccman                    # 进入菜单，包含所有操作（添加/切换/更新/删除/状态）
-
-# 智能列表命令 - 整合了多种信息显示
-ccman ls                 # 显示所有供应商 + 系统状态信息
-ccman ls --current       # 仅显示当前供应商的详细信息  
-ccman ls --brief         # 简洁模式，仅显示供应商名称和ID
-
-# 快速操作命令 - 适合脚本和熟练用户
-ccman add <id> <name> <url> [key] -d "description"  # 添加时指定描述
-ccman use <id>                                      # 快速切换
-ccman rm <id>                                       # 快速删除
-ccman clear                                         # 重置所有配置
-```
-
-## 核心类型定义
-
-### ClaudeSettings
-Claude settings.json 的标准结构
-```typescript
-interface ClaudeSettings {
-  env: {
-    ANTHROPIC_AUTH_TOKEN: string;
-    ANTHROPIC_BASE_URL: string;
-    CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC?: number;
-    CLAUDE_CODE_MAX_OUTPUT_TOKENS?: number;
-  };
-  permissions: { allow: string[]; deny: string[]; };
-  apiKeyHelper: string;
-}
-```
-
-### ProviderConfig
-供应商配置结构
-```typescript
-interface ProviderConfig {
-  name: string;
-  description: string;
-  config: ClaudeSettings;
-  metadata: {
-    createdAt: string;
-    updatedAt: string;
-    usageCount: number;
-  };
-}
-```
-
-## 关键特性
-
-### 1. 直接配置修改
-- 直接读写 `~/.claude/settings.json`
-- **选择性覆盖**: 只修改CCM管理的key，保留用户其他配置
-- 无需重启终端或 source 任何文件
-- 配置切换立即生效
-
-#### CCM管理的配置项
-```json
-{
-  "env": {
-    "ANTHROPIC_AUTH_TOKEN": "...",       // ✅ CCM管理
-    "ANTHROPIC_BASE_URL": "...",         // ✅ CCM管理
-    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,  // ✅ CCM管理
-    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": 32000  // ✅ CCM管理
-  },
-  "permissions": {
-    "allow": [],                         // ✅ CCM管理
-    "deny": []                           // ✅ CCM管理
-  },
-  "apiKeyHelper": "..."                  // ✅ CCM管理
-}
-```
-
-#### 用户配置保护
-- 保留所有其他用户自定义配置项
-- 保留 `env` 中其他环境变量  
-- 保留 `permissions` 中其他权限设置
-- 保留所有非CCM管理的顶级配置项
-
-### 2. 自动备份机制
-- 每次切换前自动备份当前配置
-- 备份文件带时间戳，便于恢复
-- 防止配置丢失和冲突
-
-### 3. 交互式界面
-- 使用 inquirer.js 提供友好的交互体验
-- 彩色输出和进度反馈
-- 确认提示防止误操作
-
-### 4. 类型安全
-- 完整的 TypeScript 类型定义
-- 编译时错误检查
-- 严格的接口约束
-
-## 安全注意事项
-
-### 🚨 开发时的重要限制
-
-**绝对禁止修改以下文件（会导致系统不可用）:**
-- `~/.ccman/config.json` - 现有历史配置文件
-- `~/.claude/settings.json` - Claude Code 配置文件
-
-**开发时的安全做法:**
-1. **使用测试目录**: 开发时使用 `~/.ccman-dev/` 或其他测试目录
-2. **配置隔离**: 通过环境变量指定不同的配置路径
-3. **备份验证**: 修改前确保备份机制正常工作
-4. **分步测试**: 先测试读取，再测试写入功能
-
-### 开发环境配置
-```bash
-# 设置开发环境配置路径
-export CCM_CONFIG_DIR="~/.ccman-dev"
-export CLAUDE_CONFIG_PATH="~/.claude/settings-dev.json"
-
-# 或在代码中使用环境变量
-const configDir = process.env.CCM_CONFIG_DIR || path.join(os.homedir(), '.ccman');
-```
-
-## 构建和部署
-
-### TypeScript 编译
-- 目标: ES2020, CommonJS 模块
-- 输出: `dist/` 目录，包含源映射
-- CLI 入口: `dist/cli.js` 带正确的 shebang
-
-### 依赖管理
-- 使用 pnpm 管理依赖
-- 包含所有必要的类型声明
-- 严格的版本控制
-
-## 测试方法
-
-### 功能测试
-- CLI 命令交互测试
-- 文件系统操作验证
-- 配置切换流程测试
-- 错误处理验证
-
-### 安全测试
-- 备份机制验证
-- 权限检查
-- 配置文件完整性
-- 回滚功能测试
-
-## 未来改进
-
-### 计划功能
-- 配置模板和预设
-- 批量配置管理
-- 网络连接测试
-- 配置迁移工具
-- 增强的错误诊断
-
-### 架构优化
-- 插件化供应商支持
-- 配置验证和修复
-- 更好的备份策略
-- 性能优化
-
-## 开发注意事项
-
-- **测试优先**: 修改任何配置管理逻辑前先测试
-- **备份验证**: 确保每次操作都有可靠的备份
-- **用户体验**: 提供清晰的反馈和错误信息
-- **向后兼容**: 考虑现有用户的配置迁移
-- **安全第一**: 绝不能破坏用户的现有配置

package/README_zh.md

@@ -1,394 +0,0 @@
-# CCM - Claude Code Manager v2.0
-
-基于 TypeScript 的命令行工具，通过**直接 settings.json 集成**和**智能语言支持**管理多个 Claude Code API 供应商配置。
-
-> [English Documentation](./README.md) | **中文文档**
-
-## ✨ v2.0 新特性
-
-🌍 **智能语言支持** - 自动检测系统语言或引导首次运行设置  
-🔧 **直接 Claude 集成** - 直接修改 `~/.claude/settings.json`，无需 shell 变量  
-📁 **供应商管理** - 存储和切换多个 API 供应商配置  
-🎯 **交互式菜单系统** - 支持连续操作的导航选项  
-⚡ **零配置体验** - 开箱即用的智能默认设置  
-
-## 🚀 快速开始
-
-### 安装
-
-```bash
-# 从 NPM 安装
-npm install -g ccman
-
-# 或者开发环境安装依赖
-npm install && npm run build
-```
-
-### 首次运行体验
-
-```bash
-# 启动 CCM（首次运行）
-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)
-
-✓ 语言已设置为中文
-✓ 您可以稍后使用以下命令更改：ccman lang set <zh|en|auto>
-```
-
-### 基本用法
-
-```bash
-# 交互式主菜单（推荐）
-ccman
-
-# 列出所有供应商
-ccman ls
-
-# 直接添加供应商  
-ccman add <id> <name> <baseUrl> [apiKey]
-
-# 切换供应商
-ccman use <id>
-
-# 删除供应商
-ccman rm <id>
-```
-
-## 🌐 语言管理
-
-### 语言命令
-```bash
-ccman lang                    # 显示当前语言设置
-ccman lang set zh             # 设置为中文
-ccman lang set en             # 设置为英文  
-ccman lang set auto           # 基于系统自动检测
-ccman lang reset              # 重置为首次运行状态
-```
-
-### 支持的语言
-- **中文 (zh)** - 完整中文界面
-- **英文 (en)** - Full English interface
-- **自动检测** - 基于系统 `LANG` 环境变量
-
-### 语言检测逻辑
-- 英文环境 (`en-*`) → 英文界面
-- 其他环境（包括 `zh-*`、未设置等）→ 中文界面
-- 随时可手动覆盖
-
-## 📖 命令参考
-
-### 核心供应商管理
-```bash
-ccman                              # 交互式菜单（默认）
-ccman add <id> <name> <url> [key]  # 添加新供应商
-ccman use <id>                     # 切换到供应商
-ccman ls                           # 列出所有供应商
-ccman ls --current                 # 显示当前供应商详情
-ccman ls --brief                   # 简洁供应商列表
-ccman rm <id>                      # 删除供应商
-ccman clear                        # 删除所有供应商（危险操作）
-```
-
-### 语言管理
-```bash
-ccman lang                         # 显示当前语言
-ccman lang set <zh|en|auto>        # 设置语言偏好
-ccman lang reset                   # 重置为首次运行状态
-```
-
-## 🎯 交互式体验
-
-### 主菜单导航
-```bash
-$ ccman
-
-? 您想要执行什么操作？
-❯ 切换供应商
-  添加新供应商
-  更新供应商  
-  删除供应商
-  显示详细状态
-  退出
-
-# 每次操作后：
-? 是否要执行其他操作？ (Y/n)
-```
-
-### 供应商添加流程
-```bash
-$ ccman add
-
-? 供应商ID（唯一标识符）: my-provider
-? 供应商名称: 我的自定义API
-? 描述: 我的自定义Claude API
-? 基础URL: https://api.mycustom.com
-? API密钥: ****************
-
-✓ 供应商添加成功
-? 将"我的自定义API"设为当前供应商？ (Y/n)
-✓ 供应商切换成功
-Claude Code 配置已成功更新！
-```
-
-## 🔧 架构概览
-
-### 直接 Claude 集成
-CCM v2.0 直接修改您的 Claude Code 设置文件：
-
-**修改前（CCM 管理）**：
-```json
-{
-  "env": {
-    "ANTHROPIC_AUTH_TOKEN": "old-token",
-    "ANTHROPIC_BASE_URL": "https://old-api.com"
-  }
-}
-```
-
-**修改后（CCM 更新）**：
-```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'"
-}
-```
-
-### 供应商存储结构
-供应商存储在 `~/.ccman/providers/`：
-
-```
-~/.ccman/
-├── config.json          # CCM 主配置
-├── providers/            # 单独的供应商配置
-│   ├── anthropic.json
-│   ├── my-provider.json
-│   └── staging.json
-```
-
-### 配置合并
-CCM 只更新 Claude 相关的键，保留您的现有设置：
-- ✅ 保留：`mcpServers`、`model`、`customUserConfig` 等
-- 🔄 更新：`env.ANTHROPIC_*`、`permissions`、`apiKeyHelper`
-
-## 📊 供应商配置
-
-### 供应商结构
-```json
-{
-  "name": "Anthropic Official",
-  "description": "Anthropic 官方 API 配置", 
-  "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
-  }
-}
-```
-
-### 主配置
-```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"
-  }
-}
-```
-
-## 💡 使用示例
-
-### 完整首次设置
-```bash
-# 首次运行 - 语言选择
-ccman
-# → 语言选择向导
-# → 未找到供应商，引导创建
-# → 自动更新 Claude 设置
-
-# 添加其他供应商
-ccman add staging "测试API" https://staging-api.com
-ccman add dev "开发环境" https://dev-api.com
-
-# 在供应商间切换
-ccman use staging
-ccman use dev
-ccman use anthropic
-```
-
-### 多供应商工作流
-```bash
-# 列出所有供应商的详情
-ccman ls
-# * Anthropic Official (anthropic) - https://api.anthropic.com
-#   测试API (staging) - https://staging-api.com  
-#   开发环境 (dev) - https://dev-api.com
-
-# 切换到测试环境
-ccman use staging
-# ✓ 供应商切换成功
-# ✓ Claude Code 配置已成功更新！
-
-# 检查当前供应商
-ccman ls --current
-# 当前供应商: 测试API (staging)
-# 基础URL: https://staging-api.com
-# 使用次数: 3 次
-# 最后更新: 2025-01-15 10:30:15
-```
-
-### 语言切换
-```bash
-# 检查当前语言
-ccman lang
-# 当前语言： 中文 (Chinese)
-
-# 切换到英文
-ccman lang set en
-# ✓ 语言切换成功
-# Current language: English
-
-# 设置自动检测
-ccman lang set auto
-# ✓ 语言切换成功  
-# 当前语言： 自动检测 (Auto-detect)
-# 自动检测结果: English
-```
-
-## 🛠️ 开发设置
-
-### 开发环境
-CCM 支持隔离的开发环境：
-
-```bash
-# 设置开发路径
-export CCM_CONFIG_DIR=".ccman-dev"
-export CLAUDE_CONFIG_PATH="$HOME/.claude/settings-dev.json"
-
-# 使用开发模式
-npm run dev
-
-# 生产环境构建
-npm run build
-
-# 测试构建版本
-npm start
-```
-
-### 开发命令
-```bash
-npm run dev                 # 使用 tsx 的开发模式
-npm run build              # TypeScript 编译  
-npm run start              # 运行构建后的 CLI
-npm run clean              # 删除 dist/ 目录
-npm run lint               # ESLint TypeScript 文件检查
-npm test                   # 运行测试（passWithNoTests）
-```
-
-## 🔍 故障排除
-
-### 供应商问题
-```bash
-# 供应商不工作？
-ccman ls --current         # 检查当前供应商详情
-ccman use <供应商id>        # 重新应用供应商配置
-
-# 设置未应用？
-# 检查 ~/.claude/settings.json 的更新
-cat ~/.claude/settings.json | grep ANTHROPIC
-```
-
-### 语言问题  
-```bash
-# 语言未切换？
-ccman lang                 # 检查当前设置
-ccman lang set zh          # 强制中文
-ccman lang set en          # 强制英文
-
-# 首次运行问题？
-ccman lang reset           # 重置为首次运行状态
-ccman                      # 重新启动进行语言选择
-```
-
-### 配置问题
-```bash  
-# 配置损坏？
-ccman clear                # 删除所有（需确认）
-ccman                      # 重新开始
-
-# 开发环境隔离
-export CCM_CONFIG_DIR=".ccman-dev"  # 独立开发配置
-```
-
-## 📋 要求
-
-- **Node.js** >= 16.0.0
-- **Claude Code** 已安装且支持 settings.json
-- **操作系统**: Linux, macOS, Windows (WSL)
-
-## 📄 许可证
-
-MIT 许可证 - 详见 LICENSE 文件。
-
----
-
-## 🚀 从 v1.x 迁移
-
-CCM v2.0 使用完全不同的架构：
-
-### v1.x（Shell 集成）
-- 修改 shell 配置文件
-- 使用环境变量
-- 复杂的 shell 集成
-
-### v2.0（直接集成）  
-- 直接修改 `~/.claude/settings.json`
-- 基于供应商的配置
-- 语言支持
-- 简化、更安全的方法
-
-**迁移**：v1.x 和 v2.x 不兼容。如果升级，请使用 `ccman clear` 重新开始。
-
----
-
-*CCM v2.0 - 智能、多语言、无缝的 Claude Code 供应商管理。*

package/dev-test.sh

@@ -1,40 +0,0 @@
-#!/bin/bash
-
-# CCM 开发测试脚本
-# 设置开发环境变量，避免影响生产配置
-
-echo "🔧 Setting up CCM development environment..."
-
-# 设置开发环境变量
-export CCM_CONFIG_DIR=".ccman-dev"
-export CLAUDE_CONFIG_PATH="$HOME/.claude/settings-dev.json"
-
-echo "   CCM Config Directory: $HOME/$CCM_CONFIG_DIR"
-echo "   Claude Config Path: $CLAUDE_CONFIG_PATH"
-echo
-
-# 创建开发用的 Claude 配置文件（如果不存在）
-if [ ! -f "$CLAUDE_CONFIG_PATH" ]; then
-    echo "📝 Creating development Claude settings file..."
-    mkdir -p "$(dirname "$CLAUDE_CONFIG_PATH")"
-    cat > "$CLAUDE_CONFIG_PATH" << 'EOF'
-{
-  "env": {
-    "ANTHROPIC_AUTH_TOKEN": "",
-    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
-  },
-  "permissions": {
-    "allow": [],
-    "deny": []
-  },
-  "apiKeyHelper": "echo ''"
-}
-EOF
-    echo "   Created: $CLAUDE_CONFIG_PATH"
-    echo
-fi
-
-# 执行 CCM 命令
-echo "🚀 Running CCM command: $@"
-echo
-npm run dev -- "$@"