thincoder 0.8.1 → 0.8.3

package/src/tui/layout.mjs

@@ -1,11 +1,11 @@
 /**
- * layout.mjs — TUI 布局引擎（纯函数）
- * 从 state + 终端尺寸计算每个面板的位置和高度。
- * 不修改 state——副作用由调用方在渲染前执行。
+ * layout.mjs — TUI layout engine (pure function)
+ * Computes position and height of each panel from state + terminal dimensions.
+ * Does not modify state — side effects are performed by the caller before rendering.
  *
- * 面板布局（自上而下）：
- *   header → conversation → picker → todo → subagent → permission → queue → input → status
- * 固定面板先扣除，条件面板按优先级分配，剩余空间全给 conversation。
+ * Panel layout (top to bottom):
+ *   header → conversation → subagent → output → todo → permission → queue → input → status
+ * Fixed panels deducted first, conditional panels allocated by priority, remaining space to conversation.
  */
 import { layoutInput, wrapText } from "./render.mjs"
 
@@ -15,13 +15,13 @@ export const MAX_SUB_LINES = 4
 const QWIN = 5
 
 /**
- * 计算布局。返回面板坐标 + 预计算的内容（影响高度的部分）。
- * 纯函数：不修改 state。
+ * Computes layout. Returns panel coordinates + precomputed content (height-affecting parts).
+ * Pure function: does not modify state.
  */
 export function computeLayout(state, { cols, rows }) {
   const W = Math.max(20, cols - 1)
 
-  // --- 输入框 ---
+  // --- input box ---
   const inputLayout = layoutInput(state.input, state.cursor, W - 4)
   let inputOffset = 0
   if (inputLayout.lines.length > MAX_INPUT_LINES) {
@@ -41,11 +41,11 @@ export function computeLayout(state, { cols, rows }) {
   }
   const inputBoxH = boxLines.length + 2
 
-  // --- 固定面板 ---
+  // --- fixed panels ---
   const headerH = 1
   const statusH = 1
 
-  // --- 条件面板 ---
+  // --- conditional panels ---
   const overlay = state.picker ?? state.wizard
   const pickerH = overlay ? Math.min(overlay.lines.length + 1, Math.max(6, rows - 12)) : 0
 
@@ -67,6 +67,10 @@ export function computeLayout(state, { cols, rows }) {
     ? Math.min(allSubs.length, MAX_SUB_LINES) + (allSubs.length > MAX_SUB_LINES ? 1 : 0)
     : 0
 
+  // Tool output panels: max 8 lines per panel, capped at reasonable total
+  const panels = Object.values(state.outputPanels).filter((p) => !p.done)
+  const outputPanelsH = panels.length > 0 ? Math.min(panels.length * 8, rows - 10) : 0
+
   // Permission preview (height depends on wrapped content)
   let permPreviewLines = []
   let permPreviewH = 0
@@ -84,17 +88,18 @@ export function computeLayout(state, { cols, rows }) {
   // Queue preview (1 line when queue has items and processing)
   const queueH = state.queue.length > 0 && state.processing ? 1 : 0
 
-  // --- 弹性面板：conversation 占剩余空间 ---
-  const fixedH = headerH + inputBoxH + statusH + pickerH + taskPanelH + subPanelH + permPreviewH + queueH
+  // --- elastic panel: conversation takes remaining space ---
+  const fixedH = headerH + inputBoxH + statusH + pickerH + taskPanelH + subPanelH + outputPanelsH + permPreviewH + queueH
   const convH = Math.max(1, rows - fixedH)
 
-  // --- Y 坐标（0-indexed，ANSI 用时 +1）---
+  // --- Y coordinates (0-indexed, +1 when used with ANSI) ---
   let y = 0
   const header = { y, h: headerH }; y += headerH
   const conversation = { y, h: convH }; y += convH
+  const subagent = subPanelH > 0 ? { y, h: subPanelH } : null; y += subPanelH
+  const output = outputPanelsH > 0 ? { y, h: outputPanelsH } : null; y += outputPanelsH
   const picker = pickerH > 0 ? { y, h: pickerH } : null; y += pickerH
   const todo = taskPanelH > 0 ? { y, h: taskPanelH } : null; y += taskPanelH
-  const subagent = subPanelH > 0 ? { y, h: subPanelH } : null; y += subPanelH
   const permission = permPreviewH > 0 ? { y, h: permPreviewH } : null; y += permPreviewH
   const queue = queueH > 0 ? { y, h: queueH } : null; y += queueH
   const inputBox = { y, h: inputBoxH }; y += inputBoxH
@@ -102,8 +107,8 @@ export function computeLayout(state, { cols, rows }) {
 
   return {
     W, cols, rows,
-    panels: { header, conversation, picker, todo, subagent, permission, queue, inputBox, status },
-    // 预计算内容（影响高度，渲染时复用）
+    panels: { header, conversation, picker, todo, subagent, output, permission, queue, inputBox, status },
+    // precomputed content (affects height, reused during render)
     inputLayout,
     inputOffset,
     boxLines,

package/src/tui/pickers.mjs

@@ -1,16 +1,16 @@
 import { sliceByWidth } from "./render.mjs"
 import { PROVIDER_PRESETS as PRESETS } from "../config.mjs"
 
-/** 通用列表选择器 + 统一模型/provider 管理 picker。
- *  通过 createPickers(ctx) 接收闭包依赖，
- *  返回 { openPicker, closePicker, renderPickerLines, openModelPicker, setProviderKey }。 */
+/** Generic list picker + unified model/provider management picker.
+ *  Receives closure dependencies via createPickers(ctx),
+ *  returns { openPicker, closePicker, renderPickerLines, openModelPicker, setProviderKey }. */
 export function createPickers(ctx) {
   const { agent, state, render, ansi, C, pushLine, persistRaw, askQuestion, maskKey } = ctx
 
   const pickerItems = () => state.picker?.entries.filter((e) => e.type === "item") ?? []
 
-  /** 打开通用列表选择器。entries 含 { type: "header"|"item", text, note?, ...extra }，
-   *  onSelect 拿到选中条目 (含 extra 字段透传），onCancel 在 Esc 时调。 */
+  /** Open a generic list picker. entries contain { type: "header"|"item", text, note?, ...extra },
+   *  onSelect receives the selected entry (with extra fields forwarded), onCancel called on Esc. */
   function openPicker({ title, entries, onSelect, onCancel, defaultIndex = 0 }) {
     state.picker = { title, entries, lines: [], index: defaultIndex, scroll: 0, selectedLine: 0, onSelect, onCancel }
     renderPickerLines()
@@ -22,7 +22,7 @@ export function createPickers(ctx) {
     render()
   }
 
-  /** 按 entries 重建显示行并刷新 */
+  /** Rebuild display lines from entries and refresh */
   function renderPickerLines() {
     const p = state.picker
     if (!p) return
@@ -48,7 +48,7 @@ export function createPickers(ctx) {
     render()
   }
 
-  // ========== 统一 picker：模型切换 + provider 管理 ==========
+  // ========== unified picker: model switch + provider management ==========
 
   async function openModelPicker() {
     const entries = buildModelEntries()
@@ -64,14 +64,14 @@ export function createPickers(ctx) {
       }
     }
     openPicker({ title: "Models & Providers", entries, onSelect })
-    // 默认选中当前在用的模型
+    // default select the currently active model
     const current = pickerItems().findIndex(
       (e) => e.action === "switch" && e.provider === agent.activeProvider && e.model === agent.provider.model,
     )
     if (current >= 0) state.picker.index = current
     renderPickerLines()
 
-    // 异步拉取远端模型列表，追加到对应 provider 下
+    // async fetch remote model list, append under each provider
     const { listModels } = await import("../provider/index.mjs")
     await Promise.all(
       agent.providers.map(async (p) => {
@@ -84,7 +84,7 @@ export function createPickers(ctx) {
             { baseURL: p.baseURL, apiKey: apiKey ?? "" },
             { signal: AbortSignal.timeout(10000) },
           )
-          // 找到当前 provider 在 entries 里的模型 item 位置，在其后插入新模型
+          // find the model item position for this provider in entries, insert new models after it
           const at = entries.findLastIndex(
             (e) => e.type === "item" && e.action === "switch" && e.provider === p.name,
           )
@@ -97,7 +97,7 @@ export function createPickers(ctx) {
                 .map((m) => ({ type: "item", text: m, action: "switch", provider: p.name, model: m })),
             )
           }
-          // 更新 header note 去掉 loading
+          // update header note to remove "loading..."
           const header = entries.find((e) => e.type === "header" && e.text === p.name)
           if (header) header.note = `${p.baseURL}${p.apiKey ? "" : " (no key)"}`
         } catch (error) {
@@ -109,7 +109,7 @@ export function createPickers(ctx) {
     )
   }
 
-  /** 构建 picker entries：每个 provider 一个 header + 模型列表，底部是管理操作 */
+  /** Build picker entries: each provider gets a header + model list, management actions at the bottom */
   function buildModelEntries() {
     const entries = []
     for (const p of agent.providers) {
@@ -128,7 +128,7 @@ export function createPickers(ctx) {
         marker: active ? "●" : "",
       })
     }
-    // 管理操作
+    // management actions
     entries.push({ type: "header", text: "Provider Management" })
     entries.push({ type: "item", text: "Add provider…", action: "add" })
     if (agent.providers.length > 1) {
@@ -138,7 +138,7 @@ export function createPickers(ctx) {
     return entries
   }
 
-  /** 切换 provider + 模型，持久化，阈值随模型走 */
+  /** Switch provider + model, persist, threshold follows model */
   async function selectModel(item) {
     closePicker()
     const target = agent.providers.find((pp) => pp.name === item.provider)
@@ -167,7 +167,7 @@ export function createPickers(ctx) {
     }
   }
 
-  /** 添加 provider：预设菜单 → 输入 key → 完成，或自定义逐项输入 */
+  /** Add provider: preset menu → input key → done, or custom step-by-step input */
   async function addProviderFlow() {
     const presetEntries = [
       { type: "header", text: "Select a preset provider" },
@@ -204,7 +204,7 @@ export function createPickers(ctx) {
           openModelPicker().catch(() => {})
           return
         }
-        // 预设
+        // preset
         if (agent.providers.some((p) => p.name === se.name)) { openModelPicker().catch(() => {}); return }
         const preset = PRESETS[se.name]
         const providerCfg = { name: se.name, baseURL: preset.baseURL, model: preset.model }
@@ -222,7 +222,7 @@ export function createPickers(ctx) {
     })
   }
 
-  /** 删除 provider（不能删当前激活的） */
+  /** Remove provider (cannot remove the currently active one) */
   async function removeProviderFlow() {
     const candidates = agent.providers.filter((p) => p.name !== agent.activeProvider)
     if (candidates.length === 0) { openModelPicker().catch(() => {}); return }
@@ -243,7 +243,7 @@ export function createPickers(ctx) {
     })
   }
 
-  /** 设置/更改 API key：选 provider → 输入 key */
+  /** Set/change API key: select provider → enter key */
   async function setKeyFlow() {
     const keyEntries = [
       { type: "header", text: "Select provider to configure key" },
@@ -266,7 +266,7 @@ export function createPickers(ctx) {
     })
   }
 
-  /** 给指定 provider 写 key (内存 + Config文件）；若它是current激活的，同步运行时 */
+  /** Write key for a given provider (memory + config file); if it's the currently active one, sync runtime too */
   async function setProviderKey(name, key) {
     const target = agent.providers.find((p) => p.name === name)
     if (!target) return

package/src/tui/render-frame.mjs

@@ -1,9 +1,9 @@
 /**
- * render-frame.mjs — 终端帧渲染（纯计算，无副作用）
- * 从 state + agent + layout 产生 ANSI 帧字符串，返回光标位置。
+ * render-frame.mjs — terminal frame renderer (pure computation, no side effects)
+ * Produces an ANSI frame string from state + agent + layout, returns cursor position.
  *
- * 布局计算见 layout.mjs（computeLayout 纯函数）。
- * 副作用（scroll 归位、ctxCache 更新）由调用方在渲染前执行。
+ * Layout calculation lives in layout.mjs (computeLayout pure function).
+ * Side effects (scroll clamping, ctxCache update) are performed by the caller before rendering.
  */
 import { ansi, C, ESC } from "./ansi.mjs"
 import { computeLayout, MAX_SUB_LINES } from "./layout.mjs"
@@ -13,7 +13,7 @@ import {
 import { specForModel } from "../config.mjs"
 import { basename } from "node:path"
 
-// ---------- status bar slash-command hints (查表替代 if-else 链) ----------
+// ---------- status bar slash-command hints (lookup table instead of if-else chain) ----------
 const SLASH_HINTS = {
   "/config": "open config menu",
   "/model": "select model & manage providers",
@@ -25,8 +25,8 @@ const SLASH_HINTS = {
 }
 
 /**
- * 渲染一帧，返回 { frame, cursorRow, cursorCol }。
- * 纯函数：不修改 state/agent。
+ * Render one frame, returns { frame, cursorRow, cursorCol }.
+ * Pure function: does not modify state/agent.
  */
 export function renderFrame(state, agent, opts) {
   const cols = opts.cols || 80
@@ -111,6 +111,29 @@ export function renderFrame(state, agent, opts) {
     }
   }
 
+  // ---- tool output panels (streaming output like tail -f, auto-clears when done) ----
+  if (panels.output) {
+    const active = Object.values(state.outputPanels).filter((p) => !p.done)
+    if (active.length > 0) {
+      const linesPerPanel = Math.max(1, Math.floor(panels.output.h / active.length))
+      for (const p of active) {
+        const textLines = (p.text ?? "").split("\n").filter((l) => l.trim())
+        const tail = textLines.slice(-linesPerPanel)
+        for (const line of tail) {
+          out.push(`${C.dim}  │ ${sliceByWidth(sanitizeDisplay(line), W - 5)}${ansi.reset}${ansi.clearLine}`)
+        }
+      }
+      // fill remaining rows
+      const used = active.reduce((s, p) => {
+        const tl = (p.text ?? "").split("\n").filter((l) => l.trim()).slice(-linesPerPanel)
+        return s + tl.length
+      }, 0)
+      for (let i = used; i < panels.output.h; i++) {
+        out.push(ansi.clearLine)
+      }
+    }
+  }
+
   // ---- permission preview ----
   if (panels.permission) {
     out.push(`${ansi.bold}${C.warn}❯ Permission Request${ansi.reset}${ansi.clearLine}`)
@@ -122,7 +145,7 @@ export function renderFrame(state, agent, opts) {
   // ---- 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}`)
+    out.push(`${C.dim}❯ Queue: ${state.queue.length} pending${state.queue.length > 1 ? ` (next: ${preview}…)` : ` (next: ${preview})`} — Ctrl+D delete${ansi.reset}${ansi.clearLine}`)
   }
 
   // ---- input box ----
@@ -131,6 +154,9 @@ export function renderFrame(state, agent, opts) {
   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 if (title === " Input ") {
+    const hint = " Ctrl+U clear "
+    topBorder = `╭─${title}${"─".repeat(Math.max(0, W - 4 - stringWidth(title) - stringWidth(hint)))}${hint}─╮`
   } else {
     topBorder = `╭─${title}${"─".repeat(Math.max(0, W - 3 - stringWidth(title)))}╮`
   }
@@ -161,7 +187,7 @@ export function renderFrame(state, agent, opts) {
   return { frame, cursorRow, cursorCol }
 }
 
-// ---------------------------------------------------------- 内部实现
+// ---------------------------------------------------------- internal helpers
 
 /** Count conversation lines after sanitize + wrap (for scroll clamping). Pure. */
 export function countConvLines(state, cols) {
@@ -282,8 +308,8 @@ function buildStatusLine(state, agent, { cols, slashCommands }) {
   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}%`
+      ? ` │ ${ansi.reset}${C.warn}context ${ctxPct}%${ansi.reset}${ansi.dim}`
+      : ` │ context ${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`

package/src/tui/render.mjs

@@ -1,14 +1,14 @@
 /**
- * tui-render.mjs — 终端显示工具（纯函数，零依赖）
- * 字符宽度计算、CJK/emoji 排版、文本折行、markdown 表格重排。
+ * tui-render.mjs — terminal display utilities (pure functions, zero dependencies)
+ * Character width calculation, CJK/emoji typesetting, text wrapping, markdown table reformatting.
  */
 
-/** 字符显示宽度：CJK/emoji 计 2，组合字符计 0，其余计 1 */
+/** Character display width: CJK/emoji count as 2, combining characters as 0, rest as 1 */
 export function charWidth(cp) {
   if (
-    (cp >= 0x300 && cp <= 0x36f) || // 组合变音符
-    (cp >= 0x200b && cp <= 0x200f) || // 零宽
-    cp === 0xfe0f // emoji 变体选择符
+    (cp >= 0x300 && cp <= 0x36f) || // combining diacritics
+    (cp >= 0x200b && cp <= 0x200f) || // zero-width
+    cp === 0xfe0f // emoji variation selector
   ) {
     return 0
   }
@@ -29,13 +29,14 @@ export function charWidth(cp) {
   return 1
 }
 
+/** Compute the display width of a string (CJK characters count as 2) */
 export function stringWidth(text) {
   let w = 0
   for (const ch of text) w += charWidth(ch.codePointAt(0))
   return w
 }
 
-/** 按显示宽度裁剪 */
+/** Slice by display width */
 export function sliceByWidth(text, maxWidth) {
   let w = 0
   let out = ""
@@ -48,19 +49,19 @@ export function sliceByWidth(text, maxWidth) {
   return out
 }
 
-/** 按显示宽度右补空格 */
+/** Right-pad by display width */
 function padByWidth(text, width) {
   return text + " ".repeat(Math.max(0, width - stringWidth(text)))
 }
 
-// ---------------------------------------------------------------- markdown 表格重排
+// ---------------------------------------------------------------- markdown table reformatting
 
 const isTableRow = (line) => (line.match(/\|/g) ?? []).length >= 2
 const isTableSeparator = (line) => /^\s*\|?[\s:|-]+\|[\s:|-]*$/.test(line) && line.includes("-")
 
 /**
- * 识别文本中的 markdown 表格块，按显示宽度重排 (修 CJK 错位）。
- * width 为可用显示宽度；过宽的表格按列收缩。非表格行原样保留。
+ * Identify markdown table blocks in text, reformat by display width (fix CJK misalignment).
+ * width is the available display width; over-wide tables shrink columns. Non-table lines are kept as-is.
  */
 export function formatTables(text, width) {
   const lines = text.split("\n")
@@ -94,31 +95,31 @@ function renderTable(block, width) {
   const colCount = Math.max(...rows.map((r) => r.length))
   for (const r of rows) while (r.length < colCount) r.push("")
 
-  // 列宽：先按内容，超宽则从最宽列开始收缩 (收缩到至少 3）
+  // Column widths: content first; if too wide, shrink from widest column (down to at least 3)
   const widths = Array.from({ length: colCount }, (_, c) =>
     Math.max(3, ...rows.map((r) => stringWidth(r[c] ?? ""))),
   )
-  const borders = colCount * 3 + 1 // " │ " 分隔 + 首尾 |
+  const borders = colCount * 3 + 1 // " │ " separators + leading/trailing |
   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 补齐
+  // Cell rendering: sliceByWidth truncates (single-line for header), padByWidth pads
   const fmtCell = (text, ci) => padByWidth(sliceByWidth(text, widths[ci]), widths[ci])
   const fmtRow = (cells) => "│ " + cells.map((c, i) => fmtCell(c, i)).join(" │ ") + " │"
 
-  // 分隔线
+  // separator line
   const separator = "├" + widths.map((w) => "─".repeat(w + 2)).join("┼") + "┤"
 
   const out = []
-  // 表头：单行截断 (表头通常是短标签，折行不如截断直观）
+  // Header: single-line truncation (header labels are usually short, truncation beats wrapping)
   out.push(fmtRow(rows[0]))
   out.push(separator)
 
-  // 数据行：过长单元格按列宽折行，一个逻辑行可能对应多条显示行
+  // Data rows: over-long cells wrap by column width; one logical row may produce multiple display lines
   for (let r = 2; r < rows.length; r++) {
-    // wrapText 返回按 width 折行后的行数组，保留内部 \n
+    // wrapText returns array of lines wrapped by width, preserving internal \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++) {
@@ -129,7 +130,7 @@ function renderTable(block, width) {
   return out
 }
 
-/** 输入区布局：把输入缓冲折行，同时算出光标的 (行, 列) 位置 (显示宽度） */
+/** Input area layout: wrap input buffer into lines, also compute cursor (row, col) position (display width) */
 export function layoutInput(chars, cursor, width) {
   const PROMPT = "\u25b8 "
   const lines = []
@@ -147,8 +148,6 @@ export function layoutInput(chars, cursor, width) {
   }
   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()
@@ -171,8 +170,10 @@ export function layoutInput(chars, cursor, width) {
 }
 
 /**
- * 显示净化：控制字符会破坏终端网格数学 (\r 回车覆盖、\t 宽度误判致整帧错位、ANSI/响铃冲屏）。
- * 只动显示层——模型看到的工具结果原文不变；session 里已存的脏 display 回放时也经此净化。
+ * Display sanitization: control characters can break terminal grid math (\r carriage return overwrite,
+ * \t width misjudgment causing entire frame misalignment, ANSI/bell screen floods).
+ * Display-layer only — raw tool results the model sees are unchanged; dirty displays already in session
+ * are also cleaned during replay.
  */
 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) {
@@ -185,7 +186,7 @@ export function sanitizeDisplay(s) {
     .replace(/\n+$/, "")
 }
 
-/** 文本按宽度折行 (保留 \n），返回行数组 */
+/** Wrap text by display width (preserving \n), returns array of lines */
 export function wrapText(text, width) {
   const lines = []
   for (const rawLine of text.split("\n")) {

package/src/tui/slash-commands.mjs

@@ -1,8 +1,8 @@
 /**
- * slash-commands.mjs — 斜杠命令定义、分发、Tab 补全。
- * 每个子命令的具体实现都在独立的 cmd-*.mjs 中，本文件只做 dispatch。
+ * slash-commands.mjs — slash command definitions, dispatch, Tab completion.
+ * Each subcommand's implementation lives in its own cmd-*.mjs file; this file only does dispatch.
  *
- * ctx 对象由 index.mjs 注入，透传给各 handler：
+ * ctx object is injected by index.mjs and forwarded to each handler:
  *   { agent, state, distillOpts, pushLine, pushLabel, render,
  *     openPicker, openModelPicker, setProviderKey, runDistill,
  *     persistRaw, syncProviderField, maskKey, exit, SLASH_COMMANDS }
@@ -47,7 +47,7 @@ export const SLASH_COMMANDS = [
   { name: "/help", group: "", desc: "this list" },
 ]
 
-/** 命令 → handler 映射表 */
+/** Command → handler mapping table */
 const HANDLERS = {
   "/clear": handleClearCommand,
   "/new": handleNewCommand,
@@ -69,17 +69,17 @@ const HANDLERS = {
 }
 
 /**
- * 创建斜杠命令处理器。
- * 返回 { handleSlash, completions, handleTab }。
+ * Creates the slash command processor.
+ * Returns { handleSlash, completions, handleTab }.
  */
 export function createSlashCommands(ctx) {
   const { agent, state, render } = ctx
-  // 给 /help 传 SLASH_COMMANDS
+  // forward SLASH_COMMANDS to /help
   const handlerCtx = { ...ctx, SLASH_COMMANDS }
 
   async function handleSlash(text) {
     const [cmd] = text.split(/\s+/)
-    // 高频命令缩写
+    // high-frequency command aliases
     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]
@@ -90,18 +90,18 @@ export function createSlashCommands(ctx) {
     ctx.pushLine(`Unknown command: ${cmd} (/help for available commands)`, C.error)
   }
 
-  /** Tab 补全候选：Commands 名 / 子 Commands / provider 名 / 预设名 / think 参数 */
+  /** Tab completion candidates: command names / subcommands / provider names / preset names / think params */
   function completions(input) {
     if (!input.startsWith("/")) return []
     const parts = input.split(/\s+/)
-    // 还在敲第一个 token：补 Commands 名
+    // still typing the first token: complete command names
     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 last = parts.at(-1) // when trailing space, list all candidates
     const head = parts.slice(0, -1).join(" ")
-    const argIndex = parts.length - 2 // 正在敲第几个参数 (0 基）
+    const argIndex = parts.length - 2 // which parameter is being typed (0-based)
     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") {
@@ -117,11 +117,11 @@ export function createSlashCommands(ctx) {
     return []
   }
 
-  /** Tab：计算候选并循环替换输入 */
+  /** Tab: compute candidates and cycle through replacement */
   function handleTab() {
     const input = state.input.join("")
     if (state.completion && input === state.completion.candidates[state.completion.index]) {
-      // 上一次的候选还在输入框：循环到下一个
+      // previous candidate still in input box: cycle to next
       state.completion.index = (state.completion.index + 1) % state.completion.candidates.length
     } else {
       const candidates = completions(input)

package/src/tui/startup.mjs

@@ -2,13 +2,13 @@ import { listSlots } from "../session.mjs"
 import { sliceByWidth } from "./render.mjs"
 import { ansi, C } from "./ansi.mjs"
 
-/** 启动画面 + 会话恢复 + 后台索引。
- *  从 index.mjs 抽出。
+/** Startup screen + session recovery + background indexing.
+ *  Extracted from index.mjs.
  *  ctx: { agent, state, opts, pushLine, pushLabel, render, startWizard } */
 export function showStartup(ctx) {
   const { agent, state, opts, pushLine, pushLabel, render, startWizard } = ctx
 
-  // 启动画面
+  // Startup screen
   if (!agent.provider.apiKey) {
     pushLabel(`Welcome to ThinCoder!`, ansi.bold + C.tool)
     pushLine("No API key configured yet — entering initial setup (Esc to skip anytime)", C.text)
@@ -18,13 +18,14 @@ export function showStartup(ctx) {
   }
   pushLine(`Tools: ${agent.tools.map((t) => t.name).join(", ")}`, C.dim)
 
-  // 恢复上次会话：重建对话区显示 (tool 结果行省略，保持清爽）
+  // Recover previous session: rebuild conversation display (tool result lines omitted, keep it clean)
   if (opts.restored?.display?.length) {
-    // 用户视角的恢复：display 是退出前对话区的原样快照，所见即所得
+    // User-facing recovery: display is a WYSIWYG snapshot of the conversation before exit
     state.lines = [...opts.restored.display.map((l) => ({ text: l.text, color: l.color })), ...state.lines]
-    pushLabel(`── Restored previous session; /new for a fresh session ──`, C.warn)
+    const recoveryNote = opts.restored._recovered ? " (recovered from backup)" : ""
+    pushLabel(`── Restored previous session${recoveryNote}; /new for a fresh session ──`, C.warn)
   } else if (opts.restored?.history?.length) {
-    // 重建对话区：user/assistant 消息逐条展示，tool 结果行只保留首行摘要
+    // Rebuild conversation: user/assistant messages shown one by one, tool result lines show only first-line summary
     for (let i = 0; i < opts.restored.history.length; i++) {
       const m = opts.restored.history[i]
       if (m.role === "user") {
@@ -35,27 +36,27 @@ export function showStartup(ctx) {
         pushLabel(`❯ ThinCoder:`, ansi.bold + C.assistant)
         if (typeof m.content === "string" && m.content) pushLine(m.content, C.text)
         for (const tc of m.tool_calls ?? []) {
-          // 找到下一条对应的 tool 结果，显示首行摘要
+          // Find the next corresponding tool result, show first-line summary
           const toolResult = opts.restored.history[i + 1]
           const hasResult = toolResult?.role === "tool" && toolResult?.tool_call_id === tc.id
           const summary = hasResult ? " → " + sliceByWidth(String(toolResult.content).split("\n")[0], 80) : ""
           pushLine(`  [tool] ${tc.function?.name ?? "?"}${summary}`, C.tool)
         }
       }
-      // tool 消息本身不单独渲染——已在 assistant 的 tool_calls 后以摘要形式展示
+      // Tool messages aren't rendered separately — already shown as summary after assistant's tool_calls
     }
     pushLabel(`── Restored previous session (${opts.restored.history.length} messages); /new for a fresh session ──`, C.warn)
   }
 
-  // 有归档槽位时给个提示
+  // Hint when archived slots exist
   if (listSlots(agent.cwd).length > 0) {
     pushLine("Tip: archived sessions available — /session to view/switch", C.dim)
   }
   render()
 }
 
-/** 后台索引 (进界面后再跑，不阻塞启动）；进度走底部状态栏，不往对话区塞行。
- *  优先用 git diff 增量（快），git 不可用或首次运行时退到全量扫描。 */
+/** Background indexing (runs after startup screen, non-blocking); progress shown in status bar, not conversation.
+ *   Prefers git diff incremental (fast); falls back to full scan when git is unavailable or on first run. */
 export async function backgroundIndex(ctx) {
   const { agent, state, render } = ctx
   const { codeSync, docSync, gitSync } = await import("../memory.mjs")
@@ -75,11 +76,11 @@ export async function backgroundIndex(ctx) {
   })
 
   if (gitRes !== null) {
-    // git 增量成功，直接统计
+    // Git incremental succeeded, count directly
     codeFiles = agent.memory.db.prepare(`SELECT COUNT(DISTINCT path) AS n FROM code_chunks`).get()?.n ?? 0
     docFiles = agent.memory.db.prepare(`SELECT COUNT(DISTINCT path) AS n FROM doc_chunks`).get()?.n ?? 0
   } else {
-    // 退到全量扫描（codeSync 和 docSync 并行——读写不同表，SQLite WAL 天然支持）
+    // Fall back to full scan (codeSync and docSync in parallel — read/write different tables, SQLite WAL supports this natively)
     const [codeRes, docRes] = await Promise.allSettled([
       codeSync(agent.memory, cwd, {
         onProgress: (p) => {