@pikecode/api-key-manager 2.0.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/README.md +444 -151
  2. package/bin/akm.js +340 -11
  3. package/package.json +29 -12
  4. package/src/CommandRegistry.js +58 -3
  5. package/src/commands/BaseCommand.js +68 -1
  6. package/src/commands/add/prompts.js +280 -0
  7. package/src/commands/add/providerSaver.js +74 -0
  8. package/src/commands/add/summaryPrinter.js +29 -0
  9. package/src/commands/add.js +54 -439
  10. package/src/commands/backup.js +396 -0
  11. package/src/commands/batch.js +313 -0
  12. package/src/commands/benchmark.js +323 -0
  13. package/src/commands/claude-clean.js +253 -0
  14. package/src/commands/clone.js +265 -0
  15. package/src/commands/current.js +89 -41
  16. package/src/commands/edit.js +3 -207
  17. package/src/commands/health.js +264 -0
  18. package/src/commands/list.js +120 -35
  19. package/src/commands/mcp.js +467 -0
  20. package/src/commands/remove.js +89 -26
  21. package/src/commands/stats.js +281 -0
  22. package/src/commands/switch/claude-settings-compatibility.js +113 -0
  23. package/src/commands/switch/launch-args-helper.js +84 -0
  24. package/src/commands/switch/provider-choices-helper.js +72 -0
  25. package/src/commands/switch/provider-details-helper.js +46 -0
  26. package/src/commands/switch/provider-edit-questions-helper.js +124 -0
  27. package/src/commands/switch/provider-launcher.js +20 -0
  28. package/src/commands/switch/provider-manager.js +214 -0
  29. package/src/commands/switch/status-helper.js +124 -0
  30. package/src/commands/switch/ui-screen-renderer.js +77 -0
  31. package/src/commands/switch.js +471 -958
  32. package/src/commands/validate.js +310 -0
  33. package/src/config.js +541 -55
  34. package/src/constants/index.js +234 -0
  35. package/src/constants/ui.js +108 -0
  36. package/src/index.js +11 -4
  37. package/src/navigation/EscNavigationManager.js +5 -5
  38. package/src/utils/atomic-file.js +47 -0
  39. package/src/utils/claude-settings.js +4 -4
  40. package/src/utils/codex-files.js +418 -0
  41. package/src/utils/codex-launcher.js +104 -0
  42. package/src/utils/concurrency.js +30 -0
  43. package/src/utils/config-opener.js +22 -2
  44. package/src/utils/env-launcher.js +50 -44
  45. package/src/utils/env-utils.js +52 -0
  46. package/src/utils/error-handler.js +27 -28
  47. package/src/utils/health-checker.js +350 -0
  48. package/src/utils/import-validator.js +210 -0
  49. package/src/utils/inquirer-setup.js +11 -0
  50. package/src/utils/launch-args.js +155 -0
  51. package/src/utils/logger.js +0 -1
  52. package/src/utils/provider-status-checker.js +211 -64
  53. package/src/utils/secrets.js +22 -0
  54. package/src/utils/shell-snippets.js +32 -0
  55. package/src/utils/terminal-format.js +22 -4
  56. package/src/utils/ui-helper.js +96 -86
  57. package/src/utils/update-checker.js +41 -12
  58. package/src/utils/validator.js +115 -88
  59. package/bin/cc.js +0 -101
  60. package/src/utils/storage.js +0 -55
package/README.md CHANGED
@@ -1,232 +1,525 @@
1
- # API 密钥管理工具 (API Key Manager)
1
+ # API Key Manager (akm)
2
2
 
3
- 一键管理和切换多个 API 提供商配置,支持 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN,让你轻松管理多个账号。
3
+ 一个 CLI 工具,用于管理和快速切换 **Claude Code** 和 **Codex CLI** 的 API 配置。
4
4
 
5
- > 🤖 本项目完全由 AI 开发 - 使用 [Claude Code](https://claude.ai/code) 构建
5
+ [![npm version](https://img.shields.io/npm/v/@pikecode/api-key-manager.svg)](https://www.npmjs.com/package/@pikecode/api-key-manager)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
7
 
7
- ## 💡 这个工具是干什么的?
8
+ ## 功能特性
8
9
 
9
- 如果你需要:
10
+ - 🎯 **双 IDE 支持** — 同时管理 Claude Code 和 Codex CLI 配置
11
+ - 🔄 **快速切换** — 一键切换不同的 API 供应商
12
+ - ⚡ **快速启动** — `-q` 跳过参数选择,秒级启动
13
+ - 🧠 **智能记忆** — 自动记住上次使用的启动参数
14
+ - 🗑️ **批量删除** — 支持一次选择多个供应商批量删除
15
+ - 🔌 **MCP 管理** — 管理 Claude Code 的 MCP 服务器配置
16
+ - 🧹 **配置清理** — 清理 Claude Code 配置文件中的冗余数据
17
+ - 📋 **克隆配置** — 快速克隆现有供应商配置
18
+ - ✅ **配置验证** — 验证 Token 有效性和 API 可用性
19
+ - 🔐 **权限保护** — 本地文件存储,Unix 自动设置 0600 权限
20
+ - 💾 **备份恢复** — 配置导出、导入、备份功能
21
+ - 🌍 **跨平台** — macOS / Linux / Windows
10
22
 
11
- - ✅ 管理多个 API 密钥配置
12
- - ✅ 支持 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN
13
- - ✅ 快速切换不同的 API 提供商
14
- - ✅ 配置第三方代理服务
15
- - ✅ 快速保存和切换多套配置
23
+ ## 安装
16
24
 
17
- 那这个工具就是为你准备的!只需要一条命令 `akm`,就能快速切换环境。
25
+ ```bash
26
+ npm install -g @pikecode/api-key-manager
27
+ ```
18
28
 
19
- ## 🚀 快速开始
29
+ ## 快速开始
20
30
 
21
- ### 第一步:安装工具
31
+ ```bash
32
+ # 添加供应商配置
33
+ akm add
22
34
 
23
- 打开终端(命令行),运行:
35
+ # 交互式切换供应商并启动
36
+ akm
24
37
 
25
- ```bash
26
- npm install -g @pikecode/api-key-manager
38
+ # 快速启动(使用上次参数)
39
+ akm my-provider -q
40
+
41
+ # 查看所有配置
42
+ akm list
43
+
44
+ # 查看当前配置
45
+ akm current
27
46
  ```
28
47
 
29
- ### 第二步:添加你的第一个 API 配置
48
+ ## 命令参考
49
+
50
+ ### 核心命令
51
+
52
+ | 命令 | 说明 |
53
+ | ----------------------- | ------------------------------ |
54
+ | `akm` / `akm switch` | 交互式选择和切换供应商 |
55
+ | `akm add` | 添加新的供应商配置 |
56
+ | `akm remove [provider]` | 删除供应商配置(支持批量删除) |
57
+ | `akm list` | 列出所有供应商 |
58
+ | `akm current` | 显示当前激活的配置 |
59
+ | `akm edit [provider]` | 编辑供应商配置 |
60
+
61
+ ### 运维命令
62
+
63
+ | 命令 | 说明 |
64
+ | ------------------------- | -------------------- |
65
+ | `akm export [file]` | 导出配置到文件 |
66
+ | `akm import <file>` | 从文件导入配置 |
67
+ | `akm backup` | 备份和恢复配置 |
68
+ | `akm validate [provider]` | 验证供应商配置有效性 |
69
+ | `akm clone [source]` | 克隆现有供应商配置 |
70
+
71
+ ### 工具命令
72
+
73
+ | 命令 | 说明 |
74
+ | ------------------------- | ------------------------------------- |
75
+ | `akm stats [provider]` | 显示供应商使用统计 |
76
+ | `akm health [provider]` | 检查配置健康状态 |
77
+ | `akm batch <operation>` | 批量操作供应商 |
78
+ | `akm benchmark` | 供应商性能测试和对比 |
79
+ | `akm claude <subcommand>` | Claude Code 配置管理 (clean/analyze) |
80
+ | `akm mcp <subcommand>` | MCP 服务器管理 (list/add/edit/remove) |
81
+
82
+ ---
83
+
84
+ ## 详细使用指南
85
+
86
+ ### 添加供应商
30
87
 
31
88
  ```bash
89
+ # 交互式添加(会询问 IDE 类型)
32
90
  akm add
91
+
92
+ # 直接添加 Claude Code 供应商
93
+ akm add --claude
94
+
95
+ # 直接添加 Codex CLI 供应商
96
+ akm add --codex
33
97
  ```
34
98
 
35
- 根据提示输入:
36
- 1. **名称**:给这个配置起个名字,比如 "官方账号"、"代理服务" 等
37
- 2. **认证方式**:选择认证模式
38
- - 🔑 通用API密钥模式 - 支持 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN
39
- - 🔐 认证令牌模式 - 仅 ANTHROPIC_AUTH_TOKEN
40
- - 🌐 OAuth令牌模式 - 用于官方 Claude Code
41
- 3. **Token 类型**(仅通用API密钥模式):选择 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN
42
- 4. **Token**:粘贴你的 API Token
43
- 5. **基础 URL**(可选):如果使用第三方服务需要填写
99
+ 添加流程分两步:
100
+
101
+ **步骤 1 — 填写供应商信息:**
102
+
103
+ - 选择 IDE 类型(Claude Code / Codex CLI)
104
+ - 输入供应商名称
105
+ - 选择认证模式(Claude Code 有两种)
106
+ - 输入 API 基础 URL 和 Token
44
107
 
45
- ### 第三步:开始使用
108
+ **步骤 2 — 可选配置:**
109
+
110
+ - 启动参数
111
+ - 模型配置
112
+
113
+ ### 认证模式
114
+
115
+ Claude Code 支持两种认证模式:
116
+
117
+ | 模式 | 环境变量 | 适用场景 |
118
+ | ---------- | --------------------------------------------- | ---------------- |
119
+ | API Key | `ANTHROPIC_API_KEY` + `ANTHROPIC_BASE_URL` | 大多数第三方代理 |
120
+ | Auth Token | `ANTHROPIC_AUTH_TOKEN` + `ANTHROPIC_BASE_URL` | 部分服务商 |
121
+
122
+ Codex CLI 使用 `OPENAI_API_KEY` + `OPENAI_BASE_URL`。
123
+
124
+ ### 切换供应商
46
125
 
47
126
  ```bash
127
+ # 交互式选择
48
128
  akm
129
+
130
+ # 直接切换到指定供应商
131
+ akm my-provider
132
+
133
+ # 仅显示 Claude Code 供应商
134
+ akm switch --claude
135
+
136
+ # 仅显示 Codex CLI 供应商
137
+ akm switch --codex
138
+ ```
139
+
140
+ ### 快速启动
141
+
142
+ ```bash
143
+ # 使用上次的启动参数
144
+ akm my-provider -q
145
+
146
+ # 以空参数启动
147
+ akm my-provider --no-args
49
148
  ```
50
149
 
51
- 用方向键选择要使用的 API 配置,按回车确认,工具会自动启动 Claude Code!
150
+ 参数优先级:`--no-args` > `--quick`
52
151
 
53
- ## 📖 常用命令
152
+ ### 查看配置
54
153
 
55
154
  ```bash
56
- akm # 打开选择界面,切换 API 配置
57
- akm add # 添加新的 API 配置
58
- akm list # 查看所有已保存的配置
59
- akm current # 查看当前正在使用的配置
60
- akm edit # 修改某个配置
61
- akm remove # 删除不需要的配置
155
+ # 列出所有供应商(默认不检测状态,秒出)
156
+ akm list
157
+
158
+ # 列出并检测在线状态
159
+ akm list --status
160
+
161
+ # 按 IDE 类型过滤
162
+ akm list --claude
163
+ akm list --codex
164
+ akm list --json
165
+
166
+ # 查看当前激活的配置(list/current 默认完整显示 Token)
167
+ akm current
168
+ akm current --shell zsh
169
+ akm current --json
62
170
  ```
63
171
 
64
- ## ✨ 主要功能
172
+ `--show-token` 作为兼容参数继续接受;本地 `list`、`current`、创建摘要和供应商详情均直接显示完整 Token。
173
+ 分享配置时仍建议使用默认的无密钥导出。
174
+
175
+ ### 克隆供应商
176
+
177
+ 快速基于现有配置创建新供应商:
65
178
 
66
- ### 🔄 智能环境切换
67
- - 一键切换多个 Claude Code 供应商配置
68
- - 支持官方和第三方 API 服务商
69
- - 自动管理环境变量,无需手动配置
179
+ ```bash
180
+ # 交互式选择源供应商
181
+ akm clone
70
182
 
71
- ### 🛡️ 冲突检测与处理
72
- - **自动检测** Claude 设置文件中的环境变量冲突
73
- - **智能备份** 在修改前自动创建配置备份
74
- - **安全清理** 清空冲突变量,确保切换成功
183
+ # 直接指定源供应商
184
+ akm clone my-provider
185
+ ```
75
186
 
76
- ### 🚀 启动参数配置
77
- - 支持 `--continue` 参数继续上次对话
78
- - 支持 `--dangerously-skip-permissions` 沙盒模式
79
- - 灵活选择启动参数组合
187
+ 克隆时可以修改名称、认证模式、Token、基础 URL 等。
80
188
 
81
- ### 📡 实时状态检测
82
- - **流式检测** 供应商可用性实时检查,逐个显示结果
83
- - **状态指示** 使用彩色图标直观显示供应商状态(🟢可用 / 🟡有限可用 / 🔴不可用)
84
- - **延迟显示** 实时显示 API 响应延迟,帮助选择最快的服务
85
- - **智能识别** 自动识别不同供应商的响应格式,兼容性强
86
- - **异步更新** 状态检测不阻塞界面操作,边检测边选择
189
+ ### 删除供应商
87
190
 
88
- ### ⌨️ 优化的键盘操作
89
- - **ESC 键** - 快速返回上一级菜单
90
- - **Ctrl+C** - 随时强制退出程序
91
- - **方向键** - 便捷的菜单导航
92
- - **空格/A/I** - 多选操作(全选/反选)
191
+ ```bash
192
+ # 交互式删除(支持批量选择)
193
+ akm remove
93
194
 
94
- ### 📊 使用统计
95
- - 记录每个供应商的使用次数
96
- - 显示最后使用时间
97
- - 智能推荐常用供应商
195
+ # 直接删除指定供应商
196
+ akm remove my-provider
197
+ ```
98
198
 
99
- ## 🎯 使用场景示例
199
+ **批量删除流程:**
100
200
 
101
- ### 场景1:工作和个人账号切换
201
+ 1. 使用空格键选择多个要删除的供应商
202
+ 2. 按 Enter 确认选择
203
+ 3. 预览将要删除的供应商列表
204
+ 4. 最终确认后批量删除
205
+
206
+ ### 编辑供应商
102
207
 
103
208
  ```bash
104
- # 上班时使用公司账号
105
- akm 公司账号
209
+ # 交互式选择要编辑的供应商
210
+ akm edit
106
211
 
107
- # 下班后切换到个人账号
108
- akm 个人账号
212
+ # 直接编辑指定供应商
213
+ akm edit my-provider
109
214
  ```
110
215
 
111
- ### 场景2:使用第三方服务
216
+ **可编辑内容:**
217
+
218
+ - 供应商名称
219
+ - 认证模式
220
+ - API 基础 URL
221
+ - Token
222
+ - 启动参数
112
223
 
113
- 有些第三方服务提供 Claude API 代理,你可以这样配置:
224
+ ### MCP 服务器管理
225
+
226
+ 管理 `~/.claude.json` 中的 MCP 服务器配置:
114
227
 
115
228
  ```bash
116
- akm add
117
- # 输入名称: 第三方服务
118
- # 选择认证方式: API 密钥模式
119
- # 输入 API 密钥: 粘贴你的密钥
120
- # 输入基础 URL: https://api.third-party.com
229
+ # 列出已配置的 MCP 服务器
230
+ akm mcp list
231
+
232
+ # 添加 MCP 服务器(支持预设模板和手动配置)
233
+ akm mcp add
234
+
235
+ # 编辑 MCP 服务器
236
+ akm mcp edit
237
+
238
+ # 删除 MCP 服务器
239
+ akm mcp remove
121
240
  ```
122
241
 
123
- ### 场景3:临时测试新服务
242
+ 内置预设模板:Playwright、filesystem、memory、fetch。
243
+
244
+ ### Claude Code 配置清理
245
+
246
+ 清理 `~/.claude.json` 中的冗余数据(如过期的项目记录):
124
247
 
125
248
  ```bash
126
- # 添加测试配置
127
- akm add
249
+ # 清理配置
250
+ akm claude clean
251
+
252
+ # 分析配置(仅查看,不修改)
253
+ akm claude analyze
254
+ ```
255
+
256
+ ### 备份与迁移
257
+
258
+ ```bash
259
+ # 创建备份
260
+ akm backup
128
261
 
129
- # 试用一下
130
- akm 测试服务
262
+ # 列出备份
263
+ akm backup --list
131
264
 
132
- # 不好用就删掉
133
- akm remove 测试服务
265
+ # 恢复备份
266
+ akm backup --restore <file>
267
+
268
+ # 导出无密钥配置(默认,可作为模板分享)
269
+ akm export my-config.json
270
+
271
+ # 显式导出包含完整 Token 的配置(敏感文件)
272
+ akm export private-backup.json --include-secrets
273
+
274
+ # 预览导出,不写入文件
275
+ akm export my-config.json --dry-run
276
+
277
+ # 导入配置
278
+ akm import my-config.json
279
+ akm import my-config.json --overwrite
280
+ akm import my-config.json --dry-run
134
281
  ```
135
282
 
136
- ## ⚙️ 认证方式说明
283
+ 导出文件在 Unix 系统上会设置为 `0600`。默认导出会把 `authToken` 设为 `null`,并写入
284
+ `secretsIncluded: false`,导入后需要重新设置密钥;只有明确使用 `--include-secrets` 时才会
285
+ 写出原始密钥。
286
+ `health` 默认只做本地配置健康检查;使用 `--connectivity` 才会真实调用 API,可能产生费用。
287
+ `--json` 和 `--dry-run` 适合脚本或自动化流程。
137
288
 
138
- 添加供应商时,会让你选择认证方式,这里简单说明:
289
+ 如果配置文件在当前操作期间被另一个 `akm` 进程修改,保存会停止并提示重新执行,避免覆盖较新的配置。
139
290
 
140
- **1. OAuth 令牌模式** (最常用)
141
- - 适用于官方 Claude Code
142
- - Token 格式: `sk-ant-oat01-...`
143
- - 只需要填 Token,不需要填 URL
291
+ ### 配置验证
144
292
 
145
- **2. API 密钥模式**
146
- - 适用于第三方服务商
147
- - 需要填写 API 密钥和服务商提供的 URL
293
+ ```bash
294
+ # 验证单个供应商
295
+ akm validate my-provider
296
+
297
+ # 验证所有供应商
298
+ akm validate
148
299
 
149
- **3. 认证令牌模式**
150
- - 适用于某些第三方服务商
151
- - 需要填写认证令牌和服务商提供的 URL
300
+ # 按 IDE 类型过滤
301
+ akm validate --claude
302
+ akm validate --codex
303
+ ```
152
304
 
153
- > 💡 不确定选哪个?看你的 Token 是什么格式,或者咨询你的服务商。
305
+ 验证内容:Token 有效性、API 响应时间、配置完整性。
154
306
 
155
- ## ❓ 常见问题
307
+ ---
156
308
 
157
- **Q: 我的 Token 存在哪里,安全吗?**
158
- A: 配置保存在你的电脑上 `~/.akm-config.json`,只有你能访问。Token 会被加密存储。
309
+ ## 配置示例
159
310
 
160
- **Q: 什么是"环境变量冲突检测"?**
161
- A: 如果你在 Claude Code 的设置文件(`.claude/settings.json` 或 `.claude/settings.local.json`)中配置了环境变量,这些变量可能会覆盖本工具设置的供应商配置。工具会自动检测这种冲突,并提示你备份和清理冲突的变量。
311
+ ### Claude Code — API Key 模式
162
312
 
163
- **Q: 备份文件保存在哪里?**
164
- A: 备份文件保存在原设置文件的同目录下,命名格式为 `settings.backup-YYYYMMDD_HHmmss.json`,方便你随时恢复。
313
+ ```yaml
314
+ 供应商名称: my-claude
315
+ 认证模式: api_key
316
+ Token (ANTHROPIC_API_KEY): sk-ant-api03-xxxxxxxx
317
+ 基础URL (ANTHROPIC_BASE_URL): https://api.anthropic.com
318
+ ```
165
319
 
166
- **Q: 状态检测是如何工作的?**
167
- A: 工具会向每个供应商的 API 发送一个简单的测试请求,根据响应时间和结果显示状态。🟢表示可用,🟡表示有限可用(响应慢或部分功能受限),🔴表示不可用,⏳表示正在检测中。状态检测采用流式模式,逐个显示结果,不会阻塞界面操作。
320
+ ### Claude Code — Auth Token 模式
168
321
 
169
- **Q: 为什么某些供应商显示"暂不支持 OAuth 令牌检测"?**
170
- A: OAuth 令牌模式的供应商(官方 Claude Code)暂不支持状态检测,因为 OAuth 认证流程比较复杂。工具只对使用 API 密钥或认证令牌的第三方供应商进行状态检测。
322
+ ```yaml
323
+ 供应商名称: third-party
324
+ 认证模式: auth_token
325
+ Token (ANTHROPIC_AUTH_TOKEN): your-auth-token
326
+ 基础URL (ANTHROPIC_BASE_URL): https://your-provider.com/v1
327
+ ```
171
328
 
172
- **Q: 如何重新来过?**
173
- A: 删除配置文件 `~/.akm-config.json` 就会清空所有配置。
329
+ ### Codex CLI
174
330
 
175
- **Q: 可以导出配置到其他电脑吗?**
176
- A: 可以!复制 `~/.akm-config.json` 文件到新电脑的相同位置即可。
331
+ ```yaml
332
+ 供应商名称: my-codex
333
+ API Key (OPENAI_API_KEY): sk-xxxxxxxx
334
+ 基础URL (OPENAI_BASE_URL): https://api.openai.com
335
+ ```
177
336
 
178
- **Q: 按 ESC 键没反应?**
179
- A: 确保你的终端支持 ESC 键捕获。如果不行,使用 `Ctrl+C` 也可以退出程序。
337
+ ### 多账号配置
180
338
 
181
- **Q: 需要什么系统?**
182
- A: Windows、macOS、Linux 都支持。需要安装 Node.js 14 或更高版本。
339
+ ```bash
340
+ # 工作账号
341
+ akm add --claude # 名称: work
183
342
 
184
- **Q: 启动参数有什么用?**
185
- A: `--continue` 可以继续上次的对话,`--dangerously-skip-permissions` 适合在沙盒环境中使用(跳过权限检查)。你可以在启动时灵活选择需要的参数。
343
+ # 个人账号
344
+ akm add --claude # 名称: personal
186
345
 
187
- ## 📝 更新日志
346
+ # 快速切换
347
+ akm work -q
348
+ akm personal -q
349
+ ```
188
350
 
189
- ### v2.0.0 (最新)
190
- - 🎉 **重大更新** - 项目重命名为 API Key Manager,全面升级
191
- - 🔄 **命令变更** - `cc` 命令升级为 `akm`
192
- - 🔑 **功能扩展** - API 密钥模式现支持 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 两种 Token 类型选择
193
- - 📋 **配置优化** - 配置文件从 `~/.cc-config.json` 升级为 `~/.akm-config.json`
194
- - 🎯 **用户体验** - 优化交互设计,支持更灵活的 Token 类型选择
351
+ ---
195
352
 
196
- ### v1.0.13
197
- - ✨ 实现供应商状态流式检测和实时更新
198
- - 📡 将批量检测改为流式模式,逐个显示状态结果
199
- - 🎨 优化状态图标显示,支持实时延迟展示
200
- - 🚀 增强UI交互,支持动态更新选择界面
201
- - 🔧 改进异步调度逻辑,提升响应速度
353
+ ## 交互式界面
202
354
 
203
- ### v1.0.12
204
- - ✨ 新增供应商状态检测功能
205
- - 📡 添加 ProviderStatusChecker 类用于检测供应商可用性
206
- - 🎨 在供应商列表和选择界面显示实时状态信息
207
- - 🟢 支持状态图标显示(可用/有限可用/不可用)和延迟时间展示
208
- - 🚀 异步更新状态不阻塞界面操作
355
+ ### 主界面
209
356
 
210
- ### v1.0.9
211
- - ✨ 新增 Claude 设置文件冲突检测功能
212
- - 🛡️ 自动备份和清理冲突的环境变量
213
- - ⌨️ 增强 ESC 键处理系统,支持各层级快速返回
214
- - 🎨 改进输入提示行为和屏幕清空功能
215
- - 🔧 重构 Windows 支持模块,提升跨平台兼容性
357
+ ```
358
+ ? 请选择要切换的供应商 (总计 3 个):
359
+ 🟢 [Claude] my-claude (My Claude Account) --- 上次使用 - 可用
360
+ 🟢 [Claude] work (Work Account) - 可用
361
+ ❯ 🟢 [Codex] my-codex (Codex Account) - 可用
362
+ ──────────────
363
+ ➕ 添加新供应商
364
+ 📋 供应商管理 (编辑/删除)
365
+ 📁 打开配置文件
366
+ ❌ 退出
367
+ ```
216
368
 
217
- ### v1.0.8
218
- - 🎯 优化用户界面和交互体验
219
- - 📊 改进供应商使用统计功能
369
+ ### 状态图标
220
370
 
221
- ## 🆘 遇到问题?
371
+ | 图标 | 含义 |
372
+ | ---- | --------------- |
373
+ | 🟢 | API 可用 |
374
+ | 🟡 | 有限可用/响应慢 |
375
+ | 🔴 | API 不可用 |
376
+ | ⏳ | 正在检测 |
377
+ | ⚪ | 未知状态 |
222
378
 
223
- 1. 查看 [常见问题](https://github.com/pikecode/api-key-manager/issues)
224
- 2. 提交 [新问题](https://github.com/pikecode/api-key-manager/issues/new)
379
+ ### 快捷键
380
+
381
+ | 按键 | 功能 |
382
+ | ------ | ---------------- |
383
+ | ↑/↓ | 上下导航 |
384
+ | Space | 切换选中(多选) |
385
+ | A | 全选 |
386
+ | I | 反选 |
387
+ | Enter | 确认 |
388
+ | ESC | 返回上级 / 取消 |
389
+ | Ctrl+C | 退出程序 |
225
390
 
226
391
  ---
227
392
 
228
- ## 🤖 关于本项目
393
+ ## 架构设计
394
+
395
+ ```
396
+ ┌──────────────────────────────────────────────────────┐
397
+ │ akm (CLI 入口) │
398
+ ├──────────────────────────────────────────────────────┤
399
+ │ CommandRegistry 命令注册中心,懒加载命令模块 │
400
+ │ ├── 核心: add, switch, remove, list, current, edit │
401
+ │ ├── 运维: export, import, backup, validate, clone │
402
+ │ └── 工具: stats, health, batch, benchmark, │
403
+ │ claude-clean, mcp │
404
+ ├──────────────────────────────────────────────────────┤
405
+ │ ConfigManager 配置管理 (~/.akm-config.json) │
406
+ │ ├── 懒加载 & 缓存 │
407
+ │ ├── 版本迁移 │
408
+ │ └── 文件权限管理 (0600) │
409
+ ├──────────────────────────────────────────────────────┤
410
+ │ IDE 启动器 │
411
+ │ ├── env-launcher.js Claude Code(环境变量注入) │
412
+ │ └── codex-launcher.js Codex CLI(配置文件+环境变量) │
413
+ └──────────────────────────────────────────────────────┘
414
+ ```
415
+
416
+ **切换原理:**
417
+
418
+ - **Claude Code** — 通过环境变量注入启动子进程,不修改配置文件,切换只在当前会话生效
419
+ - **Codex CLI** — 写入 `~/.codex/auth.json` 和 `config.toml`,切换后直接运行 `codex` 也能使用新配置
420
+
421
+ **环境变量映射:**
422
+
423
+ ```
424
+ Claude Code:
425
+ api_key → ANTHROPIC_API_KEY + ANTHROPIC_BASE_URL
426
+ auth_token → ANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL
427
+ (可选) → ANTHROPIC_MODEL, ANTHROPIC_SMALL_FAST_MODEL
428
+
429
+ Codex CLI:
430
+ → OPENAI_API_KEY + OPENAI_BASE_URL
431
+ ```
432
+
433
+ ---
434
+
435
+ ## 配置文件
436
+
437
+ 位置:`~/.akm-config.json`
438
+
439
+ ```json
440
+ {
441
+ "version": "2.0.0",
442
+ "currentProvider": "my-claude",
443
+ "providers": {
444
+ "my-claude": {
445
+ "name": "my-claude",
446
+ "displayName": "My Claude",
447
+ "ideName": "claude",
448
+ "authMode": "api_key",
449
+ "authToken": "sk-ant-api03-xxx",
450
+ "baseUrl": "https://api.anthropic.com",
451
+ "launchArgs": ["--continue"],
452
+ "models": {
453
+ "primary": "claude-sonnet-4",
454
+ "smallFast": "claude-haiku-4"
455
+ },
456
+ "createdAt": "2025-12-15T05:00:00.000Z",
457
+ "lastUsed": "2025-12-15T05:30:00.000Z"
458
+ }
459
+ }
460
+ }
461
+ ```
462
+
463
+ ---
464
+
465
+ ## 常见问题
466
+
467
+ ### 切换 Codex 后提示 "Token data is not available"
468
+
469
+ `~/.codex/auth.json` 格式不正确。重新切换即可:
470
+
471
+ ```bash
472
+ akm my-codex
473
+ ```
474
+
475
+ akm 会把活跃认证切换为 `auth_mode = "apikey"`,并写入新的 `OPENAI_API_KEY`。
476
+ 原 ChatGPT 登录态不会混入活跃认证文件,修改前内容会保存在 `~/.codex/akm-backups/`。
477
+ `auth.json` 与 `config.toml` 作为一组更新;任一文件写入失败时会自动恢复两者的原始内容。
478
+
479
+ ### Claude Code 切换后环境变量不生效
480
+
481
+ `~/.claude/settings.json` 中可能存在冲突的环境变量。切换时 akm 会自动检测并提示处理。
482
+
483
+ ### 找不到 claude/codex 命令
484
+
485
+ 需要先安装对应的 CLI 工具:
486
+
487
+ ```bash
488
+ # Claude Code
489
+ npm install -g @anthropic-ai/claude-code
490
+
491
+ # Codex CLI
492
+ npm install -g @openai/codex
493
+ ```
494
+
495
+ ### 配置文件权限问题
496
+
497
+ akm 会自动设置权限为 `0600`。手动修复:
498
+
499
+ ```bash
500
+ chmod 600 ~/.akm-config.json
501
+ ```
502
+
503
+ ---
504
+
505
+ ## 系统要求
506
+
507
+ - Node.js >= 20.0.0
508
+ - macOS / Linux / Windows
509
+
510
+ ### 2.0 升级提示
511
+
512
+ - Node.js 最低版本由 14 提升到 20。
513
+ - 默认导出改为无密钥模板;完整备份必须显式使用 `--include-secrets`。
514
+ - 远程 API 地址必须使用 HTTPS,HTTP 仅允许 localhost 和回环地址。
515
+ - 导入配置不能携带跳过审批或沙盒的最高权限启动参数。
516
+
517
+ ## 许可证
518
+
519
+ MIT License
229
520
 
230
- 本项目完全由 AI 使用 [Claude Code](https://claude.ai/code) 开发完成。
521
+ ## 链接
231
522
 
232
- **API Key Manager** - 让 API 密钥管理变得简单 🚀
523
+ - [NPM](https://www.npmjs.com/package/@pikecode/api-key-manager)
524
+ - [GitHub](https://github.com/pikecode/api-key-manager)
525
+ - [Issues](https://github.com/pikecode/api-key-manager/issues)