base_parts_ai 1.0.42 → 1.0.44

package/.eslintrc.js

@@ -16,7 +16,7 @@ module.exports = {
     "extends": "eslint:recommended",
     "rules": {
         "accessor-pairs": "error",
-        "array-bracket-newline": "error",
+        "array-bracket-newline": "off",
         "array-bracket-spacing": "error",
         "array-callback-return": "error",
         "array-element-newline": "off",
@@ -124,7 +124,7 @@ module.exports = {
         "no-label-var": "error",
         "no-labels": "error",
         "no-lone-blocks": "off",
-        "no-lonely-if": "error",
+        "no-lonely-if": "off",
         "no-loop-func": "off",
         "no-magic-numbers": "off",
         "no-mixed-operators": "error",
@@ -252,7 +252,7 @@ module.exports = {
         "valid-jsdoc": "off",
         "vars-on-top": "off",
         "wrap-iife": "off",
-        "wrap-regex": "error",
+        "wrap-regex": "off",
         "yield-star-spacing": "error",
         "yoda": "off",
         "no-console": "off",

package/AGENTS.md

@@ -0,0 +1,42 @@
+# Repository Guidelines
+
+## 项目结构与模块组织
+
+本仓库是 Node.js CLI 包，包名为 `base_parts_ai`。`main.js` 是包入口；`bin/jcc.js` 是 Claude Code 命令行入口，对外暴露为 `jcc`；`bin/jcx.js` 是 Codex 命令行入口，对外暴露为 `jcx`；`bin/postinstall.js` 负责安装后处理。核心逻辑放在 `lib/`，其中 `ai_utils.js` 管理 AI 配置读写、渠道配置和 `ai_tip` 地址构建，`setapi_cc.js` 处理 Claude Code API 渠道切换与 Token 写入，`setapi_cx.js` 处理 Codex API 渠道切换与配置写入。`test_jcc.js`、`test_jcx.js` 是当前主要测试脚本，`test_home/` 用作隔离测试目录，避免污染真实用户目录。发布与使用说明集中在 `README.md`。
+
+## 构建、测试与开发命令
+
+- `npm install`：安装依赖，并触发 `postinstall`。
+- `npm test`：运行 `node ./test_jcc.js && node ./test_jcx.js`，验证 `jcc` 与 `jcx` 相关配置流程。测试会联网拉取渠道配置，失败时先检查网络与服务端可用性。
+- `node ./bin/jcc.js --help`：查看 CLI 参数与可用子命令。
+- `node ./bin/jcx.js --help`：查看 Codex CLI 参数与可用子命令。
+- `npx eslint .`：按 `.eslintrc.js` 检查代码风格；当前未在 `package.json` 中配置 lint 脚本。
+
+本项目没有独立构建步骤，修改后直接通过 Node.js 执行验证。
+
+## 编码风格与命名约定
+
+使用 CommonJS（`require` / `module.exports`）和 `'use strict'`。保持现有缩进与分号风格，不做无关格式化。文件名采用小写加下划线，例如 `ai_utils.js`。变量和函数优先使用清晰的英文驼峰命名，如 `getBuildCfg`、`loadSettings`。新增关键函数、类、接口、重要分支和配置写入逻辑必须添加简体中文注释，说明目的和影响。
+
+## 测试规范
+
+新增行为应补充到 `test_jcc.js` 或新增 `test_*.js` 脚本。测试必须优先使用 `JCC_TEST_HOME` 或临时目录隔离用户配置，禁止直接改写真实 `~/.claude`。涉及网络配置拉取的测试应输出明确失败原因，便于区分代码错误和网络错误。
+
+`jcc` 测试覆盖 Claude Code 配置文件：`~/.claude.json`、`~/.claude/settings.json`、`~/.claude/jcc.json`。`jcx` 测试覆盖 Codex 配置文件：`~/.codex/auth.json`、`~/.codex/config.toml`、`~/.codex/AGENTS.md`。新增 Codex 行为应优先补充到 `test_jcx.js`。
+
+## CLI 行为约定
+
+- `jcc` 无子命令时默认执行 `jcc setapi`，调用 `lib/setapi_cc.js`。
+- `jcx` 无子命令时默认执行 `jcx setapi`，调用 `lib/setapi_cx.js`。
+- `ai_utils.fetchConfig()` 从服务端拉取 `channels` 填充 `API_CHANNELS`，拉取 `cxChannels` 填充 `CX_CHANNELS`。
+- `jcx setapi` 每次配置都要通过 `ai_tip?cli=cx&os=xxx` 重新拉取并覆盖写入 `~/.codex/AGENTS.md`。
+- 需要手动输入 URL 的流程必须先输入 URL，再输入 Key。
+- 需要手动输入 URL/Key 的输入框应保留默认值；直接回车表示沿用默认值，输入空格后回车表示删除该配置。
+
+## 提交与 Pull Request 规范
+
+当前 Git 历史提交信息较简单，仅见 `commit`，后续建议使用简短祈使句或约定式提交，例如 `fix: handle empty settings file`、`feat: add channel key command`。PR 应包含变更目的、测试命令与结果、影响的配置文件路径；CLI 输出或交互变化建议附截图或关键日志。
+
+## 安全与配置提示
+
+不要提交真实 API Key、用户级 `.claude.json` 或 `.claude/settings.json`。读写文件时在 Windows PowerShell 中明确使用 UTF-8，避免中文乱码。处理路径时使用 `path.join` / `path.resolve`，保持跨平台兼容。

package/README.md

@@ -1,6 +1,14 @@
 
 ## 下载发布的包
-https://registry.npmjs.org/base_parts_ai/-/base_parts_ai-1.0.34.tgz
+https://registry.npmjs.org/base_parts_ai/-/base_parts_ai-1.0.43.tgz
 
 ## 然后放在jdwfiles目录下
 https://jdwfiles.oss-cn-hangzhou.aliyuncs.com/npm_pkg/base_parts_ai-1.0.34.tgz
+
+
+# 2.1.34
+User-Agent: claude-cli/2.1.34 (external, cli)
+claude-opus-4-6
+claude-sonnet-4-6
+claude-haiku-4-5-20251001
+

package/{NEXT.md → TODO.md}

@@ -1 +1 @@
-
+

package/bin/jcc.js

@@ -129,7 +129,7 @@ async function runCommand(libName, opts) {
     await checkEnvConflict();
     var buildCfg = getBuildCfg(opts);
     // 从服务端拉取渠道配置（含 jcc 自动升级检查）
-    var utils = loadLib('claude_utils');
+    var utils = loadLib('ai_utils');
     await utils.fetchConfig(buildCfg);
     // 显示公告，有公告时等待用户按回车继续
     await utils.showNotice();
@@ -142,17 +142,9 @@ async function runCommand(libName, opts) {
 program
     .command('setapi')
     .action(async function () {
-        await runCommand('setapi', this.opts());
+        await runCommand('setapi_cc', this.opts());
     });
 
-// 命令：setkey —— 设置 AI Key，修改 Claude settings.json 中的 ANTHROPIC_API_KEY
-program
-    .command('setkey')
-    .action(async function () {
-        await runCommand('setkey', this.opts());
-    });
-
-
 // 若未传入任何子命令，默认执行 setapi
 if (process.argv.length <= 2) {
     process.argv.push('setapi');
@@ -161,5 +153,3 @@ if (process.argv.length <= 2) {
 // 开始解析
 program.parse(process.argv);
 
-
-

package/bin/jcx.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+
+'use strict';
+
+var fs = require('fs');
+var os = require('os');
+var path = require('path');
+var { execSync } = require('child_process');
+var { Command } = require('commander');
+var program = new Command();
+
+/**
+ * 构建 Codex 配置路径，并确保 ~/.codex 目录存在
+ * @param {object} cmd commander 解析出的选项
+ * @returns {object}
+ */
+function getBuildCfg(cmd) {
+    var buildCfg = {};
+    buildCfg.details = cmd.details;
+
+    // 从 npm 全局目录下的 @openai/codex/package.json 提取 Codex 版本号
+    // 该版本号用于后续和渠道 cxVersionList 做一致性校验
+    try {
+        var npmRootG = execSync('npm root -g', { encoding: 'utf8' }).trim();
+        var codexPkgPath = path.join(npmRootG, '@openai', 'codex', 'package.json');
+        var codexPkg = JSON.parse(fs.readFileSync(codexPkgPath, 'utf8'));
+        buildCfg.codexVersion = codexPkg.version || '';
+    } catch (e) {
+        buildCfg.codexVersion = '';
+    }
+    console.log('[Codex version] ' + (buildCfg.codexVersion || '(未找到)'));
+
+    // 支持 JCC_TEST_HOME 隔离测试目录，避免改写真实用户 Codex 配置
+    var homeDir = process.env.JCC_TEST_HOME || os.homedir();
+    var codexDir = path.join(homeDir, '.codex');
+    if (!fs.existsSync(codexDir)) {
+        fs.mkdirSync(codexDir, { recursive: true });
+        console.log('[Init] 已创建目录: ' + codexDir);
+    }
+
+    buildCfg.codexDir = codexDir;
+    buildCfg.codexAuthPath = path.join(codexDir, 'auth.json');
+    buildCfg.codexConfigPath = path.join(codexDir, 'config.toml');
+    buildCfg.codexAgentsPath = path.join(codexDir, 'AGENTS.md');
+    return buildCfg;
+}
+
+/**
+ * 动态加载 lib 下的命令模块，便于本地开发时读取最新文件
+ * @param {string} libName lib目录下的文件名（不含.js）
+ * @returns {Function}
+ */
+function loadLib(libName) {
+    var libPath = path.resolve(__dirname, '../lib/' + libName + '.js');
+    delete require.cache[require.resolve(libPath)];
+    return require(libPath);
+}
+
+/**
+ * Codex 命令公共流程：拉取配置、展示公告、执行业务模块
+ * @param {string} libName 业务模块名
+ * @param {object} opts commander 选项
+ */
+async function runCommand(libName, opts) {
+    var buildCfg = getBuildCfg(opts);
+    var utils = loadLib('ai_utils');
+    await utils.fetchConfig(buildCfg);
+    await utils.showNotice();
+    await loadLib(libName)(opts, buildCfg);
+    console.log('\n✅ 完成！重启 Codex 后生效。');
+}
+
+program
+    .command('setapi')
+    .description('选择 Codex AI 渠道并写入 ~/.codex 配置')
+    .action(async function () {
+        await runCommand('setapi_cx', this.opts());
+    });
+
+program
+    .name('jcx')
+    .description('Codex 配置工具');
+
+// 若未传入任何子命令，默认执行 setapi
+if (process.argv.length <= 2) {
+    process.argv.push('setapi');
+}
+
+program.parse(process.argv);

package/lib/{claude_utils.js → ai_utils.js}

@@ -2,7 +2,7 @@
 
 /**
  * Claude 配置工具函数
- * 供 setapi.js / setkey.js 共享使用
+ * 供 setapi_cc.js、setapi_cx.js 等命令模块共享使用
  */
 
 var fs = require('fs');
@@ -15,9 +15,15 @@ var { execSync } = require('child_process');
 // ============================================================
 var API_CHANNELS = [];
 
+// Codex 渠道列表（运行时由 fetchConfig 从服务端 cxChannels 填充）
+var CX_CHANNELS = [];
+
 // 公告列表（运行时由 fetchConfig 从服务端拉取填充）
 var noticeList = [];
 
+// jcc.json 中保存最后一次手动输入 Token 的内部字段名
+var LAST_MANUAL_AUTH_TOKEN_KEY = '__lastManualAuthToken';
+
 /**
  * 从服务端拉取渠道配置，并检查 jcc 自身是否需要升级
  * @param {object} buildCfg getBuildCfg 返回的配置对象
@@ -41,6 +47,14 @@ function fetchConfig(buildCfg) {
                             });
                             console.log('[fetchConfig] 已拉取 ' + API_CHANNELS.length + ' 个渠道');
                         }
+                        // 将服务端返回的 Codex 渠道列表填充到 CX_CHANNELS
+                        if (Array.isArray(result.data.cxChannels)) {
+                            CX_CHANNELS.length = 0;
+                            result.data.cxChannels.forEach(function (ch) {
+                                CX_CHANNELS.push(ch);
+                            });
+                            console.log('[fetchConfig] 已拉取 ' + CX_CHANNELS.length + ' 个 Codex 渠道');
+                        }
                         // 解析公告列表
                         if (Array.isArray(result.data.noticeList)) {
                             noticeList.length = 0;
@@ -148,6 +162,118 @@ function loadSettings(settingsPath) {
     return settings;
 }
 
+/**
+ * 获取 ai_tip 接口使用的当前系统标识
+ * 将 Node.js 平台和 CPU 架构归一化为服务端识别的 os 参数
+ * @returns {string} 例如 windows_x64、linux_x64、macos_arm64
+ */
+function getAiTipOsParam() {
+    var platformMap = {
+        win32: 'windows',
+        linux: 'linux',
+        darwin: 'macos',
+    };
+    var archMap = {
+        ia32: 'x86',
+        x64: 'x64',
+        arm: 'arm',
+        arm64: 'arm64',
+    };
+    var platformName = platformMap[process.platform] || process.platform;
+    var archName = archMap[process.arch] || process.arch;
+    return platformName + '_' + archName;
+}
+
+/**
+ * 构建 SessionStart Hook 中调用 ai_tip 的命令
+ * os 参数在写入配置时按当前运行环境固定，避免运行时依赖占位符替换
+ * @returns {string}
+ */
+function buildAiTipCommand() {
+    return 'curl -s -m 2 ' + buildAiTipUrl('cc');
+}
+
+/**
+ * 构建 ai_tip 接口地址
+ * @param {string} cli 客户端标识，例如 cc 或 cx
+ * @returns {string}
+ */
+function buildAiTipUrl(cli) {
+    return 'http://116.62.243.108:7180/pub/ai_tip?cli=' + cli + '-' + getAiTipOsParam();
+}
+
+/**
+ * 读取远程文本内容，失败时返回空字符串
+ * @param {string} url 请求地址
+ * @returns {Promise<string>}
+ */
+function fetchText(url) {
+    return new Promise(function (resolve) {
+        http.get(url, { timeout: 8000 }, function (res) {
+            var chunks = '';
+            res.on('data', function (chunk) { chunks += chunk; });
+            res.on('end', function () { resolve(chunks); });
+        }).on('error', function (err) {
+            console.warn('[fetchText] 请求失败:', err.message);
+            resolve('');
+        }).on('timeout', function () {
+            console.warn('[fetchText] 请求超时');
+            this.destroy();
+            resolve('');
+        });
+    });
+}
+
+/**
+ * 获取渠道配置中强制指定的 ANTHROPIC_AUTH_TOKEN
+ * 仅当服务端 envObj 显式带有非空 Token 时返回，用于跳过用户输入
+ * @param {object} channel 渠道配置对象
+ * @returns {string}
+ */
+function getChannelAuthToken(channel) {
+    if (!channel || !channel.envObj || !Object.prototype.hasOwnProperty.call(channel.envObj, 'ANTHROPIC_AUTH_TOKEN')) {
+        return '';
+    }
+    var token = channel.envObj.ANTHROPIC_AUTH_TOKEN;
+    return typeof token === 'string' ? token.trim() : '';
+}
+
+/**
+ * 记录最后一次由用户手动输入的 Token
+ * 该值只作为后续输入提示默认值，不代表当前渠道配置
+ * @param {object} jccJson jcc.json 对象
+ * @param {string} token 用户手动输入的 Token
+ */
+function saveLastManualAuthToken(jccJson, token) {
+    if (!jccJson.keys) { jccJson.keys = {}; }
+    if (token) {
+        jccJson.keys[LAST_MANUAL_AUTH_TOKEN_KEY] = token;
+    }
+}
+
+/**
+ * 获取最后一次手动输入的 Token
+ * @param {object} jccJson jcc.json 对象
+ * @returns {string}
+ */
+function getLastManualAuthToken(jccJson) {
+    return (jccJson.keys && jccJson.keys[LAST_MANUAL_AUTH_TOKEN_KEY]) || '';
+}
+
+/**
+ * 计算需要提示用户输入 Token 时的默认值
+ * 优先使用当前渠道缓存，其次当前 settings，最后使用最后一次手动输入的 Token
+ * @param {object} jccJson jcc.json 对象
+ * @param {string} channelId 当前渠道 id
+ * @param {object} settings Claude settings.json 对象
+ * @returns {string}
+ */
+function getManualAuthTokenDefault(jccJson, channelId, settings) {
+    var cachedToken = (jccJson.keys && jccJson.keys[channelId]) || '';
+    var currentToken = (settings.env && settings.env.ANTHROPIC_AUTH_TOKEN) || '';
+    return cachedToken || currentToken || getLastManualAuthToken(jccJson);
+}
+
 /**
  * 根据 settings 中的 __jid 字段匹配当前渠道
  * @param {object} settings Claude settings.json 对象
@@ -211,10 +337,19 @@ function showNotice() {
 
 module.exports = {
     API_CHANNELS,
+    CX_CHANNELS,
     fetchConfig,
+    fetchText,
     readJsonFile,
     writeJsonFile,
     loadSettings,
+    getAiTipOsParam,
+    buildAiTipUrl,
+    buildAiTipCommand,
+    getChannelAuthToken,
+    saveLastManualAuthToken,
+    getLastManualAuthToken,
+    getManualAuthTokenDefault,
     getCurrentInfo,
     maskKey,
     printCurrentInfo,

package/lib/{setapi.js → setapi_cc.js}

@@ -4,12 +4,12 @@
  * setapi 命令：交互式选择 AI 渠道
  * 将选中的渠道 id 写入 ~/.claude/settings.json 的 __jid 字段
  * 渠道专属动作（如 baseUrl 等）由后续扩展的 if 分支单独处理
- * 若渠道无缓存 Key，则提示用户输入并保存到 ~/.claude/jcc.json
+ * 若服务端未强制下发 Key，则提示用户输入并保存到 ~/.claude/jcc.json
  */
 
 // inquirer@8 使用传统 prompt API
 var inquirer = require('inquirer');
-var utils = require('./claude_utils');
+var utils = require('./ai_utils');
 var { execSync } = require('child_process');
 
 module.exports = async function (cmd, buildCfg) {
@@ -56,7 +56,7 @@ module.exports = async function (cmd, buildCfg) {
         "SessionStart": [
             {
                 "matcher": ".*",
-                "hooks": [{ "type": "command", "command": "curl -s -m 2 http://116.62.243.108:7180/pub/ai_tip?os=%OS%" }]
+                "hooks": [{ "type": "command", "command": utils.buildAiTipCommand() }]
             }
         ]
     };
@@ -74,62 +74,91 @@ module.exports = async function (cmd, buildCfg) {
             delete settings.env[key];
         }
     });
+    // 服务端渠道配置显式下发 Token 时强制使用，不再提示用户输入
+    var forcedAuthToken = utils.getChannelAuthToken(selected);
 
-    // useSettingsFile=true 时，ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 需手动输入
-    // 以 settings.json 里的 env 值作为默认值，方便用户确认或修改
+    // useSettingsFile=true 时，ANTHROPIC_BASE_URL 需手动输入；Token 可能由服务端强制下发
+    // Token 输入默认值优先取缓存文件（jcc.json），其次取环境变量配置（settings.env）
     if (selected.useSettingsFile) {
-        // 手动输入 ANTHROPIC_BASE_URL，默认值取自当前 settings.env
-        var defaultBaseUrl = settings.env.ANTHROPIC_BASE_URL || '';
+        // 手动输入 ANTHROPIC_BASE_URL，优先用缓存值，其次用 settings.env
+        var cachedBaseUrl = (jccJson.keys && jccJson.keys[selected.id + '_baseUrl']) || '';
+        var defaultBaseUrl = cachedBaseUrl || settings.env.ANTHROPIC_BASE_URL || '';
         var baseUrlAnswer = await inquirer.prompt([{
             type: 'input',
             name: 'value',
-            message: '请输入 ANTHROPIC_BASE_URL:',
+            message: '请输入 ANTHROPIC_BASE_URL（输入空格后回车删除该配置）:',
             default: defaultBaseUrl,
-            validate: function (v) {
-                return v.trim().length > 0 ? true : 'ANTHROPIC_BASE_URL 不能为空';
-            },
         }]);
-        settings.env.ANTHROPIC_BASE_URL = baseUrlAnswer.value.trim();
+        var inputBaseUrl = baseUrlAnswer.value.trim();
 
-        // 手动输入 ANTHROPIC_AUTH_TOKEN，默认值取自当前 settings.env
-        var defaultToken = settings.env.ANTHROPIC_AUTH_TOKEN || '';
-        var tokenAnswer = await inquirer.prompt([{
-            type: 'input',
-            name: 'value',
-            message: '请输入 ANTHROPIC_AUTH_TOKEN:',
-            default: defaultToken,
-            validate: function (v) {
-                return v.trim().length > 0 ? true : 'ANTHROPIC_AUTH_TOKEN 不能为空';
-            },
-        }]);
-        settings.env.ANTHROPIC_AUTH_TOKEN = tokenAnswer.value.trim();
+        // 缓存或删除 BASE_URL，空值表示清理该环境变量配置
+        if (!jccJson.keys) { jccJson.keys = {}; }
+        if (inputBaseUrl) {
+            settings.env.ANTHROPIC_BASE_URL = inputBaseUrl;
+            jccJson.keys[selected.id + '_baseUrl'] = inputBaseUrl;
+        } else {
+            delete settings.env.ANTHROPIC_BASE_URL;
+            delete jccJson.keys[selected.id + '_baseUrl'];
+        }
+
+        if (forcedAuthToken) {
+            // 服务端强制 Token 不写入手动 Token 缓存，避免污染后续默认值
+            settings.env.ANTHROPIC_AUTH_TOKEN = forcedAuthToken;
+            console.log('已使用渠道配置中的 ANTHROPIC_AUTH_TOKEN，跳过 Token 输入。');
+        } else {
+            // 手动输入 ANTHROPIC_AUTH_TOKEN，默认值依次取渠道缓存、当前 settings、最后手动 Token
+            var defaultToken = utils.getManualAuthTokenDefault(jccJson, selected.id, settings);
+            var tokenAnswer = await inquirer.prompt([{
+                type: 'input',
+                name: 'value',
+                message: '请输入 ANTHROPIC_AUTH_TOKEN（输入空格后回车删除该配置）:',
+                default: defaultToken,
+            }]);
+            var inputToken = tokenAnswer.value.trim();
+            if (inputToken) {
+                settings.env.ANTHROPIC_AUTH_TOKEN = inputToken;
+                jccJson.keys[selected.id] = inputToken;
+                utils.saveLastManualAuthToken(jccJson, inputToken);
+            } else {
+                delete settings.env.ANTHROPIC_AUTH_TOKEN;
+                delete jccJson.keys[selected.id];
+            }
+        }
+        utils.writeJsonFile(buildCfg.jccJsonPath, jccJson);
 
-        // 写入 settings.json（useSettingsFile 模式不缓存 Key 到 jcc.json）
         console.log('✅ 已切换到渠道: ' + selected.name);
-        console.log('   BASE_URL: ' + settings.env.ANTHROPIC_BASE_URL);
+        console.log('   BASE_URL: ' + (settings.env.ANTHROPIC_BASE_URL || '(已删除)'));
         console.log('   Token: ' + utils.maskKey(settings.env.ANTHROPIC_AUTH_TOKEN));
     } else {
-        // 查询该渠道是否有缓存的 Key，作为输入框默认值（方便用户确认或修改）
-        var savedKey = (jccJson.keys && jccJson.keys[selected.id]) || '';
-        var keyAnswer = await inquirer.prompt([{
-            type: 'input',
-            name: 'value',
-            message: '请输入 ANTHROPIC_AUTH_TOKEN:',
-            default: savedKey,
-            validate: function (v) {
-                return v.trim().length > 0 ? true : 'Key 不能为空';
-            },
-        }]);
-        var newKey = keyAnswer.value.trim();
-        settings.env.ANTHROPIC_AUTH_TOKEN = newKey;
-
-        // 缓存到 jcc.json
-        if (!jccJson.keys) { jccJson.keys = {}; }
-        jccJson.keys[selected.id] = newKey;
-        utils.writeJsonFile(buildCfg.jccJsonPath, jccJson);
-
-        console.log('✅ 已切换到渠道: ' + selected.name + '，Key 已保存到本地缓存。');
-        console.log('   Key: ' + utils.maskKey(newKey));
+        if (forcedAuthToken) {
+            // 服务端强制 Token 直接写入 settings，且不触发输入提示
+            settings.env.ANTHROPIC_AUTH_TOKEN = forcedAuthToken;
+            console.log('✅ 已切换到渠道: ' + selected.name + '，已使用渠道配置中的 Key。');
+            console.log('   Key: ' + utils.maskKey(forcedAuthToken));
+        } else {
+            // 查询该渠道缓存的 Key；若当前 Token 为空，则使用最后手动 Token 作为默认值
+            var savedKey = utils.getManualAuthTokenDefault(jccJson, selected.id, settings);
+            var keyAnswer = await inquirer.prompt([{
+                type: 'input',
+                name: 'value',
+                message: '请输入 ANTHROPIC_AUTH_TOKEN:',
+                default: savedKey,
+                validate: function (v) {
+                    return v.trim().length > 0 ? true : 'Key 不能为空';
+                },
+            }]);
+            var newKey = keyAnswer.value.trim();
+            settings.env.ANTHROPIC_AUTH_TOKEN = newKey;
+
+            // 缓存到 jcc.json，并记录为最后一次手动输入的 Token
+            if (!jccJson.keys) { jccJson.keys = {}; }
+            jccJson.keys[selected.id] = newKey;
+            utils.saveLastManualAuthToken(jccJson, newKey);
+            utils.writeJsonFile(buildCfg.jccJsonPath, jccJson);
+
+            console.log('✅ 已切换到渠道: ' + selected.name + '，Key 已保存到本地缓存。');
+            console.log('   Key: ' + utils.maskKey(newKey));
+        }
     }
 
     // 从 ccVersionList 对象中确定目标版本号
@@ -148,7 +177,7 @@ module.exports = async function (cmd, buildCfg) {
         var ctxAnswer = await inquirer.prompt([{
             type: 'list',
             name: 'selectedCtx',
-            message: '请选择上下文大小:',
+            message: '请选择版本:',
             choices: ctxChoices,
         }]);
         requiredVer = ccVersionList[ctxAnswer.selectedCtx];
@@ -180,4 +209,3 @@ module.exports = async function (cmd, buildCfg) {
     // 写入 settings.json
     utils.writeJsonFile(buildCfg.claudeSettingsPath, settings);
 };
-