@laivc/laicode 0.1.0 → 0.2.1

package/bin/laicode.js

@@ -6,8 +6,17 @@ const os = require("os")
 const path = require("path")
 const readline = require("readline")
 const { spawn } = require("child_process")
-
-const VERSION = "0.1.0"
+const {
+  applyInitPlan,
+  applyToolActionPlan,
+  buildInitPlan,
+  buildToolActionPlan,
+  detectTools,
+  rollbackLatest,
+  safePlan,
+} = require("../lib/adapters")
+
+const VERSION = "0.2.1"
 const DEFAULT_SITE_BASE = "https://lai.vc"
 const DEFAULT_API_BASE = "https://api.lai.vc/v1"
 const STATE_DIR = process.env.LAICODE_HOME || path.join(os.homedir(), ".laicode")
@@ -15,6 +24,9 @@ const CONFIG_FILE = path.join(STATE_DIR, "config.json")
 const DASHBOARD_CACHE_TTL_MS = 60_000
 
 const COMMAND_SPECS = [
+  { name: "tools", usage: "laicode tools [scan|install|uninstall|reinstall|configure] [--tool codex] [--apply] [--json]", summary: "AI 工具体检、安装、配置和维护", flags: ["scan", "install", "uninstall", "reinstall", "configure", "--tool", "--apply", "--json"] },
+  { name: "init", usage: "laicode init [--tool codex] [--apply] [--json]", summary: "预览或应用一键接入计划", flags: ["--tool", "--model", "--apply", "--json"] },
+  { name: "rollback", usage: "laicode rollback [--json]", summary: "回滚最近一次接入写入", flags: ["--json"] },
   { name: "menu", usage: "laicode menu", summary: "打开交互控制台", flags: ["--fancy"] },
   { name: "brand", usage: "laicode brand", summary: "预览终端字标和品牌色板", flags: ["--color", "--plain"] },
   { name: "status", usage: "laicode status [--refresh] [--json]", summary: "查看实时驾驶舱状态", flags: ["--refresh", "--json"] },
@@ -39,6 +51,7 @@ const ENV_VARS = [
   ["LAICODE_SITE_URL", "覆盖主站地址，默认 https://lai.vc"],
   ["LAICODE_PLAIN", "设为 1 时禁用终端样式"],
   ["LAICODE_COLOR", "设为 1 时忽略 NO_COLOR，强制彩色输出"],
+  ["LAICODE_NO_SPINNER", "设为 1 时禁用 loading 动画"],
 ]
 
 function buildHelp() {
@@ -128,6 +141,7 @@ const VALUE_FLAGS = new Set([
   "name",
   "id",
   "shell",
+  "tool",
 ])
 
 function parseArgs(argv) {
@@ -225,7 +239,111 @@ function compareVersions(a, b) {
   return 0
 }
 
+let activeSpinnerCleanup = null
+
+function spinnerEnabled(opts = {}) {
+  if (opts.enabled === false) return false
+  if (!process.stdout.isTTY) return false
+  if (process.env.LAICODE_NO_SPINNER === "1") return false
+  if (process.env.CI === "1" || process.env.CI === "true") return false
+  if (process.env.TERM === "dumb") return false
+  return true
+}
+
+function createSpinner(label, opts = {}) {
+  const enabled = spinnerEnabled(opts)
+  const frames = plainMode() ? ["-", "\\", "|", "/"] : ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
+  const intervalMs = Number(opts.intervalMs || 80)
+  const delayMs = Number(opts.delayMs ?? 120)
+  let text = label
+  let frame = 0
+  let active = false
+  let visible = false
+  let interval = null
+  let delay = null
+
+  const clear = () => {
+    readline.clearLine(process.stdout, 0)
+    readline.cursorTo(process.stdout, 0)
+  }
+
+  const paint = () => {
+    if (!active || !enabled) return
+    clear()
+    const glyph = frames[frame % frames.length]
+    frame += 1
+    process.stdout.write(`${ui.accent(glyph)} ${ui.dim(text)}`)
+  }
+
+  const show = () => {
+    if (!active || visible || !enabled) return
+    visible = true
+    activeSpinnerCleanup = () => spinner.stop()
+    paint()
+    interval = setInterval(paint, intervalMs)
+    if (interval.unref) interval.unref()
+  }
+
+  const spinner = {
+    get enabled() {
+      return enabled
+    },
+    start() {
+      if (!enabled || active) return this
+      active = true
+      if (delayMs > 0) {
+        delay = setTimeout(show, delayMs)
+        if (delay.unref) delay.unref()
+      } else {
+        show()
+      }
+      return this
+    },
+    update(nextText) {
+      if (nextText) text = nextText
+      if (visible) paint()
+      return this
+    },
+    stop(finalText) {
+      if (!enabled || !active) return this
+      active = false
+      if (delay) clearTimeout(delay)
+      if (interval) clearInterval(interval)
+      delay = null
+      interval = null
+      if (activeSpinnerCleanup) activeSpinnerCleanup = null
+      if (visible) clear()
+      visible = false
+      if (finalText) process.stdout.write(`${finalText}\n`)
+      return this
+    },
+    succeed(finalText) {
+      return this.stop(finalText ? `${ui.ok("✓")} ${finalText}` : "")
+    },
+    fail(finalText) {
+      return this.stop(finalText ? `${ui.err("×")} ${finalText}` : "")
+    },
+  }
+
+  return spinner
+}
+
+async function withSpinner(label, work, opts = {}) {
+  const spinner = createSpinner(label, opts).start()
+  try {
+    const result = await work(spinner)
+    if (opts.successText) spinner.succeed(opts.successText)
+    else spinner.stop()
+    return result
+  } catch (err) {
+    if (opts.failureText) spinner.fail(opts.failureText)
+    else spinner.stop()
+    throw err
+  }
+}
+
 function die(message, code = 1) {
+  if (activeSpinnerCleanup) activeSpinnerCleanup()
   console.error(message)
   process.exit(code)
 }
@@ -467,6 +585,229 @@ function cmdCommands(args = {}) {
   )
 }
 
+function supportLabel(value) {
+  if (value === "auto") return ui.ok("可自动接入")
+  if (value === "auto-new") return ui.ok("可创建配置")
+  if (value === "manual-merge") return ui.warn("需合并")
+  if (value === "blocked") return ui.warn("待网关")
+  return ui.dim("指引")
+}
+
+async function cmdTools(args = {}) {
+  const action = args._[1] || "scan"
+  if (action === "configure") {
+    return await cmdInit({ ...args, _: ["init"], tool: args.tool || args._[2] || "codex" })
+  }
+  if (["install", "uninstall", "reinstall"].includes(action)) {
+    return await cmdToolAction(action, args)
+  }
+  if (action !== "scan" && action !== "list") {
+    die("Usage: laicode tools [scan|install|uninstall|reinstall|configure] [--tool codex]")
+  }
+
+  const tools = await withSpinner("扫描本机 AI 工具", () => Promise.resolve(detectTools()), {
+    enabled: !args.json,
+    delayMs: 80,
+  })
+
+  if (args.json) {
+    console.log(JSON.stringify({ tools }, null, 2))
+    return
+  }
+
+  printHero("AI 工具体检")
+  printTable(
+    "接入状态",
+    [
+      { key: "name", label: "工具", width: 12, max: 18 },
+      { key: "detected", label: "检测", width: 6 },
+      { key: "support", label: "能力", width: 12, max: 18 },
+      { key: "status", label: "状态", width: 22, max: 36 },
+      { key: "next", label: "下一步", width: 28, max: 44 },
+    ],
+    tools.map((tool) => ({
+      name: tool.name,
+      detected: tool.detected ? ui.ok("发现") : ui.dim("未见"),
+      support: supportLabel(tool.support),
+      status: tool.status,
+      next: tool.next,
+    }))
+  )
+}
+
+function printToolActionPlan(plan) {
+  printHero("AI 工具维护")
+  printPanel("动作", [
+    `工具     ${plan.tool}`,
+    `动作     ${plan.action}`,
+    `模式     ${plan.mode}`,
+    `状态     ${plan.ok ? "可执行" : "不可执行"}`,
+    `说明     ${plan.summary || plan.reason || "-"}`,
+  ])
+
+  if (plan.commands?.length) {
+    console.log("")
+    printPanel("将执行的命令", plan.commands.map((command) => command.display))
+  }
+  if (plan.warnings?.length) {
+    console.log("")
+    printPanel("注意", plan.warnings)
+  }
+  if (plan.postSteps?.length) {
+    console.log("")
+    printPanel("后续", plan.postSteps)
+  }
+  if (!plan.ok && plan.reason) console.log(ui.warn(plan.reason))
+  else console.log(ui.dim(`执行命令: laicode tools ${plan.action} --tool ${plan.tool} --apply`))
+}
+
+async function cmdToolAction(action, args = {}) {
+  const tool = args.tool || args._[2] || "codex"
+  const apply = Boolean(args.apply)
+  const plan = buildToolActionPlan(tool, action, { env: process.env })
+
+  if (args.json && !apply) {
+    console.log(JSON.stringify({ apply, plan }, null, 2))
+    return
+  }
+
+  if (!args.json) printToolActionPlan(plan)
+  if (!apply) return
+  if (!plan.ok) die(plan.reason || "当前动作不可执行。")
+
+  const result = await withSpinner(
+    `执行 ${plan.tool} ${plan.action}`,
+    () => applyToolActionPlan(plan, { stdio: args.json ? "pipe" : "inherit" }),
+    {
+      enabled: !args.json,
+      delayMs: 80,
+    }
+  )
+  if (args.json) {
+    console.log(JSON.stringify({ apply, plan, result }, null, 2))
+    return
+  }
+  console.log("")
+  printPanel("已完成", [
+    `工具     ${result.tool}`,
+    `动作     ${result.action}`,
+    `命令数   ${result.commands.length}`,
+    ...(result.postSteps || []),
+  ])
+}
+
+function printInitPlan(plan, safe) {
+  printHero(plan.ok ? "接入计划" : "接入指引")
+  printPanel("目标", [
+    `工具     ${plan.tool}`,
+    `模式     ${plan.mode}`,
+    `模型     ${plan.model || "-"}`,
+    `网关     ${plan.apiBaseUrl || apiBase({})}`,
+    `说明     ${plan.summary || plan.reason || "-"}`,
+  ])
+
+  if (safe.operations?.length) {
+    console.log("")
+    printTable(
+      "将写入的文件",
+      [
+        { key: "action", label: "动作", width: 8 },
+        { key: "path", label: "路径", width: 42, max: 72 },
+        { key: "exists", label: "现状", width: 8 },
+      ],
+      safe.operations.map((op) => ({
+        action: op.action,
+        path: op.path,
+        exists: op.exists ? ui.warn("覆盖") : ui.ok("新建"),
+      }))
+    )
+    console.log("")
+    for (const op of safe.operations) {
+      console.log(ui.bold(op.description || op.path))
+      console.log(ui.dim(op.path))
+      console.log("```")
+      console.log(op.preview.trimEnd())
+      console.log("```")
+    }
+    console.log("")
+    console.log(ui.dim("应用命令: laicode init --tool " + plan.tool + " --apply"))
+    if (plan.runCommand) console.log(ui.dim("使用命令: " + plan.runCommand))
+    return
+  }
+
+  if (plan.instructions?.length) {
+    printPanel("手动接入步骤", plan.instructions.map((item, index) => `${index + 1}. ${item}`))
+  }
+}
+
+async function cmdInit(args = {}) {
+  let cfg = await readConfig()
+  const tool = args.tool || args._[1] || "codex"
+  const apply = Boolean(args.apply)
+  const model = args.model || cfg.defaultModel || "gpt-5.5"
+
+  let key = cfg.apiKey
+  if (apply && !key && cfg.accessToken) {
+    key = await withSpinner("准备 API Key", () => ensureApiKey(cfg), { enabled: !args.json, delayMs: 80 })
+    cfg = await readConfig()
+  }
+  if (apply && !key) die("未找到 API Key。请先运行 `laicode login` 或 `laicode config set api-key sk-...`。")
+
+  const plan = buildInitPlan(tool, {
+    apiBaseUrl: apiBase(cfg),
+    apiKey: apply ? key : key || "sk-preview-only",
+    commandName: "laicode",
+    env: process.env,
+    model,
+  })
+  const safe = safePlan(plan, [key, cfg.apiKey].filter(Boolean))
+
+  if (args.json && !apply) {
+    console.log(JSON.stringify({ apply, plan: safe }, null, 2))
+    return
+  }
+
+  if (!args.json) printInitPlan(plan, safe)
+  if (!apply) return
+  if (!plan.ok) die(plan.reason || "当前工具暂不能自动接入。")
+
+  const manifest = await withSpinner("写入接入配置并创建备份", () => applyInitPlan(plan, { stateDir: STATE_DIR }), {
+    enabled: !args.json,
+    delayMs: 80,
+  })
+  if (args.json) {
+    console.log(JSON.stringify({ apply, plan: safe, result: manifest }, null, 2))
+    return
+  }
+  console.log("")
+  printPanel("已应用", [
+    `工具     ${manifest.tool}`,
+    `备份     ${manifest.id}`,
+    `文件     ${manifest.operations.map((op) => op.path).join(", ")}`,
+    plan.runCommand ? `使用     ${plan.runCommand}` : "使用     打开目标工具验证",
+  ])
+}
+
+async function cmdRollback(args = {}) {
+  const manifest = await withSpinner("查找最近一次备份", () => rollbackLatest({ stateDir: STATE_DIR }), {
+    enabled: !args.json,
+    delayMs: 80,
+  })
+  if (args.json) {
+    console.log(JSON.stringify({ ok: Boolean(manifest), rollback: manifest || null }, null, 2))
+    return
+  }
+  if (!manifest) {
+    console.log("没有可回滚的 Laicode 接入备份。")
+    return
+  }
+  printPanel("已回滚", [
+    `工具     ${manifest.tool}`,
+    `备份     ${manifest.id}`,
+    `文件     ${manifest.operations.map((op) => op.path).join(", ")}`,
+  ])
+}
+
 function printHero(subtitle = "Lai.vc 中转控制台") {
   console.clear()
   printBrandMark()
@@ -1100,10 +1441,15 @@ function statusPayload(cfg, snapshot) {
 
 async function cmdStatus(args = {}) {
   const cfg = await readConfig()
-  const snapshot = await dashboardSnapshot(cfg, {
-    refresh: args.refresh,
-    ttlMs: args.refresh ? 0 : DASHBOARD_CACHE_TTL_MS,
-  })
+  const snapshot = await withSpinner(
+    args.refresh ? "刷新驾驶舱快照" : "同步驾驶舱快照",
+    () =>
+      dashboardSnapshot(cfg, {
+        refresh: args.refresh,
+        ttlMs: args.refresh ? 0 : DASHBOARD_CACHE_TTL_MS,
+      }),
+    { enabled: !args.json }
+  )
   const next = await readConfig()
 
   if (args.json) {
@@ -1141,21 +1487,34 @@ async function chatCompletion(cfg, messages, opts = {}) {
   const started = Date.now()
   let firstTokenAt = 0
   let content = ""
-  const res = await fetch(`${apiBase(cfg)}/chat/completions`, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${key}`,
-    },
-    body: JSON.stringify({
-      model,
-      messages,
-      stream: opts.stream !== false,
-      temperature: opts.temperature == null ? 0.2 : Number(opts.temperature),
-    }),
-  })
+  let prefixWritten = false
+  const loading =
+    opts.print !== false && opts.loadingText
+      ? createSpinner(opts.loadingText, { delayMs: opts.loadingDelayMs ?? 80 }).start()
+      : null
+
+  let res
+  try {
+    res = await fetch(`${apiBase(cfg)}/chat/completions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${key}`,
+      },
+      body: JSON.stringify({
+        model,
+        messages,
+        stream: opts.stream !== false,
+        temperature: opts.temperature == null ? 0.2 : Number(opts.temperature),
+      }),
+    })
+  } catch (err) {
+    if (loading) loading.stop()
+    throw err
+  }
 
   if (!res.ok) {
+    if (loading) loading.stop()
     const data = await readJsonResponse(res)
     const msg = data.error?.message || data.error || data.message || `${res.status} ${res.statusText}`
     const err = new Error(msg)
@@ -1166,6 +1525,7 @@ async function chatCompletion(cfg, messages, opts = {}) {
 
   if (opts.stream === false) {
     const data = await readJsonResponse(res)
+    if (loading) loading.stop()
     content = data.choices?.[0]?.message?.content || ""
     return { content, firstTokenMs: Date.now() - started, totalMs: Date.now() - started, status: res.status }
   }
@@ -1191,11 +1551,19 @@ async function chatCompletion(cfg, messages, opts = {}) {
       if (delta) {
         if (!firstTokenAt) firstTokenAt = Date.now()
         content += delta
-        if (opts.print !== false) process.stdout.write(delta)
+        if (opts.print !== false) {
+          if (loading) loading.stop()
+          if (opts.prefixOnFirstToken && !prefixWritten) {
+            process.stdout.write(opts.prefixOnFirstToken)
+            prefixWritten = true
+          }
+          process.stdout.write(delta)
+        }
       }
     }
   }
 
+  if (loading) loading.stop()
   if (opts.print !== false) process.stdout.write("\n")
   return {
     content,
@@ -1215,10 +1583,15 @@ async function cmdLogin(args) {
     platform: platformName(),
     scopes: ["account:read", "keys:read", "keys:create"],
   }
-  const data = await siteJson({ siteBase: base }, "/api/laicode/device/start", {
-    method: "POST",
-    body: JSON.stringify(body),
-  })
+  const data = await withSpinner(
+    "创建设备授权码",
+    () =>
+      siteJson({ siteBase: base }, "/api/laicode/device/start", {
+        method: "POST",
+        body: JSON.stringify(body),
+      }),
+    { delayMs: 80 }
+  )
 
   console.log("打开以下链接授权 LaiCode:")
   console.log(data.verificationUriComplete || data.verificationUri)
@@ -1233,23 +1606,29 @@ async function cmdLogin(args) {
 
   let interval = Number(data.interval || 2)
   const deadline = Date.now() + Number(data.expiresIn || 600) * 1000
+  const pollSpinner = createSpinner("等待浏览器授权", { delayMs: 0 }).start()
+  const fallbackDots = !pollSpinner.enabled
   while (Date.now() < deadline) {
     await sleep(interval * 1000)
+    const remaining = Math.max(0, Math.ceil((deadline - Date.now()) / 1000))
+    pollSpinner.update(`等待浏览器授权 · 剩余 ${remaining}s`)
     const poll = await siteJson({ siteBase: base }, "/api/laicode/device/poll", {
       method: "POST",
       body: JSON.stringify({ deviceCode: data.deviceCode }),
     })
     if (poll.status === "pending") {
-      process.stdout.write(".")
+      if (fallbackDots) process.stdout.write(".")
       interval = Number(poll.interval || interval)
       continue
     }
     if (poll.status === "slow_down") {
       interval = Math.max(interval + 1, Number(poll.interval || interval))
-      process.stdout.write(" slow_down ")
+      pollSpinner.update(`等待浏览器授权 · 降低轮询频率 ${interval}s`)
+      if (fallbackDots) process.stdout.write(" slow_down ")
       continue
     }
-    process.stdout.write("\n")
+    if (fallbackDots) process.stdout.write("\n")
+    else pollSpinner.stop()
     if (poll.status === "denied") die("授权已被拒绝。")
     if (poll.status === "expired") die("授权已过期，请重新运行 `laicode login`。")
     if (poll.status === "authorized") {
@@ -1264,7 +1643,7 @@ async function cmdLogin(args) {
       })
       console.log(`已授权: ${poll.user?.email || poll.user?.name || "unknown"}`)
       if (!args["no-key"]) {
-        const key = await ensureApiKey(next, { tier: args.tier })
+        const key = await withSpinner("准备 API Key", () => ensureApiKey(next, { tier: args.tier }), { delayMs: 80 })
         next = await readConfig()
         console.log(`API Key 就绪: ${maskSecret(key)} (${next.apiKeyName || "Laicode key"})`)
       }
@@ -1272,12 +1651,14 @@ async function cmdLogin(args) {
     }
     die(`Unexpected authorization status: ${poll.status}`)
   }
+  pollSpinner.stop()
+  if (fallbackDots) process.stdout.write("\n")
   die("授权等待超时，请重新运行 `laicode login`。")
 }
 
 async function cmdModels(args) {
   const cfg = await readConfig()
-  const data = await getModels(cfg)
+  const data = await withSpinner("拉取模型雷达", () => getModels(cfg), { enabled: !args.json, delayMs: 80 })
   let models = data.models || []
   if (args.online) models = models.filter(modelOnline)
   if (args.category) models = models.filter((m) => m.category === args.category)
@@ -1333,9 +1714,10 @@ async function cmdModels(args) {
 async function cmdKeys(args) {
   const action = args._[1] || "list"
   const cfg = await readConfig()
+  if (!cfg.accessToken) die("Not logged in. Run `laicode login` first.")
   if (action === "list") {
-    const keys = await listKeys(cfg)
     const reveal = await confirmRevealKey(args)
+    const keys = await withSpinner("读取 API Key 列表", () => listKeys(cfg), { enabled: !args.json, delayMs: 80 })
     if (args.json) {
       console.log(JSON.stringify({ keys: keys.map((k) => safeKeyRecord(k, reveal)), reveal }, null, 2))
       return
@@ -1367,10 +1749,15 @@ async function cmdKeys(args) {
     const body = { name }
     if (args.tier) body.tier = args.tier
     const reveal = await confirmRevealKey(args)
-    const data = await authJson(cfg, "/api/laicode/keys", {
-      method: "POST",
-      body: JSON.stringify(body),
-    })
+    const data = await withSpinner(
+      "创建 API Key",
+      () =>
+        authJson(cfg, "/api/laicode/keys", {
+          method: "POST",
+          body: JSON.stringify(body),
+        }),
+      { enabled: !args.json, delayMs: 80 }
+    )
     const key = data.key
     await patchConfig({
       apiKey: key.key,
@@ -1391,7 +1778,11 @@ async function cmdKeys(args) {
   if (action === "delete") {
     const id = args._[2] || args.id
     if (!id) die("Usage: laicode keys delete <id>")
-    await authJson(cfg, `/api/laicode/keys/${encodeURIComponent(id)}`, { method: "DELETE" })
+    await withSpinner(
+      `删除 API Key ${id}`,
+      () => authJson(cfg, `/api/laicode/keys/${encodeURIComponent(id)}`, { method: "DELETE" }),
+      { enabled: !args.json, delayMs: 80 }
+    )
     const patch = {}
     if (String(cfg.apiKeyId) === String(id)) {
       patch.apiKey = undefined
@@ -1519,16 +1910,29 @@ async function cmdConfig(args) {
   die("Usage: laicode config [list|get|set|unset]")
 }
 
+async function cmdCredential(args) {
+  const action = args._[1]
+  if (action !== "api-key") die("Usage: laicode credential api-key")
+  let cfg = await readConfig()
+  let key = cfg.apiKey
+  if (!key && cfg.accessToken) {
+    key = await ensureApiKey(cfg)
+    cfg = await readConfig()
+  }
+  if (!key) die("No API key available. Run `laicode login` first.")
+  process.stdout.write(`${key}\n`)
+}
+
 async function cmdChat(args) {
   let cfg = await readConfig()
   if (!cfg.apiKey && cfg.accessToken) {
-    await ensureApiKey(cfg)
+    await withSpinner("准备 API Key", () => ensureApiKey(cfg), { delayMs: 80 })
     cfg = await readConfig()
   }
 
   let model = args.model || cfg.defaultModel
   if (!model && cfg.accessToken) {
-    const data = await getModels(cfg)
+    const data = await withSpinner("选择默认在线模型", () => getModels(cfg), { delayMs: 80 })
     model = pickDefaultModel(data.models)
   }
   if (!model) die("未选择模型。请使用 `laicode chat --model <model>`。")
@@ -1536,7 +1940,11 @@ async function cmdChat(args) {
   const message = args.message || args.m || args._.slice(1).join(" ")
   if (message) {
     console.log(`model: ${model}`)
-    await chatCompletion(cfg, [{ role: "user", content: message }], { model, stream: true })
+    await chatCompletion(cfg, [{ role: "user", content: message }], {
+      model,
+      stream: true,
+      loadingText: "等待模型响应",
+    })
     await patchConfig({ defaultModel: model })
     return
   }
@@ -1548,8 +1956,12 @@ async function cmdChat(args) {
     const input = await new Promise((resolve) => rl.question("> ", resolve))
     if (!input || input.trim() === "/exit" || input.trim() === "/quit") break
     messages.push({ role: "user", content: input })
-    process.stdout.write("assistant: ")
-    const res = await chatCompletion(cfg, messages, { model, stream: true })
+    const res = await chatCompletion(cfg, messages, {
+      model,
+      stream: true,
+      loadingText: "assistant 思考中",
+      prefixOnFirstToken: "assistant: ",
+    })
     messages.push({ role: "assistant", content: res.content })
   }
   rl.close()
@@ -1559,12 +1971,12 @@ async function cmdChat(args) {
 async function cmdBench(args) {
   let cfg = await readConfig()
   if (!cfg.apiKey && cfg.accessToken) {
-    await ensureApiKey(cfg)
+    await withSpinner("准备 API Key", () => ensureApiKey(cfg), { enabled: !args.json, delayMs: 80 })
     cfg = await readConfig()
   }
   let model = args.model || cfg.defaultModel
   if (!model && cfg.accessToken) {
-    const data = await getModels(cfg)
+    const data = await withSpinner("选择默认在线模型", () => getModels(cfg), { enabled: !args.json, delayMs: 80 })
     model = pickDefaultModel(data.models)
   }
   if (!model) die("未选择模型。请使用 `laicode bench --model <model>`。")
@@ -1577,10 +1989,15 @@ async function cmdBench(args) {
   for (let i = 0; i < count; i++) {
     const label = `${i + 1}/${count}`
     try {
-      const res = await chatCompletion(
-        cfg,
-        [{ role: "user", content: prompt }],
-        { model, stream: true, print: false, temperature: 0 }
+      const res = await withSpinner(
+        `压测 ${label} · 等待首 token`,
+        () =>
+          chatCompletion(
+            cfg,
+            [{ role: "user", content: prompt }],
+            { model, stream: true, print: false, temperature: 0 }
+          ),
+        { enabled: !args.json, delayMs: 80 }
       )
       rows.push({ index: i + 1, ok: true, firstTokenMs: res.firstTokenMs, totalMs: res.totalMs })
       if (!args.json) console.log(`${ui.ok("●")} ${label} 成功  首 token=${res.firstTokenMs}ms  总耗时=${res.totalMs}ms`)
@@ -1680,7 +2097,11 @@ async function cmdDoctor(args) {
   record("config-file", "配置文件", true, fs.existsSync(CONFIG_FILE) ? CONFIG_FILE : "尚未创建")
 
   try {
-    const publicCatalog = await siteJson(cfg, "/api/catalog", { method: "GET", timeoutMs: 10000 })
+    const publicCatalog = await withSpinner(
+      "检查公开模型目录",
+      () => siteJson(cfg, "/api/catalog", { method: "GET", timeoutMs: 10000 }),
+      { enabled: !args.json, delayMs: 80 }
+    )
     const count = publicCatalog.models?.length || 0
     record("catalog", "公开模型目录", Boolean(count), `${count} 个模型`, { count })
   } catch (err) {
@@ -1688,7 +2109,7 @@ async function cmdDoctor(args) {
   }
 
   try {
-    const latest = await getNpmLatestVersion()
+    const latest = await withSpinner("检查 npm 版本", () => getNpmLatestVersion(), { enabled: !args.json, delayMs: 80 })
     if (!latest) {
       record("version", "版本检查", true, `当前 ${VERSION}，未取到 latest`, { current: VERSION, latest: null })
     } else {
@@ -1719,7 +2140,7 @@ async function cmdDoctor(args) {
 
   if (cfg.accessToken) {
     try {
-      const data = await bootstrap(cfg, true)
+      const data = await withSpinner("验证 CLI 会话", () => bootstrap(cfg, true), { enabled: !args.json, delayMs: 80 })
       record("session", "CLI 会话", true, data.user?.email || data.user?.name || "已授权", {
         user: data.user || cfg.user || null,
       })
@@ -1732,7 +2153,7 @@ async function cmdDoctor(args) {
 
   if (!cfg.apiKey && cfg.accessToken) {
     try {
-      await ensureApiKey(cfg)
+      await withSpinner("检查 API Key", () => ensureApiKey(cfg), { enabled: !args.json, delayMs: 80 })
       cfg = await readConfig()
       record("api-key", "API Key", true, cfg.apiKeyName || "已配置", {
         configured: Boolean(cfg.apiKey),
@@ -1754,14 +2175,19 @@ async function cmdDoctor(args) {
     try {
       let model = args.model || cfg.defaultModel
       if (!model && cfg.accessToken) {
-        const data = await getModels(cfg)
+        const data = await withSpinner("选择诊断模型", () => getModels(cfg), { enabled: !args.json, delayMs: 80 })
         model = pickDefaultModel(data.models)
       }
       if (!model) throw new Error("no model selected")
-      const res = await chatCompletion(
-        cfg,
-        [{ role: "user", content: "Reply with OK." }],
-        { model, stream: true, print: false, temperature: 0 }
+      const res = await withSpinner(
+        "执行真实模型调用",
+        () =>
+          chatCompletion(
+            cfg,
+            [{ role: "user", content: "Reply with OK." }],
+            { model, stream: true, print: false, temperature: 0 }
+          ),
+        { enabled: !args.json, delayMs: 80 }
       )
       record("chat-completion", "真实模型调用", true, `${model} 首 token=${res.firstTokenMs}ms 总耗时=${res.totalMs}ms`, {
         model,
@@ -1820,7 +2246,9 @@ async function cmdLogout() {
   const cfg = await readConfig()
   if (cfg.accessToken) {
     try {
-      await authJson(cfg, "/api/laicode/session/revoke", { method: "POST" })
+      await withSpinner("撤销远程会话", () => authJson(cfg, "/api/laicode/session/revoke", { method: "POST" }), {
+        delayMs: 80,
+      })
       console.log("Remote session revoked.")
     } catch (err) {
       if (err.status !== 401) console.log(`Remote revoke failed: ${err.message}`)
@@ -1850,7 +2278,7 @@ function localStatusRows(cfg) {
 }
 
 async function chooseModel(cfg, title = "Choose Model") {
-  const data = await getModels(cfg)
+  const data = await withSpinner("拉取在线模型", () => getModels(cfg), { delayMs: 80 })
   const online = (data.models || []).filter(modelOnline)
   if (!online.length) {
     console.log(ui.warn("没有找到在线模型。"))
@@ -1882,6 +2310,120 @@ async function menuModels() {
   await pause()
 }
 
+async function menuTools() {
+  await cmdTools({ _: ["tools"] })
+  await pause()
+}
+
+async function menuInit() {
+  await cmdTools({ _: ["tools"] })
+  console.log("")
+  const tool = await question("接入工具 [codex]: ", "codex")
+  await cmdInit({ _: ["init"], tool: tool || "codex" })
+  const answer = await question("应用这个接入计划？[y/N]: ", "n")
+  if (answer.toLowerCase() === "y" || answer.toLowerCase() === "yes") {
+    await cmdInit({ _: ["init"], tool: tool || "codex", apply: true })
+  }
+  await pause()
+}
+
+async function chooseAiTool(title = "选择 AI 工具") {
+  const tools = detectTools()
+  const items = tools.map((tool) => ({
+    label: tool.name,
+    description: `${tool.detected ? "已发现" : "未检测"} · ${tool.status}`,
+    value: tool.id,
+  }))
+  items.push({ label: "返回", description: "", value: null })
+  return selectMenu(title, items, { cancelValue: null })
+}
+
+async function maybeApplyToolCommand(action, tool) {
+  await cmdTools({ _: ["tools", action], tool })
+  const answer = await question(`执行 ${tool} ${action}？[y/N]: `, "n")
+  if (answer.toLowerCase() === "y" || answer.toLowerCase() === "yes") {
+    await cmdTools({ _: ["tools", action], tool, apply: true })
+  }
+  await pause()
+}
+
+async function maybeApplyToolConfig(tool) {
+  await cmdInit({ _: ["init"], tool })
+  const answer = await question(`应用 ${tool} 接入配置？[y/N]: `, "n")
+  if (answer.toLowerCase() === "y" || answer.toLowerCase() === "yes") {
+    await cmdInit({ _: ["init"], tool, apply: true })
+  }
+  await pause()
+}
+
+async function menuToolDetail(tool) {
+  for (;;) {
+    const action = await selectMenu(
+      `管理 ${tool}`,
+      [
+        { label: "预览接入配置", description: "只展示 diff/计划，不写入", value: "preview" },
+        { label: "应用接入配置", description: "备份后写入，可 rollback", value: "apply-config" },
+        { label: "安装工具", description: "预览安装命令，可确认执行", value: "install" },
+        { label: "卸载工具", description: "仅管理 Laicode 可控的 npm 全局安装", value: "uninstall" },
+        { label: "重装工具", description: "卸载后重新安装", value: "reinstall" },
+        { label: "查看工具矩阵", description: "回到总览表", value: "matrix" },
+        { label: "返回", description: "", value: null },
+      ],
+      { cancelValue: null }
+    )
+    if (!action) return
+    if (action === "preview") {
+      await cmdInit({ _: ["init"], tool })
+      await pause()
+    } else if (action === "apply-config") {
+      await maybeApplyToolConfig(tool)
+    } else if (action === "install" || action === "uninstall" || action === "reinstall") {
+      await maybeApplyToolCommand(action, tool)
+    } else if (action === "matrix") {
+      await cmdTools({ _: ["tools"] })
+      await pause()
+    }
+  }
+}
+
+async function menuToolAction(action) {
+  const tool = await chooseAiTool(action === "configure" ? "选择要配置的工具" : "选择要维护的工具")
+  if (!tool) return
+  if (action === "configure") await maybeApplyToolConfig(tool)
+  else await maybeApplyToolCommand(action, tool)
+}
+
+async function menuToolHub() {
+  for (;;) {
+    const action = await selectMenu(
+      "AI 工具一键配置",
+      [
+        { label: "体检全部工具", description: "扫描 Claude、Codex、VS Code、Cursor、OpenCode", value: "scan" },
+        { label: "选择工具管理", description: "进入单个工具的完整操作菜单", value: "manage" },
+        { label: "一键配置工具", description: "预览并应用 Lai.vc 接入配置", value: "configure" },
+        { label: "安装工具", description: "生成安装命令，可确认执行", value: "install" },
+        { label: "卸载工具", description: "卸载 Laicode 可控的安装", value: "uninstall" },
+        { label: "重装工具", description: "卸载并重新安装", value: "reinstall" },
+        { label: "回滚最近接入", description: "撤销最近一次 Laicode 写入", value: "rollback" },
+        { label: "返回主菜单", description: "", value: null },
+      ],
+      { cancelValue: null }
+    )
+    if (!action) return
+    if (action === "scan") {
+      await cmdTools({ _: ["tools"] })
+      await pause()
+    } else if (action === "manage") {
+      const tool = await chooseAiTool()
+      if (tool) await menuToolDetail(tool)
+    } else if (action === "configure" || action === "install" || action === "uninstall" || action === "reinstall") {
+      await menuToolAction(action)
+    } else if (action === "rollback") {
+      await menuRollback()
+    }
+  }
+}
+
 async function menuChat() {
   let cfg = await readConfig()
   if (!cfg.accessToken && !cfg.apiKey) {
@@ -1890,7 +2432,7 @@ async function menuChat() {
     return
   }
   if (!cfg.apiKey && cfg.accessToken) {
-    await ensureApiKey(cfg)
+    await withSpinner("准备 API Key", () => ensureApiKey(cfg), { delayMs: 80 })
     cfg = await readConfig()
   }
   const model = await chooseModel(cfg, "Chat Test")
@@ -1898,7 +2440,11 @@ async function menuChat() {
   const prompt = await question("Prompt: ", "Say hello in one sentence.")
   printHero("Streaming Response")
   console.log(`${ui.dim("model")} ${model}\n`)
-  await chatCompletion(cfg, [{ role: "user", content: prompt }], { model, stream: true })
+  await chatCompletion(cfg, [{ role: "user", content: prompt }], {
+    model,
+    stream: true,
+    loadingText: "等待模型响应",
+  })
   await patchConfig({ defaultModel: model })
   await pause()
 }
@@ -1911,7 +2457,7 @@ async function menuBench() {
     return
   }
   if (!cfg.apiKey && cfg.accessToken) {
-    await ensureApiKey(cfg)
+    await withSpinner("准备 API Key", () => ensureApiKey(cfg), { delayMs: 80 })
     cfg = await readConfig()
   }
   const model = await chooseModel(cfg, "Benchmark")
@@ -1977,6 +2523,14 @@ async function menuLogout() {
   await pause()
 }
 
+async function menuRollback() {
+  const answer = await question("回滚最近一次 Laicode 接入写入？[y/N]: ", "n")
+  if (answer.toLowerCase() === "y" || answer.toLowerCase() === "yes") {
+    await cmdRollback({ _: ["rollback"] })
+  }
+  await pause()
+}
+
 async function cmdMenu(args = {}) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
     console.log(buildHelp())
@@ -1985,13 +2539,14 @@ async function cmdMenu(args = {}) {
 
   for (;;) {
     const cfg = await readConfig()
-    const snapshot = await dashboardSnapshot(cfg)
+    const snapshot = await withSpinner("同步驾驶舱", () => dashboardSnapshot(cfg), { delayMs: 160 })
     printHero("Lai.vc 中转控制台")
     printDashboard(cfg, snapshot)
     console.log("")
     const action = await selectMenu(
       "选择任务",
       [
+        { label: "AI 工具一键配置", description: "体检、安装、配置、重装、卸载、回滚", value: "tool-hub" },
         { label: "开始对话", description: "流式测试单个模型", value: "chat" },
         { label: "模型雷达", description: "在线模型、价格、多源、延迟", value: "models" },
         { label: "网关压测", description: "首 token、总耗时、成功率", value: "bench" },
@@ -2000,6 +2555,7 @@ async function cmdMenu(args = {}) {
         { label: "本地配置", description: "查看 ~/.laicode 状态", value: "config" },
         { label: "品牌预览", description: "终端字标和品牌色板", value: "brand" },
         { label: "重新登录", description: "浏览器设备授权", value: "login" },
+        { label: "回滚接入", description: "撤销最近一次配置写入", value: "rollback" },
         { label: "退出登录", description: "撤销会话并清理缓存", value: "logout" },
         { label: "退出", description: "", value: "exit" },
       ],
@@ -2007,7 +2563,10 @@ async function cmdMenu(args = {}) {
     )
 
     if (!action || action === "exit") return
-    if (action === "login") await menuLogin()
+    if (action === "tool-hub") await menuToolHub()
+    else if (action === "login") await menuLogin()
+    else if (action === "tools") await menuTools()
+    else if (action === "init") await menuInit()
     else if (action === "models") await menuModels()
     else if (action === "chat") await menuChat()
     else if (action === "bench") await menuBench()
@@ -2018,6 +2577,7 @@ async function cmdMenu(args = {}) {
       cmdBrand()
       await pause()
     }
+    else if (action === "rollback") await menuRollback()
     else if (action === "logout") await menuLogout()
   }
 }
@@ -2043,8 +2603,12 @@ async function main() {
   try {
     if (cmd === "login") return await cmdLogin(args)
     if (cmd === "models") return await cmdModels(args)
+    if (cmd === "tools") return await cmdTools(args)
+    if (cmd === "init") return await cmdInit(args)
+    if (cmd === "rollback") return await cmdRollback(args)
     if (cmd === "keys") return await cmdKeys(args)
     if (cmd === "config") return await cmdConfig(args)
+    if (cmd === "credential") return await cmdCredential(args)
     if (cmd === "chat") return await cmdChat(args)
     if (cmd === "bench") return await cmdBench(args)
     if (cmd === "doctor") return await cmdDoctor(args)