claude360 0.1.0 → 0.2.0

package/src/index.js

@@ -1,22 +1,60 @@
 import readline from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
 import { execFile } from "node:child_process";
+import { createRequire } from "node:module";
 
 import { ApiClient } from "./api-client.js";
 import { authenticateWithBrowser } from "./auth.js";
+import { formatAccountStatus, loadAccountStatus } from "./account-status.js";
+import { renderBanner, formatCheckLine } from "./banner.js";
+import { runCcSwitchGenerator } from "./cc-switch.js";
 import { createConfigStore } from "./config-store.js";
-import { formatDiagnosticsSummary, runDiagnostics as collectDiagnostics } from "./diagnostics.js";
-import { runMainMenu } from "./menu.js";
+import {
+  commandVersion,
+  defaultExecCommand,
+  formatDiagnosticsSummary,
+  runDiagnostics as collectDiagnostics,
+} from "./diagnostics.js";
+import {
+  buildDailyMenu,
+  buildFirstRunMenu,
+  promptMenu,
+} from "./menu.js";
+import {
+  installCodexAgents,
+  installRecommendedMcps,
+  installRecommendedSkills,
+  listInstalledEnhancements,
+} from "./mcp-skill.js";
+import { ensureEnvironment } from "./onboarding.js";
+import { safeErrorMessage } from "./sanitize.js";
 import { installOrUpdateTools as installTools } from "./tool-installer.js";
-import { launchClaudeCode as startClaudeCode, launchCodex as startCodex } from "./tool-launcher.js";
+import {
+  checkCodexCompat,
+  configureCodexProvider,
+  launchClaudeCode as startClaudeCode,
+  launchCodex as startCodex,
+} from "./tool-launcher.js";
 import { runWechatTopUp } from "./topup.js";
-import { chooseOrCreateToken, loadBalance } from "./token-manager.js";
+import { chooseOrCreateToken, createNewToken } from "./token-manager.js";
+
+const DEFAULT_BASE_URL = "https://claude360.xyz";
+
+function readCliVersion() {
+  try {
+    const require = createRequire(import.meta.url);
+    return require("../package.json").version || "";
+  } catch {
+    return "";
+  }
+}
 
 export async function runCli({
   configStore = createConfigStore(),
   createApiClient = (config) => new ApiClient(config),
   authenticateWithBrowser: authWithBrowser = authenticateWithBrowser,
   chooseOrCreateToken: chooseToken = chooseOrCreateToken,
+  createToken = createNewToken,
   promptSelect = defaultPromptSelect,
   promptInput = defaultPromptInput,
   confirm = defaultConfirm,
@@ -24,62 +62,788 @@ export async function runCli({
   installOrUpdateTools = installTools,
   launchClaudeCode = startClaudeCode,
   launchCodex = startCodex,
+  codexCompat = checkCodexCompat,
+  configureCodex = configureCodexProvider,
+  installMcps = installRecommendedMcps,
+  installSkills = installRecommendedSkills,
+  installAgents = installCodexAgents,
+  listEnhancements = listInstalledEnhancements,
+  ccSwitchGenerator = runCcSwitchGenerator,
+  runDiagnostics = collectDiagnostics,
+  execCommand = defaultExecCommand,
   sleep,
   writeLine = console.log,
+  forceSetup = false,
+  command = "",
+  checkEnvironment = ensureEnvironment,
+  showBanner = true,
+  version = readCliVersion(),
 } = {}) {
   let config = await configStore.load();
-  const baseUrl = config.baseUrl || "https://claude360.xyz";
+  const baseUrl = config.baseUrl || DEFAULT_BASE_URL;
   let api = createApiClient({ baseUrl, cliToken: config.cliToken || "" });
 
-  if (!config.cliToken) {
-    const cliToken = await authWithBrowser({ api, openBrowser, sleep });
-    config = { ...config, baseUrl, cliToken };
+  if (showBanner) {
+    writeLine(renderBanner({ version, baseUrl }));
+    await showEnvironmentChecks();
+  }
+
+  // ──────────────────────────────────────────────
+  // 公共动作
+  // ──────────────────────────────────────────────
+
+  async function saveConfig(patch) {
+    config = { ...config, baseUrl, ...patch };
     await configStore.save(config);
+  }
+
+  async function showEnvironmentChecks() {
+    const checks = [];
+    const node = await commandVersion(execCommand, "node", ["--version"]);
+    checks.push({ status: node.ok ? "ok" : "fail", text: node.ok ? `Node.js ${node.version}` : "未检测到 Node.js 18+" });
+    const npm = await commandVersion(execCommand, "npm", ["--version"]);
+    checks.push({ status: npm.ok ? "ok" : "fail", text: npm.ok ? "npm 可用" : "npm 不可用" });
+    try {
+      await api.get("/api/status");
+      checks.push({ status: "ok", text: "Claude360 服务连接成功" });
+    } catch (error) {
+      checks.push({ status: "fail", text: `Claude360 服务连接失败：${safeErrorMessage(error)}` });
+    }
+    checks.push({ status: "ok", text: "本地配置目录正常" });
+    checks.push(config.cliToken
+      ? { status: "ok", text: "已登录 Claude360" }
+      : { status: "warn", text: "尚未登录 Claude360" });
+    writeLine(checks.map((check) => formatCheckLine(check.status, check.text)).join("\n"));
+    writeLine("");
+  }
+
+  async function ensureLogin() {
+    if (config.cliToken) {
+      return true;
+    }
+    // PRD 第 14 章注册入口：CLI 不做注册表单，只提供注册页引导
+    while (true) {
+      const guide = await promptSelect("还没有 Claude360 账号？", [
+        { label: "打开注册页面", value: "register" },
+        { label: "我已注册，继续授权", value: "continue" },
+        { label: "返回", value: "back" },
+      ]);
+      if (guide === "register") {
+        await openPage("/register", "Claude360 注册页面");
+        continue;
+      }
+      if (guide === "back") {
+        return false;
+      }
+      break;
+    }
+    writeLine("请在浏览器中完成 Claude360 授权。");
+    writeLine("如果浏览器没有自动打开，请根据终端提示访问授权页面并输入授权码。");
+    let cliToken;
+    try {
+      cliToken = await authWithBrowser({ api, openBrowser, sleep, writeLine });
+    } catch (error) {
+      if (isAuthServiceUnavailable(error)) {
+        writeLine(formatAuthUnavailable());
+        return false;
+      }
+      throw error;
+    }
+    await saveConfig({ cliToken });
     api = createApiClient({ baseUrl, cliToken });
+    writeLine("✓ 授权成功，登录状态已保存。");
+    return true;
   }
 
-  if (!config.apiKey) {
+  async function ensureApiKey() {
+    if (config.apiKey) {
+      return { apiKey: config.apiKey, tokenName: config.tokenName };
+    }
     const token = await chooseToken({ api, promptSelect, promptInput });
-    config = {
-      ...config,
+    await saveConfig({
       apiKey: token.apiKey,
       selectedTokenId: token.tokenId,
       tokenName: token.tokenName,
       group: token.group,
-    };
+    });
+    return token;
+  }
+
+  async function fetchMe() {
+    try {
+      const me = await api.get("/api/cli/me");
+      // 缓存账号标识，me 获取失败时账户状态区仍可降级展示（脱敏由展示层处理）
+      const account = me?.email || me?.display_name || me?.username || "";
+      if (account && account !== config.account) {
+        await saveConfig({ account });
+      }
+      return me;
+    } catch {
+      return null;
+    }
+  }
+
+  async function showBalanceAndUsage() {
+    const me = await fetchMe();
+    if (!me) {
+      writeLine("暂时无法获取余额与今日用量。");
+      return null;
+    }
+    writeLine(`余额：${me.balance_display ?? me.quota}${me.low_balance ? "  ! 余额较低" : ""}`);
+    writeLine(`今日用量：${me.today_usage_display || "-"}`);
+    return me;
+  }
+
+  async function markConfigured(tool) {
+    await saveConfig({
+      configuredTools: { ...(config.configuredTools || {}), [tool]: true },
+    });
+  }
+
+  async function ensureToolInstalled(target, toolName, command) {
+    const check = await commandVersion(execCommand, command, ["--version"]);
+    if (check.ok) {
+      writeLine(`✓ ${toolName} 已安装（${check.version}）`);
+      return true;
+    }
+    writeLine(`未检测到 ${toolName}。`);
+    const results = await installOrUpdateTools({ targets: [target], confirm });
+    const result = (results || []).find((item) => item.target === target);
+    if (result?.skipped) {
+      writeLine(`已跳过 ${toolName} 安装。`);
+      return false;
+    }
+    if (result?.ok === false) {
+      writeLine(`安装 ${toolName} 失败：${result.error || ""}${result.remediation ? `\n建议：${result.remediation}` : ""}`);
+      writeLine("国内网络失败时可尝试：npx --registry=https://registry.npmmirror.com claude360");
+      return false;
+    }
+    return true;
+  }
+
+  // 启动前检查 + 低余额提醒（PRD 16 / 17.5 / 18.5）
+  async function preflightLaunch(toolName) {
+    const me = await fetchMe();
+    if (!config.apiKey) {
+      writeLine("当前没有可用 API Key，先完成 Key 配置。");
+      await ensureApiKey();
+    }
+    writeLine(`✓ ${toolName} 启动前检查`);
+    writeLine(`✓ 当前 Key：${config.tokenName || "-"}`);
+    if (me) {
+      writeLine(`✓ Claude360 服务可访问`);
+      writeLine(`✓ 余额：${me.balance_display ?? me.quota}`);
+      writeLine(`✓ 今日用量：${me.today_usage_display || "-"}（已刷新）`);
+    } else {
+      writeLine("! Claude360 服务状态获取失败，仍可尝试启动");
+    }
+    if (me?.low_balance) {
+      const action = await promptSelect(
+        `当前余额较低（${me.balance_display}，低于 ${me.low_balance_threshold_display}），可能影响模型调用。`,
+        [
+          { label: "微信扫码充值", value: "topup" },
+          { label: "仍然继续启动", value: "continue" },
+          { label: "返回主菜单", value: "back" },
+        ],
+      );
+      if (action === "topup") {
+        await doWechatTopUp();
+        return true;
+      }
+      return action === "continue";
+    }
+    return true;
+  }
+
+  async function doLaunchClaude() {
+    if (!(await preflightLaunch("Claude Code"))) {
+      return false;
+    }
+    await markConfigured("claudeCode");
+    writeLine("正在启动 Claude Code...");
+    await launchClaudeCode({ config });
+    return true;
+  }
+
+  async function doLaunchCodex() {
+    const compat = await codexCompat(api);
+    if (!compat.supported) {
+      writeLine("当前 Claude360 网关暂不支持 Codex 所需协议。");
+      writeLine("你仍可使用 Claude Code，或稍后更新 Claude360 CLI。");
+      return false;
+    }
+    writeLine("✓ Claude360 已支持 Codex 所需协议");
+    if (!(await preflightLaunch("Codex"))) {
+      return false;
+    }
+    await markConfigured("codex");
+    writeLine("正在启动 Codex...");
+    await launchCodex({ config, confirmConflict: confirm, writeLine });
+    return true;
+  }
+
+  async function doConfigureCodex() {
+    const compat = await codexCompat(api);
+    if (!compat.supported) {
+      writeLine("当前 Claude360 网关暂不支持 Codex 所需协议，已停止写入配置。");
+      return false;
+    }
+    await ensureApiKey();
+    await configureCodex({ config, confirmConflict: confirm, writeLine });
+    await markConfigured("codex");
+    writeLine("✓ 已写入 Codex claude360 provider/profile（~/.codex/config.toml）");
+    return true;
+  }
+
+  async function doWechatTopUp() {
+    try {
+      const result = await runWechatTopUp({ api, promptSelect, promptInput, writeLine, sleep });
+      writeLine("✓ 支付成功");
+      if (result?.balance) {
+        writeLine(`当前余额：${result.balance.balance_display ?? result.balance.quota}`);
+        writeLine(`今日用量：${result.balance.today_usage_display || "-"}`);
+      }
+      return result;
+    } catch (error) {
+      writeLine(`充值未完成：${safeErrorMessage(error)}`);
+      return null;
+    }
+  }
+
+  // 安装或更新工具（含 claude360 CLI 自身），全局 npm 操作由 installOrUpdateTools 二次确认
+  async function runInstallToolsMenu() {
+    const selected = await promptSelect("选择要安装或更新的工具：", [
+      { label: "Claude Code", value: "claude" },
+      { label: "Codex", value: "codex" },
+      { label: "claude360 CLI（自身更新）", value: "claude360" },
+      { label: "Claude Code + Codex", value: "all" },
+      { label: "返回", value: "back" },
+    ]);
+    if (selected === "back") {
+      return;
+    }
+    const targets = selected === "all" ? ["claude", "codex"] : [selected];
+    const results = await installOrUpdateTools({ targets, confirm });
+    for (const result of results || []) {
+      if (result?.skipped) {
+        writeLine(`已跳过 ${result.target}。`);
+        continue;
+      }
+      if (result?.ok === false) {
+        writeLine(`安装或更新 ${result.target} 失败：${result.error || ""}${result.remediation ? `\n建议：${result.remediation}` : ""}`);
+        continue;
+      }
+      writeLine(`✓ ${result.target} 安装或更新完成${result.usedMirror ? "（使用国内镜像）" : ""}`);
+      if (result.target === "claude360") {
+        writeLine("claude360 CLI 已更新，重新运行 npx claude360 后生效。");
+      }
+    }
+  }
+
+  async function openPage(path, label) {
+    const url = `${baseUrl}${path}`;
+    writeLine(`正在打开${label}：${url}`);
+    await openBrowser(url);
+  }
+
+  // 退出登录：仅清除本地凭证，不触碰网站侧账号与 Key（PRD 25.2 logout）
+  async function doLogout() {
+    if (!config.cliToken && !config.apiKey) {
+      writeLine("当前未登录。");
+      return true;
+    }
+    const approved = await confirm(
+      "将退出登录并清除本地保存的 CLI Token 与 API Key。\n不会删除 Claude360 网站上的账号或 API Key。\n是否继续？",
+    );
+    if (!approved) {
+      writeLine("已取消。");
+      return false;
+    }
+    config = { baseUrl };
+    await configStore.save(config);
+    api = createApiClient({ baseUrl, cliToken: "" });
+    writeLine("已退出登录。");
+    return true;
+  }
+
+  async function doRelogin() {
+    const approved = await confirm("将重新进行浏览器授权并覆盖本地登录状态。是否继续？");
+    if (!approved) {
+      return false;
+    }
+    await saveConfig({ cliToken: "" });
+    api = createApiClient({ baseUrl, cliToken: "" });
+    return ensureLogin();
+  }
+
+  async function doClearConfig() {
+    const approved = await confirm(
+      "该操作会清除本地 Claude360 CLI 登录状态和已保存 Key。\n不会删除 Claude360 网站上的账号或 API Key。\n是否继续？",
+    );
+    if (!approved) {
+      writeLine("已取消。");
+      return false;
+    }
+    config = { baseUrl };
     await configStore.save(config);
+    api = createApiClient({ baseUrl, cliToken: "" });
+    writeLine("本地配置已清除。");
+    return ensureLogin();
+  }
+
+  // ──────────────────────────────────────────────
+  // 子菜单
+  // ──────────────────────────────────────────────
+
+  async function runBalanceTopUpMenu() {
+    while (true) {
+      writeLine("余额与充值\n");
+      const me = await showBalanceAndUsage();
+      if (me?.low_balance) {
+        writeLine("状态：余额偏低，建议充值");
+      }
+      const action = await promptSelect("请选择：", [
+        { label: "微信扫码充值", value: "wechat" },
+        { label: "打开网页充值", value: "web" },
+        { label: "返回", value: "back" },
+      ]);
+      if (action === "wechat") {
+        await doWechatTopUp();
+        continue;
+      }
+      if (action === "web") {
+        await openPage("/topup", "网页充值");
+        continue;
+      }
+      return;
+    }
+  }
+
+  async function doCreateKey() {
+    const token = await createToken({ api, promptSelect, promptInput });
+    const useNow = await confirm(`已创建 API Key：${token.tokenName}。是否将其设为当前使用的 Key？`);
+    if (useNow) {
+      await saveConfig({
+        apiKey: token.apiKey,
+        selectedTokenId: token.tokenId,
+        tokenName: token.tokenName,
+        group: token.group,
+      });
+      writeLine(`✓ 当前 Key 已切换为 ${token.tokenName}`);
+    }
+    return token;
   }
 
-  return runMainMenu({
-    promptSelect,
-    config,
-    writeLine,
-    actions: {
-      loadBalance: () => loadBalance(api),
-      runWechatTopUp: () => runWechatTopUp({ api, promptSelect, promptInput, writeLine, sleep }),
-      launchClaudeCode: () => launchClaudeCode({ config }),
-      launchCodex: () => launchCodex({ config, confirmConflict: confirm }),
-      installOrUpdateTools: async () => installOrUpdateTools({
-        targets: await selectToolTargets(promptSelect),
-        confirm,
-      }),
-      switchToken: async () => {
-        const token = await chooseToken({ api, promptSelect, promptInput });
-        config = {
-          ...config,
-          apiKey: token.apiKey,
-          selectedTokenId: token.tokenId,
-          tokenName: token.tokenName,
-          group: token.group,
-        };
-        await configStore.save(config);
-      },
-      runDiagnostics: async () => {
-        const report = await collectDiagnostics({ config, api });
+  async function runClaudeCodeMenu() {
+    while (true) {
+      const action = await promptSelect("Claude Code", [
+        { label: "安装 Claude Code", value: "install" },
+        { label: "更新 Claude Code", value: "update" },
+        { label: "写入 / 修复 Claude360 配置", value: "repair" },
+        { label: "安装推荐 MCP", value: "mcp" },
+        { label: "安装推荐工作流 / Skill", value: "skill" },
+        { label: "启动 Claude Code", value: "launch" },
+        { label: "返回", value: "back" },
+      ]);
+      switch (action) {
+        case "install":
+        case "update":
+          await installOrUpdateTools({ targets: ["claude"], confirm });
+          break;
+        case "repair":
+          await ensureApiKey();
+          await markConfigured("claudeCode");
+          writeLine("✓ Claude Code 通过启动时环境变量注入 Claude360 配置（不修改 shell profile）。");
+          writeLine(`  ANTHROPIC_BASE_URL=${baseUrl}`);
+          writeLine("  ANTHROPIC_AUTH_TOKEN=<当前 API Key>");
+          await showBalanceAndUsage();
+          break;
+        case "mcp":
+          await installMcps({ promptSelect, confirm, writeLine });
+          break;
+        case "skill":
+          await installSkills({ promptSelect, confirm, writeLine });
+          break;
+        case "launch":
+          if (await doLaunchClaude()) {
+            return "launched";
+          }
+          break;
+        default:
+          return "back";
+      }
+    }
+  }
+
+  async function runCodexMenu() {
+    while (true) {
+      const action = await promptSelect("Codex", [
+        { label: "安装 Codex", value: "install" },
+        { label: "更新 Codex", value: "update" },
+        { label: "写入 / 修复 Claude360 Provider", value: "repair" },
+        { label: "安装推荐 AGENTS / Skill", value: "agents" },
+        { label: "启动 Codex", value: "launch" },
+        { label: "返回", value: "back" },
+      ]);
+      switch (action) {
+        case "install":
+        case "update":
+          await installOrUpdateTools({ targets: ["codex"], confirm });
+          break;
+        case "repair":
+          await doConfigureCodex();
+          break;
+        case "agents":
+          await installAgents({ confirm, writeLine });
+          break;
+        case "launch":
+          if (await doLaunchCodex()) {
+            return "launched";
+          }
+          break;
+        default:
+          return "back";
+      }
+    }
+  }
+
+  async function runMcpSkillMenu() {
+    while (true) {
+      const action = await promptSelect("推荐 MCP / Skill", [
+        { label: "为 Claude Code 安装推荐 MCP", value: "mcp" },
+        { label: "为 Claude Code 安装推荐工作流 / Skill", value: "skill" },
+        { label: "为 Codex 安装推荐 AGENTS / Skill", value: "agents" },
+        { label: "查看已安装增强配置", value: "list" },
+        { label: "返回", value: "back" },
+      ]);
+      switch (action) {
+        case "mcp":
+          await installMcps({ promptSelect, confirm, writeLine });
+          break;
+        case "skill":
+          await installSkills({ promptSelect, confirm, writeLine });
+          break;
+        case "agents":
+          await installAgents({ confirm, writeLine });
+          break;
+        case "list":
+          writeLine(await listEnhancements());
+          break;
+        default:
+          return;
+      }
+    }
+  }
+
+  async function runDiagnosticsMenu() {
+    while (true) {
+      const action = await promptSelect("诊断与修复", [
+        { label: "一键诊断", value: "diagnose" },
+        { label: "修复 Claude Code 配置", value: "fix_claude" },
+        { label: "修复 Codex 配置", value: "fix_codex" },
+        { label: "重新创建 / 选择 API Key", value: "rekey" },
+        { label: "清除本地配置并重新登录", value: "reset" },
+        { label: "返回", value: "back" },
+      ]);
+      switch (action) {
+        case "diagnose": {
+          const report = await runDiagnostics({ config, api, execCommand });
+          writeLine(formatDiagnosticsSummary(report));
+          break;
+        }
+        case "fix_claude":
+          await ensureApiKey();
+          await markConfigured("claudeCode");
+          await showBalanceAndUsage();
+          writeLine("✓ Claude Code 配置修复完成（启动时注入环境变量）。");
+          break;
+        case "fix_codex":
+          await doConfigureCodex();
+          break;
+        case "rekey": {
+          const token = await chooseToken({ api, promptSelect, promptInput });
+          await saveConfig({
+            apiKey: token.apiKey,
+            selectedTokenId: token.tokenId,
+            tokenName: token.tokenName,
+            group: token.group,
+          });
+          writeLine(`✓ 当前 Key 已切换为 ${token.tokenName}`);
+          break;
+        }
+        case "reset":
+          if (await doClearConfig()) {
+            return "reset";
+          }
+          break;
+        default:
+          return "back";
+      }
+    }
+  }
+
+  // ──────────────────────────────────────────────
+  // 首次一键配置流程（PRD 第 12 章）
+  // ──────────────────────────────────────────────
+
+  async function runFirstSetup(targets) {
+    if (!(await ensureLogin())) {
+      return false;
+    }
+    await showBalanceAndUsage();
+    await ensureApiKey();
+
+    if (targets.includes("claude")) {
+      if (!(await ensureToolInstalled("claude", "Claude Code", "claude"))) {
+        return false;
+      }
+      await markConfigured("claudeCode");
+      writeLine("✓ Claude Code 将在启动时注入 Claude360 配置。");
+    }
+    if (targets.includes("codex")) {
+      if (!(await ensureToolInstalled("codex", "Codex", "codex"))) {
+        return false;
+      }
+      if (!(await doConfigureCodex())) {
+        return false;
+      }
+    }
+
+    // 可选增强配置，不阻塞主流程
+    if (targets.includes("claude")) {
+      const wantMcp = await promptSelect("是否安装推荐 MCP / Skill？（可跳过）", [
+        { label: "安装推荐 MCP", value: "mcp" },
+        { label: "安装推荐工作流 / Skill", value: "skill" },
+        { label: "跳过", value: "skip" },
+      ]);
+      if (wantMcp === "mcp") {
+        await installMcps({ promptSelect, confirm, writeLine });
+      } else if (wantMcp === "skill") {
+        await installSkills({ promptSelect, confirm, writeLine });
+      }
+    }
+    if (targets.includes("codex")) {
+      const wantAgents = await promptSelect("是否安装 Codex 推荐 AGENTS？（可跳过）", [
+        { label: "安装", value: "agents" },
+        { label: "跳过", value: "skip" },
+      ]);
+      if (wantAgents === "agents") {
+        await installAgents({ confirm, writeLine });
+      }
+    }
+
+    // 测试连接
+    const me = await fetchMe();
+    writeLine(me ? "✓ Claude360 连接测试通过" : "! Claude360 连接测试失败，可稍后在诊断菜单排查");
+
+    // 启动
+    if (targets.length === 1) {
+      const tool = targets[0];
+      const label = tool === "claude" ? "Claude Code" : "Codex";
+      if (await confirm(`配置完成。是否立即启动 ${label}？`)) {
+        return tool === "claude" ? doLaunchClaude() : doLaunchCodex();
+      }
+      return true;
+    }
+    const launch = await promptSelect("配置完成。选择要启动的工具：", [
+      { label: "启动 Claude Code", value: "claude" },
+      { label: "启动 Codex", value: "codex" },
+      { label: "暂不启动", value: "skip" },
+    ]);
+    if (launch === "claude") {
+      return doLaunchClaude();
+    }
+    if (launch === "codex") {
+      return doLaunchCodex();
+    }
+    return true;
+  }
+
+  async function runFirstRunFlow() {
+    if (forceSetup) {
+      try {
+        await checkEnvironment({ writeLine, execCommand });
+      } catch (error) {
+        writeLine(safeErrorMessage(error));
+        return "environment_failed";
+      }
+    }
+    while (true) {
+      const action = await promptMenu({ menu: buildFirstRunMenu(), promptInput, writeLine });
+      switch (action) {
+        case "setup_claude":
+          if (await runFirstSetup(["claude"])) {
+            return "setup_claude";
+          }
+          break;
+        case "setup_codex":
+          if (await runFirstSetup(["codex"])) {
+            return "setup_codex";
+          }
+          break;
+        case "setup_both":
+          if (await runFirstSetup(["claude", "codex"])) {
+            return "setup_both";
+          }
+          break;
+        case "login_only":
+          if (await ensureLogin()) {
+            await showBalanceAndUsage();
+            await ensureApiKey();
+            return runDailyFlow();
+          }
+          break;
+        case "cc_switch":
+          if (await ensureLogin()) {
+            await ccSwitchGenerator({
+              config,
+              promptSelect,
+              writeLine,
+              ensureApiKey,
+            });
+          }
+          break;
+        case "open_register":
+          await openPage("/register", "Claude360 注册 / 登录页面");
+          break;
+        default:
+          return "exit";
+      }
+      if (config.cliToken && action !== "cc_switch" && action !== "open_register") {
+        return runDailyFlow();
+      }
+    }
+  }
+
+  // ──────────────────────────────────────────────
+  // 日常菜单循环（PRD 第 11 章）
+  // ──────────────────────────────────────────────
+
+  async function runDailyFlow() {
+    while (true) {
+      const status = await loadAccountStatus({ api, config });
+      writeLine(formatAccountStatus(status));
+      writeLine("");
+      const action = await promptMenu({ menu: buildDailyMenu(), promptInput, writeLine });
+      switch (action) {
+        case "launch_claude":
+          if (await doLaunchClaude()) {
+            return action;
+          }
+          break;
+        case "launch_codex":
+          if (await doLaunchCodex()) {
+            return action;
+          }
+          break;
+        case "balance_topup":
+          await runBalanceTopUpMenu();
+          break;
+        case "create_key":
+          await doCreateKey();
+          break;
+        case "open_console":
+          await openPage("/console", "Claude360 控制台");
+          break;
+        case "claude_code_menu":
+          if ((await runClaudeCodeMenu()) === "launched") {
+            return action;
+          }
+          break;
+        case "codex_menu":
+          if ((await runCodexMenu()) === "launched") {
+            return action;
+          }
+          break;
+        case "mcp_skill":
+          await runMcpSkillMenu();
+          break;
+        case "cc_switch":
+          await ccSwitchGenerator({
+            config,
+            promptSelect,
+            writeLine,
+            ensureApiKey,
+          });
+          break;
+        case "diagnostics_menu":
+          await runDiagnosticsMenu();
+          break;
+        case "install_tools":
+          await runInstallToolsMenu();
+          break;
+        case "relogin":
+          await doRelogin();
+          break;
+        default:
+          return "exit";
+      }
+    }
+  }
+
+  // ──────────────────────────────────────────────
+  // 快捷命令直达（PRD 25.2，可选增强）
+  // ──────────────────────────────────────────────
+
+  async function runShortcut(name) {
+    switch (name) {
+      case "claude":
+        if (!(await ensureLogin())) {
+          return "login_required";
+        }
+        return (await doLaunchClaude()) ? "launch_claude" : "launch_cancelled";
+      case "codex":
+        if (!(await ensureLogin())) {
+          return "login_required";
+        }
+        return (await doLaunchCodex()) ? "launch_codex" : "launch_cancelled";
+      case "cc-switch":
+        if (!(await ensureLogin())) {
+          return "login_required";
+        }
+        await ccSwitchGenerator({ config, promptSelect, writeLine, ensureApiKey });
+        return "cc_switch";
+      case "doctor": {
+        const report = await runDiagnostics({ config, api, execCommand });
         writeLine(formatDiagnosticsSummary(report));
-      },
-    },
-  });
+        return "doctor";
+      }
+      case "login":
+        if (config.cliToken) {
+          return (await doRelogin()) ? "login" : "login_cancelled";
+        }
+        return (await ensureLogin()) ? "login" : "login_cancelled";
+      case "logout":
+        return (await doLogout()) ? "logout" : "logout_cancelled";
+      default:
+        writeLine(formatCliUsage());
+        return "unknown_command";
+    }
+  }
+
+  if (command && command !== "setup") {
+    return runShortcut(command);
+  }
+
+  if (forceSetup || !config.cliToken) {
+    return runFirstRunFlow();
+  }
+  return runDailyFlow();
+}
+
+function formatCliUsage() {
+  return [
+    "用法：npx claude360 [命令]",
+    "",
+    "（无命令）  进入交互式菜单",
+    "setup       重新运行首次配置向导",
+    "claude      启动 Claude Code",
+    "codex       启动 Codex",
+    "cc-switch   生成 cc-switch 配置",
+    "doctor      一键诊断",
+    "login       浏览器授权登录",
+    "logout      退出登录并清除本地凭证",
+  ].join("\n");
 }
 
 async function defaultPromptSelect(message, choices) {
@@ -124,24 +888,6 @@ function writeChoices(message, choices) {
   });
 }
 
-async function selectToolTargets(promptSelect) {
-  const selected = await promptSelect("选择安装或更新目标", [
-    { label: "仅 Claude Code", value: "claude" },
-    { label: "仅 Codex", value: "codex" },
-    { label: "Claude Code 和 Codex", value: "all" },
-  ]);
-  if (selected === "claude") {
-    return ["claude360", "claude"];
-  }
-  if (selected === "codex") {
-    return ["claude360", "codex"];
-  }
-  if (selected === "all") {
-    return ["claude360", "claude", "codex"];
-  }
-  throw new Error("安装或更新目标无效");
-}
-
 function defaultOpenBrowser(url) {
   const commands = {
     win32: ["cmd", ["/c", "start", "", url]],
@@ -158,3 +904,22 @@ function defaultOpenBrowser(url) {
     child.on("close", () => resolve());
   });
 }
+
+function isAuthServiceUnavailable(error) {
+  if (!error) {
+    return false;
+  }
+  const status = error.status;
+  if (status === 404 || (typeof status === "number" && status >= 500)) {
+    return true;
+  }
+  return /fetch failed|ENOTFOUND|ECONNREFUSED|ECONNRESET|ETIMEDOUT|EAI_AGAIN|getaddrinfo|network/i.test(error.message || "");
+}
+
+function formatAuthUnavailable() {
+  return [
+    "站点 CLI 授权服务暂未就绪（授权接口返回 404 或网络不可达）。",
+    "已安装的工具不受影响；待授权服务可用后，运行 `claude360 setup` 重新完成授权与 API Key 配置。",
+    "可稍后重试，或先检查网络连接与站点状态。",
+  ].join("\n");
+}