@kikkimo/claude-launcher 2.5.0 → 3.0.0

package/lib/i18n/locales/zh-TW.js

@@ -14,7 +14,7 @@ module.exports = {
             launch_api: "使用第三方API啟動 Claude Code",
             launch_api_skip: "使用第三方API啟動 Claude Code（自動跳過權限詢問）",
             api_management: "第三方API管理",
-            language_settings: "語言設定",
+            config_management: "設定管理",
             version_check: "版本更新檢查",
             exit: "退出"
         },
@@ -22,11 +22,26 @@ module.exports = {
             title: "第三方API管理",
             add_new: "新增第三方API",
             remove: "刪除API",
+            edit: "Edit API",
             switch: "切換活躍的API",
             statistics: "查看API統計",
             export: "匯出設定",
             import: "匯入設定",
             change_password: "修改密碼",
+            manual_upgrade: "手動升級模型",
+            back: "返回主選單"
+        },
+        config: {
+            title: "設定管理",
+            language: "語言設定",
+            auto_model_upgrade: "模型自動升級",
+            model_upgrade_notification: "模型升級提示",
+            telemetry: "Anthropic 遙測資料",
+            api_launch_mode: "第三方API啟動模式",
+            back: "返回主選單"
+        },
+        api_select: {
+            title: "選擇要啟動的API：",
             back: "返回主選單"
         },
         remove_api: {
@@ -204,6 +219,23 @@ module.exports = {
             remove_confirm: "要刪除的API：{0}",
             cannot_undo: "此操作無法復原！",
             removed_info: "已刪除：{0}"
+        },
+        edit: {
+            select_api: 'Select API to edit',
+            current_value: 'Current value: {0}',
+            new_value: 'New value: ',
+            success: '✅ {0} updated successfully',
+            cancelled: 'Edit cancelled',
+            back: 'Back',
+            field_name: 'Name',
+            field_provider: 'Provider',
+            field_base_url: 'Base URL',
+            field_model: 'Model',
+            name_required: 'Name cannot be empty when editing',
+            duplicate: 'This change would create a duplicate configuration',
+            provider_url_mismatch: 'Provider and URL may be inconsistent',
+            provider_url_mismatch_detail: 'Provider: {0} / URL suggests: {1}',
+            url_provider_hint: "URL matches provider '{0}' but current provider is '{1}'. Consider updating Provider field."
         }
     },
 
@@ -277,6 +309,10 @@ module.exports = {
             good: "良好",
             strong: "強",
             very_strong: "極強"
+        },
+        guard: {
+            delete: { header: '🗑️ Remove API — Password required to verify identity' },
+            edit: { header: '✏️ Edit API — Password required to verify identity' }
         }
     },
 
@@ -324,15 +360,22 @@ module.exports = {
 
     // 導航和介面
     navigation: {
-        use_arrows: "使用 ↑↓ 方向鍵導航，Enter鍵選擇，連按兩次 Ctrl+C 退出",
-        use_arrows_esc: "使用 ↑↓ 導航，Enter鍵{0}，ESC鍵返回主選單",
+        use_arrows: "使用 ↑↓ 方向鍵導航，回車/空格鍵選擇，連按兩次 Ctrl+C 退出",
+        use_arrows_esc: "使用 ↑↓ 導航，Enter鍵{0}，ESC鍵取消",
+        use_arrows_page_esc: "←→ Page {0}/{1}, ↑↓ to navigate, Enter to {2}, ESC to cancel",
         use_number_keys: "使用數字鍵選擇：",
         currently_active: "目前活躍的API",
         select_action: "選擇一個動作：",
         no_options: "無可用選項",
         enter_choice: "輸入您的選擇（{0}，或任意其他鍵返回主選單）：",
         arrow_keys_not_available: "方向鍵不可用。輸入選擇編號 (1-{0})：",
-        enter_choice_prompt: "[>] 輸入您的選擇 (1-2，或任意其他鍵返回主選單)："
+        enter_choice_prompt: "[>] 輸入您的選擇 (1-2，或任意其他鍵返回主選單)：",
+        action: {
+            edit: 'edit',
+            remove: 'remove',
+            switch: 'switch',
+            select: 'select'
+        }
     },
 
     // 啟動過程
@@ -573,19 +616,15 @@ module.exports = {
     model_upgrade: {
         notification: "模型升級可用：{0} → {1}",
         notification_api: "API：{0}",
-        notification_hint: "前往「第三方API管理 > 模型升級設定」進行升級",
+        notification_hint: "自動升級：「設定管理」/ 手動升級：「第三方API管理 > 手動升級模型」",
         auto_upgraded: "模型已自動升級：{0} → {1}",
 
-        settings_title: "模型升級設定",
         current_config: "目前設定",
         auto_upgrade_label: "自動使用最新模型",
         auto_upgrade_on: "開啟",
         auto_upgrade_off: "關閉",
 
-        menu_toggle_auto_on: "自動升級  [● 開啟]",
-        menu_toggle_auto_off: "自動升級  [○ 關閉]",
         menu_manual_upgrade: "手動一鍵升級所有模型",
-        menu_back: "返回",
 
         manual_title: "模型升級檢查",
         manual_checking: "正在檢查 {0} 個 API 設定...",
@@ -602,8 +641,47 @@ module.exports = {
         manual_stats_skipped: "已跳過：{0} 個（{1} 個已是最新，{2} 個無升級資訊）"
     },
     hints: {
-        auto_mode_info: '自動模式：目前支援 Team 方案。Enterprise/API 方案逐步推出中。啟動後按 Shift+Tab 切換。',
+        auto_mode_info: '啟動後按 Shift+Tab 可切換到自動執行模式',
         active_api_info: '目前啟用：{0} / {1}',
-        no_active_api: '未設定啟用的API，請前往「API管理」新增。'
+        no_active_api: '未設定啟用的API，請前往「API管理」新增。',
+        direct_mode_desc: '直接啟動模式，使用啟用的API直接啟動',
+        direct_mode_api_info: 'API: {0} | 提供商: {1}',
+        direct_mode_api_detail: '模型: {0} | 最後使用: {1}',
+        direct_mode_change: '啟動模式可在「設定管理」中切換',
+        direct_mode_no_active: '直接啟動模式，但目前沒有啟用的API',
+        direct_mode_no_active_detail: '已設定 {0} 個API，請在「第三方API管理」中選擇啟用',
+        select_mode_desc: '選擇模式，啟動前將從API列表中選擇',
+        select_mode_change: '啟動模式可在「設定管理」中切換',
+        select_mode_api_count: '已設定 {0} 個API，目前啟用: {1}',
+        select_mode_active_none: '無',
+        no_api_configured: '未設定第三方API，請先在「第三方API管理」中新增',
+        api_management_info: '已設定 {0} 個API，目前啟用: {1}',
+        config_summary: '語言: {0} | 啟動模式: {1} | 遙測: {2}',
+        edit_password_required: '🔒 Password verification required to edit API configuration',
+        remove_password_required: '🔒 Password verification required to remove API',
+        export_password_required: '🔒 Password verification required to export configuration',
+        import_password_required: '🔒 Password verification required to import configuration',
+        config: {
+            language: '切換介面顯示語言，目前: {0}',
+            auto_upgrade: '自動偵測並升級第三方API的模型版本',
+            upgrade_notification: '在主選單頂部顯示模型可升級的通知',
+            telemetry: '關閉後啟動時注入 DISABLE_TELEMETRY=1，建議關閉',
+            launch_mode: '直接模式: 使用啟用API啟動 / 選擇模式: 啟動前從列表選擇'
+        },
+        api_select: {
+            info: 'API: {0}',
+            detail: '提供商: {0} | 模型: {1}',
+            usage: '使用次數: {0} | 最後使用: {1}'
+        }
+    },
+
+    config: {
+        values: {
+            on: '開啟',
+            off: '關閉',
+            direct_mode: '直接模式',
+            select_mode: '選擇模式',
+            recommended_off: '關閉 (推薦)'
+        }
     }
 };

package/lib/i18n/locales/zh.js

@@ -14,7 +14,7 @@ module.exports = {
             launch_api: "使用第三方API启动 Claude Code",
             launch_api_skip: "使用第三方API启动 Claude Code（自动跳过权限询问）",
             api_management: "第三方API管理",
-            language_settings: "语言设置",
+            config_management: "配置管理",
             version_check: "版本更新检查",
             exit: "退出"
         },
@@ -22,11 +22,26 @@ module.exports = {
             title: "第三方API管理",
             add_new: "添加新的第三方API",
             remove: "删除API",
+            edit: "编辑API",
             switch: "切换激活的API",
             statistics: "查看API统计",
             export: "导出配置",
             import: "导入配置",
             change_password: "修改密码",
+            manual_upgrade: "手动升级模型",
+            back: "返回主菜单"
+        },
+        config: {
+            title: "配置管理",
+            language: "语言设置",
+            auto_model_upgrade: "模型自动升级",
+            model_upgrade_notification: "模型升级提示",
+            telemetry: "Anthropic 遥测数据",
+            api_launch_mode: "第三方API启动模式",
+            back: "返回主菜单"
+        },
+        api_select: {
+            title: "选择要启动的API：",
             back: "返回主菜单"
         },
         remove_api: {
@@ -204,6 +219,23 @@ module.exports = {
             remove_confirm: "要删除的API：{0}",
             cannot_undo: "此操作无法撤销！",
             removed_info: "已删除：{0}"
+        },
+        edit: {
+            select_api: '选择要编辑的 API',
+            current_value: '当前值：{0}',
+            new_value: '新值：',
+            success: '✅ {0} 更新成功',
+            cancelled: '编辑已取消',
+            back: '返回',
+            field_name: '名称',
+            field_provider: '供应商',
+            field_base_url: 'Base URL',
+            field_model: '模型',
+            name_required: '编辑时名称不能为空',
+            duplicate: '此更改将创建重复的配置',
+            provider_url_mismatch: '供应商和 URL 可能不一致',
+            provider_url_mismatch_detail: '供应商：{0} / URL 建议：{1}',
+            url_provider_hint: "URL 匹配供应商 '{0}'，但当前供应商为 '{1}'。建议更新供应商字段。"
         }
     },
 
@@ -277,6 +309,10 @@ module.exports = {
             good: "良好",
             strong: "强",
             very_strong: "极强"
+        },
+        guard: {
+            delete: { header: '🗑️ 删除 API — 需要密码验证身份' },
+            edit: { header: '✏️ 编辑 API — 需要密码验证身份' }
         }
     },
 
@@ -324,15 +360,22 @@ module.exports = {
 
     // 导航和界面
     navigation: {
-        use_arrows: "使用 ↑↓ 方向键导航，回车键选择，连击两次 Ctrl+C 退出",
-        use_arrows_esc: "使用 ↑↓ 导航，回车键{0}，ESC键返回主菜单",
+        use_arrows: "使用 ↑↓ 方向键导航，回车/空格键选择，连击两次 Ctrl+C 退出",
+        use_arrows_esc: "使用 ↑↓ 导航，回车键{0}，ESC键取消",
+        use_arrows_page_esc: "←→ 第{0}/{1}页，↑↓ 导航，回车键{2}，ESC键取消",
         use_number_keys: "使用数字键选择：",
         currently_active: "当前激活的API",
         select_action: "选择一个操作：",
         no_options: "无可用选项",
         enter_choice: "输入您的选择（{0}，或任意其他键返回主菜单）：",
         arrow_keys_not_available: "方向键不可用。输入选择编号 (1-{0})：",
-        enter_choice_prompt: "[>] 输入您的选择 (1-2，或任意其他键返回主菜单): "
+        enter_choice_prompt: "[>] 输入您的选择 (1-2，或任意其他键返回主菜单): ",
+        action: {
+            edit: '编辑',
+            remove: '删除',
+            switch: '切换',
+            select: '选择'
+        }
     },
 
     // 启动过程
@@ -573,19 +616,15 @@ module.exports = {
     model_upgrade: {
         notification: "模型升级可用: {0} → {1}",
         notification_api: "API: {0}",
-        notification_hint: "前往「第三方API管理 > 模型升级设置」进行升级",
+        notification_hint: "自动升级：「配置管理」/ 手动升级：「第三方API管理 > 手动升级模型」",
         auto_upgraded: "模型已自动升级: {0} → {1}",
 
-        settings_title: "模型升级设置",
         current_config: "当前配置",
         auto_upgrade_label: "自动使用最新模型",
         auto_upgrade_on: "开启",
         auto_upgrade_off: "关闭",
 
-        menu_toggle_auto_on: "自动升级  [● 开启]",
-        menu_toggle_auto_off: "自动升级  [○ 关闭]",
         menu_manual_upgrade: "手动一键升级所有模型",
-        menu_back: "返回",
 
         manual_title: "模型升级检查",
         manual_checking: "正在检查 {0} 个 API 配置...",
@@ -602,8 +641,47 @@ module.exports = {
         manual_stats_skipped: "已跳过: {0} 个 ({1} 个已是最新, {2} 个无升级信息)"
     },
     hints: {
-        auto_mode_info: '自动模式：目前支持 Team 计划。Enterprise/API 计划逐步推出中。启动后按 Shift+Tab 切换。',
+        auto_mode_info: '启动后按 Shift+Tab 可切换到自动执行模式',
         active_api_info: '当前激活：{0} / {1}',
-        no_active_api: '未配置激活的API，请前往"API管理"添加。'
+        no_active_api: '未配置激活的API，请前往"API管理"添加。',
+        direct_mode_desc: '直接启动模式，使用激活的API直接启动',
+        direct_mode_api_info: 'API: {0} | 提供商: {1}',
+        direct_mode_api_detail: '模型: {0} | 最后使用: {1}',
+        direct_mode_change: '启动模式可在「配置管理」中切换',
+        direct_mode_no_active: '直接启动模式，但当前没有激活的API',
+        direct_mode_no_active_detail: '已配置 {0} 个API，请在「第三方API管理」中选择激活',
+        select_mode_desc: '选择模式，启动前将从API列表中选择',
+        select_mode_change: '启动模式可在「配置管理」中切换',
+        select_mode_api_count: '已配置 {0} 个API，当前激活: {1}',
+        select_mode_active_none: '无',
+        no_api_configured: '未配置第三方API，请先在「第三方API管理」中添加',
+        api_management_info: '已配置 {0} 个API，当前激活: {1}',
+        config_summary: '语言: {0} | 启动模式: {1} | 遥测: {2}',
+        edit_password_required: '🔒 编辑API配置需要密码验证',
+        remove_password_required: '🔒 删除API需要密码验证',
+        export_password_required: '🔒 导出配置需要密码验证',
+        import_password_required: '🔒 导入配置需要密码验证',
+        config: {
+            language: '切换界面显示语言，当前: {0}',
+            auto_upgrade: '自动检测并升级第三方API的模型版本',
+            upgrade_notification: '在主菜单顶部显示模型可升级的通知',
+            telemetry: '关闭后启动时注入 DISABLE_TELEMETRY=1，建议关闭',
+            launch_mode: '直接模式: 使用激活API启动 / 选择模式: 启动前从列表选择'
+        },
+        api_select: {
+            info: 'API: {0}',
+            detail: '提供商: {0} | 模型: {1}',
+            usage: '使用次数: {0} | 最后使用: {1}'
+        }
+    },
+
+    config: {
+        values: {
+            on: '开启',
+            off: '关闭',
+            direct_mode: '直接模式',
+            select_mode: '选择模式',
+            recommended_off: '关闭 (推荐)'
+        }
     }
 };

package/lib/launcher.js

@@ -7,11 +7,108 @@ const colors = require('./ui/colors');
 const i18n = require('./i18n');
 const { getProvider } = require('./presets/providers');
 const stdinManager = require('./utils/stdin-manager');
+const { loadConfigSync } = require('./utils/version-checker');
+
+// Module-level flag for console handoff state
+let consoleRelinquished = false;
+
+/**
+ * Detach stdin and suspend stdinManager so the child process owns the terminal
+ */
+function relinquishConsoleToChild() {
+    if (consoleRelinquished) return;
+    consoleRelinquished = true;
+    try {
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(false);
+        }
+    } catch (_) {}
+
+    // Detach only current scope listeners to avoid affecting other modules
+    if (stdinManager.activeScope && typeof stdinManager.activeScope.detach === 'function') {
+        stdinManager.activeScope.detach();
+    }
+
+    // Suspend stdin manager so no new listeners are attached while Claude is running
+    if (typeof stdinManager.suspend === 'function') {
+        stdinManager.suspend();
+    }
+}
+
+/**
+ * Restore stdinManager after child process exits
+ */
+function restoreConsoleForLauncher() {
+    if (!consoleRelinquished) return;
+    consoleRelinquished = false;
+    if (typeof stdinManager.resume === 'function') {
+        stdinManager.resume();
+    }
+    stdinManager.enableCtrlC();
+}
+
+/**
+ * Handle launch failures with optional rollback and user prompt
+ */
+function handleLaunchFailure(message, opts = {}) {
+    if (opts.afterHandover) {
+        restoreConsoleForLauncher();
+    } else {
+        stdinManager.enableCtrlC();
+    }
+
+    // Rollback launch statistics if callback provided — pass error message for lastError
+    if (typeof opts.rollbackFn === 'function') {
+        try { opts.rollbackFn(message); } catch (_) {}
+    }
+
+    console.log(colors.red + '[x] ' + message + colors.reset);
+    console.log(colors.gray + i18n.tSync('ui.general.press_key_return_menu') + colors.reset);
+
+    if (process.stdin.isTTY) {
+        try {
+            process.stdin.setRawMode(true);
+            process.stdin.resume();
+        } catch (_) {
+            // Ignore setup failures
+        }
+
+        // Set timeout to prevent infinite hanging
+        const timeoutId = setTimeout(() => {
+            try {
+                process.stdin.setRawMode(false);
+            } catch (_) {
+                // Ignore cleanup failures
+            }
+            process.exit(1);
+        }, 60000); // 60 second timeout
+
+        process.stdin.once('data', () => {
+            clearTimeout(timeoutId);
+            try {
+                process.stdin.setRawMode(false);
+            } catch (_) {
+                // Ignore cleanup failures
+            }
+            // Exit after user acknowledges the error
+            process.exit(1);
+        });
+    } else {
+        // For non-TTY environments, exit immediately
+        process.exit(1);
+    }
+}
 
 /**
  * Launch Claude Code with specified environment variables
  */
-function launchClaude(command, envVars = {}, disableAuthTokens = false) {
+function launchClaude(command, envVars = {}, disableAuthTokens = false, opts = {}) {
+    // Inject telemetry control from config
+    const launcherConfig = loadConfigSync();
+    if (launcherConfig.disableTelemetry) {
+        envVars.DISABLE_TELEMETRY = '1';
+    }
+
     // Disable Ctrl+C monitoring before launching Claude Code
     // This allows Ctrl+C to be handled exclusively by Claude Code process
     stdinManager.disableCtrlC();
@@ -49,81 +146,6 @@ function launchClaude(command, envVars = {}, disableAuthTokens = false) {
     const args = command.split(' ');
     const cmd = args.shift();
 
-    let consoleRelinquished = false;
-    const relinquishConsoleToChild = () => {
-        if (consoleRelinquished) return;
-        consoleRelinquished = true;
-        // Do the minimal changes: switch to cooked mode and detach current scope, but do not pause stdin nor swallow signals
-        try {
-            if (process.stdin.isTTY) {
-                process.stdin.setRawMode(false);
-            }
-        } catch (_) {}
-
-        // Detach only current scope listeners to avoid affecting other modules
-        if (stdinManager.activeScope && typeof stdinManager.activeScope.detach === 'function') {
-            stdinManager.activeScope.detach();
-        }
-
-        // Suspend stdin manager so no new listeners are attached while Claude is running
-        if (typeof stdinManager.suspend === 'function') {
-            stdinManager.suspend();
-        }
-    };
-
-    const restoreConsoleForLauncher = () => {
-        if (!consoleRelinquished) return;
-        consoleRelinquished = false;
-        if (typeof stdinManager.resume === 'function') {
-            stdinManager.resume();
-        }
-        stdinManager.enableCtrlC();
-    };
-
-    const handleLaunchFailure = (message, opts = {}) => {
-        if (opts.afterHandover) {
-            restoreConsoleForLauncher();
-        } else {
-            stdinManager.enableCtrlC();
-        }
-
-        console.log(colors.red + '[x] ' + message + colors.reset);
-        console.log(colors.gray + i18n.tSync('ui.general.press_key_return_menu') + colors.reset);
-
-        if (process.stdin.isTTY) {
-            try {
-                process.stdin.setRawMode(true);
-                process.stdin.resume();
-            } catch (_) {
-                // Ignore setup failures
-            }
-
-            // Set timeout to prevent infinite hanging
-            const timeoutId = setTimeout(() => {
-                try {
-                    process.stdin.setRawMode(false);
-                } catch (_) {
-                    // Ignore cleanup failures
-                }
-                process.exit(1);
-            }, 60000); // 60 second timeout
-
-            process.stdin.once('data', () => {
-                clearTimeout(timeoutId);
-                try {
-                    process.stdin.setRawMode(false);
-                } catch (_) {
-                    // Ignore cleanup failures
-                }
-                // Exit after user acknowledges the error
-                process.exit(1);
-            });
-        } else {
-            // For non-TTY environments, exit immediately
-            process.exit(1);
-        }
-    };
-
     try {
         // Clean up terminal state before launching Claude
         if (process.stdin.isTTY) {
@@ -135,15 +157,8 @@ function launchClaude(command, envVars = {}, disableAuthTokens = false) {
             }
         }
 
-        // Note: stdin listener management is handled by relinquishConsoleToChild()
-        // using stdinManager.activeScope.detach() and stdinManager.suspend().
-        // This ensures only the current scope's listeners are detached while
-        // preserving any listeners from other modules.
-        //
-        // Note: Do NOT remove global SIGINT/SIGTERM handlers here.
-        // The existing handlers already check stdinManager.isSuspended() and
-        // will properly ignore signals during child process execution.
-        // Removing all handlers would break other modules and degrade reliability.
+        // Relinquish console before spawn so the child inherits a clean terminal
+        relinquishConsoleToChild();
 
         // Launch Claude in current terminal, inherit stdio
         const child = spawn(cmd, args, {
@@ -153,19 +168,22 @@ function launchClaude(command, envVars = {}, disableAuthTokens = false) {
             shell: true
         });
 
-        relinquishConsoleToChild();
-
         child.on('close', (code) => {
             restoreConsoleForLauncher();
             process.exit(code || 0);
         });
 
         child.on('error', (error) => {
-            handleLaunchFailure('Error running Claude: ' + error.message, { afterHandover: true });
+            handleLaunchFailure('Error running Claude: ' + error.message, {
+                afterHandover: true,
+                rollbackFn: opts.rollbackFn
+            });
         });
 
     } catch (error) {
-        handleLaunchFailure('Error launching Claude Code: ' + error.message);
+        handleLaunchFailure('Error launching Claude Code: ' + error.message, {
+            rollbackFn: opts.rollbackFn
+        });
     }
 }
 
@@ -231,12 +249,21 @@ function getProviderEnvVars(api) {
 /**
  * Launch Claude with third-party API configuration
  */
-function launchClaudeWithApi(api, skipPermissions = false) {
+function launchClaudeWithApi(api, skipPermissions = false, opts = {}) {
     const command = skipPermissions
         ? 'claude --dangerously-skip-permissions'
         : 'claude';
 
-    const envVars = getProviderEnvVars(api);
+    let envVars;
+    try {
+        envVars = getProviderEnvVars(api);
+    } catch (error) {
+        handleLaunchFailure('Failed to prepare API environment: ' + error.message, {
+            afterHandover: true,
+            rollbackFn: opts.rollbackFn
+        });
+        return;
+    }
 
     console.log('');
     console.log(colors.bright + colors.orange + '🔗 ' + i18n.tSync('launch.using_third_party_api') + colors.reset);
@@ -281,7 +308,7 @@ function launchClaudeWithApi(api, skipPermissions = false) {
 
     console.log('');
 
-    launchClaude(command, envVars, true);
+    launchClaude(command, envVars, true, { rollbackFn: opts.rollbackFn });
 }
 
 /**
@@ -365,5 +392,6 @@ module.exports = {
     launchClaudeAutoMode,
     launchClaudeWithApi,
     getProviderEnvVars,
-    testApiConnection
+    testApiConnection,
+    handleLaunchFailure
 };