@pikecode/api-key-manager 2.0.0 → 2.0.2

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 +558 -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 +212 -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 +136 -89
  59. package/bin/cc.js +0 -101
  60. package/src/utils/storage.js +0 -55
@@ -0,0 +1,234 @@
1
+ /**
2
+ * 全局常量定义
3
+ * 统一管理项目中重复出现的常量,提高可维护性
4
+ */
5
+
6
+ // ============ 认证模式常量 ============
7
+
8
+ /**
9
+ * 认证模式的显示名称映射
10
+ */
11
+ const AUTH_MODE_DISPLAY = {
12
+ api_key: 'API Key 模式',
13
+ auth_token: 'Auth Token 模式'
14
+ };
15
+
16
+ /**
17
+ * 认证模式详细说明(用于添加供应商时)
18
+ */
19
+ const AUTH_MODE_DISPLAY_DETAILED = {
20
+ api_key: 'API Key 模式 (ANTHROPIC_API_KEY)',
21
+ auth_token: 'Auth Token 模式 (ANTHROPIC_AUTH_TOKEN)'
22
+ };
23
+
24
+ /**
25
+ * 所有支持的认证模式列表
26
+ */
27
+ const AUTH_MODES = ['api_key', 'auth_token'];
28
+
29
+ // ============ ESC 返回提示常量 ============
30
+
31
+ /**
32
+ * ESC 导航提示消息
33
+ */
34
+ const ESC_HINTS = {
35
+ BACK_TO_PROVIDER_SELECTION: '返回供应商选择',
36
+ BACK_TO_MANAGE_LIST: '返回管理列表',
37
+ BACK_TO_QUICK_SETTINGS: '返回快速设置',
38
+ BACK_TO_MAIN_MENU: '返回主菜单',
39
+ EXIT_PROGRAM: '退出程序',
40
+ CANCEL_ADD: '取消添加'
41
+ };
42
+
43
+ /**
44
+ * ESC 日志消息
45
+ */
46
+ const ESC_LOGS = {
47
+ BACK_TO_PROVIDER_SELECTION: '返回供应商选择',
48
+ BACK_TO_MANAGE_LIST: '返回管理列表',
49
+ BACK_TO_QUICK_SETTINGS: '返回快速设置',
50
+ BACK_TO_MAIN_MENU: '返回主菜单',
51
+ EXIT_PROGRAM: '退出程序',
52
+ CANCEL_ADD: '取消添加供应商',
53
+ CANCEL_LAUNCH: '已取消启动'
54
+ };
55
+
56
+ // ============ IDE 类型常量 ============
57
+
58
+ /**
59
+ * IDE 名称常量
60
+ */
61
+ const IDE_NAMES = {
62
+ CLAUDE: 'claude',
63
+ CODEX: 'codex'
64
+ };
65
+
66
+ /**
67
+ * IDE 显示名称
68
+ */
69
+ const IDE_DISPLAY_NAMES = {
70
+ claude: 'Claude Code',
71
+ codex: 'Codex CLI'
72
+ };
73
+
74
+ // ============ 状态检查常量 ============
75
+
76
+ /**
77
+ * 供应商状态
78
+ */
79
+ const PROVIDER_STATUS = {
80
+ ONLINE: 'online',
81
+ DEGRADED: 'degraded',
82
+ OFFLINE: 'offline',
83
+ PENDING: 'pending',
84
+ UNKNOWN: 'unknown'
85
+ };
86
+
87
+ /**
88
+ * 状态图标映射
89
+ */
90
+ const STATUS_ICONS = {
91
+ online: '🟢',
92
+ degraded: '🟡',
93
+ offline: '🔴',
94
+ pending: '⏳',
95
+ unknown: '⚪'
96
+ };
97
+
98
+ /**
99
+ * 状态颜色配置 (chalk 颜色名称)
100
+ */
101
+ const STATUS_COLORS = {
102
+ online: 'green',
103
+ degraded: 'yellow',
104
+ offline: 'red',
105
+ pending: 'gray',
106
+ unknown: 'gray'
107
+ };
108
+
109
+ // ============ 操作类型常量 ============
110
+
111
+ /**
112
+ * 特殊选择值
113
+ */
114
+ const SPECIAL_SELECTION = {
115
+ ADD_PROVIDER: '__ADD__',
116
+ MANAGE_PROVIDER: '__MANAGE__',
117
+ OPEN_CONFIG: '__OPEN_CONFIG__',
118
+ EXIT: '__EXIT__',
119
+ BACK: 'back'
120
+ };
121
+
122
+ // ============ 配置相关常量 ============
123
+
124
+ /**
125
+ * 基础 URL 相关的常量
126
+ */
127
+ const BASE_URL = {
128
+ OFFICIAL_DEFAULT: '✨ 官方默认服务器',
129
+ NOT_SET: '⚠️ 未设置'
130
+ };
131
+
132
+ /**
133
+ * 当前状态显示
134
+ */
135
+ const CURRENT_STATUS = {
136
+ IN_USE: '✅ 使用中',
137
+ NOT_IN_USE: '⚫ 未使用'
138
+ };
139
+
140
+ // ============ 模型相关常量 ============
141
+
142
+ /**
143
+ * 默认模型值
144
+ */
145
+ const DEFAULT_MODELS = {
146
+ NOT_SET: '未设置'
147
+ };
148
+
149
+ /**
150
+ * 模型类型
151
+ */
152
+ const MODEL_TYPES = {
153
+ PRIMARY: 'primary',
154
+ SMALL_FAST: 'smallFast'
155
+ };
156
+
157
+ // ============ 消息常量 ============
158
+
159
+ /**
160
+ * 系统消息
161
+ */
162
+ const MESSAGES = {
163
+ CONFIGURATION_COMPLETE: '🎉 供应商添加完成!正在返回主界面...',
164
+ NO_PROVIDER_CONFIGURED: '暂无配置的供应商',
165
+ NO_CODEX_PROVIDER: '暂无 Codex CLI 供应商配置',
166
+ NO_CLAUDE_PROVIDER: '暂无 Claude Code 供应商配置',
167
+ ADD_FIRST_PROVIDER: '请先运行 "akm add" 添加供应商配置'
168
+ };
169
+
170
+ // ============ API 相关常量 ============
171
+
172
+ /**
173
+ * API 请求配置
174
+ */
175
+ const API_CONFIG = {
176
+ // 请求超时时间(毫秒)
177
+ DEFAULT_TIMEOUT: 5000,
178
+ // 状态缓存时间(毫秒)
179
+ CACHE_TTL: 30000,
180
+ // 默认测试消息
181
+ TEST_MESSAGE: '你好',
182
+ // 默认最大 Token 数
183
+ MAX_TOKENS: 32,
184
+ // 默认模型
185
+ DEFAULT_MODEL: 'claude-haiku-4-5-20251001'
186
+ };
187
+
188
+ /**
189
+ * 环境变量名称
190
+ */
191
+ const ENV_VARS = {
192
+ ANTHROPIC_AUTH_TOKEN: 'ANTHROPIC_AUTH_TOKEN',
193
+ ANTHROPIC_API_KEY: 'ANTHROPIC_API_KEY',
194
+ OPENAI_API_KEY: 'OPENAI_API_KEY',
195
+ OPENAI_BASE_URL: 'OPENAI_BASE_URL'
196
+ };
197
+
198
+ module.exports = {
199
+ // 认证模式
200
+ AUTH_MODE_DISPLAY,
201
+ AUTH_MODE_DISPLAY_DETAILED,
202
+ AUTH_MODES,
203
+
204
+ // ESC 提示
205
+ ESC_HINTS,
206
+ ESC_LOGS,
207
+
208
+ // IDE
209
+ IDE_NAMES,
210
+ IDE_DISPLAY_NAMES,
211
+
212
+ // 状态
213
+ PROVIDER_STATUS,
214
+ STATUS_ICONS,
215
+ STATUS_COLORS,
216
+
217
+ // 操作
218
+ SPECIAL_SELECTION,
219
+
220
+ // 配置
221
+ BASE_URL,
222
+ CURRENT_STATUS,
223
+
224
+ // 模型
225
+ DEFAULT_MODELS,
226
+ MODEL_TYPES,
227
+
228
+ // 消息
229
+ MESSAGES,
230
+
231
+ // API
232
+ API_CONFIG,
233
+ ENV_VARS
234
+ };
@@ -0,0 +1,108 @@
1
+ /**
2
+ * UI 文案常量
3
+ * 集中管理所有用户界面文本,便于维护和本地化
4
+ */
5
+
6
+ const UI_MESSAGES = {
7
+ // 通用操作
8
+ CANCEL: '取消',
9
+ CONFIRM: '确认',
10
+ BACK: '返回',
11
+ SKIP: '跳过',
12
+
13
+ // ESC 键提示
14
+ ESC_CANCEL: '取消操作',
15
+ ESC_BACK_TO_MENU: '返回上级菜单',
16
+ ESC_CANCEL_ADD: '取消添加',
17
+ ESC_CANCEL_CLONE: '取消克隆',
18
+ ESC_CANCEL_EDIT: '取消编辑',
19
+ ESC_SKIP_CONFIG: '跳过配置',
20
+
21
+ // 添加供应商
22
+ ADD_PROVIDER_TITLE: '添加新供应商',
23
+ ADD_PROVIDER_TOOLTIP: '请填写供应商配置信息',
24
+ ADD_PROVIDER_STEP_1: '填写供应商信息',
25
+ ADD_PROVIDER_STEP_2_LAUNCH_ARGS: '可选: 配置启动参数',
26
+ ADD_PROVIDER_STEP_2_MODELS: '可选: 配置模型参数',
27
+ ADD_PROVIDER_SUCCESS: '供应商添加完成',
28
+ ADD_PROVIDER_CANCELLED: '取消添加供应商',
29
+
30
+ // 克隆供应商
31
+ CLONE_PROVIDER_TITLE: '克隆供应商',
32
+ CLONE_PROVIDER_SUCCESS: '供应商克隆成功!',
33
+ CLONE_PROVIDER_CANCELLED: '取消克隆供应商',
34
+
35
+ // 配置启动参数
36
+ CONFIG_LAUNCH_ARGS_TITLE: '配置启动参数',
37
+ CONFIG_LAUNCH_ARGS_TOOLTIP: '选择要使用的启动参数',
38
+ CONFIG_LAUNCH_ARGS_SKIP: '跳过启动参数配置',
39
+
40
+ // 配置 Codex 启动参数
41
+ CONFIG_CODEX_LAUNCH_ARGS_TITLE: '配置 Codex 启动参数',
42
+ CONFIG_CODEX_LAUNCH_ARGS_TOOLTIP: '选择要使用的 Codex 启动参数',
43
+ CONFIG_CODEX_LAUNCH_ARGS_SKIP: '跳过 Codex 启动参数配置',
44
+
45
+ // 配置模型参数
46
+ CONFIG_MODELS_TITLE: '配置模型参数',
47
+ CONFIG_MODELS_TOOLTIP: '配置主模型和快速模型(可选)',
48
+ CONFIG_MODELS_SKIP: '跳过模型参数配置',
49
+
50
+ // 键盘提示
51
+ HINT_ENTER: 'Enter',
52
+ HINT_ENTER_DESC: '确认输入',
53
+ HINT_TAB: 'Tab',
54
+ HINT_TAB_DESC: '切换字段',
55
+ HINT_ESC: 'ESC',
56
+ HINT_ESC_CANCEL: '取消添加',
57
+ HINT_ESC_SKIP: '跳过配置',
58
+ HINT_SPACE: '空格',
59
+ HINT_SPACE_DESC: '切换选中',
60
+ HINT_A: 'A',
61
+ HINT_A_DESC: '全选',
62
+ HINT_I: 'I',
63
+ HINT_I_DESC: '反选',
64
+ HINT_ENTER_CONFIRM: '确认选择',
65
+
66
+ // 提示信息
67
+ SELECT_IDE: '选择要管理的 IDE:',
68
+ IMPORT_FROM_CODEX: '是否从现有 Codex 配置导入?',
69
+ IMPORT_FROM_CODEX_EXISTING: '从 ~/.codex 导入现有配置',
70
+ IMPORT_FROM_CODEX_MANUAL: '手动输入配置',
71
+ INPUT_PROVIDER_NAME: '请输入供应商名称:',
72
+ SELECT_AUTH_MODE: '选择认证模式:',
73
+ INPUT_BASE_URL: '请输入 API 基础URL (ANTHROPIC_BASE_URL):',
74
+ INPUT_OPENAI_BASE_URL: '请输入 OpenAI API 基础URL (如使用官方API可留空):',
75
+ INPUT_TOKEN: '请输入 Token',
76
+ INPUT_OPENAI_API_KEY: '请输入 OpenAI API Key (OPENAI_API_KEY):',
77
+ SET_AS_DEFAULT: '是否设置为当前供应商?',
78
+ CONFIGURE_LAUNCH_ARGS: '是否配置启动参数?',
79
+ CONFIGURE_CODEX_LAUNCH_ARGS: '是否配置 Codex 启动参数?',
80
+ CONFIGURE_MODELS: '是否配置模型参数?',
81
+ SELECT_LAUNCH_ARGS: '请选择启动参数:',
82
+ INPUT_PRIMARY_MODEL: '主模型 (ANTHROPIC_MODEL):',
83
+ INPUT_SMALL_FAST_MODEL: '快速模型 (ANTHROPIC_SMALL_FAST_MODEL):',
84
+
85
+ // IDE 选项
86
+ IDE_CLAUDE_CODE: 'Claude Code (Anthropic)',
87
+ IDE_CODEX: 'Codex CLI (OpenAI)',
88
+
89
+ // 认证模式
90
+ AUTH_MODE_API_KEY: '🔑 ANTHROPIC_API_KEY - 大多数第三方代理使用',
91
+ AUTH_MODE_AUTH_TOKEN: '🔐 ANTHROPIC_AUTH_TOKEN - 部分服务商使用',
92
+
93
+ // 操作结果
94
+ OPERATION_CANCELLED: '操作已取消',
95
+ OPERATION_SUCCESS: '操作成功',
96
+
97
+ // 供应商信息显示
98
+ PROVIDER_NAME: '名称',
99
+ PROVIDER_IDE: 'IDE',
100
+ PROVIDER_BASE_URL: '基础 URL',
101
+ PROVIDER_TOKEN: 'Token',
102
+ PROVIDER_LAUNCH_ARGS: '启动参数',
103
+ PROVIDER_MODEL_CONFIG: '模型配置',
104
+ PROVIDER_PRIMARY_MODEL: '主模型',
105
+ PROVIDER_SMALL_FAST_MODEL: '快速模型'
106
+ };
107
+
108
+ module.exports = { UI_MESSAGES };
package/src/index.js CHANGED
@@ -2,18 +2,25 @@ require('./utils/inquirer-setup');
2
2
  const { switchCommand } = require('./commands/switch');
3
3
  const { Logger } = require('./utils/logger');
4
4
 
5
- async function main(providerName) {
5
+ /**
6
+ * 主入口函数
7
+ * @param {string} providerName - 供应商名称
8
+ * @param {Object} options - 选项
9
+ * @param {boolean} options.quick - 快速启动
10
+ * @param {boolean} options.noArgs - 不使用任何启动参数
11
+ */
12
+ async function main(providerName, options = {}) {
6
13
  try {
7
14
  if (providerName) {
8
15
  // 直接切换到指定供应商
9
- await switchCommand(providerName);
16
+ await switchCommand(providerName, options);
10
17
  } else {
11
18
  // 显示供应商选择界面
12
- await switchCommand();
19
+ await switchCommand(null, options);
13
20
  }
14
21
  } catch (error) {
15
22
  Logger.fatal(`程序执行失败: ${error.message}`);
16
23
  }
17
24
  }
18
25
 
19
- module.exports = { main };
26
+ module.exports = { main };
@@ -134,7 +134,7 @@ class EscNavigationManager {
134
134
  setTimeout(() => {
135
135
  try {
136
136
  handler.onTrigger();
137
- } catch (error) {
137
+ } catch {
138
138
  // 在ESC回调中抛出的错误不应终止进程
139
139
  // 交由调用方自行处理记录
140
140
  }
@@ -155,7 +155,7 @@ class EscNavigationManager {
155
155
  if (currentMax !== 0 && currentMax < 50) {
156
156
  this.input.setMaxListeners(50);
157
157
  }
158
- } catch (error) {
158
+ } catch {
159
159
  // 某些输入流可能不支持获取/设置监听器上限
160
160
  }
161
161
  }
@@ -165,7 +165,7 @@ class EscNavigationManager {
165
165
  this.previousRawMode = typeof this.input.isRaw === 'boolean' ? this.input.isRaw : null;
166
166
  this.input.setRawMode(true);
167
167
  this.rawModeEnabled = true;
168
- } catch (error) {
168
+ } catch {
169
169
  this.supported = false;
170
170
  this.handlers = [];
171
171
  return;
@@ -175,7 +175,7 @@ class EscNavigationManager {
175
175
  if (typeof this.input.resume === 'function') {
176
176
  try {
177
177
  this.input.resume();
178
- } catch (error) {
178
+ } catch {
179
179
  // 某些输入流不支持 resume,忽略即可
180
180
  }
181
181
  }
@@ -201,7 +201,7 @@ class EscNavigationManager {
201
201
  try {
202
202
  const restoreRaw = typeof this.previousRawMode === 'boolean' ? this.previousRawMode : false;
203
203
  this.input.setRawMode(restoreRaw);
204
- } catch (error) {
204
+ } catch {
205
205
  // 忽略还原失败
206
206
  }
207
207
 
@@ -0,0 +1,47 @@
1
+ const fs = require('fs-extra');
2
+ const nodeFs = require('fs');
3
+ const path = require('path');
4
+
5
+ let tempSequence = 0;
6
+
7
+ function buildTempPath(filePath) {
8
+ const directory = path.dirname(filePath);
9
+ const fileName = path.basename(filePath);
10
+ return path.join(directory, `.${fileName}.${process.pid}.${Date.now()}.${tempSequence++}.tmp`);
11
+ }
12
+
13
+ async function writeFileAtomic(filePath, content, options = {}) {
14
+ const mode = options.mode ?? 0o600;
15
+ const encoding = options.encoding ?? (Buffer.isBuffer(content) ? undefined : 'utf8');
16
+ const tempPath = buildTempPath(filePath);
17
+ let handle;
18
+
19
+ try {
20
+ handle = await nodeFs.promises.open(tempPath, 'wx', mode);
21
+ await handle.writeFile(content, encoding ? { encoding } : undefined);
22
+ await handle.sync();
23
+ await handle.close();
24
+ handle = null;
25
+ await nodeFs.promises.rename(tempPath, filePath);
26
+ if (process.platform !== 'win32') {
27
+ await nodeFs.promises.chmod(filePath, mode);
28
+ }
29
+ } catch (error) {
30
+ if (handle) {
31
+ await handle.close().catch(() => {});
32
+ }
33
+ await fs.remove(tempPath).catch(() => {});
34
+ throw error;
35
+ }
36
+ }
37
+
38
+ async function writeJsonAtomic(filePath, data, options = {}) {
39
+ const spaces = options.spaces ?? 2;
40
+ const content = JSON.stringify(data, null, spaces);
41
+ await writeFileAtomic(filePath, content, {
42
+ encoding: 'utf8',
43
+ mode: options.mode ?? 0o600
44
+ });
45
+ }
46
+
47
+ module.exports = { writeFileAtomic, writeJsonAtomic };
@@ -1,12 +1,12 @@
1
1
  const fs = require('fs-extra');
2
2
  const path = require('path');
3
3
  const os = require('os');
4
+ const { writeJsonAtomic } = require('./atomic-file');
4
5
 
5
6
  const CONFLICT_ENV_KEYS = [
6
7
  'ANTHROPIC_API_KEY',
7
8
  'ANTHROPIC_AUTH_TOKEN',
8
9
  'ANTHROPIC_BASE_URL',
9
- 'CLAUDE_CODE_OAUTH_TOKEN',
10
10
  'ANTHROPIC_MODEL',
11
11
  'ANTHROPIC_SMALL_FAST_MODEL'
12
12
  ];
@@ -19,7 +19,7 @@ function unique(array) {
19
19
 
20
20
  function timestampSuffix() {
21
21
  const now = new Date();
22
- const pad = (num) => String(num).padStart(2, '0');
22
+ const pad = num => String(num).padStart(2, '0');
23
23
  return [
24
24
  now.getFullYear(),
25
25
  pad(now.getMonth() + 1),
@@ -91,7 +91,7 @@ function detectConflictKeys(settings) {
91
91
  return [];
92
92
  }
93
93
 
94
- return CONFLICT_ENV_KEYS.filter((key) => Object.prototype.hasOwnProperty.call(env, key));
94
+ return CONFLICT_ENV_KEYS.filter(key => Object.prototype.hasOwnProperty.call(env, key));
95
95
  }
96
96
 
97
97
  async function backupSettingsFile(filePath) {
@@ -121,7 +121,7 @@ function clearConflictKeys(settings, keys) {
121
121
  }
122
122
 
123
123
  async function saveSettingsFile(filePath, data) {
124
- await fs.writeJson(filePath, data, { spaces: 2 });
124
+ await writeJsonAtomic(filePath, data, { spaces: 2, mode: 0o600 });
125
125
  }
126
126
 
127
127
  async function findSettingsConflict() {