thincoder 0.1.0 → 0.3.0

package/src/tui.mjs

@@ -1,14 +1,17 @@
 /**
  * tui.mjs — 裸 ANSI 终端 UI
  * 零依赖：raw mode 键盘输入、ANSI 转义渲染、自研宽字符换行。
- * 布局：header / 对话区（可滚动）/ 输入框 / 状态栏。
+ * 布局：header / 对话区（可滚动）/ todo 面板（有任务时）/ 输入框 / 状态栏。
  */
 
 import { emitKeypressEvents } from "node:readline"
 import { PassThrough } from "node:stream"
 import { basename } from "node:path"
-import { runAgent } from "./agent.mjs"
+import { existsSync, readFileSync } from "node:fs"
+import { runAgent, ContinueError } from "./agent.mjs"
 import { saveSession, clearSession } from "./session.mjs"
+import { PROVIDER_PRESETS as PRESETS } from "./config.mjs"
+import { closeAllMcp } from "./mcp.mjs"
 
 // ---------------------------------------------------------------- ANSI 工具
 
@@ -226,10 +229,15 @@ export async function startTUI(agent, opts = {}) {
     historyIndex: -1,
     scroll: 0, // 从底部向上的滚动行数
     processing: false,
+    controller: null, // AbortController for current agent run
     permission: null, // { name, args, resolve }
+    question: null, // { text, options, resolve } — agent 的 question 工具回调
+    picker: null, // 模型选择器 { entries, lines, index, scroll, selectedLine }
+    wizard: null, // 首次配置向导 { step, index, scroll, selectedLine, fields, error, lines }
     tasks: [], // task 工具的任务列表（状态栏显示进度）
     reasoning: "", // 思考流缓冲（暗色展示）
-    toolStream: "", // 当前工具的实时输出（暗色展示，bash 流式）
+    completion: null, // Tab 补全状态 { candidates, index }
+    toolStreams: {}, // 各工具的实时输出（按工具名隔离，并行工具互不串扰）
     currentTool: null, // 正在执行的工具名（状态栏显示）
     processingStarted: 0, // 本轮处理开始时间（状态栏计时）
     status: "Ready",
@@ -279,6 +287,12 @@ export async function startTUI(agent, opts = {}) {
     } catch {
       // 存失败不耽误退出
     }
+    // 关闭 MCP stdio 子进程，不留孤儿
+    try {
+      closeAllMcp(agent)
+    } catch {
+      // 关不掉就算了，进程马上退出
+    }
     process.stdin.setRawMode(false)
     process.stdout.write(ansi.mouseOff + ansi.mainBuffer + ansi.showCursor + ansi.reset)
   }
@@ -325,6 +339,10 @@ export async function startTUI(agent, opts = {}) {
     const cols = process.stdout.columns || 80
     const rows = process.stdout.rows || 24
     const model = agent.provider.model
+    const thinking = agent.provider.thinking
+    const effort = agent.provider.reasoningEffort
+    const thinkBadge = thinking?.type === "disabled" ? "│ think: off"
+      : effort ? `│ think: ${effort}` : thinking?.type === "enabled" ? "│ think: on" : ""
 
     // 输入区：全边框盒，宽度 W（所有输出行严格 ≤ cols-1，防自动折行错位）
     const W = Math.max(20, cols - 1)
@@ -336,11 +354,37 @@ export async function startTUI(agent, opts = {}) {
       inputOffset = Math.min(layout.cursorLine, layout.lines.length - MAX_INPUT_LINES)
     }
     const inputLines = layout.lines.slice(inputOffset, inputOffset + MAX_INPUT_LINES)
-    const inputBoxH = inputLines.length + 2
+    // question 模式下输入框显示选项/答案草稿，而不是普通输入（高度也要跟着走）
+    let boxLines = inputLines
+    if (state.question) {
+      const q = state.question
+      boxLines = q.options.length > 0
+        ? q.options.map((opt, i) => (i === (q.selected ?? 0) ? "▸ " : "  ") + opt)
+        : ["▸ " + (q.answer ?? "")]
+    }
+    const inputBoxH = boxLines.length + 2
 
     const headerH = 1
     const statusH = 1
-    const convH = Math.max(1, rows - headerH - inputBoxH - statusH)
+    // 浮层（模型选择器 / 初始配置向导）打开时，在对话区下方预留一块（标题 + 列表窗口）
+    const overlay = state.picker ?? state.wizard
+    const pickerH = overlay
+      ? Math.min(overlay.lines.length + 1, Math.max(6, rows - 12))
+      : 0
+    // todo 面板：有任务列表时占对话区与输入框之间最多 5 行
+    // 折叠时优先 in_progress，兼顾最早的 pending 和最近的 done
+    const MAX_TASK_LINES = 5
+    let visibleTasks = []
+    if (state.tasks.length <= MAX_TASK_LINES) {
+      visibleTasks = state.tasks
+    } else {
+      const inProgress = state.tasks.filter((t) => t.status === "in_progress")
+      const pending = state.tasks.filter((t) => t.status === "pending")
+      const done = state.tasks.filter((t) => t.status === "done")
+      visibleTasks = [...inProgress, ...pending, ...done].slice(0, MAX_TASK_LINES)
+    }
+    const taskPanelH = visibleTasks.length
+    const convH = Math.max(1, rows - headerH - inputBoxH - statusH - pickerH - taskPanelH)
 
     // 对话区内容行（含流式缓冲）；markdown 表格先按显示宽度重排
     const convLines = []
@@ -364,9 +408,10 @@ export async function startTUI(agent, opts = {}) {
         }
       }
     }
-    // 工具实时输出（暗色，只保留末尾防刷屏）
-    if (state.toolStream) {
-      const tail = state.toolStream.slice(-4000)
+    // 工具实时输出（暗色，只保留末尾防刷屏；按工具名隔离防止并行工具串扰）
+    const allStreams = Object.values(state.toolStreams).join("")
+    if (allStreams) {
+      const tail = allStreams.slice(-4000)
       for (const wrapped of wrapText(tail, cols - 1)) {
         convLines.push({ text: wrapped, color: C.dim })
       }
@@ -379,9 +424,9 @@ export async function startTUI(agent, opts = {}) {
 
     const out = [ansi.home]
 
-    // header
+    // header（超宽截断，防终端折行）
     out.push(
-      `${ansi.bold}${C.tool} ThinCoder ${ansi.reset}${ansi.dim}│ ${model} │ ${basename(agent.cwd)}${ansi.reset}${ansi.clearLine}`,
+      `${ansi.bold}${C.tool} ThinCoder ${ansi.reset}${ansi.dim}│ ${sliceByWidth(model, 30)}${thinkBadge ? " " + thinkBadge : ""} │ ${sliceByWidth(basename(agent.cwd), Math.max(10, cols - 60))}${ansi.reset}${ansi.clearLine}`,
     )
 
     // 对话区（不足部分补空行，把输入框钉在底部）
@@ -391,16 +436,53 @@ export async function startTUI(agent, opts = {}) {
       out.push(`${l.color}${l.text}${ansi.reset}${ansi.clearLine}`)
     }
 
+    // 浮层（模型选择器 / 初始配置向导）：列表滚动跟随选中行
+    if (overlay) {
+      const winH = pickerH - 1
+      if (overlay.selectedLine < overlay.scroll) overlay.scroll = overlay.selectedLine
+      if (overlay.selectedLine >= overlay.scroll + winH) overlay.scroll = overlay.selectedLine - winH + 1
+      const start = Math.max(0, Math.min(overlay.scroll, Math.max(0, overlay.lines.length - winH)))
+      const shown = overlay.lines.slice(start, start + winH)
+      const overlayTitle = state.picker ? " ❯ 选择模型 " : " ❯ 初始配置 "
+      out.push(`${ansi.bold}${C.tool}${overlayTitle}${ansi.reset}${ansi.dim}${state.picker ? "(↑↓ 移动, Enter 确认, Esc 取消)" : ""}${ansi.reset}${ansi.clearLine}`)
+      for (const l of shown) {
+        out.push(`${l.color}${sliceByWidth(l.text, cols - 1)}${ansi.reset}${ansi.clearLine}`)
+      }
+      for (let i = shown.length; i < winH; i++) out.push(ansi.clearLine)
+    }
+
+    // todo 面板（对话区与输入框之间）：▶ in_progress / ✓ done / ○ pending
+    for (const t of visibleTasks) {
+      const mark = t.status === "done" ? "✓" : t.status === "in_progress" ? "▶" : "○"
+      const color = t.status === "done" ? C.dim : t.status === "in_progress" ? C.tool : C.text
+      out.push(`${color} ${mark} ${sliceByWidth(t.title, cols - 4)}${ansi.reset}${ansi.clearLine}`)
+    }
+
     // 输入框（全边框，宽 W）
-    const borderColor = state.permission ? C.warn : C.tool
-    const title = state.permission
-      ? ` Allow ${state.permission.name}? (y/n) `
-      : state.processing
-        ? " Processing... "
-        : " Input "
+    let borderColor = C.tool
+    let title
+    if (state.question) {
+      borderColor = C.tool
+      title = ` ${sliceByWidth(state.question.text, W - 6)} `
+    } else if (state.permission) {
+      borderColor = C.warn
+      if (state.permission.name === "continue") {
+        title = " Continue? (y/n) "
+      } else {
+        title = ` Allow ${state.permission.name}? (y/n/a) `
+      }
+    } else if (state.picker) {
+      title = " Model "
+    } else if (state.wizard) {
+      title = " Setup "
+    } else if (state.processing) {
+      title = " Processing... "
+    } else {
+      title = " Input "
+    }
     const topBorder = `╭─${title}${"─".repeat(Math.max(0, W - 3 - stringWidth(title)))}╮`
     out.push(`${borderColor}${topBorder}${ansi.reset}${ansi.clearLine}`)
-    for (const l of inputLines) {
+    for (const l of boxLines) {
       const content = sliceByWidth(l, W - 4)
       const fill = " ".repeat(Math.max(0, W - 4 - stringWidth(content)))
       out.push(`${borderColor}│${ansi.reset} ${content}${fill} ${borderColor}│${ansi.reset}${ansi.clearLine}`)
@@ -411,12 +493,42 @@ export async function startTUI(agent, opts = {}) {
     const scrollHint = state.scroll > 0 ? ` │ scrolled ${state.scroll}` : ""
     const rawInput = state.input.join("")
     let statusLine
-    if (rawInput.startsWith("/") && !state.processing && !state.permission) {
-      const prefix = rawInput.split(/\s/)[0]
-      const matches = SLASH_COMMANDS.filter((c) => c.name.startsWith(prefix))
-      statusLine = matches.length > 0
-        ? ` ${matches.map((c) => `${c.name} ${c.desc}`).join("  │  ")}`
-        : ` 未知命令（/help 查看可用命令）`
+    if (state.question) {
+      const q = state.question
+      statusLine = q.options.length > 0
+        ? " ↑↓: 选择 │ Enter: 确认 │ Esc: 取消"
+        : " 输入回答后 Enter 提交 │ Esc: 取消"
+    } else if (state.permission) {
+      statusLine = state.permission.name === "continue"
+        ? " y: 继续 │ n: 停止"
+        : " y: 批准 │ n: 拒绝 │ a: 批准并全部放行（AUTO）"
+    } else if (state.picker) {
+      statusLine = " ↑↓: 选择 │ Enter: 确认 │ Esc: 取消"
+    } else if (state.wizard) {
+      statusLine = state.wizard.step === "provider"
+        ? " ↑↓: 选择 │ Enter: 确认 │ Esc: 跳过"
+        : " 输入后 Enter 确认 │ Esc: 取消"
+    } else if (rawInput.startsWith("/") && !state.processing && !state.permission) {
+      const [cmd, sub] = rawInput.split(/\s+/)
+      const cmds = SLASH_COMMANDS.filter((c) => c.name.startsWith(cmd))
+      const match = cmds.length === 1 ? cmds[0] : null
+      if (match?.name === "/config" && cmd === "/config") {
+        statusLine = " /config 查看  │  embedkey 配 embedding  │  set 改参数"
+      } else if (match?.name === "/provider" && cmd === "/provider") {
+        statusLine = " /provider 列表  │  add / remove / key"
+      } else if (match?.name === "/model" && cmd === "/model" && !sub) {
+        statusLine = " /model 打开选择器  │  /model <名称> 直接切换"
+      } else if (match?.name === "/think" && cmd === "/think") {
+        statusLine = " /think 查看  │  on / off 开关  │  effort high / max 强度"
+      } else if (cmds.length > 0) {
+        if (cmds.length <= 4) {
+          statusLine = ` ${cmds.map((c) => `${c.name} ${c.desc}`).join("  │  ")}`
+        } else {
+          statusLine = ` ${cmds.map((c) => c.name).join("  ")}  │  Tab 补全`
+        }
+      } else {
+        statusLine = ` 未知命令（/help 查看可用命令）`
+      }
     } else {
       const taskHint = state.tasks.length > 0
         ? ` │ ▶${state.tasks.filter((t) => t.status === "done").length}/${state.tasks.length}`
@@ -427,7 +539,12 @@ export async function startTUI(agent, opts = {}) {
       statusLine = ` ${statusText}${taskHint}${scrollHint} │ Enter: send │ /: commands │ wheel/PgUp/PgDn: scroll │ Ctrl+C: exit`
     }
     const autoBanner = agent.autoApprove ? `${C.warn} AUTO${ansi.reset}${ansi.dim}│` : ""
-    out.push(`${ansi.dim}${autoBanner}${statusLine}${ansi.reset}${ansi.clearLine}`)
+    const planBanner = agent.planMode ? `${C.tool} PLAN${ansi.reset}${ansi.dim}│` : ""
+    // 状态栏最多一行：终端宽度扣掉 banner 前缀的可视列数，防折行
+    const bannerPrefix = (agent.planMode ? " PLAN│ " : "") + (agent.autoApprove ? " AUTO│ " : "")
+    const statusMax = cols - 1 - (bannerPrefix ? stringWidth(bannerPrefix) : 0)
+    statusLine = sliceByWidth(statusLine, Math.max(10, statusMax))
+    out.push(`${ansi.dim}${planBanner}${autoBanner}${statusLine}${ansi.reset}${ansi.clearLine}`)
 
     const frame = out.join("\r\n")
     if (frame !== lastFrame) {
@@ -435,11 +552,11 @@ export async function startTUI(agent, opts = {}) {
       process.stdout.write(frame)
     }
 
-    // 光标：输入态定位到输入框内（IME 候选框跟随真实光标）；处理中/权限确认时隐藏
-    if (state.processing || state.permission) {
+    // 光标：输入态定位到输入框内（IME 候选框跟随真实光标）；处理中/权限确认/菜单态时隐藏
+    if (state.processing || state.permission || state.question || state.picker || state.wizard?.step === "provider") {
       process.stdout.write(ansi.hideCursor)
     } else {
-      const cursorRow = 1 + convH + 2 + (layout.cursorLine - inputOffset) // header + 对话区 + 上边框 + 行偏移
+      const cursorRow = 1 + convH + taskPanelH + 2 + (layout.cursorLine - inputOffset) // header + 对话区 + todo 面板 + 上边框 + 行偏移
       const cursorCol = 3 + layout.cursorCol // 左边框 + 空格 + 文本偏移（1 基）
       process.stdout.write(`${ESC}[${cursorRow};${cursorCol}H${ansi.showCursor}`)
     }
@@ -482,63 +599,105 @@ export async function startTUI(agent, opts = {}) {
     state.reasoning = ""
     state.currentTool = null
     state.processingStarted = Date.now()
+    state.controller = new AbortController()
     // 处理中每秒刷新一次状态栏（运行计时）
     const ticker = setInterval(() => {
       if (state.processing) render()
     }, 1000)
     render()
 
-    try {
-      await runAgent(agent, text, {
-        onToken: (t) => {
-          ensureAssistantLabel()
-          state.streaming += t
-          scheduleRender() // token 洪流限流，防闪屏
-        },
-        onReasoning: (t) => {
-          ensureAssistantLabel()
-          state.reasoning += t
-          scheduleRender()
-        },
-        onToolCall: (name, args) => {
-          flushStream()
-          ensureAssistantLabel()
-          state.currentTool = name
-          pushLine(`  [tool] ${name} ${summarize(args)}`, C.tool)
-        },
-        onToolResult: (name, result) => {
-          state.currentTool = null
-          if (state.toolStream) {
-            // 实时输出落盘为历史行（保留末尾 4000 字符），并清掉临时缓冲
-            const tail = state.toolStream.trimEnd().slice(-4000)
-            if (tail) pushLine(tail, C.dim)
-            state.toolStream = ""
+    const callbacks = {
+      onToken: (t) => {
+        ensureAssistantLabel()
+        state.streaming += t
+        scheduleRender()
+      },
+      onReasoning: (t) => {
+        ensureAssistantLabel()
+        state.reasoning += t
+        scheduleRender()
+      },
+      onToolCall: (name, args) => {
+        flushStream()
+        ensureAssistantLabel()
+        state.currentTool = name
+        pushLine(`  [tool] ${name} ${summarize(args)}`, C.tool)
+      },
+      onToolResult: (name, result) => {
+        state.currentTool = null
+        const stream = state.toolStreams[name]
+        if (stream) {
+          const tail = stream.trimEnd().slice(-4000)
+          if (tail) pushLine(tail, C.dim)
+          delete state.toolStreams[name]
+        }
+        const first = result.split("\n")[0]
+        pushLine(`  [done] ${name} → ${sliceByWidth(first, 100)}`, C.dim)
+      },
+      onToolOutput: (name, chunk) => {
+        state.toolStreams[name] = (state.toolStreams[name] ?? "") + chunk
+        scheduleRender()
+      },
+      onPermissionRequest: (name, args) => askPermission(name, args),
+      onQuestion: (text, options) => askQuestion(text, options),
+      onCompress: () => {
+        pushLine("  [context] 上下文过长，已自动压缩（早期对话由 LLM 摘要，任务状态保留）", C.warn)
+      },
+      onTaskUpdate: (items) => {
+        state.tasks = items
+        const done = items.filter((i) => i.status === "done").length
+        pushLine(`  [task] ${done}/${items.length}`, C.dim)
+        render()
+      },
+    }
+
+    for (let resume = false; ; resume = true) {
+      try {
+        await runAgent(agent, text, callbacks, { signal: state.controller.signal, resume })
+        flushStream()
+        break // 正常完成，退出循环
+      } catch (error) {
+        flushStream()
+        if (error.name === "AbortError" || state.controller?.signal.aborted) {
+          pushLine("[已中止]", C.warn)
+          break
+        }
+        if (error instanceof ContinueError) {
+          pushLabel(`❯ Continue`, ansi.bold + C.warn)
+          pushLine(`已执行 ${error.turn} 轮（上限 ${error.turn}），要继续吗？`, C.warn)
+          // 暂停询问：复用 permission 机制
+          const willContinue = await new Promise((resolve) => {
+            state.permission = {
+              name: "continue",
+              args: { turns: error.turn },
+              resolve,
+            }
+            state.status = `Continue after ${error.turn} turns?`
+            render()
+          })
+          state.permission = null
+          if (!willContinue) {
+            pushLine("[已取消继续]", C.warn)
+            break
           }
-          const first = result.split("\n")[0]
-          pushLine(`  [done] ${name} → ${sliceByWidth(first, 100)}`, C.dim)
-        },
-        onToolOutput: (name, chunk) => {
-          state.toolStream += chunk
-          scheduleRender()
-        },
-        onPermissionRequest: (name, args) => askPermission(name, args),
-        onTaskUpdate: (items) => {
-          state.tasks = items
-          const done = items.filter((i) => i.status === "done").length
-          pushLine(`  [task] ${done}/${items.length}`, C.dim)
-          render()
-        },
-      })
-      flushStream()
-    } catch (error) {
-      flushStream()
-      pushLine(`[error] ${error.message}`, C.error)
-    } finally {
-      clearInterval(ticker)
+          pushLine("[继续执行…]", C.tool)
+          // 重创新 AbortController：旧 signal 一旦 abort 过，resume 会立即失败（防御性，当前路径不可达但耦合紧）
+          state.controller = new AbortController()
+          continue
+        }
+        pushLine(`[error] ${error.message}`, C.error)
+        break
+      }
     }
 
+    clearInterval(ticker)
     state.processing = false
+    state.controller = null
     state.status = "Ready"
+    // 全部完成时自动收起 todo 面板（对齐 kimi-code TUI；agent.tasks 本身保留）
+    if (state.tasks.length > 0 && state.tasks.every((t) => t.status === "done")) {
+      state.tasks = []
+    }
     // 每轮结束后保存会话（崩溃也不丢）
     try {
       saveSession(agent)
@@ -565,6 +724,9 @@ export async function startTUI(agent, opts = {}) {
       pushLine(`  [auto] ${name} ${summarize(args)}`, C.warn)
       return Promise.resolve(true)
     }
+    // 把关键参数摆出来：批什么要让人看明白
+    pushLabel(`❯ 权限请求`, ansi.bold + C.warn)
+    for (const line of formatPermission(name, args)) pushLine(`  ${line}`, C.text)
     return new Promise((resolve) => {
       state.permission = { name, args, resolve }
       state.status = `Waiting: ${name}`
@@ -572,19 +734,62 @@ export async function startTUI(agent, opts = {}) {
     })
   }
 
+  /** 权限请求的关键信息（按工具定制），返回行数组 */
+  function formatPermission(name, args) {
+    const cap = (s, n = 1000) => (s.length > n ? `${s.slice(0, n)}…(共 ${s.length} 字符)` : s)
+    if (name === "bash") return cap(args.command ?? "").split("\n")
+    if (name === "write") return [`${args.path}（写入 ${(args.content ?? "").length} 字符）`]
+    if (name === "edit") return [`${args.path}（替换 ${(args.old_string ?? "").length} 字符 → ${(args.new_string ?? "").length} 字符）`]
+    if (name === "subagent") return cap(args.task ?? "", 500).split("\n")
+    if (name === "memory_put") return [`[${args.type ?? ""}] ${args.title ?? ""}`]
+    return [cap(summarize(args), 300)]
+  }
+
+  function askQuestion(text, options = []) {
+    // 一次只能问一个：question 是只读工具走并行通道，同批第二个直接驳回，
+    // 否则后到的会覆盖 state.question，先到的 Promise 永远悬挂（agent 死等）
+    if (state.question) {
+      return Promise.resolve("(error: 已有问题在等待回答；请一次只问一个，得到答复后再问下一个)")
+    }
+    if (!options.length) {
+      // 自由文本：打开输入态让用户打字，Enter 提交
+      pushLabel(`❯ Question`, ansi.bold + C.tool)
+      for (const line of text.split("\n")) pushLine(`  ${line}`, C.text)
+      return new Promise((resolve) => {
+        state.question = { text, options: [], resolve }
+        state.status = "Waiting for answer..."
+        render()
+      })
+    }
+    // 选项模式：输入框内显示列表，方向键选，Enter 确认
+    pushLabel(`❯ Question`, ansi.bold + C.tool)
+    for (const line of text.split("\n")) pushLine(`  ${line}`, C.text)
+    return new Promise((resolve) => {
+      state.question = { text, options, selected: 0, resolve }
+      state.status = "Waiting for choice..."
+      render()
+    })
+  }
+
   // ---------------------------------------------------------- 斜杠命令
 
   const SLASH_COMMANDS = [
-    { name: "/help", desc: "命令列表" },
-    { name: "/model", desc: "查看/切换模型" },
-    { name: "/config", desc: "查看当前配置" },
-    { name: "/auto", desc: "自动授权开关" },
-    { name: "/rewind", desc: "回滚到存档点" },
-    { name: "/reindex", desc: "重建记忆索引" },
-    { name: "/distill", desc: "从会话提取知识" },
-    { name: "/new", desc: "开始新会话" },
-    { name: "/clear", desc: "清屏" },
-    { name: "/exit", desc: "退出" },
+    { name: "/plan", group: "Agent", desc: "规划模式（先设计、再实现）" },
+    { name: "/auto", group: "Agent", desc: "自动授权开关" },
+    { name: "/model", group: "Agent", desc: "选择模型" },
+    { name: "/goal", group: "Agent", desc: "设置/查看/取消长期目标" },
+    { name: "/think", group: "Agent", desc: "思维模式与推理强度" },
+    { name: "/skills", group: "Tools", desc: "列出项目技能" },
+    { name: "/mcp", group: "Tools", desc: "管理 MCP server" },
+    { name: "/provider", group: "Config", desc: "管理 provider（增/删/配 key）" },
+    { name: "/config", group: "Config", desc: "配置管理（embedding / agent）" },
+    { name: "/reindex", group: "Config", desc: "重建记忆索引" },
+    { name: "/new", group: "Session", desc: "开始新会话" },
+    { name: "/clear", group: "Session", desc: "清屏" },
+    { name: "/distill", group: "Session", desc: "从会话提取知识" },
+    { name: "/rewind", group: "Session", desc: "回滚到存档点" },
+    { name: "/exit", group: "Session", desc: "退出" },
+    { name: "/help", group: "", desc: "此列表" },
   ]
 
   async function handleSlash(text) {
@@ -598,6 +803,9 @@ export async function startTUI(agent, opts = {}) {
       case "/new":
         agent.history = []
         agent.tasks = []
+        agent.planMode = false
+        agent.goal = null
+        agent._pendingReminders = []
         state.tasks = []
         state.lines = []
         state.streaming = ""
@@ -606,7 +814,7 @@ export async function startTUI(agent, opts = {}) {
         return
       case "/exit":
         cleanup()
-        process.exit(0)
+        setTimeout(() => process.exit(0), 100) // 延迟一拍：fetch 后立刻 exit 在 Windows/Node 24 会触发 libuv 断言
         return
       case "/reindex": {
         const { syncDir } = await import("./memory.mjs")
@@ -658,8 +866,200 @@ export async function startTUI(agent, opts = {}) {
         }
         return
       }
+      case "/plan": {
+        agent.planMode = !agent.planMode
+        agent._pendingReminders = agent._pendingReminders ?? []
+        if (agent.planMode) {
+          agent._pendingReminders.push("[System reminder: plan mode is now ON. You are restricted to READ-ONLY tools — explore, search, read, analyze. DO NOT write, edit, or run mutation commands. Present your design to the user first.]")
+        } else {
+          agent._pendingReminders.push("[System reminder: plan mode is now OFF. You may edit files, run commands, and implement changes.]")
+        }
+        pushLabel(`❯ Plan`, ansi.bold + (agent.planMode ? C.tool : C.dim))
+        pushLine(
+          agent.planMode
+            ? `规划模式已开启：只读工具受限，先设计方案再实现。再次 /plan 退出。`
+            : `规划模式已关闭：可以编辑文件和执行命令了。`,
+          agent.planMode ? C.tool : C.dim,
+        )
+        return
+      }
+      case "/goal": {
+        const sub = rest[0]
+        if (sub === "set") {
+          const text = rest.slice(1).join(" ")
+          if (!text) { pushLine("用法: /goal set <目标描述>（; 分隔完成条件）", C.error); return }
+          const semi = text.indexOf("；") >= 0 ? "；" : text.indexOf(";") >= 0 ? ";" : null
+          const objective = semi ? text.slice(0, semi).trim() : text.trim()
+          const criteria = semi ? text.slice(semi + 1).trim() : ""
+          agent.goal = { objective, criteria, setAt: Date.now() }
+          pushLabel(`❯ Goal`, ansi.bold + C.warn)
+          pushLine(`目标已设置: ${objective}`, C.tool)
+          if (criteria) pushLine(`  完成条件: ${criteria}`, C.dim)
+          return
+        }
+        if (sub === "cancel") {
+          agent.goal = null
+          pushLabel(`❯ Goal`, ansi.bold + C.dim)
+          pushLine(`目标已取消。`, C.dim)
+          return
+        }
+        if (agent.goal) {
+          pushLabel(`❯ Goal`, ansi.bold + C.warn)
+          pushLine(`目标: ${agent.goal.objective}`, C.tool)
+          if (agent.goal.criteria) pushLine(`  完成条件: ${agent.goal.criteria}`, C.dim)
+          pushLine(`  设置于: ${new Date(agent.goal.setAt).toLocaleString()}`, C.dim)
+          pushLine("操作: /goal set <描述> 覆盖 | /goal cancel 取消", C.dim)
+        } else {
+          pushLabel(`❯ Goal`, ansi.bold + C.dim)
+          pushLine("（无活跃目标——/goal set <描述> 设置）", C.dim)
+        }
+        return
+      }
+      case "/skills": {
+        const { loadSkills } = await import("./skills.mjs")
+        const skills = await loadSkills(agent.cwd)
+        pushLabel(`❯ Skills`, ansi.bold + C.tool)
+        if (skills.length === 0) {
+          pushLine("（无项目技能——在 .thincoder/skills/ 下创建 .md 文件即可添加）", C.dim)
+        }
+        for (const s of skills) {
+          pushLine(`  ${s.name}: ${s.description.slice(0, 100)}`, C.dim)
+        }
+        pushLine("激活: 告诉 agent \"load the <name> skill\"", C.dim)
+        return
+      }
+      case "/mcp": {
+        const sub = rest[0]
+        // ---- /mcp list — 列出配置的 servers + 连接状态 ----
+        if (!sub || sub === "list") {
+          const servers = agent.config?.mcp?.servers ?? []
+          pushLabel(`❯ MCP Servers`, ansi.bold + C.tool)
+          if (servers.length === 0) {
+            pushLine("（无 MCP server——使用 /mcp add <name> <command> [args] 添加）", C.dim)
+          }
+          for (const srv of servers) {
+            const connected = agent.tools.some((t) => t._mcpName === srv.name)
+            const mark = connected ? "●" : "○"
+            const color = connected ? C.tool : C.dim
+            const toolCount = agent.tools.filter((t) => t._mcpName === srv.name).length
+            const desc = srv.url ? srv.url : `${srv.command} ${(srv.args ?? []).join(" ")}`
+            pushLine(`  ${mark} ${srv.name}: ${desc}  (${toolCount} tools)`, color)
+          }
+          pushLabel(`❯ 操作`, ansi.bold + C.tool)
+          pushLine(`/mcp add <name> <command> [args...]    添加 stdio server`, C.dim)
+          pushLine(`/mcp url <name> <url> [headers...]     添加 HTTP server`, C.dim)
+          pushLine(`/mcp remove <name>                     断开并移除 server`, C.dim)
+          pushLine(`/mcp connect <name>                   重连已配置的 server`, C.dim)
+          pushLine("配置持久化到 config.json 的 mcp.servers[]", C.dim)
+          return
+        }
+        // ---- /mcp add <name> <command> [args...] (stdio) ----
+        if (sub === "add") {
+          const args = rest.slice(1)
+          if (args.length < 2) {
+            pushLine("用法: /mcp add <name> <command> [args...]", C.error)
+            pushLine("  例: /mcp add github npx -y @modelcontextprotocol/server-github", C.dim)
+            return
+          }
+          const name = args[0]
+          const command = args[1]
+          const cmdArgs = args.slice(2)
+          const existing = (agent.config?.mcp?.servers ?? []).find((s) => s.name === name)
+          if (existing) { pushLine(`[mcp] "${name}" 已存在，用 /mcp remove ${name} 先移除`, C.error); return }
+          const srv = { name, command, args: cmdArgs.length > 0 ? cmdArgs : undefined }
+          await addAndConnect(srv)
+          return
+        }
+        // ---- /mcp url <name> <url> [key=value...] (HTTP) ----
+        if (sub === "url") {
+          const args = rest.slice(1)
+          if (args.length < 2) {
+            pushLine("用法: /mcp url <name> <url> [header=value...]", C.error)
+            pushLine("  例: /mcp url myapi https://api.example.com/mcp Authorization=\"Bearer token123\"", C.dim)
+            return
+          }
+          const name = args[0]
+          const url = args[1]
+          const headerPairs = args.slice(2)
+          const existing = (agent.config?.mcp?.servers ?? []).find((s) => s.name === name)
+          if (existing) { pushLine(`[mcp] "${name}" 已存在，用 /mcp remove ${name} 先移除`, C.error); return }
+          const headers = {}
+          for (const pair of headerPairs) {
+            const eq = pair.indexOf("=")
+            if (eq > 0) headers[pair.slice(0, eq)] = pair.slice(eq + 1).replace(/^["']|["']$/g, "")
+          }
+          const srv = { name, url, headers: Object.keys(headers).length > 0 ? headers : undefined }
+          await addAndConnect(srv)
+          return
+        }
+        // ---- /mcp remove <name> ----
+        if (sub === "remove") {
+          const name = rest[1]
+          if (!name) { pushLine("用法: /mcp remove <name>", C.error); return }
+          const { removeMcpTools } = await import("./mcp.mjs")
+          removeMcpTools(agent, name)
+          await persistRaw((raw) => { raw.mcp ??= { servers: [] }; raw.mcp.servers = raw.mcp.servers.filter((s) => s.name !== name) })
+          if (agent.config?.mcp?.servers) agent.config.mcp.servers = agent.config.mcp.servers.filter((s) => s.name !== name)
+          pushLabel(`❯ MCP`, ansi.bold + C.tool)
+          pushLine(`${name} 已断开并从配置移除。`, C.tool)
+          return
+        }
+        // ---- /mcp connect <name> — 重连 ----
+        if (sub === "connect") {
+          const name = rest[1]
+          if (!name) { pushLine("用法: /mcp connect <name>", C.error); return }
+          const srv = (agent.config?.mcp?.servers ?? []).find((s) => s.name === name)
+          if (!srv) { pushLine(`[mcp] "${name}" 未在配置中找到（先用 /mcp add 或 /mcp url）`, C.error); return }
+          const { removeMcpTools, connectMcpServer } = await import("./mcp.mjs")
+          removeMcpTools(agent, name)
+          try {
+            pushLine(`[mcp] 重连 ${name}...`, C.dim)
+            const tools = await connectMcpServer(srv)
+            agent.tools.push(...tools)
+            pushLabel(`❯ MCP`, ansi.bold + C.tool)
+            pushLine(`${name} 已重连，${tools.length} 个工具可用。`, C.tool)
+          } catch (error) {
+            pushLine(`[mcp] ${name}: ${error.message}`, C.error)
+          }
+          return
+        }
+        pushLine(`未知子命令: ${sub}（/mcp list | add | url | remove | connect）`, C.error)
+        return
+      }
+
+      // ---- /mcp 共享 helper: 保存配置 + 连接 ----
+      async function addAndConnect(srv) {
+        await persistRaw((raw) => {
+          raw.mcp ??= { servers: [] }
+          const entry = { name: srv.name }
+          if (srv.url) { entry.url = srv.url; if (srv.headers) entry.headers = srv.headers }
+          else { entry.command = srv.command; if (srv.args) entry.args = srv.args }
+          raw.mcp.servers.push(entry)
+        })
+        agent.config ??= {}
+        agent.config.mcp ??= { servers: [] }
+        agent.config.mcp.servers.push(srv)
+        try {
+          pushLine(`[mcp] 连接 ${srv.name}...`, C.dim)
+          const { connectMcpServer } = await import("./mcp.mjs")
+          const tools = await connectMcpServer(srv)
+          agent.tools.push(...tools)
+          pushLabel(`❯ MCP`, ansi.bold + C.tool)
+          const desc = srv.url ? srv.url : `${srv.command} ${(srv.args ?? []).join(" ")}`
+          pushLine(`${srv.name} (${desc}) 已连接，${tools.length} 个工具:`, C.tool)
+          for (const t of tools) pushLine(`  ${t.name}: ${t.description.slice(0, 100)}`, C.dim)
+        } catch (error) {
+          pushLine(`[mcp] ${srv.name}: ${error.message}（配置已保存，重启后重试）`, C.error)
+        }
+      }
       case "/auto":
         agent.autoApprove = !agent.autoApprove
+        agent._pendingReminders = agent._pendingReminders ?? []
+        if (agent.autoApprove) {
+          agent._pendingReminders.push("[System reminder: AUTO mode is now ON. All tool calls are automatically approved — you may write, edit, and run commands without asking. Use this for long autonomous tasks. The user can still interrupt.]")
+        } else {
+          agent._pendingReminders.push("[System reminder: AUTO mode is now OFF. Destructive tool calls now require user approval again. Confirm before writing files, running commands, or spawning subagents.]")
+        }
         pushLabel(`❯ Auto`, ansi.bold + (agent.autoApprove ? C.warn : C.tool))
         pushLine(
           agent.autoApprove
@@ -668,53 +1068,247 @@ export async function startTUI(agent, opts = {}) {
           agent.autoApprove ? C.warn : C.dim,
         )
         return
+      case "/think": {
+        const sub = rest[0]
+        const cur = agent.provider
+        const thinkingEnabled = cur.thinking?.type === "enabled" || cur.thinking?.type === undefined
+        // ---- /think（无参）: 查看状态 ----
+        if (!sub) {
+          pushLabel(`❯ Think`, ansi.bold + C.tool)
+          pushLine(`思维模式: ${thinkingEnabled ? "🟢 开启" : "⚫ 关闭"}`, C.dim)
+          pushLine(`推理强度: ${cur.reasoningEffort ?? "(未设置)"}`, C.dim)
+          pushLine(`切换: /think on | off | effort high | effort max`, C.dim)
+          return
+        }
+        // ---- /think on / off ----
+        if (sub === "on" || sub === "off") {
+          const enable = sub === "on"
+          cur.thinking = enable ? { type: "enabled" } : { type: "disabled" }
+          if (!enable) delete cur.reasoningEffort
+          else if (!cur.reasoningEffort) cur.reasoningEffort = "high"
+          await syncProviderField("thinking", cur.thinking)
+          if (!enable) await syncProviderField("reasoningEffort", undefined)
+          else await syncProviderField("reasoningEffort", cur.reasoningEffort)
+          pushLabel(`❯ Think`, ansi.bold + C.tool)
+          pushLine(`思维模式已${enable ? "开启" : "关闭"}`, C.tool)
+          if (enable) pushLine(`推理强度: ${cur.reasoningEffort}`, C.dim)
+          return
+        }
+        // ---- /think effort <level> ----
+        if (sub === "effort") {
+          const level = rest[1]
+          if (!level || !["low", "high", "max"].includes(level)) {
+            pushLine("用法: /think effort low | high | max", C.error)
+            return
+          }
+          cur.reasoningEffort = level
+          await syncProviderField("reasoningEffort", level)
+          pushLabel(`❯ Think`, ansi.bold + C.tool)
+          pushLine(`推理强度已设为 ${level}`, C.tool)
+          return
+        }
+        pushLine(`未知参数: ${sub}（可用: on / off / effort / effort high|max）`, C.error)
+        return
+      }
       case "/model": {
         const arg = rest[0]
         if (!arg) {
+          // 打开交互选择器：全部 provider 的全部模型，方向键选择
           pushLabel(`❯ Model`, ansi.bold + C.tool)
-          pushLine(`model:   ${agent.provider.model}`, C.dim)
-          pushLine(`baseURL: ${agent.provider.baseURL}`, C.dim)
-          pushLine(`切换: /model <名称>（仅本次会话；永久修改请编辑 ~/.thincoder/config.json）`, C.dim)
-          // 拉取端点可用模型列表
-          pushLine(`正在拉取可用模型...`, C.dim)
-          try {
-            const { listModels } = await import("./provider.mjs")
-            const models = await listModels(agent.provider)
-            pushLabel(`❯ Available (${models.length})`, ansi.bold + C.tool)
-            for (const m of models) {
-              pushLine(`  ${m === agent.provider.model ? "▸ " : "  "}${m}`, m === agent.provider.model ? C.tool : C.dim)
-            }
-          } catch (error) {
-            pushLine(`  (拉取失败: ${error.message})`, C.error)
+          pushLine(`/model <名称>      直接切换 provider 或模型（如 /model deepseek-v4-pro）`, C.dim)
+          pushLine(`/provider          管理 provider（添加/删除/配 key）`, C.dim)
+          openModelPicker().catch((e) => pushLine(`[error] ${e.message}`, C.error))
+          return
+        }
+        if (arg === "add" || arg === "--add") {
+          pushLine(`添加 provider 已移到 /provider add（/provider 查看全部管理命令）`, C.warn)
+          return
+        }
+        // 一个参数两种含义：先按 provider 名匹配，匹配不到就当模型名改当前 provider
+        const { resolveCompactThreshold } = await import("./config.mjs")
+        const p = agent.providers.find((pp) => pp.name === arg)
+        const newModel = p ? p.model : arg
+        let thresholdNote = ""
+        if (agent.config?.agent?.compactThresholdAuto) {
+          const { value } = resolveCompactThreshold(null, newModel)
+          agent.config.agent.compactThreshold = value
+          thresholdNote = `，压缩阈值随模型调整为 ${value}`
+        }
+        if (p) {
+          agent.activeProvider = arg
+          agent.provider = { ...p }
+          // key 的环境变量兜底和 loadConfig 保持一致（提供商专用变量只对同名生效）
+          if (!agent.provider.apiKey) {
+            const envKey = { deepseek: "DEEPSEEK_API_KEY", openai: "OPENAI_API_KEY" }[arg]
+            if (envKey && process.env[envKey]) agent.provider.apiKey = process.env[envKey]
           }
+          if (!agent.provider.apiKey) agent.provider.apiKey = process.env.THINCODER_API_KEY
+          await persistRaw((raw) => { raw.activeProvider = arg })
+          agent.config.activeProvider = arg
+          pushLabel(`❯ Model`, ansi.bold + C.tool)
+          pushLine(`已切换到 ${arg} / ${p.model}${thresholdNote}（已持久化）`, C.tool)
+          if (!agent.provider.apiKey) pushLine(`该 provider 还没配 key: /provider key <apikey>`, C.warn)
         } else {
+          const target = agent.providers.find((pp) => pp.name === agent.activeProvider) ?? agent.providers[0]
+          if (target) target.model = arg
           agent.provider.model = arg
-          // 阈值是自动推导的则跟着新模型走；用户显式配置过的不动
-          let thresholdNote = ""
-          if (agent.config?.agent?.compactThresholdAuto) {
-            const { resolveCompactThreshold } = await import("./config.mjs")
-            const { value } = resolveCompactThreshold(null, arg)
-            agent.config.agent.compactThreshold = value
-            thresholdNote = `，压缩阈值随模型调整为 ${value}`
-          }
+          await persistRaw((raw) => { raw.providers = agent.providers })
           pushLabel(`❯ Model`, ansi.bold + C.tool)
-          pushLine(`已切换到 ${arg}（仅本次会话）${thresholdNote}`, C.tool)
+          pushLine(`已将 ${target?.name ?? agent.activeProvider} 的模型改为 ${arg}${thresholdNote}（已持久化）`, C.tool)
+        }
+        return
+      }
+      case "/provider": {
+        const sub = rest[0]
+        // ---- /provider add <名称> <baseURL> <模型>，或 /provider add <预设> ----
+        if (sub === "add") {
+          const name = rest[1]
+          if (!name) {
+            pushLine(`用法: /provider add <名称> <baseURL> <模型>，或 /provider add <预设>（${Object.keys(PRESETS).join(", ")}）`, C.error)
+            return
+          }
+          if (agent.providers.some((p) => p.name === name)) {
+            pushLine(`"${name}" 已存在；要重建可先 /provider remove ${name}`, C.warn)
+            return
+          }
+          const preset = PRESETS[name]
+          const baseURL = (rest[2] ?? preset?.baseURL)?.replace(/\/+$/, "")
+          const model = rest[3] ?? preset?.model
+          if (!baseURL || !model) {
+            pushLine(`缺少参数: /provider add ${name} <baseURL> <模型>`, C.error)
+            if (!preset) pushLine(`（"${name}" 不是预设；预设: ${Object.keys(PRESETS).join(", ")}）`, C.dim)
+            return
+          }
+          if (!/^https?:\/\//.test(baseURL)) { pushLine(`baseURL 应以 http(s):// 开头`, C.error); return }
+          agent.providers.push({ name, baseURL, model, ...(preset?.desc ? { desc: preset.desc } : {}) })
+          await persistRaw((raw) => { raw.providers = agent.providers })
+          pushLabel(`❯ Provider`, ansi.bold + C.tool)
+          pushLine(`已添加 ${name}（${baseURL} / ${model}）`, C.tool)
+          pushLine(`下一步: /provider key ${name} <apikey> 配 key，/model ${name} 切换`, C.dim)
+          return
+        }
+        // ---- /provider remove <名称> ----
+        if (sub === "remove" || sub === "rm") {
+          const name = rest[1]
+          if (!name) { pushLine("用法: /provider remove <名称>", C.error); return }
+          const at = agent.providers.findIndex((p) => p.name === name)
+          if (at < 0) { pushLine(`未找到 provider "${name}"`, C.error); return }
+          if (name === agent.activeProvider) { pushLine(`"${name}" 正在使用中，先 /model 切换到别的 provider 再删`, C.warn); return }
+          agent.providers.splice(at, 1)
+          await persistRaw((raw) => { raw.providers = agent.providers })
+          pushLabel(`❯ Provider`, ansi.bold + C.tool)
+          pushLine(`已删除 ${name}`, C.tool)
+          return
         }
+        // ---- /provider key [名称] <apikey> ----
+        if (sub === "key") {
+          let name = agent.activeProvider
+          let keyParts = rest.slice(1)
+          if (rest[1] && agent.providers.some((p) => p.name === rest[1])) {
+            name = rest[1]
+            keyParts = rest.slice(2)
+          }
+          const key = keyParts.join(" ")
+          if (!key) { pushLine("用法: /provider key [名称] <apikey>（不填名称配当前 provider）", C.error); return }
+          await setProviderKey(name, key)
+          return
+        }
+        if (sub) { pushLine(`未知: ${sub}（/provider add | remove | key）`, C.error); return }
+        // ---- /provider（无参）: 列表 ----
+        pushLabel(`❯ Providers (${agent.providers.length})`, ansi.bold + C.tool)
+        for (const p of agent.providers) {
+          const active = p.name === agent.activeProvider
+          pushLine(
+            `${active ? " ▸" : "  "} ${p.name.padEnd(12)} ${p.model.padEnd(20)} ${p.baseURL}${p.apiKey ? " ●key" : " ○无key"}${active ? " ← 当前" : ""}`,
+            active ? C.tool : C.dim,
+          )
+        }
+        pushLabel(`❯ 操作`, ansi.bold + C.tool)
+        pushLine(`/provider add <名称|预设> <url> <模型>  添加（预设: ${Object.keys(PRESETS).join(" ")}）`, C.dim)
+        pushLine(`/provider remove <名称>                 删除`, C.dim)
+        if (!agent.provider.apiKey) pushLine("⚡ /provider key <apikey>  ← 当前 provider 还没配 key", C.warn)
+        else pushLine("/provider key [名称] <apikey>           设置/更换 key", C.dim)
         return
       }
       case "/config": {
-        pushLabel(`❯ Config`, ansi.bold + C.tool)
-        pushLine(`provider: ${agent.provider.baseURL} | model: ${agent.provider.model}`, C.dim)
-        pushLine(`apiKey: ${maskKey(agent.provider.apiKey)}`, C.dim)
+        const sub = rest[0]
+        // ---- /config embedkey <apikey>：embedding 服务的 key ----
+        if (sub === "embedkey") {
+          const key = rest.slice(1).join(" ")
+          if (!key) { pushLine("用法: /config embedkey <apikey>（embedding 服务，默认 SiliconFlow bge-m3）", C.error); return }
+          agent.config.embedding ??= {}
+          agent.config.embedding.apiKey = key
+          await persistRaw((raw) => { raw.embedding = { ...(raw.embedding ?? {}), apiKey: key } })
+          if (agent.memory) {
+            const { createEmbedder } = await import("./embedding.mjs")
+            agent.memory.embedder = createEmbedder(agent.config.embedding)
+          }
+          pushLabel(`❯ Config`, ansi.bold + C.tool)
+          pushLine(`embedding key 已保存，向量检索已启用`, C.tool)
+          return
+        }
+        // ---- /config set <path> <value> (高级) ----
+        if (sub === "set") {
+          const [path, value] = [rest[1], rest.slice(2).join(" ")]
+          if (!path || !value) { pushLine("用法: /config set <path> <value>  如 /config set agent.maxTurns 80", C.error); return }
+          try {
+            const { configPath, loadConfig, saveConfig } = await import("./config.mjs")
+            const raw = existsSync(configPath) ? JSON.parse(readFileSync(configPath, "utf8")) : {}
+            // 支持 a.b 形式的嵌套 key
+            const keys = path.split(".")
+            let obj = raw
+            for (let i = 0; i < keys.length - 1; i++) { obj[keys[i]] ??= {}; obj = obj[keys[i]] }
+            obj[keys[keys.length - 1]] = isNaN(value) ? value : Number(value)
+            saveConfig(raw)
+            const cfg = loadConfig()
+            agent.provider = cfg.provider
+            agent.providers = cfg.providersList
+            agent.activeProvider = cfg.activeProvider
+            agent.config = cfg
+            pushLabel(`❯ Config`, ansi.bold + C.tool)
+            pushLine(`已保存: ${path} = ${value}`, C.tool)
+          } catch (error) {
+            pushLine(`保存失败: ${error.message}`, C.error)
+          }
+          return
+        }
+        if (sub) { pushLine(`未知: ${sub}（可用: embedkey / set）`, C.error); return }
+        // ---- /config（无参）: 查看 ----
+        const { configPath: cp } = await import("./config.mjs")
+        pushLabel(`❯ 配置`, ansi.bold + C.tool)
+        pushLine(`激活:   ${agent.activeProvider} / ${agent.provider.model}`, C.dim)
+        pushLine(`Key:    ${maskKey(agent.provider.apiKey)}`, C.dim)
         const ac = agent.config?.agent ?? {}
-        const thresholdNote = `${ac.compactThreshold ?? 100000}${ac.compactThresholdAuto ? " (auto，随模型)" : ""}`
-        pushLine(`agent: maxTurns=${ac.maxTurns ?? 50} | compactThreshold=${thresholdNote}`, C.dim)
-        pushLine(`memory: ${agent.memory ? "enabled" : "disabled"}${agent.memory?.embedder ? " + vector" : " (FTS only)"}`, C.dim)
+        const tn = `${ac.compactThreshold ?? 100000}${ac.compactThresholdAuto ? " (auto)" : ""}`
+        pushLine(`agent:  maxTurns=${ac.maxTurns ?? 100} | compactThreshold=${tn}`, C.dim)
+        pushLine(`embedding: ${agent.memory?.embedder ? `enabled (${agent.config?.embedding?.model ?? ""})` : "disabled（纯 FTS 检索）"}`, C.dim)
+        pushLabel(`❯ 管理`, ansi.bold + C.tool)
+        pushLine(`/provider            管理 provider（添加/删除/配 key）`, C.dim)
+        if (!agent.memory?.embedder) pushLine(`/config embedkey <k>  开启向量检索`, C.dim)
+        pushLine(`/config set <k> <v>    修改任意配置项`, C.dim)
+        pushLine(`配置文件: ${cp}`, C.dim)
         return
       }
       case "/help": {
-        pushLabel(`❯ Commands`, ansi.bold + C.tool)
-        for (const c of SLASH_COMMANDS) pushLine(`  ${c.name.padEnd(10)} ${c.desc}`, C.dim)
+        const order = ["Agent", "Session", "Tools", "Config"]
+        const byGroup = new Map()
+        for (const c of SLASH_COMMANDS) {
+          if (!c.group) continue
+          if (!byGroup.has(c.group)) byGroup.set(c.group, [])
+          byGroup.get(c.group).push(c)
+        }
+        const maxW = Math.max(...SLASH_COMMANDS.map((c) => c.name.length))
+        for (const g of order) {
+          const cmds = byGroup.get(g)
+          if (!cmds?.length) continue
+          byGroup.delete(g)
+          pushLabel(`❯ ${g}`, ansi.bold + C.tool)
+          for (const c of cmds) pushLine(`  ${c.name.padEnd(maxW + 1)} ${c.desc}`, C.dim)
+        }
+        for (const [g, cmds] of byGroup) {
+          pushLabel(`❯ ${g}`, ansi.bold + C.tool)
+          for (const c of cmds) pushLine(`  ${c.name.padEnd(maxW + 1)} ${c.desc}`, C.dim)
+        }
         return
       }
       default:
@@ -729,6 +1323,351 @@ export async function startTUI(agent, opts = {}) {
     return `${key.slice(0, 5)}…${key.slice(-4)}`
   }
 
+  /** Tab 补全候选：命令名 / 子命令 / provider 名 / 预设名 / think 参数 */
+  function completions(input) {
+    if (!input.startsWith("/")) return []
+    const parts = input.split(/\s+/)
+    // 还在敲第一个 token：补命令名
+    if (parts.length === 1) {
+      return SLASH_COMMANDS.filter((c) => c.name.startsWith(parts[0])).map((c) => c.name)
+    }
+    const cmd = parts[0]
+    const last = parts.at(-1) // 结尾是空格时为 ""，即列出全部候选
+    const head = parts.slice(0, -1).join(" ")
+    const argIndex = parts.length - 2 // 正在敲第几个参数（0 基）
+    const match = (cands) => cands.filter((c) => c.startsWith(last)).map((c) => `${head} ${c}`)
+    if (cmd === "/model" && argIndex === 0) return match(agent.providers.map((p) => p.name))
+    if (cmd === "/provider") {
+      if (argIndex === 0) return match(["add", "remove", "key"])
+      if (argIndex === 1 && parts[1] === "add") return match(Object.keys(PRESETS))
+      if (argIndex === 1 && (parts[1] === "remove" || parts[1] === "key")) return match(agent.providers.map((p) => p.name))
+    }
+    if (cmd === "/think") {
+      if (argIndex === 0) return match(["on", "off", "effort"])
+      if (argIndex === 1 && parts[1] === "effort") return match(["low", "high", "max"])
+    }
+    if (cmd === "/config" && argIndex === 0) return match(["embedkey", "set"])
+    if (cmd === "/goal" && argIndex === 0) return match(["set", "cancel"])
+    if (cmd === "/mcp") {
+      if (argIndex === 0) return match(["add", "url", "remove", "connect", "list"])
+      if (argIndex === 1 && (parts[1] === "remove" || parts[1] === "connect")) return match((agent.config?.mcp?.servers ?? []).map((s) => s.name))
+    }
+    return []
+  }
+
+  /** Tab：计算候选并循环替换输入 */
+  function handleTab() {
+    const input = state.input.join("")
+    if (state.completion && input === state.completion.candidates[state.completion.index]) {
+      // 上一次的候选还在输入框：循环到下一个
+      state.completion.index = (state.completion.index + 1) % state.completion.candidates.length
+    } else {
+      const candidates = completions(input)
+      if (candidates.length === 0) return
+      state.completion = { candidates, index: 0 }
+    }
+    const text = state.completion.candidates[state.completion.index]
+    state.input = [...text]
+    state.cursor = state.input.length
+    render()
+  }
+
+  /** 读配置文件 → 修改 → 写回；文件不存在时从空对象开始 */
+  async function persistRaw(mutate) {
+    const { saveConfig, configPath } = await import("./config.mjs")
+    const raw = existsSync(configPath) ? JSON.parse(readFileSync(configPath, "utf8")) : {}
+    mutate(raw)
+    saveConfig(raw)
+  }
+
+  /** 把当前激活 provider 的某个字段同步到 providers 列表并持久化 */
+  async function syncProviderField(field, value) {
+    const target = agent.providers.find((p) => p.name === agent.activeProvider)
+    if (!target) return
+    if (value === undefined) delete target[field]
+    else target[field] = value
+    // 全量写回：raw 里的 providers 顺序/内容可能与运行时列表不一致，逐字段改容易写错位
+    await persistRaw((raw) => {
+      raw.providers = agent.providers
+    })
+  }
+
+  // ---------------------------------------------------------- 模型选择器（/model）
+
+  const pickerItems = () => state.picker.entries.filter((e) => e.type === "item")
+
+  /** 按 entries 重建显示行并刷新；高亮选中项、标注当前模型 */
+  function renderPickerLines() {
+    const p = state.picker
+    if (!p) return
+    const lines = []
+    let row = 0
+    let selectedLine = 0
+    for (const e of p.entries) {
+      if (e.type === "header") {
+        lines.push({ text: ` ${e.name}${e.note ? `  ${e.note}` : ""}`, color: ansi.bold + C.tool })
+      } else {
+        const selected = row === p.index
+        if (selected) selectedLine = lines.length
+        const current = e.provider === agent.activeProvider && e.model === agent.provider.model
+        lines.push({
+          text: `${selected ? " ▸ " : "   "}${e.model}${current ? "  ← 当前" : ""}`,
+          color: selected ? ansi.bold + C.text : C.dim,
+        })
+        row++
+      }
+    }
+    p.lines = lines
+    p.selectedLine = selectedLine
+    render()
+  }
+
+  /** 打开选择器：先列出各 provider 已配置的模型，再并发拉取各端点的全部模型展开进去 */
+  async function openModelPicker() {
+    const entries = []
+    for (const p of agent.providers) {
+      entries.push({ type: "header", name: p.name, note: `${p.baseURL}${p.apiKey ? "" : "（未配 key）"}  加载中...` })
+      entries.push({ type: "item", provider: p.name, model: p.model })
+    }
+    state.picker = { entries, lines: [], index: 0, scroll: 0, selectedLine: 0 }
+    // 默认选中当前在用的模型
+    const current = pickerItems().findIndex(
+      (e) => e.provider === agent.activeProvider && e.model === agent.provider.model,
+    )
+    if (current >= 0) state.picker.index = current
+    renderPickerLines()
+
+    const { listModels } = await import("./provider.mjs")
+    await Promise.all(
+      agent.providers.map(async (p) => {
+        const header = entries.find((e) => e.type === "header" && e.name === p.name)
+        const noteBase = `${p.baseURL}${p.apiKey ? "" : "（未配 key）"}`
+        try {
+          // key 的环境变量兜底和 loadConfig 保持一致（提供商专用变量只对同名生效）
+          const envKey = { deepseek: "DEEPSEEK_API_KEY", openai: "OPENAI_API_KEY" }[p.name]
+          let apiKey = p.apiKey
+          if (!apiKey && envKey && process.env[envKey]) apiKey = process.env[envKey]
+          if (!apiKey) apiKey = process.env.THINCODER_API_KEY
+          const models = await listModels(
+            { baseURL: p.baseURL, apiKey: apiKey ?? "" },
+            { signal: AbortSignal.timeout(10000) },
+          )
+          // 展开到该 provider 已配置模型的后面（去重）
+          const at = entries.findIndex((e) => e.type === "item" && e.provider === p.name && e.model === p.model)
+          entries.splice(
+            at + 1,
+            0,
+            ...models.filter((m) => m !== p.model).map((m) => ({ type: "item", provider: p.name, model: m })),
+          )
+          header.note = noteBase
+        } catch (error) {
+          header.note = `${noteBase}  （拉取失败: ${sliceByWidth(error.message, 60)}）`
+        }
+        if (state.picker?.entries === entries) renderPickerLines() // 已关闭就不再刷新
+      }),
+    )
+  }
+
+  function closeModelPicker() {
+    state.picker = null
+    render()
+  }
+
+  /** 给指定 provider 写 key（内存 + 配置文件）；若它是当前激活的，同步运行时 */
+  async function setProviderKey(name, key) {
+    const target = agent.providers.find((p) => p.name === name)
+    if (!target) {
+      pushLine(`未找到 provider "${name}"`, C.error)
+      return
+    }
+    target.apiKey = key
+    if (name === agent.activeProvider) agent.provider.apiKey = key
+    await persistRaw((raw) => { raw.providers = agent.providers })
+    pushLabel(`❯ Provider`, ansi.bold + C.tool)
+    pushLine(`apiKey 已保存到 ${name}`, C.tool)
+  }
+
+  // ---------------------------------------------------------- 初始配置向导（首次启动）
+
+  /** 菜单步的候选项：已有 provider（未配 key 的标注）+ 未添加的预设 + 自定义 */
+  function wizardProviderItems() {
+    const items = []
+    for (const p of agent.providers) {
+      items.push({ kind: "existing", name: p.name, baseURL: p.baseURL, model: p.model, label: `${p.name}（已添加${p.apiKey ? "" : "，未配 key"}）` })
+    }
+    for (const [name, p] of Object.entries(PRESETS)) {
+      if (!agent.providers.some((x) => x.name === name)) {
+        items.push({ kind: "preset", name, baseURL: p.baseURL, model: p.model, label: `${name}（${p.desc}）` })
+      }
+    }
+    items.push({ kind: "custom", name: null, label: "自定义端点…" })
+    return items
+  }
+
+  /** 文本步骤定义：提示语 + 校验（通过返回 true，否则返回错误文案） */
+  const WIZARD_STEPS = {
+    name: {
+      prompt: "给这个 provider 起个名字（字母/数字/-/_，如 my-openai）",
+      validate: (v) =>
+        (/^[\w-]+$/.test(v) && !agent.providers.some((p) => p.name === v)) || "名字需为字母/数字/-/_，且不与已有 provider 重名",
+    },
+    baseURL: {
+      prompt: "输入 baseURL（如 https://api.openai.com/v1）",
+      validate: (v) => /^https?:\/\/.+/.test(v) || "baseURL 应以 http(s):// 开头",
+    },
+    model: {
+      prompt: "输入模型名（如 gpt-4o）",
+      validate: (v) => v.length > 0 || "模型名不能为空",
+    },
+    key: {
+      prompt: "输入 API key",
+      validate: (v) => v.length > 0 || "key 不能为空",
+    },
+    embedkey: {
+      prompt: "可选：embedding API key（SiliconFlow，记忆向量检索用；直接回车跳过）",
+      validate: () => true, // 可跳过
+    },
+  }
+  const WIZARD_NEXT = { name: "baseURL", baseURL: "model", model: "key", key: "embedkey", embedkey: null }
+
+  function startWizard() {
+    state.wizard = { step: "provider", index: 0, scroll: 0, selectedLine: 0, fields: {}, error: null, lines: [] }
+    renderWizard()
+  }
+
+  function renderWizard() {
+    const w = state.wizard
+    if (!w) return
+    const lines = []
+    if (w.step === "provider") {
+      lines.push({ text: " 选择一个模型提供商：", color: C.text })
+      wizardProviderItems().forEach((it, i) => {
+        if (i === w.index) w.selectedLine = lines.length
+        lines.push({
+          text: `${i === w.index ? " ▸ " : "   "}${it.label}`,
+          color: i === w.index ? ansi.bold + C.text : C.dim,
+        })
+      })
+    } else {
+      const f = w.fields
+      if (f.name) lines.push({ text: ` 提供商:  ${f.name}`, color: C.dim })
+      if (f.baseURL) lines.push({ text: ` baseURL: ${f.baseURL}`, color: C.dim })
+      if (f.model) lines.push({ text: ` 模型:    ${f.model}`, color: C.dim })
+      lines.push({ text: ` ❯ ${WIZARD_STEPS[w.step].prompt}`, color: ansi.bold + C.text })
+      lines.push({ text: " （在下方输入框输入）", color: C.dim })
+      w.selectedLine = 0
+    }
+    if (w.error) lines.push({ text: ` ${w.error}`, color: C.error })
+    w.lines = lines
+    render()
+  }
+
+  function wizardChooseProvider(item) {
+    const w = state.wizard
+    if (item.kind === "custom") {
+      w.step = "name"
+    } else {
+      w.fields = { name: item.name, baseURL: item.baseURL, model: item.model }
+      w.step = "key"
+    }
+    renderWizard()
+  }
+
+  function wizardSubmitText() {
+    const w = state.wizard
+    const value = state.input.join("").trim()
+    const ok = WIZARD_STEPS[w.step].validate(value)
+    if (ok !== true) {
+      w.error = ok
+      renderWizard()
+      return
+    }
+    w.error = null
+    state.input = []
+    state.cursor = 0
+    w.fields[w.step === "key" ? "key" : w.step] = w.step === "baseURL" ? value.replace(/\/+$/, "") : value
+    const next = WIZARD_NEXT[w.step]
+    if (next) {
+      w.step = next
+      renderWizard()
+    } else {
+      finishWizard().catch((e) => pushLine(`[error] ${e.message}`, C.error))
+    }
+  }
+
+  function cancelWizard() {
+    state.wizard = null
+    pushLine("已跳过初始配置。之后随时可用 /provider add 添加提供商、/provider key 配 key。", C.dim)
+    render()
+  }
+
+  /** 向导完成：写入 provider（有则更新）、设为激活、持久化，然后接模型选择器 */
+  async function finishWizard() {
+    const f = state.wizard.fields
+    state.wizard = null
+    const existing = agent.providers.find((p) => p.name === f.name)
+    if (existing) Object.assign(existing, { baseURL: f.baseURL, model: f.model, apiKey: f.key })
+    else agent.providers.push({ name: f.name, baseURL: f.baseURL, model: f.model, apiKey: f.key })
+    agent.activeProvider = f.name
+    agent.provider = { ...agent.providers.find((p) => p.name === f.name) }
+    if (agent.config?.agent?.compactThresholdAuto) {
+      const { resolveCompactThreshold } = await import("./config.mjs")
+      agent.config.agent.compactThreshold = resolveCompactThreshold(null, f.model).value
+    }
+    await persistRaw((raw) => {
+      raw.providers = agent.providers
+      raw.activeProvider = f.name
+    })
+    agent.config.activeProvider = f.name
+    pushLabel(`❯ Setup`, ansi.bold + C.tool)
+    pushLine(`配置完成：${f.name} / ${f.model}（已写入配置文件）`, C.tool)
+    // embedding key：配了就启用向量检索，没配提示事后通道
+    if (f.embedkey) {
+      agent.config.embedding ??= {}
+      agent.config.embedding.apiKey = f.embedkey
+      await persistRaw((raw) => { raw.embedding = { ...(raw.embedding ?? {}), apiKey: f.embedkey } })
+      if (agent.memory && !agent.memory.embedder) {
+        const { createEmbedder } = await import("./embedding.mjs")
+        agent.memory.embedder = createEmbedder(agent.config.embedding)
+      }
+      pushLine(`向量检索已启用（${agent.config.embedding.model ?? "BAAI/bge-m3"}）`, C.tool)
+    } else {
+      pushLine(`向量检索未启用（记忆退化为纯文本检索）；之后可 /config embedkey <key> 开启`, C.dim)
+    }
+    pushLine(`选择要用的模型（Esc 保持 ${f.model}）`, C.dim)
+    openModelPicker().catch((e) => pushLine(`[error] ${e.message}`, C.error))
+  }
+
+  /** 选中：切换 provider + 模型，持久化，阈值随模型走 */
+  async function selectModel(item) {
+    closeModelPicker()
+    const target = agent.providers.find((pp) => pp.name === item.provider)
+    if (!target) return
+    target.model = item.model
+    agent.activeProvider = item.provider
+    agent.provider = { ...target }
+    if (!agent.provider.apiKey) {
+      const envKey = { deepseek: "DEEPSEEK_API_KEY", openai: "OPENAI_API_KEY" }[item.provider]
+      if (envKey && process.env[envKey]) agent.provider.apiKey = process.env[envKey]
+    }
+    if (!agent.provider.apiKey) agent.provider.apiKey = process.env.THINCODER_API_KEY
+    let thresholdNote = ""
+    if (agent.config?.agent?.compactThresholdAuto) {
+      const { resolveCompactThreshold } = await import("./config.mjs")
+      const { value } = resolveCompactThreshold(null, item.model)
+      agent.config.agent.compactThreshold = value
+      thresholdNote = `，压缩阈值随模型调整为 ${value}`
+    }
+    await persistRaw((raw) => {
+      raw.providers = agent.providers
+      raw.activeProvider = item.provider
+    })
+    agent.config.activeProvider = item.provider
+    pushLabel(`❯ Model`, ansi.bold + C.tool)
+    pushLine(`已切换到 ${item.provider} / ${item.model}${thresholdNote}（已持久化）`, C.tool)
+    if (!agent.provider.apiKey) pushLine(`该 provider 还没配 key: /config key <apikey>`, C.warn)
+  }
+
   /** /distill：从当前会话提取候选，逐条 y/n 确认后入库 */
   async function runDistill() {
     if (agent.history.length === 0) {
@@ -774,22 +1713,130 @@ export async function startTUI(agent, opts = {}) {
 
   // keypress 挂在过滤后的 keyStream 上：鼠标序列已在上游滤网中处理并剥除
   keyStream.on("keypress", (str, key = {}) => {
-    // 权限确认态：只认 y/n
+    // 权限确认态：y 批准 / n 拒绝 / a 批准并开启 AUTO（后续不再询问）
     if (state.permission) {
       const answer = (str || "").toLowerCase()
-      if (answer === "y" || answer === "n" || key.name === "escape") {
+      const isContinue = state.permission.name === "continue"
+      const validKeys = isContinue ? ["y", "n"] : ["y", "n", "a"]
+      if (validKeys.includes(answer) || key.name === "escape") {
         const { resolve } = state.permission
         state.permission = null
         state.status = "Processing..."
-        resolve(answer === "y")
+        if (answer === "a" && !isContinue) {
+          agent.autoApprove = true
+          agent._pendingReminders = agent._pendingReminders ?? []
+          agent._pendingReminders.push("[System reminder: AUTO mode is now ON. All tool calls are automatically approved. Use /auto to disable.]")
+          pushLine(`  [auto] AUTO 已开启：后续工具调用不再询问（/auto 关闭）`, C.warn)
+        }
+        resolve(answer === "y" || (answer === "a" && !isContinue))
         render()
       }
       return
     }
 
+    // question 工具回调：自由文本 / 选项选择
+    if (state.question) {
+      const q = state.question
+      if (q.options.length > 0) {
+        // 选项模式：↑↓ 选择，Enter 确认，Esc 取消
+        if (key.name === "escape") {
+          q.resolve("(cancelled)")
+          state.question = null
+          state.status = "Processing..."
+          render()
+        } else if (key.name === "up") {
+          q.selected = Math.max(0, (q.selected ?? 0) - 1)
+          render()
+        } else if (key.name === "down") {
+          q.selected = Math.min(q.options.length - 1, (q.selected ?? 0) + 1)
+          render()
+        } else if (key.name === "return") {
+          const answer = q.options[q.selected ?? 0]
+          q.resolve(answer)
+          state.question = null
+          state.status = "Processing..."
+          pushLine(`  → ${answer}`, C.tool)
+          render()
+        }
+      } else {
+        // 自由文本：键入答案，Enter 提交，Esc 取消
+        if (key.name === "escape") {
+          q.resolve("(cancelled)")
+          state.question = null
+          state.status = "Processing..."
+          render()
+        } else if (key.name === "return") {
+          const answer = (q.answer ?? "").trim()
+          q.resolve(answer || "(empty answer)")
+          state.question = null
+          state.status = "Processing..."
+          pushLine(`  → ${answer || "(empty)"}`, C.tool)
+          render()
+        } else if (key.name === "backspace") {
+          q.answer = (q.answer ?? "").slice(0, -1)
+          render()
+        } else if (str && !key.ctrl && !key.meta) {
+          q.answer = (q.answer ?? "") + str
+          render()
+        }
+      }
+      return
+    }
+
     if (key.ctrl && key.name === "c") {
+      if (state.processing && state.controller) {
+        state.controller.abort()
+        pushLine("[中止中…]", C.warn)
+        render()
+        return
+      }
       cleanup()
-      process.exit(0)
+      setTimeout(() => process.exit(0), 100)
+    }
+
+    // 模型选择器：↑↓ 移动，Enter 确认，Esc 取消，其余按键吞掉
+    if (state.picker) {
+      const items = pickerItems()
+      if (key.name === "escape") {
+        closeModelPicker()
+      } else if (key.name === "up" && items.length) {
+        state.picker.index = (state.picker.index - 1 + items.length) % items.length
+        renderPickerLines()
+      } else if (key.name === "down" && items.length) {
+        state.picker.index = (state.picker.index + 1) % items.length
+        renderPickerLines()
+      } else if (key.name === "return" && items.length) {
+        selectModel(items[state.picker.index]).catch((e) => pushLine(`[error] ${e.message}`, C.error))
+      }
+      return
+    }
+
+    // 初始配置向导：菜单步 ↑↓/Enter/Esc；文本步 Enter 提交、Esc 取消，编辑键落到正常输入
+    if (state.wizard) {
+      const w = state.wizard
+      if (key.name === "escape") {
+        cancelWizard()
+        return
+      }
+      if (w.step === "provider") {
+        const items = wizardProviderItems()
+        if (key.name === "up" && items.length) {
+          w.index = (w.index - 1 + items.length) % items.length
+          renderWizard()
+        } else if (key.name === "down" && items.length) {
+          w.index = (w.index + 1) % items.length
+          renderWizard()
+        } else if (key.name === "return" && items.length) {
+          wizardChooseProvider(items[w.index])
+        }
+        return
+      }
+      if (key.name === "return") {
+        wizardSubmitText()
+        return
+      }
+      // 文本步骤屏蔽翻页/历史，其余编辑键放行到下面的普通输入逻辑
+      if (key.name === "up" || key.name === "down" || key.name === "pageup" || key.name === "pagedown") return
     }
 
     // 翻页
@@ -806,6 +1853,12 @@ export async function startTUI(agent, opts = {}) {
 
     if (state.processing) return // 处理中锁定输入
 
+    // Tab：斜杠命令补全（循环候选）；其余输入忽略（\t 会顶破输入框，永不直接插入）
+    if (key.name === "tab") {
+      handleTab()
+      return
+    }
+
     // 输入历史
     if (key.name === "up") {
       if (state.history.length) {
@@ -874,9 +1927,9 @@ export async function startTUI(agent, opts = {}) {
       return
     }
 
-    // 可打印字符 / 粘贴（str 可能一次多个字符）
+    // 可打印字符 / 粘贴（str 可能一次多个字符）；Tab 一律转成两个空格（\t 显示宽度不定，会顶破输入框）
     if (str && !key.ctrl && !key.meta) {
-      const chars = [...str.replace(/\r/g, "")]
+      const chars = [...str.replace(/\r/g, "").replace(/\t/g, "  ")]
       state.input.splice(state.cursor, 0, ...chars)
       state.cursor += chars.length
       render()
@@ -884,7 +1937,13 @@ export async function startTUI(agent, opts = {}) {
   })
 
   // 启动画面
-  pushLine(`Welcome to ThinCoder. Model: ${agent.provider.model}`, C.dim)
+  if (!agent.provider.apiKey) {
+    pushLabel(`欢迎使用 ThinCoder！`, ansi.bold + C.tool)
+    pushLine("检测到还没配置 API key，进入初始配置（Esc 可随时跳过）", C.text)
+    startWizard()
+  } else {
+    pushLine(`Welcome to ThinCoder. Provider: ${agent.activeProvider} / ${agent.provider.model}`, C.dim)
+  }
   pushLine(`Tools: ${agent.tools.map((t) => t.name).join(", ")}`, C.dim)
   // 恢复上次会话：重建对话区显示（tool 结果行省略，保持清爽）
   if (opts.restored?.history?.length) {