claude360 0.2.5 → 0.2.6

package/README.md

@@ -115,25 +115,37 @@ claude360
 
 ## 日常使用
 
+主菜单按分组展示，TTY 环境下用 **方向键 + Enter** 选择（Esc 返回）；非 TTY / CI 环境自动降级为编号输入，编号以实际输出为准：
+
 ```
-Claude360
-1. 查看余额
-2. 微信扫码充值
-3. 启动 Claude Code
-4. 启动 Codex
-5. 安装或更新工具
-6. 切换 API Key / 分组
-7. 诊断
-8. 退出
+请选择功能：
+─── 常用操作 ───
+❯ 启动 Claude Code        使用 Claude360 接入配置直接启动
+  启动 Codex              使用 Claude360 接入配置直接启动
+─── 账户与充值 ───
+  余额与充值              查看余额用量，支持微信扫码充值
+  切换 Key / 模型         切换当前 API Key 或默认模型
+  创建新的 API Key        在当前账号下新建一个 API Key
+  打开 Claude360 控制台   在浏览器中打开网页控制台
+─── Key / 模型 / MCP 配置 ───
+  Claude Code 配置        完整初始化、工作流、MCP、模型与记忆配置
+  Codex 配置              完整初始化、Provider、工作流与 MCP 配置
+  一键完整初始化          Claude Code / Codex 完整初始化向导
+  推荐 MCP / Skill        安装推荐的 MCP、工作流与 Skill 增强
+  生成 cc-switch 配置     生成可导入 cc-switch 的供应商配置
+─── 维护与设置 ───
+  安装或更新工具          安装或升级 Claude Code / Codex / 本 CLI
+  诊断与修复              一键诊断环境与配置问题并尝试修复
+  重新登录                清除本地登录态后重新浏览器授权
+  退出                    退出 claude360 CLI
 ```
 
-- **查看余额**：调用 `GET /api/cli/me`，展示账号、余额、已用、当前 Key 名称与分组。
-- **微信扫码充值**：先取 `/api/cli/topup/options`，按后端校验通过的金额或最低额提交，再用 `qrcode-terminal` 在终端渲染 `code_url`，渲染失败时降级为纯文本 URL。轮询 `/api/cli/topup/order?order_id=`，支付完成自动刷新余额。
+- **余额与充值**：调用 `GET /api/cli/me`，展示账号、余额、已用、当前 Key 名称与分组；充值先取 `/api/cli/topup/options`，按后端校验通过的金额或最低额提交，再用 `qrcode-terminal` 在终端渲染 `code_url`，渲染失败时降级为纯文本 URL。轮询 `/api/cli/topup/order?order_id=`，支付完成自动刷新余额。
 - **启动 Claude Code**：调用 `claude` 子进程，并通过 `ANTHROPIC_BASE_URL` + `ANTHROPIC_AUTH_TOKEN` 注入。
 - **启动 Codex**：写入 `~/.codex/config.toml` 中 `[model_providers.claude360]` 与 `[profiles.claude360]`，发现既有冲突字段会先要求用户确认再覆盖，然后 `codex --profile claude360`，并通过 `CLAUDE360_API_KEY` 注入。
 - **安装或更新工具**：三选一菜单（仅 Claude Code / 仅 Codex / 两者），每步都需要确认。
-- **切换 API Key / 分组**：重新进入 Token 向导。
-- **诊断**：见下方“诊断与故障排查”。
+- **切换 Key / 模型**：重新进入 Token 向导，或从 `/api/cli/models` 拉取真实模型列表选择默认模型。
+- **诊断与修复**：见下方“诊断与故障排查”。
 
 ## 本地配置
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude360",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Interactive Claude360 CLI for browser auth, API key setup, balance checks, top-up, Claude Code and Codex launch.",
   "type": "module",
   "bin": {

package/src/index.js

@@ -127,6 +127,9 @@ export async function runCli({
     }
   }
   multiSelectInput = multiSelectInput || promptMultiSelect;
+  // 覆盖 ~/.codex/config.toml 冲突字段属于危险操作：默认 NO，
+  // 交互模式下 NO 使用危险色高亮（审查 P2-3）
+  const confirmDanger = (message) => confirm(message, { danger: true });
 
   if (showBanner) {
     if (fancyOutput) {
@@ -497,7 +500,7 @@ export async function runCli({
       installWorkflows: () => installCodexWfs({ codexDir, multiSelect, confirm, writeLine }),
       configureProvider: async () => {
         await ensureApiKey();
-        await configureCodex({ config, confirmConflict: confirm, writeLine });
+        await configureCodex({ config, confirmConflict: confirmDanger, writeLine });
         await markConfigured("codex");
         writeLine("✓ 已写入 Codex claude360 provider/profile（~/.codex/config.toml）");
       },
@@ -640,7 +643,7 @@ export async function runCli({
     }
     await markConfigured("codex");
     writeLine("正在启动 Codex...");
-    await launchCodex({ config, confirmConflict: confirm, writeLine });
+    await launchCodex({ config, confirmConflict: confirmDanger, writeLine });
     return true;
   }
 
@@ -651,7 +654,7 @@ export async function runCli({
       return false;
     }
     await ensureApiKey();
-    await configureCodex({ config, confirmConflict: confirm, writeLine });
+    await configureCodex({ config, confirmConflict: confirmDanger, writeLine });
     await markConfigured("codex");
     writeLine("✓ 已写入 Codex claude360 provider/profile（~/.codex/config.toml）");
     return true;

package/src/init-config.js

@@ -205,7 +205,8 @@ export const FALLBACK_CLAUDE_ALIASES = [
 ];
 
 // 后端接口 GET /api/cli/models?tool=<claude_code|codex>：
-// { models: [{ id, display_name, description, tags, recommended, context_length }] }
+// { models: [{ id, display_name, description, tags, recommended }] }
+// （后端暂无上下文长度数据源，契约中不含 context_length）
 export async function loadAvailableModels(api, tool = "") {
   if (api && typeof api.get === "function") {
     try {

package/src/mcp-skill.js

@@ -78,16 +78,24 @@ export function resolveClaudeJsonPath({ homedir = os.homedir } = {}) {
   return path.join(homedir(), ".claude.json");
 }
 
-// 远程 MCP 项必须带完整安装信息才可用，避免脏数据进入安装流程
-function isValidRemoteMcp(mcp) {
-  return Boolean(
-    mcp
-    && typeof mcp.id === "string" && mcp.id !== ""
-    && typeof mcp.label === "string" && mcp.label !== ""
-    && Array.isArray(mcp.claudeArgs) && mcp.claudeArgs.length > 0
-    && mcp.codex && typeof mcp.codex.command === "string"
-    && Array.isArray(mcp.codex.args),
-  );
+// 安全边界：远程接口只允许下发展示层元数据（label / desc / recommended /
+// platforms），安装命令（claudeArgs / codex）必须来自 CLI 内置受信清单；
+// 未知 id 直接丢弃，防止后端被攻破或响应被篡改时执行任意命令。
+export function normalizeRemoteMcp(mcp) {
+  if (!mcp || typeof mcp.id !== "string") {
+    return null;
+  }
+  const builtin = RECOMMENDED_MCPS.find((item) => item.id === mcp.id);
+  if (!builtin) {
+    return null;
+  }
+  return {
+    ...builtin,
+    label: typeof mcp.label === "string" && mcp.label !== "" ? mcp.label : builtin.label,
+    desc: typeof mcp.desc === "string" ? mcp.desc : builtin.desc,
+    recommended: Boolean(mcp.recommended ?? builtin.recommended),
+    platforms: typeof mcp.platforms === "string" ? mcp.platforms : builtin.platforms,
+  };
 }
 
 // MCP 列表远程优先（优化需求第 4 节）：GET /api/cli/mcps 返回
@@ -97,7 +105,9 @@ export async function loadRecommendedMcps(api) {
   if (api && typeof api.get === "function") {
     try {
       const data = await api.get("/api/cli/mcps");
-      const mcps = (Array.isArray(data?.mcps) ? data.mcps : []).filter(isValidRemoteMcp);
+      const mcps = (Array.isArray(data?.mcps) ? data.mcps : [])
+        .map(normalizeRemoteMcp)
+        .filter(Boolean);
       if (mcps.length > 0) {
         return { mcps, source: "remote" };
       }

package/src/prompts.js

@@ -35,6 +35,10 @@ export function isInteractive(stream = process.stdout) {
   if (process.env.CI) {
     return false;
   }
+  // TERM=dumb 的终端可能是 TTY，但不支持方向键 UI 与 ANSI 光标控制
+  if (process.env.TERM === "dumb") {
+    return false;
+  }
   return Boolean(stream && stream.isTTY && process.stdin.isTTY);
 }
 
@@ -62,12 +66,28 @@ export function renderConfirmLine(yesActive, { color = true, danger = false } =
 
 const PAGE_SIZE = 14;
 
+// 防御：调用方传入空列表或全部为分隔行时，方向键取模运算会得到 NaN 或
+// 进入同步死循环，回车会访问 undefined.value。统一在渲染前抛出可读错误。
+function getSelectableIndexes(choices = []) {
+  return choices
+    .map((choice, index) => (choice && !choice.separator ? index : -1))
+    .filter((index) => index >= 0);
+}
+
+function assertSelectableChoices(message, choices) {
+  const indexes = getSelectableIndexes(choices);
+  if (indexes.length === 0) {
+    throw new Error(`${message || "选择列表"}缺少可选择项`);
+  }
+  return indexes;
+}
+
 // 单选：方向键移动（跳过分隔行）、回车确认、Esc 返回 escValue
 export const interactiveSelect = createPrompt((config, done) => {
-  const { message, choices, escValue, color = true } = config;
+  const { message, choices = [], escValue, color = true } = config;
+  const selectable = assertSelectableChoices(message, choices);
   const [status, setStatus] = useState("idle");
-  const firstIndex = choices.findIndex((choice) => !choice.separator);
-  const [active, setActive] = useState(Math.max(firstIndex, 0));
+  const [active, setActive] = useState(selectable[0]);
 
   useKeypress((key) => {
     if (status === "done") {
@@ -79,12 +99,9 @@ export const interactiveSelect = createPrompt((config, done) => {
       return;
     }
     if (isUpKey(key) || isDownKey(key)) {
-      const direction = isUpKey(key) ? -1 : 1;
-      let next = active;
-      do {
-        next = (next + direction + choices.length) % choices.length;
-      } while (choices[next].separator);
-      setActive(next);
+      const delta = isUpKey(key) ? -1 : 1;
+      const pos = selectable.indexOf(active);
+      setActive(selectable[(pos + delta + selectable.length) % selectable.length]);
       return;
     }
     if (key.name === "escape" && escValue !== undefined) {
@@ -119,7 +136,10 @@ export const interactiveSelect = createPrompt((config, done) => {
 
 // 多选：空格选择/取消、a 全选、i 反选、回车确认、Esc 取消（需求第 4 节）
 export const interactiveMultiSelect = createPrompt((config, done) => {
-  const { message, choices, preselected = [], color = true } = config;
+  const { message, choices = [], preselected = [], color = true } = config;
+  if (choices.length === 0) {
+    throw new Error(`${message || "多选列表"}缺少可选择项`);
+  }
   const [status, setStatus] = useState("idle");
   const [active, setActive] = useState(0);
   const [selected, setSelected] = useState(

package/src/ui.js

@@ -192,15 +192,16 @@ export function renderBox(message, { kind = "info", color = false, width = 0 } =
   return lines.join("\n");
 }
 
-// 模型表（优化需求第 3 节）：展示后端返回的真实模型信息
+// 模型表（优化需求第 3 节）：展示后端返回的真实模型信息。
+// 字段契约与 /api/cli/models 对齐：id / display_name / tags / description；
+// 后端暂无上下文长度数据源，不渲染“上下文”列，名称列回退模型 ID。
 export function renderModelTable(models = [], { color = false, width = 0 } = {}) {
   return renderTable({
-    head: ["模型 ID", "名称", "标签", "上下文", "说明"],
+    head: ["模型 ID", "名称", "标签", "说明"],
     rows: models.map((model) => [
       model.id ?? "-",
-      model.display_name || "-",
+      model.display_name || model.id || "-",
       Array.isArray(model.tags) && model.tags.length > 0 ? model.tags.join(",") : "-",
-      model.context_length ? String(model.context_length) : "-",
       model.description || "-",
     ]),
   }, { color, width });