@haiyangj/ccs 1.0.1

package/UPDATE_NOTES.md

@@ -0,0 +1,126 @@
+# 更新说明 (v1.0.1)
+
+## 主要变更
+
+### 1. ✅ 修复 settings.json 结构
+**问题**: 之前的实现更新的是顶层的 `apiUrl` 和 `apiKey` 字段，但实际 Claude Code 使用的是嵌套的 `env` 对象。
+
+**修复内容**:
+- 现在正确更新 `env.ANTHROPIC_BASE_URL`
+- 现在正确更新 `env.ANTHROPIC_AUTH_TOKEN`
+- 保留其他配置项（如 `enabledPlugins`）
+
+**实际的 settings.json 格式**:
+```json
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
+    "ANTHROPIC_BASE_URL": "https://api.url.com"
+  },
+  "enabledPlugins": {
+    "document-skills@anthropic-agent-skills": true,
+    "code-review@claude-plugins-official": true,
+    "superpowers@superpowers-marketplace": true
+  },
+  "apiUrl": "",
+  "apiKey": ""
+}
+```
+
+### 2. ✅ 移除 API Key 格式限制
+**问题**: 之前要求 API key 必须以 `sk-ant-` 开头，不支持其他 API 提供商。
+
+**修复内容**:
+- 移除 `sk-ant-` 前缀要求
+- 最小长度从 20 字符降低到 10 字符
+- 支持任意格式的 API key
+
+**示例**: 现在可以使用以下格式的 key：
+- `sk-ant-xxxxx` (Anthropic 官方)
+- `cr_xxxxx` (其他提供商)
+- 任何自定义格式
+
+## 修改的文件
+
+### 核心代码
+1. **src/core/config.js**
+   - `getApiConfig()` - 从嵌套的 env 对象读取配置
+   - `updateApiConfig()` - 更新嵌套的 env 对象
+   - `createSettings()` - 创建正确的初始结构
+
+2. **src/core/validator.js**
+   - `validateApiKey()` - 放宽验证规则
+
+### 文档
+3. **DESIGN_SPEC.md** - 更新验证规则和示例
+4. **README.md** - 更新 settings.json 示例
+5. **IMPLEMENTATION.md** - 更新数据结构说明
+6. **CHANGELOG.md** - 记录变更历史
+7. **package.json** - 版本升级到 1.0.1
+
+## 使用示例
+
+```bash
+# 现在可以添加任意格式的 API key
+ccm add aihezu https://cn.aihezu.dev/api cr_b31cbdea1b3fda0a5bfcd7ae11f3c6e5b01b5bc9702a394c522c45a54a4fc886
+
+# 切换配置
+ccm use aihezu
+
+# 查看当前配置
+ccm show
+```
+
+## 验证测试
+
+建议进行以下测试：
+1. [ ] `ccm init` - 初始化
+2. [ ] `ccm add` - 添加新配置（使用非 sk-ant- 格式的 key）
+3. [ ] `ccm use` - 切换配置
+4. [ ] 检查 settings.json 文件是否正确更新 env 字段
+5. [ ] 验证其他配置（如 enabledPlugins）是否保留
+
+## 向后兼容性
+
+- ✅ 如果 settings.json 不存在，会创建正确格式的文件
+- ✅ 如果 settings.json 已存在但缺少 env 对象，会自动创建
+- ✅ 保留所有其他配置项，不会覆盖
+
+---
+
+**更新日期**: 2026-01-16
+**版本**: 1.0.0 → 1.0.1
+
+---
+
+## 包名更新记录
+
+### 最终包名: @haiyangj/ccs
+
+**发布命名**: `@haiyangj/ccs` (Haiyangj's Claude Config Switcher)
+
+**原因**: 原始包名 `claude-config-manager` 已被其他开发者占用
+
+**命名历史**:
+1. ❌ `claude-config-manager` - 已被占用
+2. ❌ `claude-profile-switcher` - 已被占用
+3. ✅ `@haiyangj/ccs` - 最终选择（作用域包）
+
+**安装方式**:
+```bash
+# 全局安装（推荐）
+npm install -g @haiyangj/ccs
+
+# 从源码安装
+git clone https://github.com/haiyangj/ccs.git
+cd ccs
+npm install
+npm link
+```
+
+**作用域包的优势**:
+- ✅ 不会与他人的包冲突
+- ✅ 明确的包归属权
+- ✅ 可以发布为私有包（免费）
+- ✅ 更好的组织结构
+

package/bin/ccm.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { initCommand } from '../src/commands/init.js';
+import { listCommand } from '../src/commands/list.js';
+import { showCommand } from '../src/commands/show.js';
+import { addCommand } from '../src/commands/add.js';
+import { useCommand } from '../src/commands/use.js';
+import { setCommand } from '../src/commands/set.js';
+import { deleteCommand } from '../src/commands/delete.js';
+import { renameCommand } from '../src/commands/rename.js';
+import { exportCommand } from '../src/commands/export.js';
+import { importCommand } from '../src/commands/import.js';
+
+const program = new Command();
+
+program
+  .name('ccm')
+  .description('CLI tool for managing Claude Code configuration profiles')
+  .version('1.0.0');
+
+// Init command
+program
+  .command('init')
+  .description('Initialize profile management')
+  .action(initCommand);
+
+// List command
+program
+  .command('list')
+  .alias('ls')
+  .description('List all profiles')
+  .action(listCommand);
+
+// Show command
+program
+  .command('show')
+  .alias('current')
+  .description('Show current active profile')
+  .action(showCommand);
+
+// Add command
+program
+  .command('add [name] [url] [key]')
+  .description('Add a new profile')
+  .option('--no-switch', 'Do not prompt to switch to new profile')
+  .action(addCommand);
+
+// Use command
+program
+  .command('use <name>')
+  .description('Switch to a profile')
+  .action(useCommand);
+
+// Set command
+program
+  .command('set [name] [url] [key]')
+  .description('Update an existing profile')
+  .action(setCommand);
+
+// Delete command
+program
+  .command('delete <name>')
+  .alias('rm')
+  .description('Delete a profile')
+  .option('-f, --force', 'Skip confirmation prompt')
+  .action(deleteCommand);
+
+// Rename command
+program
+  .command('rename <old-name> <new-name>')
+  .alias('mv')
+  .description('Rename a profile')
+  .action(renameCommand);
+
+// Export command
+program
+  .command('export [file]')
+  .description('Export profiles to a file (default: ./claude-profiles-backup.json)')
+  .option('--no-keys', 'Export without API keys')
+  .action(exportCommand);
+
+// Import command
+program
+  .command('import <file>')
+  .description('Import profiles from a file')
+  .option('--merge', 'Merge with existing profiles (overwrite conflicts)')
+  .action(importCommand);
+
+// Parse arguments
+program.parse(process.argv);
+
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@haiyangj/ccs",
+  "version": "1.0.1",
+  "description": "CLI tool for managing Claude Code configuration profiles",
+  "main": "src/index.js",
+  "bin": {
+    "ccm": "./bin/ccm.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "claude",
+    "config",
+    "cli",
+    "profile",
+    "manager"
+  ],
+  "author": "",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "inquirer": "^13.2.0",
+    "ora": "^9.0.0"
+  }
+}

package/src/commands/add.js

@@ -0,0 +1,98 @@
+import inquirer from 'inquirer';
+import { addProfile } from '../core/profiles.js';
+import { updateApiConfig } from '../core/config.js';
+import { validateProfile } from '../core/validator.js';
+import { success, error, maskApiKey } from '../utils/logger.js';
+
+/**
+ * Add a new profile
+ */
+export async function addCommand(name, url, key, options = {}) {
+  try {
+    // Interactive mode if arguments not provided
+    if (!name || !url || !key) {
+      const answers = await inquirer.prompt([
+        {
+          type: 'input',
+          name: 'name',
+          message: 'Profile name:',
+          default: name,
+          validate: (input) => {
+            const result = validateProfile(input, 'https://example.com', 'sk-ant-12345678901234567890');
+            if (!result.valid && result.error.includes('name')) {
+              return result.error;
+            }
+            return true;
+          }
+        },
+        {
+          type: 'input',
+          name: 'url',
+          message: 'API URL:',
+          default: url || 'https://api.anthropic.com',
+          validate: (input) => {
+            const result = validateProfile('default', input, 'sk-ant-12345678901234567890');
+            if (!result.valid && result.error.includes('URL')) {
+              return result.error;
+            }
+            return true;
+          }
+        },
+        {
+          type: 'password',
+          name: 'key',
+          message: 'API Key:',
+          mask: '*',
+          default: key,
+          validate: (input) => {
+            const result = validateProfile('default', 'https://api.anthropic.com', input);
+            if (!result.valid && result.error.includes('key')) {
+              return result.error;
+            }
+            return true;
+          }
+        }
+      ]);
+
+      name = answers.name;
+      url = answers.url;
+      key = answers.key;
+    }
+
+    // Validate inputs
+    const validation = validateProfile(name, url, key);
+    if (!validation.valid) {
+      error(validation.error);
+      process.exit(1);
+    }
+
+    // Add profile
+    const profile = addProfile(name, url, key);
+
+    success(`Profile '${name}' added successfully`);
+    console.log(`  API URL: ${url}`);
+    console.log(`  API Key: ${maskApiKey(key)}`);
+    console.log();
+
+    // Ask if user wants to switch to this profile
+    if (!options.noSwitch) {
+      const { shouldSwitch } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'shouldSwitch',
+          message: 'Switch to this profile now?',
+          default: false
+        }
+      ]);
+
+      if (shouldSwitch) {
+        updateApiConfig(url, key);
+        success(`Switched to profile '${name}'`);
+      }
+    }
+
+  } catch (err) {
+    error(`Failed to add profile: ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/delete.js

@@ -0,0 +1,50 @@
+import inquirer from 'inquirer';
+import { deleteProfile, getProfile } from '../core/profiles.js';
+import { success, error, info } from '../utils/logger.js';
+
+/**
+ * Delete a profile
+ */
+export async function deleteCommand(name, options = {}) {
+  try {
+    if (!name) {
+      error('Profile name is required');
+      info('Usage: ccm delete <name>');
+      process.exit(1);
+    }
+
+    // Check if profile exists
+    const profile = getProfile(name);
+    if (!profile) {
+      error(`Profile '${name}' does not exist`);
+      info('Use "ccm list" to see available profiles');
+      process.exit(1);
+    }
+
+    // Confirmation prompt unless --force flag is used
+    if (!options.force) {
+      const { confirmed } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'confirmed',
+          message: `Delete profile '${name}'? This cannot be undone.`,
+          default: false
+        }
+      ]);
+
+      if (!confirmed) {
+        info('Deletion cancelled');
+        return;
+      }
+    }
+
+    // Delete profile (this will throw if it's the current profile)
+    deleteProfile(name);
+
+    success(`Profile '${name}' deleted`);
+
+  } catch (err) {
+    error(`Failed to delete profile: ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/export.js

@@ -0,0 +1,46 @@
+import { writeFileSync } from 'fs';
+import { resolve } from 'path';
+import { readProfiles } from '../core/profiles.js';
+import { success, error, info } from '../utils/logger.js';
+
+/**
+ * Export profiles to a file
+ */
+export async function exportCommand(file, options = {}) {
+  try {
+    const profiles = readProfiles();
+
+    if (Object.keys(profiles.profiles).length === 0) {
+      info('No profiles to export');
+      return;
+    }
+
+    // Default file path
+    const outputFile = file || './claude-profiles-backup.json';
+    const outputPath = resolve(outputFile);
+
+    // Clone profiles to avoid modifying original
+    const exportData = JSON.parse(JSON.stringify(profiles));
+
+    // Remove API keys if --no-keys flag is set
+    if (options.noKeys) {
+      for (const name in exportData.profiles) {
+        delete exportData.profiles[name].apiKey;
+      }
+    }
+
+    // Write to file
+    writeFileSync(outputPath, JSON.stringify(exportData, null, 2), 'utf-8');
+
+    const profileCount = Object.keys(profiles.profiles).length;
+    success(`Exported ${profileCount} profile${profileCount > 1 ? 's' : ''} to ${outputPath}`);
+
+    if (options.noKeys) {
+      info('API keys were excluded from export');
+    }
+
+  } catch (err) {
+    error(`Failed to export profiles: ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/import.js

@@ -0,0 +1,99 @@
+import { readFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
+import { readProfiles, writeProfiles } from '../core/profiles.js';
+import { success, error, warning, info } from '../utils/logger.js';
+
+/**
+ * Import profiles from a file
+ */
+export async function importCommand(file, options = {}) {
+  try {
+    if (!file) {
+      error('Import file path is required');
+      info('Usage: ccm import <file>');
+      process.exit(1);
+    }
+
+    const inputPath = resolve(file);
+
+    // Check if file exists
+    if (!existsSync(inputPath)) {
+      error(`File not found: ${inputPath}`);
+      process.exit(1);
+    }
+
+    // Read and parse import file
+    let importData;
+    try {
+      const fileContent = readFileSync(inputPath, 'utf-8');
+      importData = JSON.parse(fileContent);
+    } catch (err) {
+      error(`Failed to parse import file: ${err.message}`);
+      process.exit(1);
+    }
+
+    // Validate import data structure
+    if (!importData.profiles || typeof importData.profiles !== 'object') {
+      error('Invalid import file format: missing profiles object');
+      process.exit(1);
+    }
+
+    // Get current profiles
+    const currentProfiles = readProfiles();
+
+    let imported = 0;
+    let skipped = 0;
+    const conflicts = [];
+
+    // Import profiles
+    for (const [name, profile] of Object.entries(importData.profiles)) {
+      // Check for conflicts
+      if (currentProfiles.profiles[name] && !options.merge) {
+        conflicts.push(name);
+        skipped++;
+        continue;
+      }
+
+      // Validate required fields
+      if (!profile.apiUrl || !profile.apiKey) {
+        warning(`Skipping profile '${name}': missing apiUrl or apiKey`);
+        skipped++;
+        continue;
+      }
+
+      // Add profile
+      currentProfiles.profiles[name] = {
+        name,
+        apiUrl: profile.apiUrl,
+        apiKey: profile.apiKey,
+        createdAt: profile.createdAt || new Date().toISOString(),
+        lastUsed: profile.lastUsed || null
+      };
+
+      imported++;
+    }
+
+    // Write updated profiles
+    writeProfiles(currentProfiles);
+
+    // Report results
+    info(`Importing profiles from ${inputPath}...`);
+    console.log();
+
+    if (imported > 0) {
+      success(`${imported} profile${imported > 1 ? 's' : ''} imported`);
+    }
+
+    if (conflicts.length > 0) {
+      warning(`${conflicts.length} profile${conflicts.length > 1 ? 's' : ''} skipped (name conflict: ${conflicts.join(', ')})`);
+      info('Use --merge flag to overwrite existing profiles');
+    }
+
+    console.log();
+    info('Use "ccm list" to see all profiles');
+
+  } catch (err) {
+    error(`Failed to import profiles: ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/init.js

@@ -0,0 +1,55 @@
+import { readSettings, createSettings, settingsFileExists } from '../core/config.js';
+import { addProfile, hasProfiles, writeProfiles } from '../core/profiles.js';
+import { success, error, warning, info, section } from '../utils/logger.js';
+import { resolveClaudeDir, claudeDirExists } from '../utils/paths.js';
+import { mkdirSync } from 'fs';
+
+/**
+ * Initialize profile management
+ */
+export async function initCommand() {
+  try {
+    section('Initializing Claude Config Manager...');
+
+    // Ensure .claude directory exists
+    const claudeDir = resolveClaudeDir();
+    if (!claudeDirExists()) {
+      mkdirSync(claudeDir, { recursive: true, mode: 0o700 });
+      success(`Created directory: ${claudeDir}`);
+    }
+
+    // Check if profiles already exist
+    if (hasProfiles()) {
+      warning('Profile management is already initialized');
+      info('Use "ccm list" to see existing profiles');
+      return;
+    }
+
+    // Check if settings.json exists
+    const settings = readSettings();
+
+    if (settings && settings.apiUrl && settings.apiKey) {
+      // Import existing settings as default profile
+      addProfile('default', settings.apiUrl, settings.apiKey);
+      success('Found existing settings.json');
+      success('Imported current config as "default" profile');
+    } else {
+      // Create empty profiles structure
+      writeProfiles({
+        version: '1.0.0',
+        currentProfile: null,
+        profiles: {}
+      });
+      success('Initialized empty profile storage');
+      info('Use "ccm add <name> <url> <key>" to create your first profile');
+    }
+
+    console.log();
+    info('Profile management is ready!');
+    info('Run "ccm --help" to see available commands');
+
+  } catch (err) {
+    error(`Initialization failed: ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/list.js

@@ -0,0 +1,55 @@
+import { getAllProfiles, getCurrentProfileName } from '../core/profiles.js';
+import { section, formatProfileName, maskApiKey, dim, info } from '../utils/logger.js';
+
+/**
+ * List all profiles
+ */
+export async function listCommand() {
+  try {
+    const profiles = getAllProfiles();
+    const currentProfile = getCurrentProfileName();
+
+    if (Object.keys(profiles).length === 0) {
+      info('No profiles found. Use "ccm add <name> <url> <key>" to create one.');
+      return;
+    }
+
+    section('Available profiles:');
+
+    // Sort profiles: current first, then by last used, then alphabetically
+    const sortedEntries = Object.entries(profiles).sort(([nameA, profA], [nameB, profB]) => {
+      if (nameA === currentProfile) return -1;
+      if (nameB === currentProfile) return 1;
+
+      if (profA.lastUsed && !profB.lastUsed) return -1;
+      if (!profA.lastUsed && profB.lastUsed) return 1;
+
+      if (profA.lastUsed && profB.lastUsed) {
+        return new Date(profB.lastUsed) - new Date(profA.lastUsed);
+      }
+
+      return nameA.localeCompare(nameB);
+    });
+
+    // Calculate max name length for alignment
+    const maxNameLength = Math.max(...sortedEntries.map(([name]) => name.length));
+    const padding = maxNameLength + 4;
+
+    for (const [name, profile] of sortedEntries) {
+      const isActive = name === currentProfile;
+      const displayName = formatProfileName(name, isActive);
+      const paddedName = displayName + ' '.repeat(padding - name.length);
+      const maskedKey = maskApiKey(profile.apiKey);
+      const activeTag = isActive ? '(active)' : '';
+
+      console.log(`${paddedName} ${profile.apiUrl.padEnd(40)} ${dim(maskedKey)} ${activeTag}`);
+    }
+
+    console.log();
+    info('Use "ccm use <name>" to switch profiles');
+
+  } catch (err) {
+    console.error(`Failed to list profiles: ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/rename.js

@@ -0,0 +1,40 @@
+import { renameProfile, getProfile } from '../core/profiles.js';
+import { validateProfileName } from '../core/validator.js';
+import { success, error, info } from '../utils/logger.js';
+
+/**
+ * Rename a profile
+ */
+export async function renameCommand(oldName, newName) {
+  try {
+    if (!oldName || !newName) {
+      error('Both old and new profile names are required');
+      info('Usage: ccm rename <old-name> <new-name>');
+      process.exit(1);
+    }
+
+    // Check if old profile exists
+    const profile = getProfile(oldName);
+    if (!profile) {
+      error(`Profile '${oldName}' does not exist`);
+      info('Use "ccm list" to see available profiles');
+      process.exit(1);
+    }
+
+    // Validate new name
+    const validation = validateProfileName(newName);
+    if (!validation.valid) {
+      error(validation.error);
+      process.exit(1);
+    }
+
+    // Rename profile
+    renameProfile(oldName, newName);
+
+    success(`Profile renamed: '${oldName}' → '${newName}'`);
+
+  } catch (err) {
+    error(`Failed to rename profile: ${err.message}`);
+    process.exit(1);
+  }
+}