@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
@@ -0,0 +1,124 @@
1
+ class ProviderEditQuestionsHelper {
2
+ static buildQuestions(provider, validator) {
3
+ const isCodex = provider.ideName === 'codex';
4
+ const questions = [
5
+ this.buildNameQuestion(provider, validator),
6
+ this.buildDisplayNameQuestion(provider, validator)
7
+ ];
8
+
9
+ if (!isCodex) {
10
+ questions.push(...this.buildClaudeQuestions(provider, validator));
11
+ }
12
+
13
+ questions.push(
14
+ this.buildBaseUrlQuestion(provider, isCodex, validator),
15
+ this.buildAuthTokenQuestion(provider, isCodex, validator)
16
+ );
17
+
18
+ return questions;
19
+ }
20
+
21
+ static buildNameQuestion(provider, validator) {
22
+ return {
23
+ type: 'input',
24
+ name: 'name',
25
+ message: '请输入供应商名称 (用于命令行):',
26
+ default: provider.name,
27
+ validate: (input) => {
28
+ const error = validator.validateName(input);
29
+ if (error) return error;
30
+ return true;
31
+ }
32
+ };
33
+ }
34
+
35
+ static buildDisplayNameQuestion(provider, validator) {
36
+ return {
37
+ type: 'input',
38
+ name: 'displayName',
39
+ message: '请输入显示名称:',
40
+ default: provider.displayName || provider.name,
41
+ validate: input => {
42
+ if (typeof validator?.validateDisplayName !== 'function') return true;
43
+ return validator.validateDisplayName(input) || true;
44
+ }
45
+ };
46
+ }
47
+
48
+ static buildClaudeQuestions(provider, validator) {
49
+ return [
50
+ {
51
+ type: 'list',
52
+ name: 'authMode',
53
+ message: '认证模式:',
54
+ choices: [
55
+ { name: '🔑 ANTHROPIC_API_KEY - 大多数第三方代理使用', value: 'api_key' },
56
+ { name: '🔐 ANTHROPIC_AUTH_TOKEN - 部分服务商使用', value: 'auth_token' }
57
+ ],
58
+ default: provider.authMode || 'api_key'
59
+ },
60
+ {
61
+ type: 'input',
62
+ name: 'primaryModel',
63
+ message: '主模型 (ANTHROPIC_MODEL):',
64
+ default: provider.models?.primary || '',
65
+ prefillDefault: true,
66
+ allowEmpty: true,
67
+ validate: (input) => {
68
+ const error = validator.validateModel(input);
69
+ if (error) return error;
70
+ return true;
71
+ }
72
+ },
73
+ {
74
+ type: 'input',
75
+ name: 'smallFastModel',
76
+ message: '快速模型 (ANTHROPIC_SMALL_FAST_MODEL):',
77
+ default: provider.models?.smallFast || '',
78
+ prefillDefault: true,
79
+ allowEmpty: true,
80
+ validate: (input) => {
81
+ const error = validator.validateModel(input);
82
+ if (error) return error;
83
+ return true;
84
+ }
85
+ }
86
+ ];
87
+ }
88
+
89
+ static buildBaseUrlQuestion(provider, isCodex, validator) {
90
+ return {
91
+ type: 'input',
92
+ name: 'baseUrl',
93
+ message: isCodex ? '基础URL (OPENAI_BASE_URL):' : '基础URL:',
94
+ default: provider.baseUrl,
95
+ prefillDefault: true,
96
+ validate: input => {
97
+ if (typeof validator?.validateUrl !== 'function') return true;
98
+ return validator.validateUrl(input, false) || true;
99
+ }
100
+ };
101
+ }
102
+
103
+ static buildAuthTokenQuestion(provider, isCodex, validator) {
104
+ return {
105
+ type: 'input',
106
+ name: 'authToken',
107
+ message: (answers) => {
108
+ if (isCodex) {
109
+ return 'API Key (OPENAI_API_KEY):';
110
+ }
111
+ const envVar = answers.authMode === 'auth_token' ? 'ANTHROPIC_AUTH_TOKEN' : 'ANTHROPIC_API_KEY';
112
+ return `Token (${envVar}):`;
113
+ },
114
+ default: provider.authToken,
115
+ prefillDefault: true,
116
+ validate: input => {
117
+ if (typeof validator?.validateToken !== 'function') return true;
118
+ return validator.validateToken(input) || true;
119
+ }
120
+ };
121
+ }
122
+ }
123
+
124
+ module.exports = { ProviderEditQuestionsHelper };
@@ -0,0 +1,20 @@
1
+ const { executeWithEnv } = require('../../utils/env-launcher');
2
+ const { executeCodexWithEnv } = require('../../utils/codex-launcher');
3
+
4
+ async function launchProviderProcess(provider, selectedLaunchArgs) {
5
+ if (provider.ideName === 'codex') {
6
+ await executeCodexWithEnv(provider, selectedLaunchArgs);
7
+ return;
8
+ }
9
+
10
+ await executeWithEnv(provider, selectedLaunchArgs);
11
+ }
12
+
13
+ async function markProviderAsCurrent(configManager, provider, lastUsedArgs = []) {
14
+ await configManager.activateProvider(provider.name, lastUsedArgs);
15
+ }
16
+
17
+ module.exports = {
18
+ launchProviderProcess,
19
+ markProviderAsCurrent
20
+ };
@@ -0,0 +1,214 @@
1
+ /**
2
+ * Provider Manager
3
+ * 供应商管理功能(详情、编辑、删除)
4
+ */
5
+
6
+ const { configManager } = require('../../config');
7
+ const { Logger } = require('../../utils/logger');
8
+ const { UIHelper } = require('../../utils/ui-helper');
9
+ const { AUTH_MODE_DISPLAY, BASE_URL } = require('../../constants');
10
+ const { ProviderDetailsHelper } = require('./provider-details-helper');
11
+ const { ProviderEditQuestionsHelper } = require('./provider-edit-questions-helper');
12
+ const { validator } = require('../../utils/validator');
13
+
14
+ class ProviderManager {
15
+ constructor(baseCommand) {
16
+ this.baseCommand = baseCommand;
17
+ this.configManager = configManager;
18
+ }
19
+
20
+ async showProviderDetails(providerName, onBack, onEdit, onRemove, onLaunch) {
21
+ try {
22
+ await this.configManager.load();
23
+ const provider = this.configManager.getProvider(providerName);
24
+
25
+ if (!provider) {
26
+ Logger.error(`供应商 '${providerName}' 不存在`);
27
+ return await onBack();
28
+ }
29
+
30
+ this.baseCommand.clearScreen();
31
+ console.log(UIHelper.createTitle('供应商详情', UIHelper.icons.info));
32
+ console.log();
33
+ console.log(UIHelper.createHintLine([
34
+ ['↑ / ↓', '选择操作'],
35
+ ['Enter', '确认'],
36
+ ['ESC', '返回管理列表']
37
+ ]));
38
+ console.log();
39
+
40
+ const details = ProviderDetailsHelper.buildDetailsRows(provider, {
41
+ authModeDisplay: AUTH_MODE_DISPLAY,
42
+ baseUrl: BASE_URL,
43
+ formatTime: UIHelper.formatTime
44
+ });
45
+
46
+ console.log(UIHelper.createTable(['项目', '信息'], details));
47
+ console.log();
48
+
49
+ const launchArgsText = ProviderDetailsHelper.formatLaunchArgs(provider);
50
+ if (launchArgsText) {
51
+ console.log(UIHelper.createCard('默认启动参数', launchArgsText, UIHelper.icons.settings));
52
+ console.log();
53
+ }
54
+
55
+ const answer = await this.baseCommand.promptWithESC([
56
+ {
57
+ type: 'list',
58
+ name: 'action',
59
+ message: '选择操作:',
60
+ choices: ProviderDetailsHelper.buildActionChoices(UIHelper.icons)
61
+ }
62
+ ], '返回管理列表', () => {
63
+ Logger.info('返回管理列表');
64
+ });
65
+
66
+ switch (answer.action) {
67
+ case 'back':
68
+ return await onBack();
69
+ case 'edit':
70
+ return await onEdit(providerName);
71
+ case 'remove':
72
+ return await onRemove(providerName);
73
+ case 'launch':
74
+ return await onLaunch(providerName);
75
+ }
76
+ } catch (error) {
77
+ if (this.baseCommand.isEscCancelled(error)) {
78
+ return await onBack();
79
+ }
80
+ throw error;
81
+ }
82
+ }
83
+
84
+ async editProvider(providerName, onComplete) {
85
+ try {
86
+ await this.configManager.load();
87
+ const provider = this.configManager.getProvider(providerName);
88
+
89
+ if (!provider) {
90
+ Logger.error(`供应商 '${providerName}' 不存在`);
91
+ return await onComplete();
92
+ }
93
+
94
+ this.baseCommand.clearScreen();
95
+ console.log(UIHelper.createTitle(`编辑供应商: ${provider.displayName || provider.name}`, UIHelper.icons.edit));
96
+ console.log();
97
+
98
+ const isCodex = provider.ideName === 'codex';
99
+ const questions = ProviderEditQuestionsHelper.buildQuestions(provider, validator);
100
+
101
+ let answers;
102
+ try {
103
+ answers = await this.baseCommand.promptWithESC(questions, '取消编辑', () => {
104
+ Logger.info('取消编辑供应商');
105
+ });
106
+ } catch (error) {
107
+ if (this.baseCommand.isEscCancelled(error)) {
108
+ return await onComplete();
109
+ }
110
+ throw error;
111
+ }
112
+
113
+ const originalConfig = this.configManager.config;
114
+ const originalName = provider.name;
115
+ const newName = answers.name;
116
+
117
+ if (newName !== originalName && originalConfig.providers[newName]) {
118
+ Logger.error(`供应商名称 '${newName}' 已存在,请使用其他名称`);
119
+ return await onComplete();
120
+ }
121
+
122
+ // 在内存中构造快照,校验和保存失败时不污染当前配置对象。
123
+ const updatedProvider = {
124
+ ...provider,
125
+ name: newName,
126
+ displayName: answers.displayName || provider.displayName || newName,
127
+ baseUrl: answers.baseUrl || null,
128
+ authToken: answers.authToken,
129
+ launchArgs: Array.isArray(answers.launchArgs)
130
+ ? answers.launchArgs
131
+ : (provider.launchArgs || [])
132
+ };
133
+
134
+ if (!isCodex) {
135
+ updatedProvider.authMode = answers.authMode;
136
+ updatedProvider.models = {
137
+ ...(provider.models || {}),
138
+ primary: answers.primaryModel || null,
139
+ smallFast: answers.smallFastModel || null
140
+ };
141
+ } else {
142
+ updatedProvider.authMode = null;
143
+ updatedProvider.models = null;
144
+ }
145
+
146
+ updatedProvider.ideName = isCodex ? 'codex' : 'claude';
147
+
148
+ const providers = { ...originalConfig.providers };
149
+ delete providers[originalName];
150
+ providers[newName] = updatedProvider;
151
+ const nextConfig = {
152
+ ...originalConfig,
153
+ currentProvider:
154
+ originalConfig.currentProvider === originalName
155
+ ? newName
156
+ : originalConfig.currentProvider,
157
+ providers
158
+ };
159
+
160
+ await this.configManager.save(nextConfig);
161
+ Logger.success(`供应商 '${newName}' 已更新`);
162
+
163
+ return await onComplete();
164
+ } catch (error) {
165
+ Logger.error(`编辑供应商失败: ${error.message}`);
166
+ throw error;
167
+ }
168
+ }
169
+
170
+ async removeProvider(providerName, onComplete) {
171
+ try {
172
+ await this.configManager.load();
173
+ const provider = this.configManager.getProvider(providerName);
174
+
175
+ if (!provider) {
176
+ Logger.error(`供应商 '${providerName}' 不存在`);
177
+ return await onComplete();
178
+ }
179
+
180
+ let confirm;
181
+ try {
182
+ confirm = await this.baseCommand.promptWithESC([
183
+ {
184
+ type: 'confirm',
185
+ name: 'confirmed',
186
+ message: `确定要删除供应商 '${provider.displayName || providerName}' 吗?`,
187
+ default: false
188
+ }
189
+ ], '取消删除', () => {
190
+ Logger.info('取消删除供应商');
191
+ });
192
+ } catch (error) {
193
+ if (this.baseCommand.isEscCancelled(error)) {
194
+ return await onComplete();
195
+ }
196
+ throw error;
197
+ }
198
+
199
+ if (confirm.confirmed) {
200
+ await this.configManager.removeProvider(providerName);
201
+ Logger.success(`供应商 '${providerName}' 已删除`);
202
+ } else {
203
+ Logger.info('删除操作已取消');
204
+ }
205
+
206
+ return await onComplete();
207
+ } catch (error) {
208
+ Logger.error(`删除供应商失败: ${error.message}`);
209
+ throw error;
210
+ }
211
+ }
212
+ }
213
+
214
+ module.exports = { ProviderManager };
@@ -0,0 +1,124 @@
1
+ /**
2
+ * Status Helper
3
+ * 供应商状态管理辅助函数
4
+ */
5
+
6
+ const chalk = require('chalk');
7
+
8
+ class StatusHelper {
9
+ /**
10
+ * 根据状态获取图标
11
+ * @param {string} state - 状态 (online/degraded/offline/pending)
12
+ * @returns {string} 状态图标
13
+ */
14
+ static getIconForState(state) {
15
+ const iconMap = {
16
+ online: chalk.green('●'),
17
+ degraded: chalk.yellow('◐'),
18
+ offline: chalk.red('○'),
19
+ pending: chalk.gray('…')
20
+ };
21
+ return iconMap[state] || chalk.gray('·');
22
+ }
23
+
24
+ /**
25
+ * 格式化可用性状态显示
26
+ * @param {Object} availability - 可用性对象 {state, label, latency}
27
+ * @returns {string} 格式化后的状态文本
28
+ */
29
+ static formatAvailability(availability) {
30
+ if (!availability) {
31
+ return chalk.gray('测试中...');
32
+ }
33
+
34
+ const colorMap = {
35
+ online: chalk.green,
36
+ degraded: chalk.yellow,
37
+ offline: chalk.red,
38
+ pending: chalk.gray
39
+ };
40
+
41
+ const defaultLabelMap = {
42
+ online: '可用',
43
+ degraded: '有限可用',
44
+ offline: '不可用',
45
+ pending: '测试中...'
46
+ };
47
+
48
+ const color = colorMap[availability.state] || chalk.gray;
49
+ const label = availability.label || defaultLabelMap[availability.state] || '未知';
50
+
51
+ return color(label);
52
+ }
53
+
54
+ /**
55
+ * 构建初始状态映射
56
+ * @param {Array} providers - 供应商列表
57
+ * @param {Object} cachedStatusMap - 缓存的状态映射
58
+ * @returns {Object} 状态映射
59
+ */
60
+ static buildInitialStatusMap(providers, cachedStatusMap = {}) {
61
+ const map = {};
62
+ providers.forEach(provider => {
63
+ map[provider.name] = cachedStatusMap[provider.name] || {
64
+ state: 'pending',
65
+ label: '测试中...',
66
+ latency: null
67
+ };
68
+ });
69
+ return map;
70
+ }
71
+
72
+ /**
73
+ * 构建错误状态映射
74
+ * @param {Array} providers - 供应商列表
75
+ * @param {Error} error - 错误对象
76
+ * @returns {Object} 错误状态映射
77
+ */
78
+ static buildErrorStatusMap(providers, error) {
79
+ const message = error ? `检测失败: ${error.message}` : '检测失败';
80
+ const map = {};
81
+ providers.forEach(provider => {
82
+ map[provider.name] = {
83
+ state: 'offline',
84
+ label: message,
85
+ latency: null
86
+ };
87
+ });
88
+ return map;
89
+ }
90
+
91
+ /**
92
+ * 格式化延迟显示
93
+ * @param {number} latency - 延迟毫秒数
94
+ * @returns {string} 格式化后的延迟文本
95
+ */
96
+ static formatLatency(latency) {
97
+ if (latency === null || latency === undefined) {
98
+ return '';
99
+ }
100
+
101
+ if (latency < 100) {
102
+ return chalk.green(`${latency}ms`);
103
+ } else if (latency < 300) {
104
+ return chalk.yellow(`${latency}ms`);
105
+ } else {
106
+ return chalk.red(`${latency}ms`);
107
+ }
108
+ }
109
+
110
+ /**
111
+ * 判断状态是否需要刷新
112
+ * @param {Object} status - 状态对象
113
+ * @param {number} maxAge - 最大有效期(毫秒)
114
+ * @returns {boolean} 是否需要刷新
115
+ */
116
+ static needsRefresh(status, maxAge = 30000) {
117
+ if (!status || !status.timestamp) {
118
+ return true;
119
+ }
120
+ return Date.now() - status.timestamp > maxAge;
121
+ }
122
+ }
123
+
124
+ module.exports = { StatusHelper };
@@ -0,0 +1,77 @@
1
+ /**
2
+ * UI Screen Renderer
3
+ * 通用界面渲染工具,减少重复代码
4
+ */
5
+
6
+ const { UIHelper } = require('../utils/ui-helper');
7
+
8
+ class UIScreenRenderer {
9
+ constructor(baseCommand) {
10
+ this.baseCommand = baseCommand;
11
+ }
12
+
13
+ /**
14
+ * 渲染标准页面(标题+内容+操作提示)
15
+ */
16
+ renderPage(options) {
17
+ const { title, icon, hints, content } = options;
18
+
19
+ this.baseCommand.clearScreen();
20
+
21
+ if (title) {
22
+ console.log(UIHelper.createTitle(title, icon || UIHelper.icons.info));
23
+ console.log();
24
+ }
25
+
26
+ if (hints) {
27
+ console.log(UIHelper.createHintLine(hints));
28
+ console.log();
29
+ }
30
+
31
+ if (content) {
32
+ if (typeof content === 'function') {
33
+ content();
34
+ } else {
35
+ console.log(content);
36
+ }
37
+ console.log();
38
+ }
39
+ }
40
+
41
+ /**
42
+ * 渲染带卡片的页面
43
+ */
44
+ renderCardPage(options) {
45
+ const { title, icon, cardTitle, cardContent, cardIcon, hints } = options;
46
+
47
+ this.baseCommand.clearScreen();
48
+
49
+ if (title) {
50
+ console.log(UIHelper.createTitle(title, icon || UIHelper.icons.info));
51
+ console.log();
52
+ }
53
+
54
+ if (cardTitle) {
55
+ console.log(UIHelper.createCard(cardTitle, cardContent, cardIcon));
56
+ console.log();
57
+ }
58
+
59
+ if (hints) {
60
+ console.log(UIHelper.createHintLine(hints));
61
+ console.log();
62
+ }
63
+ }
64
+
65
+ /**
66
+ * 渲染简单的确认页面
67
+ */
68
+ renderConfirmPage(title, message, icon) {
69
+ this.renderPage({
70
+ title,
71
+ icon: icon || UIHelper.icons.warning,
72
+ content: message
73
+ });
74
+ }
75
+ }
76
+
77
+ module.exports = { UIScreenRenderer };