thincoder 0.7.8 → 0.8.1

package/src/tui/render-frame.mjs

@@ -0,0 +1,304 @@
+/**
+ * render-frame.mjs — 终端帧渲染（纯计算，无副作用）
+ * 从 state + agent + layout 产生 ANSI 帧字符串，返回光标位置。
+ *
+ * 布局计算见 layout.mjs（computeLayout 纯函数）。
+ * 副作用（scroll 归位、ctxCache 更新）由调用方在渲染前执行。
+ */
+import { ansi, C, ESC } from "./ansi.mjs"
+import { computeLayout, MAX_SUB_LINES } from "./layout.mjs"
+import {
+  sliceByWidth, stringWidth, wrapText, formatTables, sanitizeDisplay,
+} from "./render.mjs"
+import { specForModel } from "../config.mjs"
+import { basename } from "node:path"
+
+// ---------- status bar slash-command hints (查表替代 if-else 链) ----------
+const SLASH_HINTS = {
+  "/config": "open config menu",
+  "/model": "select model & manage providers",
+  "/think": "open thinking mode menu",
+  "/mcp": "open MCP management menu",
+  "/goal": "open goal management menu",
+  "/session": "select archived session",
+  "/restore": "select checkpoint to restore",
+}
+
+/**
+ * 渲染一帧，返回 { frame, cursorRow, cursorCol }。
+ * 纯函数：不修改 state/agent。
+ */
+export function renderFrame(state, agent, opts) {
+  const cols = opts.cols || 80
+  const rows = opts.rows || 24
+  const slashCommands = opts.slashCommands ?? []
+  const platform = opts.platform ?? process.platform
+
+  const layout = computeLayout(state, { cols, rows })
+  const { W, panels, inputLayout, inputOffset, boxLines, visibleTasks, allSubs, permPreviewLines, overlay } = layout
+  const model = agent.provider.model
+  const thinking = agent.provider.thinking
+  const effort = agent.provider.reasoningEffort
+  const isMultimodal = specForModel(model).multimodal
+  const thinkBadge = thinking?.type === "disabled" ? "│ think: off"
+    : effort ? `│ think: ${effort}` : thinking?.type === "enabled" ? "│ think: on" : ""
+
+  const out = [ansi.home]
+  let cursorRow = 0, cursorCol = 0
+
+  // ---- header ----
+  out.push(
+    `${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}`,
+  )
+
+  // ---- conversation ----
+  const convLines = buildConvLines(state, cols)
+  const maxScroll = Math.max(0, convLines.length - panels.conversation.h)
+  const scroll = Math.min(state.scroll, maxScroll)
+  const end = convLines.length - scroll
+  const visible = convLines.slice(Math.max(0, end - panels.conversation.h), end)
+  const pad = panels.conversation.h - visible.length
+  for (let i = 0; i < pad; i++) out.push(ansi.clearLine)
+  for (const l of visible) {
+    out.push(`${l.color}${l.text}${ansi.reset}${ansi.clearLine}`)
+  }
+
+  // ---- picker / wizard overlay ----
+  if (panels.picker) {
+    const winH = panels.picker.h - 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 ? ` ❯ ${state.picker.title} ` : " ❯ Setup "
+    out.push(`${ansi.bold}${C.tool}${overlayTitle}${ansi.reset}${ansi.dim}${state.picker ? "(↑↓ navigate, Enter confirm, Esc cancel)" : ""}${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 panel ----
+  for (const t of visibleTasks) {
+    const mark = t.status === "done" ? "✓" : t.status === "in_progress" ? "▶" : "○"
+    const color = t.status === "done" ? `${C.dim}${ESC}[9m` : t.status === "in_progress" ? C.tool : C.text
+    out.push(`${color} ${mark} ${sliceByWidth(t.title, cols - 4)}${ansi.reset}${ansi.clearLine}`)
+  }
+
+  // ---- subagent panel ----
+  if (panels.subagent) {
+    const subs = allSubs
+    for (const s of subs.slice(0, MAX_SUB_LINES)) {
+      const icon = s.done ? "✓" : "…"
+      const color = s.done ? C.dim : C.tool
+      const label = `[${s.role}]`.padEnd(10)
+      let content
+      if (s.done) {
+        const elapsed = Math.floor((Date.now() - s.started) / 1000)
+        content = `done ${elapsed}s`
+      } else if (s.tool) {
+        const argSummary = s.toolArgs ? summarizeToolArg(s.tool, s.toolArgs) : ""
+        content = `${s.tool}${argSummary ? ` ${argSummary}` : ""}`
+      } else if (s.text) {
+        const textLines = s.text.split("\n").filter((l) => l.trim())
+        content = textLines.length > 0 ? textLines[textLines.length - 1] : "thinking..."
+      } else {
+        content = "thinking..."
+      }
+      const availWidth = W - 14
+      out.push(`${color} ${icon} ${label} ${sliceByWidth(content, Math.max(10, availWidth))}${ansi.reset}${ansi.clearLine}`)
+    }
+    if (subs.length > MAX_SUB_LINES) {
+      out.push(`${C.dim}  ... +${subs.length - MAX_SUB_LINES} more subagents${ansi.reset}${ansi.clearLine}`)
+    }
+  }
+
+  // ---- permission preview ----
+  if (panels.permission) {
+    out.push(`${ansi.bold}${C.warn}❯ Permission Request${ansi.reset}${ansi.clearLine}`)
+    for (const wrapped of permPreviewLines) {
+      out.push(`${C.warn}${wrapped}${ansi.reset}${ansi.clearLine}`)
+    }
+  }
+
+  // ---- queue preview ----
+  if (panels.queue) {
+    const preview = sliceByWidth(state.queue[0].text, W - 20)
+    out.push(`${C.dim}❯ Queue: ${state.queue.length} pending${state.queue.length > 1 ? ` (next: ${preview}…)` : ` (next: ${preview})`} — Ctrl+D del${ansi.reset}${ansi.clearLine}`)
+  }
+
+  // ---- input box ----
+  const { borderColor, title } = inputBoxStyle(state)
+  let topBorder
+  if (title === " Input " && isMultimodal) {
+    const hint = platform === "win32" ? " Alt+V paste " : " Ctrl+V paste "
+    topBorder = `╭─${title}${"─".repeat(Math.max(0, W - 4 - stringWidth(title) - stringWidth(hint)))}${hint}─╮`
+  } else {
+    topBorder = `╭─${title}${"─".repeat(Math.max(0, W - 3 - stringWidth(title)))}╮`
+  }
+  out.push(`${borderColor}${topBorder}${ansi.reset}${ansi.clearLine}`)
+  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}`)
+  }
+  out.push(`${borderColor}╰${"─".repeat(Math.max(0, W - 2))}╯${ansi.reset}${ansi.clearLine}`)
+
+  // ---- status bar ----
+  const statusLine = buildStatusLine(state, agent, { cols, slashCommands })
+  const autoBanner = agent.autoApprove ? `${C.warn} AUTO${ansi.reset}${ansi.dim}│` : ""
+  const planBanner = agent.planMode ? `${C.tool} PLAN${ansi.reset}${ansi.dim}│` : ""
+  const bannerPrefix = (agent.planMode ? " PLAN│ " : "") + (agent.autoApprove ? " AUTO│ " : "")
+  const statusMax = cols - 1 - (bannerPrefix ? stringWidth(bannerPrefix) : 0)
+  out.push(`${ansi.dim}${planBanner}${autoBanner}${sliceByWidth(statusLine, Math.max(10, statusMax))}${ansi.reset}${ansi.clearLine}`)
+
+  const frame = out.join("\r\n")
+
+  // ---- cursor ----
+  if (!state.permission && !state.question && !state.picker && state.wizard?.step !== "provider") {
+    cursorRow = panels.inputBox.y + 1 + (inputLayout.cursorLine - inputOffset) + 1
+    cursorCol = 3 + inputLayout.cursorCol
+  }
+
+  return { frame, cursorRow, cursorCol }
+}
+
+// ---------------------------------------------------------- 内部实现
+
+/** Count conversation lines after sanitize + wrap (for scroll clamping). Pure. */
+export function countConvLines(state, cols) {
+  return buildConvLines(state, cols).length
+}
+
+/** Build conversation lines from state (sanitized + wrapped). Pure. */
+function buildConvLines(state, cols) {
+  const convLines = []
+  for (const l of state.lines) {
+    for (const line of formatTables(sanitizeDisplay(l.text), cols - 1)) {
+      for (const wrapped of wrapText(line, cols - 1)) {
+        convLines.push({ text: wrapped, color: l.color })
+      }
+    }
+  }
+  if (state.reasoning) {
+    for (const wrapped of wrapText(sanitizeDisplay(state.reasoning), cols - 1)) {
+      convLines.push({ text: wrapped, color: C.reason })
+    }
+  }
+  if (state.streaming) {
+    for (const line of formatTables(sanitizeDisplay(state.streaming), cols - 1)) {
+      for (const wrapped of wrapText(line, cols - 1)) {
+        convLines.push({ text: wrapped, color: C.text })
+      }
+    }
+  }
+  const allStreams = Object.values(state.toolStreams).join("")
+  if (allStreams) {
+    const tail = sanitizeDisplay(allStreams.slice(-4000))
+    for (const wrapped of wrapText(tail, cols - 1)) {
+      convLines.push({ text: wrapped, color: C.dim })
+    }
+  }
+  return convLines
+}
+
+/** Determine input box border color and title. Pure. */
+function inputBoxStyle(state) {
+  let borderColor = C.tool
+  let title
+  if (state.question) {
+    borderColor = C.tool
+    title = " Question "
+  } 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 = " Select "
+  } else if (state.wizard) {
+    title = " Setup "
+  } else if (state.processing) {
+    title = " Processing... "
+  } else {
+    title = " Input "
+  }
+  return { borderColor, title }
+}
+
+/** Build status bar line. Pure. */
+function buildStatusLine(state, agent, { cols, slashCommands }) {
+  const scrollHint = state.scroll > 0 ? ` │ scrolled ${state.scroll}` : ""
+  const rawInput = state.input.join("")
+
+  if (state.question) {
+    const q = state.question
+    return q.options.length > 0
+      ? " ↑↓: select │ Enter: confirm │ Esc: cancel"
+      : " Type answer then Enter │ Esc: cancel"
+  }
+  if (state.permission) {
+    return state.permission.name === "continue"
+      ? " y: continue │ n: stop"
+      : " y: approve │ n: deny │ a: approve all (AUTO)"
+  }
+  if (state.picker) {
+    return " ↑↓: select │ Enter: confirm │ Esc: cancel"
+  }
+  if (state.wizard) {
+    return state.wizard.step === "provider"
+      ? " ↑↓: select │ Enter: confirm │ Esc: skip"
+      : " Type then Enter │ Esc: cancel"
+  }
+  if (rawInput.startsWith("/") && !state.processing && !state.permission) {
+    const [cmd] = rawInput.split(/\s+/)
+    const cmds = slashCommands.filter((c) => c.name.startsWith(cmd))
+    const match = cmds.length === 1 ? cmds[0] : null
+    if (match && SLASH_HINTS[match.name]) {
+      return ` ${match.name} ${SLASH_HINTS[match.name]}`
+    }
+    if (cmds.length > 0) {
+      if (cmds.length <= 4) {
+        return ` ${cmds.map((c) => `${c.name} ${c.desc}`).join("  │  ")}`
+      }
+      return ` ${cmds.map((c) => c.name).join("  ")}  │  Tab complete`
+    }
+    return ` unknown command (/help for available commands)`
+  }
+
+  const taskHint = state.tasks.length > 0
+    ? ` │ ✓${state.tasks.filter((t) => t.status === "done").length}/${state.tasks.length}`
+    : ""
+  const tk = state.tokens
+  const fmtK = (n) => (n >= 10000 ? `${Math.round(n / 1000)}k` : n >= 1000 ? `${(n / 1000).toFixed(1)}k` : `${n}`)
+  const cacheTotal = tk.cacheHit + tk.cacheMiss
+  const tokenHint = tk.prompt > 0
+    ? ` │ ↑${fmtK(tk.prompt)} ↓${fmtK(tk.completion)}${cacheTotal > 0 ? ` hit${Math.round((tk.cacheHit / cacheTotal) * 100)}%` : ""}`
+    : ""
+  const elapsed = state.processing ? ` ${Math.floor((Date.now() - state.processingStarted) / 1000)}s` : ""
+  const toolHint = state.currentTool ? ` ${state.currentTool}…` : ""
+  const statusText = state.processing ? `${state.status}${toolHint}${elapsed}` : state.status
+  const ctxThreshold = agent.config?.agent?.compactThreshold ?? 100_000
+  const ctxPct = Math.round((state.ctxCache.tokens / ctxThreshold) * 100)
+  const ctxHint = ctxPct > 0
+    ? ctxPct >= 80
+      ? ` │ ${ansi.reset}${C.warn}ctx ${ctxPct}%${ansi.reset}${ansi.dim}`
+      : ` │ ctx ${ctxPct}%`
+    : ""
+  const queueHint = state.queue.length > 0 ? ` │ queue: ${state.queue.length}` : ""
+  return ` ${statusText}${taskHint}${tokenHint}${ctxHint}${queueHint}${scrollHint} │ Enter: send${state.processing ? " (queue)" : ""} │ /: commands │ wheel/PgUp/PgDn: scroll │ Ctrl+C: exit`
+}
+
+/** Summarize tool args for subagent panel display (one line, short). Pure. */
+function summarizeToolArg(toolName, args) {
+  if (!args || typeof args !== "object") return ""
+  if (toolName === "bash" && args.command) {
+    const cmd = args.command.split("\n")[0]
+    return `"${sliceByWidth(cmd, 50)}"`
+  }
+  if (args.path) return sliceByWidth(args.path, 60)
+  if (args.pattern) return `"${sliceByWidth(args.pattern, 50)}"`
+  if (args.query) return `"${sliceByWidth(args.query, 50)}"`
+  if (args.task) return `"${sliceByWidth(args.task, 50)}"`
+  return ""
+}

package/src/tui/render.mjs

@@ -0,0 +1,205 @@
+/**
+ * tui-render.mjs — 终端显示工具（纯函数，零依赖）
+ * 字符宽度计算、CJK/emoji 排版、文本折行、markdown 表格重排。
+ */
+
+/** 字符显示宽度：CJK/emoji 计 2，组合字符计 0，其余计 1 */
+export function charWidth(cp) {
+  if (
+    (cp >= 0x300 && cp <= 0x36f) || // 组合变音符
+    (cp >= 0x200b && cp <= 0x200f) || // 零宽
+    cp === 0xfe0f // emoji 变体选择符
+  ) {
+    return 0
+  }
+  if (
+    (cp >= 0x1100 && cp <= 0x115f) ||
+    (cp >= 0x2e80 && cp <= 0xa4cf) ||
+    (cp >= 0xac00 && cp <= 0xd7a3) ||
+    (cp >= 0xf900 && cp <= 0xfaff) ||
+    (cp >= 0xfe30 && cp <= 0xfe4f) ||
+    (cp >= 0xff00 && cp <= 0xff60) ||
+    (cp >= 0xffe0 && cp <= 0xffe6) ||
+    (cp >= 0x1f000 && cp <= 0x1faff) ||
+    (cp >= 0x20000 && cp <= 0x3fffd) ||
+    (cp >= 0x2600 && cp <= 0x27bf)
+  ) {
+    return 2
+  }
+  return 1
+}
+
+export function stringWidth(text) {
+  let w = 0
+  for (const ch of text) w += charWidth(ch.codePointAt(0))
+  return w
+}
+
+/** 按显示宽度裁剪 */
+export function sliceByWidth(text, maxWidth) {
+  let w = 0
+  let out = ""
+  for (const ch of text) {
+    const cw = charWidth(ch.codePointAt(0))
+    if (w + cw > maxWidth) break
+    w += cw
+    out += ch
+  }
+  return out
+}
+
+/** 按显示宽度右补空格 */
+function padByWidth(text, width) {
+  return text + " ".repeat(Math.max(0, width - stringWidth(text)))
+}
+
+// ---------------------------------------------------------------- markdown 表格重排
+
+const isTableRow = (line) => (line.match(/\|/g) ?? []).length >= 2
+const isTableSeparator = (line) => /^\s*\|?[\s:|-]+\|[\s:|-]*$/.test(line) && line.includes("-")
+
+/**
+ * 识别文本中的 markdown 表格块，按显示宽度重排 (修 CJK 错位）。
+ * width 为可用显示宽度；过宽的表格按列收缩。非表格行原样保留。
+ */
+export function formatTables(text, width) {
+  const lines = text.split("\n")
+  const out = []
+  let i = 0
+  while (i < lines.length) {
+    if (isTableRow(lines[i]) && i + 1 < lines.length && isTableSeparator(lines[i + 1])) {
+      const block = [lines[i], lines[i + 1]]
+      i += 2
+      while (i < lines.length && isTableRow(lines[i])) {
+        block.push(lines[i])
+        i++
+      }
+      out.push(...renderTable(block, width))
+    } else {
+      out.push(lines[i])
+      i++
+    }
+  }
+  return out
+}
+
+function renderTable(block, width) {
+  const rows = block.map((line) =>
+    line
+      .replace(/^\s*\|/, "")
+      .replace(/\|\s*$/, "")
+      .split("|")
+      .map((c) => c.trim()),
+  )
+  const colCount = Math.max(...rows.map((r) => r.length))
+  for (const r of rows) while (r.length < colCount) r.push("")
+
+  // 列宽：先按内容，超宽则从最宽列开始收缩 (收缩到至少 3）
+  const widths = Array.from({ length: colCount }, (_, c) =>
+    Math.max(3, ...rows.map((r) => stringWidth(r[c] ?? ""))),
+  )
+  const borders = colCount * 3 + 1 // " │ " 分隔 + 首尾 |
+  while (widths.reduce((a, b) => a + b, 0) + borders > width && Math.max(...widths) > 3) {
+    const widest = widths.indexOf(Math.max(...widths))
+    widths[widest]--
+  }
+
+  // 单元格渲染：sliceByWidth 截断 (表头单行），padByWidth 补齐
+  const fmtCell = (text, ci) => padByWidth(sliceByWidth(text, widths[ci]), widths[ci])
+  const fmtRow = (cells) => "│ " + cells.map((c, i) => fmtCell(c, i)).join(" │ ") + " │"
+
+  // 分隔线
+  const separator = "├" + widths.map((w) => "─".repeat(w + 2)).join("┼") + "┤"
+
+  const out = []
+  // 表头：单行截断 (表头通常是短标签，折行不如截断直观）
+  out.push(fmtRow(rows[0]))
+  out.push(separator)
+
+  // 数据行：过长单元格按列宽折行，一个逻辑行可能对应多条显示行
+  for (let r = 2; r < rows.length; r++) {
+    // wrapText 返回按 width 折行后的行数组，保留内部 \n
+    const wrapped = rows[r].map((cell, ci) => wrapText(cell, widths[ci]))
+    const height = Math.max(...wrapped.map((lines) => lines.length))
+    for (let lineIdx = 0; lineIdx < height; lineIdx++) {
+      out.push(fmtRow(wrapped.map((lines) => lines[lineIdx] ?? "")))
+    }
+  }
+
+  return out
+}
+
+/** 输入区布局：把输入缓冲折行，同时算出光标的 (行, 列) 位置 (显示宽度） */
+export function layoutInput(chars, cursor, width) {
+  const PROMPT = "\u25b8 "
+  const lines = []
+  let cursorLine = 0
+  let cursorCol = 0
+  let cur = ""
+  let col = 0
+  let firstLine = true
+  const avail = () => (firstLine ? width - 2 : width)
+  const flush = () => {
+    lines.push((firstLine ? PROMPT : "") + cur)
+    firstLine = false
+    cur = ""
+    col = 0
+  }
+  for (let i = 0; i <= chars.length; i++) {
+    const ch = chars[i]
+    // 先处理 flush：宽字符可能触发换行，cursorCol 必须在 flush 之后取，
+    // 否则光标会停在上一行的末尾而非下一行的起始
+    if (ch !== undefined && ch !== "\n") {
+      const w = charWidth(ch.codePointAt(0))
+      if (col + w > avail()) flush()
+      if (i === cursor) {
+        cursorLine = lines.length
+        cursorCol = (firstLine ? 2 : 0) + col
+      }
+      cur += ch
+      col += w
+    } else {
+      if (i === cursor) {
+        cursorLine = lines.length
+        cursorCol = (firstLine ? 2 : 0) + col
+      }
+      if (ch === "\n") flush()
+    }
+  }
+  if (cur || lines.length === 0) flush()
+  return { lines, cursorLine, cursorCol }
+}
+
+/**
+ * 显示净化：控制字符会破坏终端网格数学 (\r 回车覆盖、\t 宽度误判致整帧错位、ANSI/响铃冲屏）。
+ * 只动显示层——模型看到的工具结果原文不变；session 里已存的脏 display 回放时也经此净化。
+ */
+const ANSI_SEQUENCE_RE = /\x1b\[[0-9;?]*[a-zA-Z]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b[()][0-9A-B]|\x1b[=>#][0-9]?/g
+export function sanitizeDisplay(s) {
+  return s
+    .replace(ANSI_SEQUENCE_RE, "")
+    .replace(/\r\n/g, "\n")
+    .replace(/\r/g, "\n")
+    .replace(/\t/g, "    ")
+    .replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, "")
+    .replace(/\n+$/, "")
+}
+
+/** 文本按宽度折行 (保留 \n），返回行数组 */
+export function wrapText(text, width) {
+  const lines = []
+  for (const rawLine of text.split("\n")) {
+    if (rawLine === "") {
+      lines.push("")
+      continue
+    }
+    let line = rawLine
+    while (stringWidth(line) > width) {
+      const head = sliceByWidth(line, width)
+      lines.push(head)
+      line = line.slice([...head].length)
+    }
+    lines.push(line)
+  }
+  return lines
+}

package/src/tui/slash-commands.mjs

@@ -0,0 +1,138 @@
+/**
+ * slash-commands.mjs — 斜杠命令定义、分发、Tab 补全。
+ * 每个子命令的具体实现都在独立的 cmd-*.mjs 中，本文件只做 dispatch。
+ *
+ * ctx 对象由 index.mjs 注入，透传给各 handler：
+ *   { agent, state, distillOpts, pushLine, pushLabel, render,
+ *     openPicker, openModelPicker, setProviderKey, runDistill,
+ *     persistRaw, syncProviderField, maskKey, exit, SLASH_COMMANDS }
+ */
+
+import { C } from "./ansi.mjs"
+import { handleClearCommand } from "./cmd-clear.mjs"
+import { handleNewCommand } from "./cmd-new.mjs"
+import { handleExitCommand } from "./cmd-exit.mjs"
+import { handleSessionCommand } from "./cmd-session.mjs"
+import { handleReindexCommand } from "./cmd-reindex.mjs"
+import { handleInitCommand } from "./cmd-init.mjs"
+import { handleRestoreCommand } from "./cmd-restore.mjs"
+import { handlePlanCommand } from "./cmd-plan.mjs"
+import { handleGoalCommand } from "./cmd-goal.mjs"
+import { handleSkillsCommand } from "./cmd-skills.mjs"
+import { handleMcpCommand } from "./cmd-mcp.mjs"
+import { handleAutoCommand } from "./cmd-auto.mjs"
+import { handleThinkCommand } from "./cmd-think.mjs"
+import { handleModelCommand } from "./cmd-model.mjs"
+import { handleConfigCommand } from "./cmd-config.mjs"
+import { handleExtractCommand } from "./cmd-extract.mjs"
+import { handleHelpCommand } from "./cmd-help.mjs"
+
+export const SLASH_COMMANDS = [
+  { name: "/plan", group: "Agent", desc: "toggle plan mode (design first, then implement)" },
+  { name: "/auto", group: "Agent", desc: "toggle auto-approve" },
+  { name: "/model", group: "Agent", desc: "select model & manage providers" },
+  { name: "/goal", group: "Agent", desc: "set/view/cancel long-term goal" },
+  { name: "/think", group: "Agent", desc: "thinking mode & reasoning effort" },
+  { name: "/init", group: "Tools", desc: "generate project AGENTS.md skeleton" },
+  { name: "/skills", group: "Tools", desc: "list project skills" },
+  { name: "/mcp", group: "Tools", desc: "manage MCP servers" },
+  { name: "/config", group: "Config", desc: "config management (embedding / agent)" },
+  { name: "/reindex", group: "Config", desc: "rebuild memory index" },
+  { name: "/new", group: "Session", desc: "new session (old one archived to slot)" },
+  { name: "/session", group: "Session", desc: "list/switch archived sessions" },
+  { name: "/clear", group: "Session", desc: "clear screen" },
+  { name: "/extract", group: "Session", desc: "extract knowledge from session" },
+  { name: "/restore", group: "Session", desc: "restore checkpoint" },
+  { name: "/exit", group: "Session", desc: "exit" },
+  { name: "/help", group: "", desc: "this list" },
+]
+
+/** 命令 → handler 映射表 */
+const HANDLERS = {
+  "/clear": handleClearCommand,
+  "/new": handleNewCommand,
+  "/exit": handleExitCommand,
+  "/session": handleSessionCommand,
+  "/reindex": handleReindexCommand,
+  "/init": handleInitCommand,
+  "/restore": handleRestoreCommand,
+  "/plan": handlePlanCommand,
+  "/goal": handleGoalCommand,
+  "/skills": handleSkillsCommand,
+  "/mcp": handleMcpCommand,
+  "/auto": handleAutoCommand,
+  "/think": handleThinkCommand,
+  "/model": handleModelCommand,
+  "/config": handleConfigCommand,
+  "/extract": handleExtractCommand,
+  "/help": handleHelpCommand,
+}
+
+/**
+ * 创建斜杠命令处理器。
+ * 返回 { handleSlash, completions, handleTab }。
+ */
+export function createSlashCommands(ctx) {
+  const { agent, state, render } = ctx
+  // 给 /help 传 SLASH_COMMANDS
+  const handlerCtx = { ...ctx, SLASH_COMMANDS }
+
+  async function handleSlash(text) {
+    const [cmd] = text.split(/\s+/)
+    // 高频命令缩写
+    const aliases = { "/h": "/help", "/x": "/exit", "/m": "/model", "/p": "/plan", "/t": "/think", "/c": "/clear", "/n": "/new" }
+    const resolved = aliases[cmd] ?? cmd
+    const handler = HANDLERS[resolved]
+    if (handler) {
+      await handler(handlerCtx)
+      return
+    }
+    ctx.pushLine(`Unknown command: ${cmd} (/help for available commands)`, C.error)
+  }
+
+  /** Tab 补全候选：Commands 名 / 子 Commands / provider 名 / 预设名 / think 参数 */
+  function completions(input) {
+    if (!input.startsWith("/")) return []
+    const parts = input.split(/\s+/)
+    // 还在敲第一个 token：补 Commands 名
+    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 === "/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", "ws", "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()
+  }
+
+  return { handleSlash, completions, handleTab }
+}