@laivc/laicode 0.2.0 → 0.2.1

package/README.md

@@ -16,15 +16,21 @@ Network and model calls use TTY-aware loading animations. JSON output and non-in
 ```bash
 laicode                 # interactive console
 laicode --fancy          # arrow-key console where supported
+laicode tools            # AI tool scan, install, configure, uninstall, reinstall
+laicode tools install --tool codex
+laicode tools install --tool opencode
+laicode tools reinstall --tool claude
+laicode tools configure --tool codex --apply
+laicode init --tool codex # preview a one-click Codex profile
+laicode init --tool codex --apply
+laicode init --tool opencode
+laicode init --tool vscode # guide VS Code extension routes
+laicode rollback         # undo the latest Laicode config write
 laicode brand            # brand mark and palette preview
 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"
@@ -37,7 +43,7 @@ laicode config
 laicode logout
 ```
 
-Local state is stored in `~/.laicode` by default. LaiCode does not modify your existing Claude, ChatGPT, Cursor, Codex, Cline, or Continue configuration in this phase.
+Local state is stored in `~/.laicode` by default. LaiCode previews every AI tool change before applying it, backs up Laicode-managed writes, and can roll them back.
 When logged in, the interactive cockpit shows live account status, online model count, balance, request count, gateway URL, and npm release status. Cockpit snapshots use a short local cache so returning to the menu stays fast.
 
 ## First Run
@@ -49,6 +55,9 @@ laicode models --online
 laicode doctor
 laicode tools
 laicode init --tool codex
+laicode init --tool opencode
+laicode init --tool vscode
+laicode tools install --tool codex
 ```
 
 `status` shows the next recommended actions when the local state is empty.
@@ -69,15 +78,27 @@ Phase 1 focuses on checking local AI tools and safely connecting them to Lai.vc.
 
 ```bash
 laicode tools
+laicode tools install --tool codex
+laicode tools install --tool opencode
 laicode init --tool codex
 laicode init --tool codex --apply
 codex --profile laicode
+laicode init --tool opencode
+laicode init --tool opencode --apply
+opencode
+laicode tools reinstall --tool codex
 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 interactive menu puts "AI 工具一键配置" first. Inside it you can scan all tools, pick one tool, preview/apply configuration, install, uninstall, reinstall, and rollback from a nested menu instead of typing separate commands.
+
+`tools install|uninstall|reinstall` preview shell commands by default. `--apply` executes the command. `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 high-priority scan order follows common AI developer tool usage: Claude Code, Codex CLI, VS Code, Cursor, OpenCode, Continue, and Cline.
+
+Codex creates `~/.codex/laicode.config.toml` instead of modifying the main Codex config. OpenCode can create or merge `~/.config/opencode/opencode.json` with a Lai.vc OpenAI-compatible provider. Continue can create a fresh `~/.continue/config.yaml` when no existing Continue config is present.
 
-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.
+VS Code is treated as an editor host, not a single API client: LaiCode guides users into Codex, Continue, or Cline routes instead of writing editor secure storage directly. Claude Code is detected and installable, but Lai.vc connection is blocked until the gateway exposes Anthropic Messages compatibility. 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.
 

package/bin/laicode.js

@@ -8,13 +8,15 @@ const readline = require("readline")
 const { spawn } = require("child_process")
 const {
   applyInitPlan,
+  applyToolActionPlan,
   buildInitPlan,
+  buildToolActionPlan,
   detectTools,
   rollbackLatest,
   safePlan,
 } = require("../lib/adapters")
 
-const VERSION = "0.2.0"
+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")
@@ -22,14 +24,14 @@ 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"] },
   { 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"] },
@@ -587,10 +589,22 @@ 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,
@@ -621,6 +635,67 @@ async function cmdTools(args = {}) {
   )
 }
 
+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("目标", [
@@ -2252,6 +2327,103 @@ async function menuInit() {
   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) {
@@ -2374,9 +2546,8 @@ async function cmdMenu(args = {}) {
     const action = await selectMenu(
       "选择任务",
       [
+        { label: "AI 工具一键配置", description: "体检、安装、配置、重装、卸载、回滚", value: "tool-hub" },
         { 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" },
@@ -2392,7 +2563,8 @@ 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()

package/lib/adapters.js

@@ -8,6 +8,33 @@ const path = require("path")
 const DEFAULT_API_BASE = "https://api.lai.vc/v1"
 const DEFAULT_MODEL = "gpt-5.5"
 
+const TOOL_PACKAGES = {
+  claude: {
+    packageName: "@anthropic-ai/claude-code",
+    binary: "claude",
+    name: "Claude Code",
+    installNotes: ["官方支持 native installer、Homebrew、WinGet、npm；Laicode 默认使用 npm 全局安装。"],
+  },
+  codex: {
+    packageName: "@openai/codex",
+    binary: "codex",
+    name: "Codex CLI",
+    installNotes: ["官方支持 standalone、npm、Homebrew；Laicode 默认使用 npm 全局安装，便于卸载和重装。"],
+  },
+  opencode: {
+    packageName: "opencode-ai",
+    binary: "opencode",
+    name: "OpenCode",
+    installNotes: ["OpenCode 官方支持 install script、npm、Bun、pnpm、Yarn、Homebrew、Chocolatey、Scoop；Laicode 默认使用 npm 全局安装。"],
+  },
+  continue: {
+    packageName: "@continuedev/cli",
+    binary: "cn",
+    name: "Continue CLI",
+    installNotes: ["Continue CLI 安装后提供 `cn` 命令；IDE 扩展仍需要在对应编辑器内安装。"],
+  },
+}
+
 function homeDir(env = process.env) {
   return env.HOME || env.USERPROFILE || os.homedir()
 }
@@ -51,6 +78,14 @@ function continueHome(env = process.env) {
   return path.join(homeDir(env), ".continue")
 }
 
+function claudeHome(env = process.env) {
+  return path.join(homeDir(env), ".claude")
+}
+
+function opencodeHome(env = process.env) {
+  return path.join(env.XDG_CONFIG_HOME || path.join(homeDir(env), ".config"), "opencode")
+}
+
 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)
@@ -61,6 +96,8 @@ function detectTools(opts = {}) {
   const env = opts.env || process.env
   const codexDir = codexHome(env)
   const continueDir = continueHome(env)
+  const claudeDir = claudeHome(env)
+  const opencodeDir = opencodeHome(env)
   const cursorDir = platformConfigDir("Cursor", env)
   const codeDir = platformConfigDir("Code", env)
   const vscodeExtensions = path.join(homeDir(env), ".vscode", "extensions")
@@ -74,6 +111,15 @@ function detectTools(opts = {}) {
       fs.readdirSync(vscodeExtensions).some((name) => /(^|\.)(cline|claude-dev)/i.test(name)))
 
   return [
+    {
+      id: "claude",
+      name: "Claude Code",
+      detected: commandExists("claude", env) || commandExists("ant", env) || exists(claudeDir) || exists(path.join(homeDir(env), ".claude.json")),
+      support: "blocked",
+      status: commandExists("claude", env) ? "已安装，接入待 Anthropic 网关" : "可安装，接入待 Anthropic 网关",
+      configPath: path.join(claudeDir, "settings.json"),
+      next: "laicode init --tool claude",
+    },
     {
       id: "codex",
       name: "Codex CLI",
@@ -83,6 +129,33 @@ function detectTools(opts = {}) {
       configPath: path.join(codexDir, "laicode.config.toml"),
       next: "laicode init --tool codex --apply",
     },
+    {
+      id: "vscode",
+      name: "VS Code",
+      detected: commandExists("code", env) || exists(codeDir),
+      support: "guide",
+      status: commandExists("code", env) || exists(codeDir) ? "编辑器已发现，请选择具体 AI 扩展接入" : "未检测到",
+      configPath: path.join(codeDir, "User"),
+      next: "laicode init --tool vscode",
+    },
+    {
+      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",
+    },
+    {
+      id: "opencode",
+      name: "OpenCode",
+      detected: commandExists("opencode", env) || exists(opencodeDir),
+      support: "auto",
+      status: exists(path.join(opencodeDir, "opencode.json")) ? "可合并 Lai.vc provider" : "可创建 Lai.vc provider",
+      configPath: path.join(opencodeDir, "opencode.json"),
+      next: "laicode init --tool opencode --apply",
+    },
     {
       id: "continue",
       name: "Continue",
@@ -101,18 +174,18 @@ function detectTools(opts = {}) {
       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 normalizeToolId(tool) {
+  const value = String(tool || "codex").toLowerCase()
+  if (value === "claude-code" || value === "claudecli") return "claude"
+  if (value === "continue-cli") return "continue"
+  if (value === "open-code" || value === "opencode-ai") return "opencode"
+  if (value === "code" || value === "visual-studio-code") return "vscode"
+  return value
+}
+
 function tomlString(value) {
   return JSON.stringify(String(value))
 }
@@ -121,6 +194,10 @@ function yamlString(value) {
   return JSON.stringify(String(value))
 }
 
+function plainObject(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {}
+}
+
 function codexProfileContent(ctx) {
   const model = ctx.model || DEFAULT_MODEL
   const apiBaseUrl = ctx.apiBaseUrl || DEFAULT_API_BASE
@@ -161,6 +238,43 @@ function continueConfigContent(ctx) {
   ].join("\n")
 }
 
+function opencodeConfigContent(ctx, existing = {}) {
+  const model = ctx.model || DEFAULT_MODEL
+  const apiBaseUrl = ctx.apiBaseUrl || DEFAULT_API_BASE
+  const apiKey = ctx.apiKey || "sk-..."
+  const existingProviders = plainObject(existing.provider)
+  const existingLaivc = plainObject(existingProviders.laivc)
+  const existingOptions = plainObject(existingLaivc.options)
+  const existingModels = plainObject(existingLaivc.models)
+  const existingModel = plainObject(existingModels[model])
+  const next = {
+    "$schema": "https://opencode.ai/config.json",
+    ...existing,
+    provider: {
+      ...existingProviders,
+      laivc: {
+        ...existingLaivc,
+        npm: "@ai-sdk/openai-compatible",
+        name: "Lai.vc",
+        options: {
+          ...existingOptions,
+          baseURL: apiBaseUrl,
+          apiKey,
+        },
+        models: {
+          ...existingModels,
+          [model]: {
+            ...existingModel,
+            name: model,
+          },
+        },
+      },
+    },
+    model: `laivc/${model}`,
+  }
+  return JSON.stringify(next, null, 2) + "\n"
+}
+
 function manualPlan(tool, ctx, reason, instructions) {
   return {
     tool,
@@ -176,7 +290,7 @@ function manualPlan(tool, ctx, reason, instructions) {
 
 function buildInitPlan(tool, ctx = {}) {
   const env = ctx.env || process.env
-  const normalized = String(tool || "codex").toLowerCase()
+  const normalized = normalizeToolId(tool)
   const apiBaseUrl = ctx.apiBaseUrl || DEFAULT_API_BASE
   const model = ctx.model || DEFAULT_MODEL
 
@@ -232,6 +346,58 @@ function buildInitPlan(tool, ctx = {}) {
     }
   }
 
+  if (normalized === "opencode") {
+    const target = path.join(opencodeHome(env), "opencode.json")
+    let existing = {}
+    if (exists(target)) {
+      try {
+        existing = JSON.parse(fs.readFileSync(target, "utf8"))
+      } catch {
+        return manualPlan("opencode", { ...ctx, apiBaseUrl, model }, "检测到 OpenCode 配置，但不是有效 JSON，当前版本不自动覆盖。", [
+          `打开 ${target}。`,
+          "按 OpenCode provider 文档新增 `laivc` provider。",
+          `baseURL 填 ${apiBaseUrl}，npm adapter 使用 @ai-sdk/openai-compatible。`,
+        ])
+      }
+    }
+    return {
+      tool: "opencode",
+      ok: true,
+      mode: exists(target) ? "json-merge" : "new-config",
+      summary: "创建或合并 OpenCode Lai.vc provider。",
+      apiBaseUrl,
+      model,
+      runCommand: "opencode",
+      operations: [
+        {
+          action: "write",
+          path: target,
+          mode: 0o600,
+          description: "OpenCode Lai.vc provider",
+          content: opencodeConfigContent({ ...ctx, apiBaseUrl, model }, existing),
+        },
+      ],
+    }
+  }
+
+  if (normalized === "claude") {
+    return manualPlan("claude", { ...ctx, apiBaseUrl, model }, "Claude Code 使用 Anthropic Messages API；当前 Lai.vc 只提供 OpenAI compatible /v1，不能直接接入。", [
+      "等待 Lai.vc 主站提供 Anthropic `/v1/messages` 兼容端点或官方代理决策。",
+      "届时可配置 `ANTHROPIC_BASE_URL` 指向 Lai.vc 的 Anthropic-compatible 网关。",
+      "认证可使用 `ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_API_KEY`，具体以主站契约为准。",
+      "当前请使用 Codex、Continue、Cursor 或 Cline 的 OpenAI compatible 接入路径测试 Lai.vc。",
+    ])
+  }
+
+  if (normalized === "vscode") {
+    return manualPlan("vscode", { ...ctx, apiBaseUrl, model }, "VS Code 是编辑器宿主，本身没有统一的 OpenAI-compatible 网关配置；请选择具体扩展接入。", [
+      "优先使用 Codex CLI/扩展时，运行 `laicode init --tool codex` 创建独立 Codex profile。",
+      "使用 Continue 扩展时，运行 `laicode init --tool continue` 预览 Continue 配置。",
+      "使用 Cline 扩展时，在 Cline 设置中选择 OpenAI Compatible，并填入 Lai.vc base URL 和 API Key。",
+      "Laicode 后续会按扩展稳定配置契约逐个自动化，不直接改 VS Code 安全存储。",
+    ])
+  }
+
   if (normalized === "cline") {
     return manualPlan("cline", { ...ctx, apiBaseUrl, model }, "Cline 设置目前由 VS Code 扩展 UI 管理，先提供可靠指引。", [
       "打开 Cline 设置。",
@@ -254,6 +420,125 @@ function buildInitPlan(tool, ctx = {}) {
   return manualPlan(normalized, { ...ctx, apiBaseUrl, model }, `暂不支持工具: ${normalized}`, ["运行 `laicode tools` 查看当前支持矩阵。"])
 }
 
+function commandPlan(command, args) {
+  return {
+    command,
+    args,
+    display: [command, ...args].join(" "),
+  }
+}
+
+function buildToolActionPlan(tool, action, ctx = {}) {
+  const normalized = normalizeToolId(tool)
+  const normalizedAction = String(action || "scan").toLowerCase()
+  const meta = TOOL_PACKAGES[normalized]
+  const env = ctx.env || process.env
+
+  if (normalizedAction === "configure") {
+    return buildInitPlan(normalized, ctx)
+  }
+
+  if (!["install", "uninstall", "reinstall"].includes(normalizedAction)) {
+    return manualPlan(normalized, ctx, `暂不支持动作: ${normalizedAction}`, [
+      "支持动作: install、uninstall、reinstall、configure。",
+      "运行 `laicode tools` 查看工具状态。",
+    ])
+  }
+
+  if (!meta) {
+    return manualPlan(normalized, ctx, "当前工具没有安全的自动安装/卸载策略。", [
+      "请按工具官方文档安装。",
+      "安装后运行 `laicode tools` 重新检测。",
+    ])
+  }
+
+  const npmCommand = process.platform === "win32" ? "npm.cmd" : "npm"
+  const hasNpm = commandExists(npmCommand, env) || commandExists("npm", env)
+  const commands = []
+  if (normalizedAction === "install") commands.push(commandPlan(npmCommand, ["install", "-g", meta.packageName]))
+  if (normalizedAction === "uninstall") commands.push(commandPlan(npmCommand, ["uninstall", "-g", meta.packageName]))
+  if (normalizedAction === "reinstall") {
+    commands.push(commandPlan(npmCommand, ["uninstall", "-g", meta.packageName]))
+    commands.push(commandPlan(npmCommand, ["install", "-g", meta.packageName]))
+  }
+
+  const postSteps = []
+  if (normalized === "codex") {
+    postSteps.push("运行 `laicode init --tool codex` 预览接入 profile。")
+    postSteps.push("应用后使用 `codex --profile laicode` 测试 Lai.vc。")
+  } else if (normalized === "continue") {
+    postSteps.push("运行 `laicode init --tool continue` 预览 Continue 配置。")
+    postSteps.push("IDE 扩展仍需在 Cursor/VS Code 扩展市场安装。")
+  } else if (normalized === "claude") {
+    postSteps.push("当前只能安装 Claude Code；接入 Lai.vc 需等待 Anthropic Messages 兼容端点。")
+  } else if (normalized === "opencode") {
+    postSteps.push("运行 `laicode init --tool opencode` 预览 OpenCode provider。")
+    postSteps.push("应用后使用 `opencode` 测试 Lai.vc。")
+  }
+
+  return {
+    tool: normalized,
+    action: normalizedAction,
+    ok: hasNpm,
+    mode: "command",
+    summary: `${meta.name} ${normalizedAction} 计划`,
+    reason: hasNpm ? "" : "未找到 npm，无法自动执行安装/卸载命令。",
+    commands,
+    warnings: [
+      "默认只预览命令；传 `--apply` 才会执行。",
+      "卸载/重装只覆盖 npm 全局安装的包；通过 Homebrew、WinGet 或官方安装器安装的版本需用对应工具管理。",
+      ...meta.installNotes,
+    ],
+    postSteps,
+  }
+}
+
+function runCommand(command, args, opts = {}) {
+  const { spawnSync } = require("child_process")
+  const result = spawnSync(command, args, {
+    encoding: "utf8",
+    stdio: opts.stdio || "pipe",
+    env: opts.env || process.env,
+  })
+  return {
+    command,
+    args,
+    status: result.status,
+    ok: result.status === 0,
+    stdout: result.stdout || "",
+    stderr: result.stderr || "",
+    error: result.error ? result.error.message : null,
+  }
+}
+
+async function applyToolActionPlan(plan, opts = {}) {
+  if (!plan.ok || !plan.commands?.length) {
+    throw new Error(plan.reason || "No commands to apply")
+  }
+  const results = []
+  for (const command of plan.commands) {
+    const result = runCommand(command.command, command.args, {
+      stdio: opts.stdio || "inherit",
+      env: opts.env || process.env,
+    })
+    results.push(result)
+    if (!result.ok) {
+      const err = new Error(`Command failed: ${command.display}`)
+      err.result = result
+      err.results = results
+      throw err
+    }
+  }
+  return {
+    tool: plan.tool,
+    action: plan.action,
+    appliedAt: new Date().toISOString(),
+    commands: plan.commands,
+    results,
+    postSteps: plan.postSteps || [],
+  }
+}
+
 function redactText(value, secrets = []) {
   let out = String(value || "")
   for (const secret of secrets.filter(Boolean)) {
@@ -372,7 +657,9 @@ module.exports = {
   DEFAULT_API_BASE,
   DEFAULT_MODEL,
   applyInitPlan,
+  applyToolActionPlan,
   buildInitPlan,
+  buildToolActionPlan,
   detectTools,
   rollbackLatest,
   safePlan,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laivc/laicode",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Official Lai.vc CLI for configuring developer tools.",
   "license": "MIT",
   "homepage": "https://lai.vc",

package/scripts/smoke-test.js

@@ -31,7 +31,14 @@ fs.writeFileSync(
   { mode: 0o600 }
 )
 
-const env = { ...process.env, CODEX_HOME: codexHome, HOME: home, LAICODE_HOME: home, LAICODE_PLAIN: "1" }
+const env = {
+  ...process.env,
+  CODEX_HOME: codexHome,
+  HOME: home,
+  LAICODE_HOME: home,
+  LAICODE_PLAIN: "1",
+  XDG_CONFIG_HOME: path.join(home, ".config"),
+}
 
 function run(args) {
   const result = spawnSync(process.execPath, args, { encoding: "utf8", env })
@@ -76,13 +83,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 tools [scan|install|uninstall|reinstall|configure]", "help lists tools actions")
 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(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", "--version"]), "0.2.1", "long version")
+assertIncludes(run(["bin/laicode.js", "-v"]), "0.2.1", "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")
@@ -95,15 +102,119 @@ if (!Array.isArray(status.nextActions) || !status.nextActions.find((action) => a
   console.error("Smoke assertion failed: status json includes first-run next action")
   process.exit(1)
 }
-assertIncludes(run(["bin/laicode.js", "commands", "--json"]), '"name": "commands"', "commands json")
+const commandsJson = run(["bin/laicode.js", "commands", "--json"])
+assertIncludes(commandsJson, '"name": "commands"', "commands json")
+const commandCatalog = parseJson(commandsJson, "commands json parses")
+if (commandCatalog.commands[0]?.name !== "tools") {
+  console.error("Smoke assertion failed: tools command is first in command catalog")
+  process.exit(1)
+}
 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")
+const toolOrder = tools.tools.map((tool) => tool.id)
+if (toolOrder.slice(0, 5).join(",") !== "claude,codex,vscode,cursor,opencode") {
+  console.error("Smoke assertion failed: high-priority tool order")
+  console.error(toolOrder.join(","))
+  process.exit(1)
+}
 if (!tools.tools.find((tool) => tool.id === "codex")) {
   console.error("Smoke assertion failed: tools json includes codex")
   process.exit(1)
 }
+const vscodeTool = tools.tools.find((tool) => tool.id === "vscode")
+if (!vscodeTool || vscodeTool.support !== "guide") {
+  console.error("Smoke assertion failed: tools json includes guided vscode support")
+  process.exit(1)
+}
+const opencodeTool = tools.tools.find((tool) => tool.id === "opencode")
+if (!opencodeTool || opencodeTool.support !== "auto") {
+  console.error("Smoke assertion failed: tools json includes automatic opencode support")
+  process.exit(1)
+}
+const claudeTool = tools.tools.find((tool) => tool.id === "claude")
+if (!claudeTool || claudeTool.support !== "blocked") {
+  console.error("Smoke assertion failed: tools json includes blocked claude support")
+  process.exit(1)
+}
+const claudeInitJson = run(["bin/laicode.js", "init", "--tool", "claude", "--json"])
+const claudeInit = parseJson(claudeInitJson, "claude init json parses")
+if (claudeInit.plan.ok !== false || !String(claudeInit.plan.reason || "").includes("Anthropic Messages")) {
+  console.error("Smoke assertion failed: claude init explains Anthropic compatibility gap")
+  process.exit(1)
+}
+const vscodeInitJson = run(["bin/laicode.js", "init", "--tool", "vscode", "--json"])
+const vscodeInit = parseJson(vscodeInitJson, "vscode init json parses")
+if (vscodeInit.plan.ok !== false || !String(vscodeInit.plan.reason || "").includes("VS Code 是编辑器宿主")) {
+  console.error("Smoke assertion failed: vscode init explains editor-host boundary")
+  process.exit(1)
+}
+const opencodeInitJson = run(["bin/laicode.js", "init", "--tool", "opencode", "--json"])
+assertExcludes(opencodeInitJson, "sk-smoke-test-secret-value", "opencode init preview redacts api key")
+const opencodeInit = parseJson(opencodeInitJson, "opencode init json parses")
+if (
+  opencodeInit.plan.ok !== true ||
+  opencodeInit.plan.tool !== "opencode" ||
+  !opencodeInit.plan.operations.find((op) => String(op.path || "").endsWith("opencode.json"))
+) {
+  console.error("Smoke assertion failed: opencode init creates provider plan")
+  process.exit(1)
+}
+const opencodePath = path.join(home, ".config", "opencode", "opencode.json")
+fs.mkdirSync(path.dirname(opencodePath), { recursive: true, mode: 0o700 })
+fs.writeFileSync(
+  opencodePath,
+  JSON.stringify(
+    {
+      provider: {
+        other: { name: "Other Provider" },
+        laivc: {
+          options: { customOption: "keep-me" },
+          models: { "old-model": { name: "old-model" } },
+        },
+      },
+    },
+    null,
+    2
+  ) + "\n",
+  { mode: 0o600 }
+)
+const opencodeMergeJson = run(["bin/laicode.js", "init", "--tool", "opencode", "--json"])
+assertExcludes(opencodeMergeJson, "sk-smoke-test-secret-value", "opencode merge preview redacts api key")
+assertIncludes(opencodeMergeJson, "old-model", "opencode merge preserves existing models")
+assertIncludes(opencodeMergeJson, "customOption", "opencode merge preserves existing options")
+const opencodeMerge = parseJson(opencodeMergeJson, "opencode merge json parses")
+if (opencodeMerge.plan.mode !== "json-merge") {
+  console.error("Smoke assertion failed: opencode merge uses json-merge mode")
+  process.exit(1)
+}
+const opencodeMergePreview = parseJson(opencodeMerge.plan.operations[0].preview, "opencode merge preview parses")
+if (
+  opencodeMergePreview.provider.laivc.options.customOption !== "keep-me" ||
+  !opencodeMergePreview.provider.laivc.models["old-model"]
+) {
+  console.error("Smoke assertion failed: opencode merge keeps existing laivc provider details")
+  process.exit(1)
+}
+const installCodexJson = run(["bin/laicode.js", "tools", "install", "--tool", "codex", "--json"])
+const installCodex = parseJson(installCodexJson, "codex install plan json parses")
+if (installCodex.plan.action !== "install" || !installCodex.plan.commands.find((cmd) => cmd.display.includes("@openai/codex"))) {
+  console.error("Smoke assertion failed: codex install plan includes npm package")
+  process.exit(1)
+}
+const installOpencodeJson = run(["bin/laicode.js", "tools", "install", "--tool", "opencode", "--json"])
+const installOpencode = parseJson(installOpencodeJson, "opencode install plan json parses")
+if (installOpencode.plan.action !== "install" || !installOpencode.plan.commands.find((cmd) => cmd.display.includes("opencode-ai"))) {
+  console.error("Smoke assertion failed: opencode install plan includes npm package")
+  process.exit(1)
+}
+const reinstallClaudeJson = run(["bin/laicode.js", "tools", "reinstall", "--tool", "claude", "--json"])
+const reinstallClaude = parseJson(reinstallClaudeJson, "claude reinstall plan json parses")
+if (reinstallClaude.plan.action !== "reinstall" || reinstallClaude.plan.commands.length !== 2) {
+  console.error("Smoke assertion failed: claude reinstall plan includes uninstall and install")
+  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")