@pikecode/api-key-manager 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 API Key Manager Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,232 @@
+# API 密钥管理工具 (API Key Manager)
+
+一键管理和切换多个 API 提供商配置，支持 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN，让你轻松管理多个账号。
+
+> 🤖 本项目完全由 AI 开发 - 使用 [Claude Code](https://claude.ai/code) 构建
+
+## 💡 这个工具是干什么的？
+
+如果你需要：
+
+- ✅ 管理多个 API 密钥配置
+- ✅ 支持 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN
+- ✅ 快速切换不同的 API 提供商
+- ✅ 配置第三方代理服务
+- ✅ 快速保存和切换多套配置
+
+那这个工具就是为你准备的！只需要一条命令 `akm`，就能快速切换环境。
+
+## 🚀 快速开始
+
+### 第一步：安装工具
+
+打开终端(命令行),运行：
+
+```bash
+npm install -g @pikecode/api-key-manager
+```
+
+### 第二步：添加你的第一个 API 配置
+
+```bash
+akm add
+```
+
+根据提示输入：
+1. **名称**：给这个配置起个名字,比如 "官方账号"、"代理服务" 等
+2. **认证方式**：选择认证模式
+   - 🔑 通用API密钥模式 - 支持 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN
+   - 🔐 认证令牌模式 - 仅 ANTHROPIC_AUTH_TOKEN
+   - 🌐 OAuth令牌模式 - 用于官方 Claude Code
+3. **Token 类型**（仅通用API密钥模式）：选择 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN
+4. **Token**：粘贴你的 API Token
+5. **基础 URL**（可选）：如果使用第三方服务需要填写
+
+### 第三步：开始使用
+
+```bash
+akm
+```
+
+用方向键选择要使用的 API 配置,按回车确认,工具会自动启动 Claude Code！
+
+## 📖 常用命令
+
+```bash
+akm              # 打开选择界面,切换 API 配置
+akm add          # 添加新的 API 配置
+akm list         # 查看所有已保存的配置
+akm current      # 查看当前正在使用的配置
+akm edit         # 修改某个配置
+akm remove       # 删除不需要的配置
+```
+
+## ✨ 主要功能
+
+### 🔄 智能环境切换
+- 一键切换多个 Claude Code 供应商配置
+- 支持官方和第三方 API 服务商
+- 自动管理环境变量,无需手动配置
+
+### 🛡️ 冲突检测与处理
+- **自动检测** Claude 设置文件中的环境变量冲突
+- **智能备份** 在修改前自动创建配置备份
+- **安全清理** 清空冲突变量,确保切换成功
+
+### 🚀 启动参数配置
+- 支持 `--continue` 参数继续上次对话
+- 支持 `--dangerously-skip-permissions` 沙盒模式
+- 灵活选择启动参数组合
+
+### 📡 实时状态检测
+- **流式检测** 供应商可用性实时检查,逐个显示结果
+- **状态指示** 使用彩色图标直观显示供应商状态(🟢可用 / 🟡有限可用 / 🔴不可用)
+- **延迟显示** 实时显示 API 响应延迟,帮助选择最快的服务
+- **智能识别** 自动识别不同供应商的响应格式,兼容性强
+- **异步更新** 状态检测不阻塞界面操作,边检测边选择
+
+### ⌨️ 优化的键盘操作
+- **ESC 键** - 快速返回上一级菜单
+- **Ctrl+C** - 随时强制退出程序
+- **方向键** - 便捷的菜单导航
+- **空格/A/I** - 多选操作(全选/反选)
+
+### 📊 使用统计
+- 记录每个供应商的使用次数
+- 显示最后使用时间
+- 智能推荐常用供应商
+
+## 🎯 使用场景示例
+
+### 场景1：工作和个人账号切换
+
+```bash
+# 上班时使用公司账号
+akm 公司账号
+
+# 下班后切换到个人账号
+akm 个人账号
+```
+
+### 场景2：使用第三方服务
+
+有些第三方服务提供 Claude API 代理,你可以这样配置：
+
+```bash
+akm add
+# 输入名称: 第三方服务
+# 选择认证方式: API 密钥模式
+# 输入 API 密钥: 粘贴你的密钥
+# 输入基础 URL: https://api.third-party.com
+```
+
+### 场景3：临时测试新服务
+
+```bash
+# 添加测试配置
+akm add
+
+# 试用一下
+akm 测试服务
+
+# 不好用就删掉
+akm remove 测试服务
+```
+
+## ⚙️ 认证方式说明
+
+添加供应商时,会让你选择认证方式,这里简单说明：
+
+**1. OAuth 令牌模式** (最常用)
+- 适用于官方 Claude Code
+- Token 格式: `sk-ant-oat01-...`
+- 只需要填 Token,不需要填 URL
+
+**2. API 密钥模式**
+- 适用于第三方服务商
+- 需要填写 API 密钥和服务商提供的 URL
+
+**3. 认证令牌模式**
+- 适用于某些第三方服务商
+- 需要填写认证令牌和服务商提供的 URL
+
+> 💡 不确定选哪个？看你的 Token 是什么格式,或者咨询你的服务商。
+
+## ❓ 常见问题
+
+**Q: 我的 Token 存在哪里,安全吗？**
+A: 配置保存在你的电脑上 `~/.akm-config.json`,只有你能访问。Token 会被加密存储。
+
+**Q: 什么是"环境变量冲突检测"？**
+A: 如果你在 Claude Code 的设置文件（`.claude/settings.json` 或 `.claude/settings.local.json`）中配置了环境变量，这些变量可能会覆盖本工具设置的供应商配置。工具会自动检测这种冲突，并提示你备份和清理冲突的变量。
+
+**Q: 备份文件保存在哪里？**
+A: 备份文件保存在原设置文件的同目录下，命名格式为 `settings.backup-YYYYMMDD_HHmmss.json`，方便你随时恢复。
+
+**Q: 状态检测是如何工作的？**
+A: 工具会向每个供应商的 API 发送一个简单的测试请求,根据响应时间和结果显示状态。🟢表示可用,🟡表示有限可用(响应慢或部分功能受限),🔴表示不可用,⏳表示正在检测中。状态检测采用流式模式,逐个显示结果,不会阻塞界面操作。
+
+**Q: 为什么某些供应商显示"暂不支持 OAuth 令牌检测"？**
+A: OAuth 令牌模式的供应商(官方 Claude Code)暂不支持状态检测,因为 OAuth 认证流程比较复杂。工具只对使用 API 密钥或认证令牌的第三方供应商进行状态检测。
+
+**Q: 如何重新来过？**
+A: 删除配置文件 `~/.akm-config.json` 就会清空所有配置。
+
+**Q: 可以导出配置到其他电脑吗？**
+A: 可以！复制 `~/.akm-config.json` 文件到新电脑的相同位置即可。
+
+**Q: 按 ESC 键没反应？**
+A: 确保你的终端支持 ESC 键捕获。如果不行，使用 `Ctrl+C` 也可以退出程序。
+
+**Q: 需要什么系统？**
+A: Windows、macOS、Linux 都支持。需要安装 Node.js 14 或更高版本。
+
+**Q: 启动参数有什么用？**
+A: `--continue` 可以继续上次的对话，`--dangerously-skip-permissions` 适合在沙盒环境中使用（跳过权限检查）。你可以在启动时灵活选择需要的参数。
+
+## 📝 更新日志
+
+### v2.0.0 (最新)
+- 🎉 **重大更新** - 项目重命名为 API Key Manager，全面升级
+- 🔄 **命令变更** - `cc` 命令升级为 `akm`
+- 🔑 **功能扩展** - API 密钥模式现支持 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 两种 Token 类型选择
+- 📋 **配置优化** - 配置文件从 `~/.cc-config.json` 升级为 `~/.akm-config.json`
+- 🎯 **用户体验** - 优化交互设计，支持更灵活的 Token 类型选择
+
+### v1.0.13
+- ✨ 实现供应商状态流式检测和实时更新
+- 📡 将批量检测改为流式模式,逐个显示状态结果
+- 🎨 优化状态图标显示,支持实时延迟展示
+- 🚀 增强UI交互,支持动态更新选择界面
+- 🔧 改进异步调度逻辑,提升响应速度
+
+### v1.0.12
+- ✨ 新增供应商状态检测功能
+- 📡 添加 ProviderStatusChecker 类用于检测供应商可用性
+- 🎨 在供应商列表和选择界面显示实时状态信息
+- 🟢 支持状态图标显示(可用/有限可用/不可用)和延迟时间展示
+- 🚀 异步更新状态不阻塞界面操作
+
+### v1.0.9
+- ✨ 新增 Claude 设置文件冲突检测功能
+- 🛡️ 自动备份和清理冲突的环境变量
+- ⌨️ 增强 ESC 键处理系统，支持各层级快速返回
+- 🎨 改进输入提示行为和屏幕清空功能
+- 🔧 重构 Windows 支持模块，提升跨平台兼容性
+
+### v1.0.8
+- 🎯 优化用户界面和交互体验
+- 📊 改进供应商使用统计功能
+
+## 🆘 遇到问题？
+
+1. 查看 [常见问题](https://github.com/pikecode/api-key-manager/issues)
+2. 提交 [新问题](https://github.com/pikecode/api-key-manager/issues/new)
+
+---
+
+## 🤖 关于本项目
+
+本项目完全由 AI 使用 [Claude Code](https://claude.ai/code) 开发完成。
+
+**API Key Manager** - 让 API 密钥管理变得简单 🚀

package/bin/akm.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const { main } = require('../src/index');
+const { registry } = require('../src/CommandRegistry');
+const pkg = require('../package.json');
+const { checkForUpdates } = require('../src/utils/update-checker');
+
+// Set up CLI
+program
+  .name('akm')
+  .description('API密钥管理工具 - Manage and switch multiple API provider configurations')
+  .version(pkg.version, '-v, -V, --version', '显示版本号');
+
+// Check for updates before any command runs
+program.hook('preAction', async () => {
+  await checkForUpdates({ packageName: pkg.name, currentVersion: pkg.version });
+});
+
+// Default command - show provider selection
+program
+  .argument('[provider]', '直接切换到指定供应商')
+  .action(async (provider) => {
+    try {
+      await main(provider);
+    } catch (error) {
+      console.error(chalk.red('❌ 执行失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Add command
+program
+  .command('add')
+  .description('添加新的API密钥配置')
+  .action(async () => {
+    try {
+      await registry.executeCommand('add');
+    } catch (error) {
+      console.error(chalk.red('❌ 添加失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Remove command
+program
+  .command('remove')
+  .argument('[provider]', '要删除的供应商名称')
+  .description('删除API密钥配置')
+  .action(async (provider) => {
+    try {
+      await registry.executeCommand('remove', provider);
+    } catch (error) {
+      console.error(chalk.red('❌ 删除失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// List command
+program
+  .command('list')
+  .description('列出所有API密钥配置')
+  .action(async () => {
+    try {
+      await registry.executeCommand('list');
+    } catch (error) {
+      console.error(chalk.red('❌ 列表失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Current command
+program
+  .command('current')
+  .description('显示当前活跃的配置')
+  .action(async () => {
+    try {
+      await registry.executeCommand('current');
+    } catch (error) {
+      console.error(chalk.red('❌ 获取当前配置失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Edit command
+program
+  .command('edit')
+  .argument('[provider]', '要编辑的供应商名称')
+  .description('编辑API密钥配置')
+  .action(async (provider) => {
+    try {
+      await registry.executeCommand('edit', provider);
+    } catch (error) {
+      console.error(chalk.red('❌ 编辑失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Parse arguments
+program.parse();

package/bin/cc.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const { main } = require('../src/index');
+const { registry } = require('../src/CommandRegistry');
+const pkg = require('../package.json');
+const { checkForUpdates } = require('../src/utils/update-checker');
+
+// Set up CLI
+program
+  .name('akm')
+  .description('API密钥管理工具 - Manage and switch multiple API provider configurations')
+  .version(pkg.version, '-v, -V, --version', '显示版本号');
+
+// Check for updates before any command runs
+program.hook('preAction', async () => {
+  await checkForUpdates({ packageName: pkg.name, currentVersion: pkg.version });
+});
+
+// Default command - show provider selection
+program
+  .argument('[provider]', '直接切换到指定供应商')
+  .action(async (provider) => {
+    try {
+      await main(provider);
+    } catch (error) {
+      console.error(chalk.red('❌ 执行失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Add command
+program
+  .command('add')
+  .description('添加新供应商配置')
+  .action(async () => {
+    try {
+      await registry.executeCommand('add');
+    } catch (error) {
+      console.error(chalk.red('❌ 添加失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Remove command
+program
+  .command('remove')
+  .argument('[provider]', '要删除的供应商名称')
+  .description('删除供应商配置')
+  .action(async (provider) => {
+    try {
+      await registry.executeCommand('remove', provider);
+    } catch (error) {
+      console.error(chalk.red('❌ 删除失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// List command
+program
+  .command('list')
+  .description('列出所有供应商')
+  .action(async () => {
+    try {
+      await registry.executeCommand('list');
+    } catch (error) {
+      console.error(chalk.red('❌ 列表失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Current command
+program
+  .command('current')
+  .description('显示当前配置')
+  .action(async () => {
+    try {
+      await registry.executeCommand('current');
+    } catch (error) {
+      console.error(chalk.red('❌ 获取当前配置失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Edit command
+program
+  .command('edit')
+  .argument('[provider]', '要编辑的供应商名称')
+  .description('编辑供应商配置')
+  .action(async (provider) => {
+    try {
+      await registry.executeCommand('edit', provider);
+    } catch (error) {
+      console.error(chalk.red('❌ 编辑失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Parse arguments
+program.parse();

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@pikecode/api-key-manager",
+  "version": "2.0.0",
+  "description": "API密钥管理工具 - A powerful CLI tool for managing and switching multiple API provider configurations (supports ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, and more)",
+  "main": "src/index.js",
+  "bin": {
+    "akm": "bin/akm.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node bin/akm.js",
+    "dev": "nodemon bin/akm.js",
+    "test": "jest",
+    "build": "echo 'No build needed'",
+    "prepare": "echo 'Preparing package'",
+    "prepublishOnly": "npm test",
+    "release": "npm version patch && npm publish --access public"
+  },
+  "keywords": [
+    "api",
+    "api-key",
+    "key-manager",
+    "authentication",
+    "anthropic",
+    "anthropic-api-key",
+    "anthropic-auth-token",
+    "environment",
+    "config",
+    "provider",
+    "switcher",
+    "cli",
+    "command-line",
+    "tool"
+  ],
+  "author": "Developer",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pikecode/api-key-manager.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pikecode/api-key-manager/issues"
+  },
+  "homepage": "https://github.com/pikecode/api-key-manager#readme",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.67.0",
+    "chalk": "^4.1.2",
+    "commander": "^9.4.1",
+    "cross-spawn": "^7.0.3",
+    "fs-extra": "^11.1.1",
+    "inquirer": "^8.2.6",
+    "supports-color": "^9.4.0"
+  },
+  "devDependencies": {
+    "jest": "^29.7.0",
+    "nodemon": "^3.0.1"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "win32",
+    "darwin",
+    "linux"
+  ]
+}

package/src/CommandRegistry.js

@@ -0,0 +1,74 @@
+class CommandRegistry {
+  constructor() {
+    this.commands = new Map();
+    this.lazyCommands = new Map();
+  }
+
+  // 注册懒加载命令
+  registerLazy(name, loader) {
+    this.lazyCommands.set(name, loader);
+  }
+
+  // 获取命令（懒加载）
+  async getCommand(name) {
+    if (this.commands.has(name)) {
+      return this.commands.get(name);
+    }
+
+    if (this.lazyCommands.has(name)) {
+      const loader = this.lazyCommands.get(name);
+      const command = await loader();
+      this.commands.set(name, command);
+      return command;
+    }
+
+    throw new Error(`命令 '${name}' 未注册`);
+  }
+
+  // 执行命令
+  async executeCommand(name, ...args) {
+    const command = await this.getCommand(name);
+    return await command(...args);
+  }
+
+  // 清理所有缓存的命令
+  clear() {
+    this.commands.clear();
+  }
+}
+
+// 单例实例
+const registry = new CommandRegistry();
+
+// 注册所有懒加载命令
+registry.registerLazy('switch', async () => {
+  const { switchCommand } = require('./commands/switch');
+  return switchCommand;
+});
+
+registry.registerLazy('add', async () => {
+  const { addCommand } = require('./commands/add');
+  return addCommand;
+});
+
+registry.registerLazy('remove', async () => {
+  const { removeCommand } = require('./commands/remove');
+  return removeCommand;
+});
+
+registry.registerLazy('list', async () => {
+  const { listCommand } = require('./commands/list');
+  return listCommand;
+});
+
+registry.registerLazy('current', async () => {
+  const { currentCommand } = require('./commands/current');
+  return currentCommand;
+});
+
+registry.registerLazy('edit', async () => {
+  const { editCommand } = require('./commands/edit');
+  return editCommand;
+});
+
+module.exports = { CommandRegistry, registry };