@laivc/laicode 0.1.0 → 0.2.0

package/README.md

@@ -9,6 +9,7 @@ LaiCode is the official CLI testbench for the Lai.vc API gateway.
 
 The interface defaults to Chinese and uses terminal panels/tables that handle CJK alignment correctly.
 Its terminal cockpit follows the Lai.vc brand palette: plum, coral, persimmon, ivory, and gold.
+Network and model calls use TTY-aware loading animations. JSON output and non-interactive shell usage stay clean.
 
 ## Commands
 
@@ -20,6 +21,10 @@ laicode status           # live cockpit snapshot
 laicode status --refresh # bypass the short dashboard cache
 laicode commands         # command catalog
 laicode completion bash  # print shell completion script
+laicode tools            # inspect local AI tools
+laicode init --tool codex # preview a one-click Codex profile
+laicode init --tool codex --apply
+laicode rollback         # undo the latest Laicode config write
 laicode login
 laicode models --online
 laicode chat --model gpt-5.5 --message "Say hello"
@@ -42,6 +47,8 @@ laicode status
 laicode login
 laicode models --online
 laicode doctor
+laicode tools
+laicode init --tool codex
 ```
 
 `status` shows the next recommended actions when the local state is empty.
@@ -56,6 +63,24 @@ Use `laicode bench --json` for script-friendly health checks. The JSON output in
 
 Use `laicode doctor --json` for CI-friendly diagnostics across local state, catalog reachability, npm version status, CLI session, API key, and a real chat completion check.
 
+## Local Tool Onboarding
+
+Phase 1 focuses on checking local AI tools and safely connecting them to Lai.vc.
+
+```bash
+laicode tools
+laicode init --tool codex
+laicode init --tool codex --apply
+codex --profile laicode
+laicode rollback
+```
+
+`init` previews the files it would write by default. `--apply` creates a backup under `~/.laicode/backups` before writing, and `rollback` restores the latest Laicode-managed write.
+
+The first automatic adapter creates `~/.codex/laicode.config.toml` instead of modifying the main Codex config. Continue can create a fresh `~/.continue/config.yaml` when no existing Continue config is present. Cursor and Cline are currently inspected with guided setup to avoid unsafe writes into app-managed secure storage.
+
+The Codex profile uses Codex's command-backed auth to call `laicode credential api-key`, so the Lai.vc key stays in `~/.laicode` instead of being copied into Codex config.
+
 完整 API Key 默认不会显示。若确实需要查看，使用:
 
 ```bash
@@ -101,6 +126,7 @@ LAICODE_HOME=/path/to/state    # default: ~/.laicode
 LAICODE_SITE_URL=https://lai.vc
 LAICODE_PLAIN=1               # disable styling
 LAICODE_COLOR=1               # force color preview/output
+LAICODE_NO_SPINNER=1          # disable loading animations
 ```
 
 ## Manual API Key Mode

package/bin/laicode.js

@@ -6,8 +6,15 @@ const os = require("os")
 const path = require("path")
 const readline = require("readline")
 const { spawn } = require("child_process")
-
-const VERSION = "0.1.0"
+const {
+  applyInitPlan,
+  buildInitPlan,
+  detectTools,
+  rollbackLatest,
+  safePlan,
+} = require("../lib/adapters")
+
+const VERSION = "0.2.0"
 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")
@@ -20,6 +27,9 @@ const COMMAND_SPECS = [
   { name: "status", usage: "laicode status [--refresh] [--json]", summary: "查看实时驾驶舱状态", flags: ["--refresh", "--json"] },
   { name: "commands", usage: "laicode commands [--json]", summary: "查看命令目录和 flag 清单", flags: ["--json"] },
   { name: "completion", usage: "laicode completion [bash|zsh|fish|powershell]", summary: "输出 shell 补全脚本", flags: ["bash", "zsh", "fish", "powershell"] },
+  { name: "tools", usage: "laicode tools [--json]", summary: "检查本机 AI 工具接入状态", flags: ["--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: "login", usage: "laicode login [--tier std] [--no-open]", summary: "通过浏览器设备授权登录", flags: ["--tier", "--no-open", "--no-key"] },
   { name: "doctor", usage: "laicode doctor [--model gpt-5.5] [--json]", summary: "运行本机、会话、网关诊断", flags: ["--model", "--json"] },
   { name: "models", usage: "laicode models [--json] [--online]", summary: "查看模型雷达和价格档位", flags: ["--json", "--online", "--category", "--vendor"] },
@@ -39,6 +49,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 +139,7 @@ const VALUE_FLAGS = new Set([
   "name",
   "id",
   "shell",
+  "tool",
 ])
 
 function parseArgs(argv) {
@@ -225,7 +237,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 +583,156 @@ 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("需合并")
+  return ui.dim("指引")
+}
+
+async function cmdTools(args = {}) {
+  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 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 +1366,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 +1412,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 +1450,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 +1476,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 +1508,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 +1531,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 +1568,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 +1576,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 +1639,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 +1674,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 +1703,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 +1835,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 +1865,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 +1881,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 +1896,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 +1914,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 +2022,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 +2034,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 +2065,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 +2078,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 +2100,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 +2171,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 +2203,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 +2235,23 @@ 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 menuChat() {
   let cfg = await readConfig()
   if (!cfg.accessToken && !cfg.apiKey) {
@@ -1890,7 +2260,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 +2268,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 +2285,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 +2351,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,7 +2367,7 @@ 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("")
@@ -1993,6 +2375,8 @@ async function cmdMenu(args = {}) {
       "选择任务",
       [
         { label: "开始对话", description: "流式测试单个模型", value: "chat" },
+        { label: "AI 工具体检", description: "检查 Codex、Cursor、Continue、Cline", value: "tools" },
+        { label: "一键接入", description: "预览 diff、备份、写入、可回滚", value: "init" },
         { label: "模型雷达", description: "在线模型、价格、多源、延迟", value: "models" },
         { label: "网关压测", description: "首 token、总耗时、成功率", value: "bench" },
         { label: "系统诊断", description: "会话、密钥、目录、真实调用", value: "doctor" },
@@ -2000,6 +2384,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" },
       ],
@@ -2008,6 +2393,8 @@ async function cmdMenu(args = {}) {
 
     if (!action || action === "exit") return
     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 +2405,7 @@ async function cmdMenu(args = {}) {
       cmdBrand()
       await pause()
     }
+    else if (action === "rollback") await menuRollback()
     else if (action === "logout") await menuLogout()
   }
 }
@@ -2043,8 +2431,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)

package/lib/adapters.js

@@ -0,0 +1,379 @@
+"use strict"
+
+const fs = require("fs")
+const fsp = require("fs/promises")
+const os = require("os")
+const path = require("path")
+
+const DEFAULT_API_BASE = "https://api.lai.vc/v1"
+const DEFAULT_MODEL = "gpt-5.5"
+
+function homeDir(env = process.env) {
+  return env.HOME || env.USERPROFILE || os.homedir()
+}
+
+function expandHome(value, env = process.env) {
+  if (!value) return value
+  if (value === "~") return homeDir(env)
+  if (value.startsWith("~/")) return path.join(homeDir(env), value.slice(2))
+  return value
+}
+
+function exists(file) {
+  try {
+    fs.accessSync(file)
+    return true
+  } catch {
+    return false
+  }
+}
+
+function commandExists(cmd, env = process.env) {
+  const pathEnv = String(env.PATH || "")
+  const dirs = pathEnv.split(path.delimiter).filter(Boolean)
+  const exts =
+    process.platform === "win32"
+      ? String(env.PATHEXT || ".EXE;.CMD;.BAT;.COM").split(";")
+      : [""]
+  for (const dir of dirs) {
+    for (const ext of exts) {
+      if (exists(path.join(dir, cmd + ext))) return true
+    }
+  }
+  return false
+}
+
+function codexHome(env = process.env) {
+  return env.CODEX_HOME ? expandHome(env.CODEX_HOME, env) : path.join(homeDir(env), ".codex")
+}
+
+function continueHome(env = process.env) {
+  return path.join(homeDir(env), ".continue")
+}
+
+function platformConfigDir(appName, env = process.env) {
+  if (process.platform === "darwin") return path.join(homeDir(env), "Library", "Application Support", appName)
+  if (process.platform === "win32") return path.join(env.APPDATA || path.join(homeDir(env), "AppData", "Roaming"), appName)
+  return path.join(env.XDG_CONFIG_HOME || path.join(homeDir(env), ".config"), appName)
+}
+
+function detectTools(opts = {}) {
+  const env = opts.env || process.env
+  const codexDir = codexHome(env)
+  const continueDir = continueHome(env)
+  const cursorDir = platformConfigDir("Cursor", env)
+  const codeDir = platformConfigDir("Code", env)
+  const vscodeExtensions = path.join(homeDir(env), ".vscode", "extensions")
+
+  const continueYaml = path.join(continueDir, "config.yaml")
+  const continueJson = path.join(continueDir, "config.json")
+  const clineDetected =
+    exists(path.join(codeDir, "User", "globalStorage", "saoudrizwan.claude-dev")) ||
+    exists(path.join(codeDir, "User", "globalStorage", "cline.cline")) ||
+    (exists(vscodeExtensions) &&
+      fs.readdirSync(vscodeExtensions).some((name) => /(^|\.)(cline|claude-dev)/i.test(name)))
+
+  return [
+    {
+      id: "codex",
+      name: "Codex CLI",
+      detected: commandExists("codex", env) || exists(codexDir),
+      support: "auto",
+      status: exists(path.join(codexDir, "laicode.config.toml")) ? "已接入 profile" : "可一键接入",
+      configPath: path.join(codexDir, "laicode.config.toml"),
+      next: "laicode init --tool codex --apply",
+    },
+    {
+      id: "continue",
+      name: "Continue",
+      detected: exists(continueDir),
+      support: exists(continueYaml) || exists(continueJson) ? "manual-merge" : "auto-new",
+      status: exists(continueYaml) || exists(continueJson) ? "检测到现有配置，先预览手动合并" : "可创建新配置",
+      configPath: exists(continueYaml) ? continueYaml : exists(continueJson) ? continueJson : continueYaml,
+      next: "laicode init --tool continue --apply",
+    },
+    {
+      id: "cline",
+      name: "Cline",
+      detected: clineDetected,
+      support: "guide",
+      status: clineDetected ? "需在扩展 UI 中选择 OpenAI Compatible" : "未检测到",
+      configPath: path.join(codeDir, "User"),
+      next: "laicode init --tool cline",
+    },
+    {
+      id: "cursor",
+      name: "Cursor",
+      detected: exists(cursorDir) || commandExists("cursor", env),
+      support: "guide",
+      status: exists(cursorDir) || commandExists("cursor", env) ? "密钥在安全存储，暂不脚本写入" : "未检测到",
+      configPath: path.join(cursorDir, "User"),
+      next: "laicode init --tool cursor",
+    },
+  ]
+}
+
+function tomlString(value) {
+  return JSON.stringify(String(value))
+}
+
+function yamlString(value) {
+  return JSON.stringify(String(value))
+}
+
+function codexProfileContent(ctx) {
+  const model = ctx.model || DEFAULT_MODEL
+  const apiBaseUrl = ctx.apiBaseUrl || DEFAULT_API_BASE
+  return [
+    "# Created by Laicode. Remove this file or run `laicode rollback` to undo.",
+    `model = ${tomlString(model)}`,
+    'model_provider = "laivc"',
+    "",
+    "[model_providers.laivc]",
+    'name = "Lai.vc"',
+    `base_url = ${tomlString(apiBaseUrl)}`,
+    "",
+    "[model_providers.laivc.auth]",
+    `command = ${tomlString(ctx.commandName || "laicode")}`,
+    'args = ["credential", "api-key"]',
+    "timeout_ms = 5000",
+    "refresh_interval_ms = 300000",
+    "",
+  ].join("\n")
+}
+
+function continueConfigContent(ctx) {
+  const model = ctx.model || DEFAULT_MODEL
+  const apiBaseUrl = ctx.apiBaseUrl || DEFAULT_API_BASE
+  const apiKey = ctx.apiKey || "sk-..."
+  return [
+    "name: LaiCode",
+    "version: 0.0.1",
+    "schema: v1",
+    "models:",
+    `  - name: ${yamlString(`Lai.vc ${model}`)}`,
+    "    provider: openai",
+    `    model: ${yamlString(model)}`,
+    `    apiBase: ${yamlString(apiBaseUrl)}`,
+    `    apiKey: ${yamlString(apiKey)}`,
+    "    useResponsesApi: false",
+    "",
+  ].join("\n")
+}
+
+function manualPlan(tool, ctx, reason, instructions) {
+  return {
+    tool,
+    ok: false,
+    mode: "manual",
+    reason,
+    instructions,
+    operations: [],
+    apiBaseUrl: ctx.apiBaseUrl || DEFAULT_API_BASE,
+    model: ctx.model || DEFAULT_MODEL,
+  }
+}
+
+function buildInitPlan(tool, ctx = {}) {
+  const env = ctx.env || process.env
+  const normalized = String(tool || "codex").toLowerCase()
+  const apiBaseUrl = ctx.apiBaseUrl || DEFAULT_API_BASE
+  const model = ctx.model || DEFAULT_MODEL
+
+  if (normalized === "codex") {
+    const target = path.join(codexHome(env), "laicode.config.toml")
+    return {
+      tool: "codex",
+      ok: true,
+      mode: "profile",
+      summary: "创建 Codex 独立 profile，不改主配置和官方登录态。",
+      apiBaseUrl,
+      model,
+      runCommand: "codex --profile laicode",
+      operations: [
+        {
+          action: "write",
+          path: target,
+          mode: 0o600,
+          description: "Codex Lai.vc profile",
+          content: codexProfileContent({ ...ctx, apiBaseUrl, model }),
+        },
+      ],
+    }
+  }
+
+  if (normalized === "continue") {
+    const target = path.join(continueHome(env), "config.yaml")
+    const existingYaml = exists(target)
+    const existingJson = exists(path.join(continueHome(env), "config.json"))
+    if ((existingYaml || existingJson) && !ctx.force) {
+      return manualPlan("continue", { ...ctx, apiBaseUrl, model }, "检测到 Continue 现有配置，当前版本不自动合并 YAML/JSON。", [
+        "打开 Continue 配置文件。",
+        `新增 provider=openai, apiBase=${apiBaseUrl}, model=${model}, useResponsesApi=false。`,
+        "后续版本会在引入结构化 YAML 合并后支持自动 patch。",
+      ])
+    }
+    return {
+      tool: "continue",
+      ok: true,
+      mode: "new-config",
+      summary: "创建 Continue config.yaml，使用 OpenAI compatible provider。",
+      apiBaseUrl,
+      model,
+      operations: [
+        {
+          action: "write",
+          path: target,
+          mode: 0o600,
+          description: "Continue Lai.vc config",
+          content: continueConfigContent({ ...ctx, apiBaseUrl, model }),
+        },
+      ],
+    }
+  }
+
+  if (normalized === "cline") {
+    return manualPlan("cline", { ...ctx, apiBaseUrl, model }, "Cline 设置目前由 VS Code 扩展 UI 管理，先提供可靠指引。", [
+      "打开 Cline 设置。",
+      "API Provider 选择 OpenAI Compatible。",
+      `Base URL 填 ${apiBaseUrl}。`,
+      "API Key 使用 `laicode keys --show` 显式查看后粘贴。",
+      `Model ID 填 ${model}。`,
+    ])
+  }
+
+  if (normalized === "cursor") {
+    return manualPlan("cursor", { ...ctx, apiBaseUrl, model }, "Cursor API Key 存在安全存储中，当前不支持可靠脚本写入。", [
+      "打开 Cursor Settings -> Models。",
+      "添加 OpenAI API Key。",
+      `启用 Override OpenAI Base URL 并填写 ${apiBaseUrl}。`,
+      `添加并启用自定义模型 ${model}。`,
+    ])
+  }
+
+  return manualPlan(normalized, { ...ctx, apiBaseUrl, model }, `暂不支持工具: ${normalized}`, ["运行 `laicode tools` 查看当前支持矩阵。"])
+}
+
+function redactText(value, secrets = []) {
+  let out = String(value || "")
+  for (const secret of secrets.filter(Boolean)) {
+    out = out.split(secret).join(maskSecret(secret))
+  }
+  return out
+}
+
+function maskSecret(value) {
+  if (!value || value.length <= 16) return "***"
+  return `${value.slice(0, 8)}...${value.slice(-4)}`
+}
+
+function safePlan(plan, secrets = []) {
+  return {
+    ...plan,
+    operations: (plan.operations || []).map((op) => ({
+      action: op.action,
+      path: op.path,
+      mode: op.mode,
+      description: op.description,
+      preview: redactText(op.content, secrets),
+      exists: exists(op.path),
+    })),
+  }
+}
+
+function backupName(file) {
+  return Buffer.from(file).toString("base64url")
+}
+
+async function writeFileAtomic(file, content, mode = 0o600) {
+  await fsp.mkdir(path.dirname(file), { recursive: true, mode: 0o700 })
+  const tmp = `${file}.${process.pid}.tmp`
+  await fsp.writeFile(tmp, content, { mode })
+  try {
+    await fsp.chmod(tmp, mode)
+  } catch {
+    // Best effort for non-POSIX filesystems.
+  }
+  await fsp.rename(tmp, file)
+}
+
+async function applyInitPlan(plan, opts = {}) {
+  if (!plan.ok || !plan.operations?.length) {
+    throw new Error(plan.reason || "No operations to apply")
+  }
+  const stateDir = opts.stateDir || path.join(homeDir(), ".laicode")
+  const id = new Date().toISOString().replace(/[:.]/g, "-")
+  const backupDir = path.join(stateDir, "backups", id)
+  const applied = []
+
+  await fsp.mkdir(backupDir, { recursive: true, mode: 0o700 })
+  for (const op of plan.operations) {
+    if (op.action !== "write") throw new Error(`Unsupported operation: ${op.action}`)
+    const existed = exists(op.path)
+    const backupPath = path.join(backupDir, backupName(op.path))
+    if (existed) {
+      await fsp.mkdir(path.dirname(backupPath), { recursive: true })
+      await fsp.copyFile(op.path, backupPath)
+    }
+    await writeFileAtomic(op.path, op.content, op.mode || 0o600)
+    applied.push({
+      action: op.action,
+      path: op.path,
+      description: op.description,
+      existed,
+      backupPath: existed ? backupPath : null,
+      mode: op.mode || 0o600,
+    })
+  }
+
+  const manifest = {
+    id,
+    createdAt: new Date().toISOString(),
+    tool: plan.tool,
+    mode: plan.mode,
+    operations: applied,
+  }
+  await writeFileAtomic(path.join(backupDir, "manifest.json"), JSON.stringify(manifest, null, 2) + "\n", 0o600)
+  return manifest
+}
+
+async function rollbackLatest(opts = {}) {
+  const stateDir = opts.stateDir || path.join(homeDir(), ".laicode")
+  const backupsDir = path.join(stateDir, "backups")
+  let entries
+  try {
+    entries = await fsp.readdir(backupsDir, { withFileTypes: true })
+  } catch (err) {
+    if (err.code === "ENOENT") return null
+    throw err
+  }
+  const ids = entries
+    .filter((entry) => entry.isDirectory() && !entry.name.endsWith(".rolled-back"))
+    .map((entry) => entry.name)
+    .sort()
+  const id = ids[ids.length - 1]
+  if (!id) return null
+
+  const backupDir = path.join(backupsDir, id)
+  const manifest = JSON.parse(await fsp.readFile(path.join(backupDir, "manifest.json"), "utf8"))
+  for (const op of [...manifest.operations].reverse()) {
+    if (op.existed && op.backupPath) {
+      await fsp.mkdir(path.dirname(op.path), { recursive: true, mode: 0o700 })
+      await fsp.copyFile(op.backupPath, op.path)
+    } else if (!op.existed) {
+      await fsp.rm(op.path, { force: true })
+    }
+  }
+  await fsp.rename(backupDir, `${backupDir}.rolled-back`)
+  return manifest
+}
+
+module.exports = {
+  DEFAULT_API_BASE,
+  DEFAULT_MODEL,
+  applyInitPlan,
+  buildInitPlan,
+  detectTools,
+  rollbackLatest,
+  safePlan,
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laivc/laicode",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Official Lai.vc CLI for configuring developer tools.",
   "license": "MIT",
   "homepage": "https://lai.vc",
@@ -27,6 +27,7 @@
   },
   "files": [
     "bin",
+    "lib",
     "README.md",
     "scripts"
   ],

package/scripts/smoke-test.js

@@ -5,14 +5,17 @@ const fs = require("fs")
 const os = require("os")
 const path = require("path")
 
-const home = path.join(os.tmpdir(), "laicode-npm-smoke-test")
+const home = path.join(os.tmpdir(), `laicode-npm-smoke-test-${process.pid}`)
+const codexHome = path.join(home, "codex")
 fs.rmSync(home, { recursive: true, force: true })
 fs.mkdirSync(home, { recursive: true, mode: 0o700 })
+fs.mkdirSync(codexHome, { recursive: true, mode: 0o700 })
 fs.writeFileSync(
   path.join(home, "config.json"),
   JSON.stringify(
     {
       apiBaseUrl: "https://api.lai.vc/v1",
+      apiKey: "sk-smoke-test-secret-value",
       defaultModel: "gpt-5.5",
       dashboardCache: {
         onlineModels: 8,
@@ -28,7 +31,7 @@ fs.writeFileSync(
   { mode: 0o600 }
 )
 
-const env = { ...process.env, LAICODE_HOME: home, LAICODE_PLAIN: "1" }
+const env = { ...process.env, CODEX_HOME: codexHome, HOME: home, LAICODE_HOME: home, LAICODE_PLAIN: "1" }
 
 function run(args) {
   const result = spawnSync(process.execPath, args, { encoding: "utf8", env })
@@ -73,10 +76,13 @@ const help = run(["bin/laicode.js", "--help"])
 assertIncludes(help, "laicode status [--refresh] [--json]", "help lists status")
 assertIncludes(help, "laicode commands [--json]", "help lists commands")
 assertIncludes(help, "laicode completion [bash|zsh|fish|powershell]", "help lists completion")
+assertIncludes(help, "laicode tools [--json]", "help lists tools")
+assertIncludes(help, "laicode init [--tool codex] [--apply] [--json]", "help lists init")
 assertIncludes(help, "laicode doctor [--model gpt-5.5] [--json]", "help lists doctor json")
 assertIncludes(help, "laicode bench [--model gpt-5.5] [--count 3] [--json]", "help lists bench json")
-assertIncludes(run(["bin/laicode.js", "--version"]), "0.1.0", "long version")
-assertIncludes(run(["bin/laicode.js", "-v"]), "0.1.0", "short version")
+assertIncludes(help, "LAICODE_NO_SPINNER", "help lists spinner toggle")
+assertIncludes(run(["bin/laicode.js", "--version"]), "0.2.0", "long version")
+assertIncludes(run(["bin/laicode.js", "-v"]), "0.2.0", "short version")
 assertIncludes(run(["bin/laicode.js", "--plain", "brand"]), "Lai.vc 终端字标", "plain brand command")
 assertIncludes(run(["bin/laicode.js", "--color", "brand"]), "品牌色板", "color brand command")
 assertIncludes(run(["bin/laicode.js", "status"]), "快照   缓存", "status uses local dashboard cache")
@@ -92,6 +98,37 @@ if (!Array.isArray(status.nextActions) || !status.nextActions.find((action) => a
 assertIncludes(run(["bin/laicode.js", "commands", "--json"]), '"name": "commands"', "commands json")
 assertIncludes(run(["bin/laicode.js", "completion", "bash"]), "complete -F _laicode_completion laicode", "bash completion")
 assertIncludes(run(["bin/laicode.js", "completion", "fish"]), "__fish_seen_subcommand_from bench", "fish completion")
+const toolsJson = run(["bin/laicode.js", "tools", "--json"])
+const tools = parseJson(toolsJson, "tools json parses")
+if (!tools.tools.find((tool) => tool.id === "codex")) {
+  console.error("Smoke assertion failed: tools json includes codex")
+  process.exit(1)
+}
+const initPreviewJson = run(["bin/laicode.js", "init", "--tool", "codex", "--json"])
+assertExcludes(initPreviewJson, "sk-smoke-test-secret-value", "init preview redacts api key")
+const initPreview = parseJson(initPreviewJson, "init preview json parses")
+if (initPreview.apply !== false || initPreview.plan.tool !== "codex") {
+  console.error("Smoke assertion failed: init preview describes codex plan")
+  process.exit(1)
+}
+const initApplyJson = run(["bin/laicode.js", "init", "--tool", "codex", "--apply", "--json"])
+const initApply = parseJson(initApplyJson, "init apply json parses")
+if (initApply.apply !== true || initApply.plan.tool !== "codex") {
+  console.error("Smoke assertion failed: init apply json describes codex plan")
+  process.exit(1)
+}
+const profilePath = path.join(codexHome, "laicode.config.toml")
+if (!fs.existsSync(profilePath)) {
+  console.error("Smoke assertion failed: init apply writes codex profile")
+  process.exit(1)
+}
+assertIncludes(fs.readFileSync(profilePath, "utf8"), "model_provider = \"laivc\"", "codex profile provider")
+const rollbackJson = run(["bin/laicode.js", "rollback", "--json"])
+const rollback = parseJson(rollbackJson, "rollback json parses")
+if (!rollback.ok || fs.existsSync(profilePath)) {
+  console.error("Smoke assertion failed: rollback removes created codex profile")
+  process.exit(1)
+}
 const configJson = run(["bin/laicode.js", "config", "--json"])
 assertIncludes(configJson, '"defaultModel": "gpt-5.5"', "config json")
 assertExcludes(configJson, "sk-", "config json hides api keys")