min-agent 0.2.0 → 0.3.0

package/docs/superpowers/plans/2026-08-16-batch1-tui-improvements.md

@@ -0,0 +1,1510 @@
+# 第一批：TUI 交互体验改进 Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 修复 `chat -i` 图片丢弃缺陷，补齐 TUI 输入历史、undo/redo、diff、会话管理、成本估算等交互体验。
+
+**Architecture:** 交互逻辑抽为纯函数模块（`src/tui/input-history.ts`、`src/tui/undo-stack.ts`、`src/tui/diff-view.ts`、`src/pricing.ts`），TUI 层只做状态集成；图片加载抽为 `agent.ts` 的 `loadImageParts()`，CLI 单次模式与 TUI 共用。
+
+**Tech Stack:** TypeScript, React 18 + Ink 5, bun:test
+
+**Spec:** `docs/superpowers/specs/2026-08-16-batch1-tui-improvements-design.md`
+
+---
+
+## 文件结构
+
+| 文件 | 职责 |
+|---|---|
+| `src/tui/input-history.ts`(新) | 输入历史纯函数 |
+| `src/tui/undo-stack.ts`(新) | 回合记录与撤销纯函数 |
+| `src/tui/diff-view.ts`(新) | git diff 提取纯函数 |
+| `src/pricing.ts`(新) | 模型价格查询/缓存/成本估算 |
+| `tests/input-history.test.ts`(新) | 输入历史测试 |
+| `tests/undo-stack.test.ts`(新) | 撤销栈测试 |
+| `tests/diff-view.test.ts`(新) | diff 提取测试 |
+| `tests/pricing.test.ts`(新) | 价格/成本测试 |
+| `tests/image-parts.test.ts`(新) | 图片加载测试 |
+| `src/tui/InputBar.tsx`(改) | 输入历史集成 |
+| `src/tui/index.tsx`(改) | TuiRenderer 加 `messageCount()` / `truncateMessages()` |
+| `src/sessions.ts`(改) | `renameSession()` |
+| `tests/sessions.test.ts`(改) | renameSession 测试 |
+| `src/agent.ts`(改) | 提取 `loadImageParts()` |
+| `src/tui-chat.ts`(改) | images 注入 + 新斜杠命令 + 成本显示 |
+| `src/cli.ts`(改) | chat 分支透传 images |
+| `src/config.ts`(改) | `AppConfig.pricing` 字段 |
+| `src/tui/slash-commands.ts`(改) | 菜单新命令 |
+| `README.md`(改) | 命令表同步 |
+
+测试命令（`packages/min-agent` 下）：`bun test tests/<file>`、全量 `bun test`、类型 `npx tsc --noEmit`。
+
+---
+
+## Task 1: input-history.ts — 输入历史纯函数
+
+**Files:**
+- Create: `src/tui/input-history.ts`
+- Test: `tests/input-history.test.ts`
+
+- [ ] **Step 1: 写失败测试**
+
+```ts
+import { expect, test } from "bun:test"
+import { createHistory, pushInput, browseHistory, resetHistory } from "../src/tui/input-history.js"
+
+test("createHistory starts empty", () => {
+  expect(createHistory()).toEqual({ entries: [], index: -1, draft: "" })
+})
+
+test("pushInput appends submitted text", () => {
+  const h = pushInput(pushInput(createHistory(), "a"), "b")
+  expect(h.entries).toEqual(["a", "b"])
+})
+
+test("pushInput skips empty text", () => {
+  expect(pushInput(createHistory(), "")).toEqual(createHistory())
+})
+
+test("pushInput deduplicates consecutive identical entries", () => {
+  const h = pushInput(pushInput(createHistory(), "a"), "a")
+  expect(h.entries).toEqual(["a"])
+})
+
+test("browseHistory up enters history with the most recent entry", () => {
+  const h = pushInput(pushInput(createHistory(), "first"), "second")
+  expect(browseHistory(h, 1)).toEqual({
+    text: "second",
+    state: { entries: ["first", "second"], index: 1, draft: "" },
+  })
+})
+
+test("browseHistory up walks to older entries and clamps", () => {
+  const h = pushInput(pushInput(createHistory(), "first"), "second")
+  const older = browseHistory(browseHistory(h, 1).state, 1)
+  expect(older.text).toBe("first")
+  const clamped = browseHistory(older.state, 1)
+  expect(clamped.text).toBe("first")
+})
+
+test("browseHistory down returns to the draft after the newest entry", () => {
+  const h = pushInput(pushInput(createHistory(), "first"), "second")
+  const entered = browseHistory(h, 1).state
+  const draft = browseHistory(entered, -1)
+  expect(draft.text).toBe("")
+  expect(draft.state.index).toBe(-1)
+})
+
+test("browseHistory down at the draft is a no-op", () => {
+  const h = pushInput(createHistory(), "a")
+  expect(browseHistory(h, -1)).toEqual({ text: "", state: h })
+})
+
+test("browseHistory with empty history returns the draft", () => {
+  const h = createHistory()
+  expect(browseHistory(h, 1)).toEqual({ text: "", state: h })
+})
+
+test("browseHistory keeps the draft while browsing", () => {
+  const h = { entries: ["a"], index: -1, draft: "draft" }
+  const r = browseHistory(h, 1)
+  expect(r.text).toBe("a")
+  expect(r.state.draft).toBe("draft")
+})
+
+test("resetHistory restores the draft and leaves history", () => {
+  const h = { entries: ["a"], index: 0, draft: "draft" }
+  expect(resetHistory(h, "edited")).toEqual({ entries: ["a"], index: -1, draft: "edited" })
+})
+
+test("resetHistory is a no-op at the draft with the same text", () => {
+  const h = { entries: ["a"], index: -1, draft: "draft" }
+  expect(resetHistory(h, "draft")).toBe(h)
+})
+```
+
+- [ ] **Step 2: 运行测试确认失败**
+
+Run: `bun test tests/input-history.test.ts`
+Expected: FAIL — `Cannot find module "../src/tui/input-history.js"`
+
+- [ ] **Step 3: 实现 input-history.ts**
+
+```ts
+export interface HistoryState {
+  entries: string[]
+  index: number
+  draft: string
+}
+
+export function createHistory(): HistoryState {
+  return { entries: [], index: -1, draft: "" }
+}
+
+export function pushInput(state: HistoryState, text: string): HistoryState {
+  if (!text) return state
+  if (state.entries.length > 0 && state.entries[state.entries.length - 1] === text) return state
+  return { entries: [...state.entries, text], index: -1, draft: "" }
+}
+
+export function browseHistory(state: HistoryState, direction: 1 | -1): { text: string; state: HistoryState } {
+  const count = state.entries.length
+  if (count === 0) return { text: state.draft, state }
+  if (direction === 1) {
+    const index = state.index === -1 ? count - 1 : Math.max(0, state.index - 1)
+    return { text: state.entries[index]!, state: { ...state, index } }
+  }
+  if (state.index === -1) return { text: state.draft, state }
+  if (state.index >= count - 1) return { text: state.draft, state: { ...state, index: -1 } }
+  const index = state.index + 1
+  return { text: state.entries[index]!, state: { ...state, index } }
+}
+
+export function resetHistory(state: HistoryState, text: string): HistoryState {
+  if (state.index === -1 && state.draft === text) return state
+  return { entries: state.entries, index: -1, draft: text }
+}
+```
+
+- [ ] **Step 4: 运行测试确认通过**
+
+Run: `bun test tests/input-history.test.ts`
+Expected: PASS (12 个用例)
+
+- [ ] **Step 5: 提交**
+
+```bash
+git add src/tui/input-history.ts tests/input-history.test.ts
+git commit -m "feat: 输入历史纯函数模块"
+```
+
+---
+
+## Task 2: undo-stack.ts — 回合撤销栈纯函数
+
+**Files:**
+- Create: `src/tui/undo-stack.ts`
+- Test: `tests/undo-stack.test.ts`
+
+- [ ] **Step 1: 写失败测试**
+
+```ts
+import { expect, test } from "bun:test"
+import { createUndoStack, pushTurn, popTurn, clearStack } from "../src/tui/undo-stack.js"
+
+test("createUndoStack starts empty", () => {
+  expect(createUndoStack()).toEqual([])
+})
+
+test("pushTurn appends a turn", () => {
+  const stack = pushTurn(createUndoStack(), 0, 3, 5)
+  expect(stack).toEqual([{ start: 0, end: 3, uiEnd: 5 }])
+})
+
+test("popTurn returns the last turn and a shrunk stack", () => {
+  let stack = pushTurn(pushTurn(createUndoStack(), 0, 3, 5), 3, 7, 10)
+  const last = popTurn(stack)
+  expect(last).toEqual({ turn: { start: 3, end: 7, uiEnd: 10 }, stack: [{ start: 0, end: 3, uiEnd: 5 }] })
+})
+
+test("popTurn on an empty stack returns null", () => {
+  expect(popTurn(createUndoStack())).toBeNull()
+})
+
+test("clearStack empties the stack", () => {
+  const stack = pushTurn(createUndoStack(), 0, 3, 5)
+  expect(clearStack(stack)).toEqual([])
+})
+```
+
+- [ ] **Step 2: 运行测试确认失败**
+
+Run: `bun test tests/undo-stack.test.ts`
+Expected: FAIL — module not found
+
+- [ ] **Step 3: 实现 undo-stack.ts**
+
+```ts
+export interface TurnRecord {
+  start: number
+  end: number
+  uiEnd: number
+}
+
+export function createUndoStack(): TurnRecord[] {
+  return []
+}
+
+export function pushTurn(stack: TurnRecord[], start: number, end: number, uiEnd: number): TurnRecord[] {
+  return [...stack, { start, end, uiEnd }]
+}
+
+export function popTurn(stack: TurnRecord[]): { turn: TurnRecord; stack: TurnRecord[] } | null {
+  if (stack.length === 0) return null
+  return { turn: stack[stack.length - 1]!, stack: stack.slice(0, -1) }
+}
+
+export function clearStack(stack: TurnRecord[]): TurnRecord[] {
+  return []
+}
+```
+
+- [ ] **Step 4: 运行测试确认通过**
+
+Run: `bun test tests/undo-stack.test.ts`
+Expected: PASS (5 个用例)
+
+- [ ] **Step 5: 提交**
+
+```bash
+git add src/tui/undo-stack.ts tests/undo-stack.test.ts
+git commit -m "feat: 回合撤销栈纯函数模块"
+```
+
+---
+
+## Task 3: diff-view.ts — 工作区 diff 提取
+
+**Files:**
+- Create: `src/tui/diff-view.ts`
+- Test: `tests/diff-view.test.ts`
+
+- [ ] **Step 1: 写失败测试**
+
+```ts
+import { expect, test } from "bun:test"
+import { getWorkingTreeDiff } from "../src/tui/diff-view.js"
+
+function runStub(commands: Record<string, string>): (cmd: string, cwd: string) => string {
+  return (cmd) => {
+    const out = commands[cmd]
+    if (out === undefined) throw new Error(`not stubbed: ${cmd}`)
+    return out
+  }
+}
+
+test("returns the diff with stat for a git repo with changes", () => {
+  const run = runStub({
+    "git rev-parse --is-inside-work-tree": "true",
+    "git diff --stat": " src/a.ts | 2 +-\n 1 file changed",
+    "git diff": "diff --git a/src/a.ts b/src/a.ts\n+line\n",
+  })
+  const result = getWorkingTreeDiff("/tmp/x", run)
+  expect(result).toEqual({
+    ok: true,
+    diff: " src/a.ts | 2 +-\n 1 file changed\n\ndiff --git a/src/a.ts b/src/a.ts\n+line\n",
+  })
+})
+
+test("returns not_git when rev-parse fails", () => {
+  const result = getWorkingTreeDiff("/tmp/x", runStub({}))
+  expect(result).toEqual({ ok: false, reason: "not_git", message: "当前目录不是 git 仓库" })
+})
+
+test("returns no_changes for an empty diff", () => {
+  const run = runStub({
+    "git rev-parse --is-inside-work-tree": "true",
+    "git diff --stat": "",
+    "git diff": "",
+  })
+  const result = getWorkingTreeDiff("/tmp/x", run)
+  expect(result).toEqual({ ok: false, reason: "no_changes", message: "工作区无未提交变更" })
+})
+
+test("truncates very long diffs", () => {
+  const run = runStub({
+    "git rev-parse --is-inside-work-tree": "true",
+    "git diff --stat": " 1 file changed",
+    "git diff": "x".repeat(9000),
+  })
+  const result = getWorkingTreeDiff("/tmp/x", run)
+  if (result.ok) expect(result.diff.length).toBeLessThan(8200)
+})
+```
+
+- [ ] **Step 2: 运行测试确认失败**
+
+Run: `bun test tests/diff-view.test.ts`
+Expected: FAIL — module not found
+
+- [ ] **Step 3: 实现 diff-view.ts**
+
+```ts
+import { execSync } from "child_process"
+
+export type DiffResult =
+  | { ok: true; diff: string }
+  | { ok: false; reason: "not_git" | "no_changes" | "error"; message: string }
+
+const MAX_DIFF_CHARS = 8000
+
+export function getWorkingTreeDiff(
+  cwd: string = process.cwd(),
+  run: (cmd: string, cwd: string) => string = defaultRun,
+): DiffResult {
+  try {
+    run("git rev-parse --is-inside-work-tree", cwd)
+  } catch {
+    return { ok: false, reason: "not_git", message: "当前目录不是 git 仓库" }
+  }
+  let stat = ""
+  let full = ""
+  try {
+    stat = run("git diff --stat", cwd).trim()
+    full = run("git diff", cwd)
+  } catch (err: any) {
+    return { ok: false, reason: "error", message: err?.message ?? String(err) }
+  }
+  if (!full.trim()) return { ok: false, reason: "no_changes", message: "工作区无未提交变更" }
+  const body = full.length > MAX_DIFF_CHARS ? full.slice(0, MAX_DIFF_CHARS) + "\n… [diff 过长，已截断]" : full
+  return { ok: true, diff: stat ? `${stat}\n\n${body}` : body }
+}
+
+function defaultRun(cmd: string, cwd: string): string {
+  return execSync(cmd, { cwd, encoding: "utf-8", timeout: 10000, stdio: "pipe" })
+}
+```
+
+- [ ] **Step 4: 运行测试确认通过**
+
+Run: `bun test tests/diff-view.test.ts`
+Expected: PASS (4 个用例)
+
+- [ ] **Step 5: 提交**
+
+```bash
+git add src/tui/diff-view.ts tests/diff-view.test.ts
+git commit -m "feat: 工作区 diff 提取模块"
+```
+
+---
+
+## Task 4: pricing.ts + config.pricing — 成本估算
+
+**Files:**
+- Create: `src/pricing.ts`
+- Modify: `src/config.ts`（AppConfig 加 pricing 字段）
+- Test: `tests/pricing.test.ts`
+
+- [ ] **Step 1: 写失败测试**
+
+```ts
+import { expect, test } from "bun:test"
+import { mkdtempSync, rmSync, realpathSync, writeFileSync } from "fs"
+import os from "os"
+import path from "path"
+import { estimateCost, formatCost, getModelPrice } from "../src/pricing.js"
+
+const modelsDev = {
+  provider1: {
+    models: {
+      "my-model": { pricing: { input: 2.5, output: 10 } },
+      "other-model": { pricing: { input: 1, output: 2 } },
+    },
+  },
+}
+
+function makeTemp(): string {
+  return realpathSync(mkdtempSync(path.join(os.tmpdir(), "min-agent-pricing-")))
+}
+
+test("estimateCost computes USD from tokens and price", () => {
+  const price = { inputPerMillion: 2.5, outputPerMillion: 10 }
+  expect(estimateCost({ inputTokens: 1_000_000, outputTokens: 500_000 }, price)).toBe(7.5)
+})
+
+test("estimateCost returns null without a price", () => {
+  expect(estimateCost({ inputTokens: 100, outputTokens: 50 }, null)).toBeNull()
+})
+
+test("formatCost renders USD or --", () => {
+  expect(formatCost(0.01234)).toBe("$0.0123")
+  expect(formatCost(0.12345)).toBe("$0.123")
+  expect(formatCost(null)).toBe("--")
+})
+
+test("getModelPrice fetches from models.dev and caches", async () => {
+  const base = makeTemp()
+  const oldDir = process.env.MIN_AGENT_CONFIG_DIR
+  process.env.MIN_AGENT_CONFIG_DIR = base
+  const calls: string[] = []
+  const originalFetch = globalThis.fetch
+  globalThis.fetch = (async (url: any) => {
+    calls.push(String(url))
+    return new Response(JSON.stringify(modelsDev), { status: 200 })
+  }) as typeof fetch
+  try {
+    const first = await getModelPrice("my-model")
+    expect(first).toEqual({ inputPerMillion: 2.5, outputPerMillion: 10 })
+    const second = await getModelPrice("my-model")
+    expect(second).toEqual(first)
+    expect(calls.length).toBe(1)
+  } finally {
+    globalThis.fetch = originalFetch
+    if (oldDir) process.env.MIN_AGENT_CONFIG_DIR = oldDir
+    else delete process.env.MIN_AGENT_CONFIG_DIR
+    rmSync(base, { recursive: true, force: true })
+  }
+})
+
+test("getModelPrice returns null when models.dev has no match", async () => {
+  const base = makeTemp()
+  const oldDir = process.env.MIN_AGENT_CONFIG_DIR
+  process.env.MIN_AGENT_CONFIG_DIR = base
+  const originalFetch = globalThis.fetch
+  globalThis.fetch = (async () => new Response(JSON.stringify(modelsDev), { status: 200 })) as typeof fetch
+  try {
+    expect(await getModelPrice("no-such-model")).toBeNull()
+  } finally {
+    globalThis.fetch = originalFetch
+    if (oldDir) process.env.MIN_AGENT_CONFIG_DIR = oldDir
+    else delete process.env.MIN_AGENT_CONFIG_DIR
+    rmSync(base, { recursive: true, force: true })
+  }
+})
+
+test("getModelPrice prefers the config override without fetching", async () => {
+  const base = makeTemp()
+  const oldDir = process.env.MIN_AGENT_CONFIG_DIR
+  process.env.MIN_AGENT_CONFIG_DIR = base
+  writeFileSync(
+    path.join(base, "config.json"),
+    JSON.stringify({ pricing: { "my-model": { inputPerMillion: 99, outputPerMillion: 199 } } }),
+  )
+  let fetched = false
+  const originalFetch = globalThis.fetch
+  globalThis.fetch = (async () => {
+    fetched = true
+    return new Response(JSON.stringify(modelsDev), { status: 200 })
+  }) as typeof fetch
+  try {
+    const price = await getModelPrice("my-model")
+    expect(price).toEqual({ inputPerMillion: 99, outputPerMillion: 199 })
+    expect(fetched).toBe(false)
+  } finally {
+    globalThis.fetch = originalFetch
+    if (oldDir) process.env.MIN_AGENT_CONFIG_DIR = oldDir
+    else delete process.env.MIN_AGENT_CONFIG_DIR
+    rmSync(base, { recursive: true, force: true })
+  }
+})
+```
+
+- [ ] **Step 2: 运行测试确认失败**
+
+Run: `bun test tests/pricing.test.ts`
+Expected: FAIL — module not found
+
+- [ ] **Step 3: config.ts 加 pricing 字段**
+
+在 `src/config.ts` 的 `AppConfig` 接口末尾（`webFetchURL` 之后）添加：
+
+```ts
+  /** Per-model price overrides (USD per 1M tokens), used for cost estimation */
+  pricing?: Record<string, { inputPerMillion: number; outputPerMillion: number }>
+```
+
+- [ ] **Step 4: 实现 pricing.ts**
+
+```ts
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs"
+import path from "path"
+import { getConfigDir, loadConfig } from "./config.js"
+
+export interface ModelPrice {
+  inputPerMillion: number
+  outputPerMillion: number
+}
+
+const CACHE_TTL = 7 * 24 * 60 * 60 * 1000
+
+interface CacheEntry {
+  price: ModelPrice
+  timestamp: number
+}
+
+type Cache = Record<string, CacheEntry>
+
+const memoryCache = new Map<string, CacheEntry>()
+const inFlight = new Map<string, Promise<ModelPrice | null>>()
+
+function cacheFile(): string {
+  return path.join(getConfigDir(), "pricing-cache.json")
+}
+
+function loadDiskCache(): Cache {
+  const file = cacheFile()
+  if (!existsSync(file)) return {}
+  try {
+    return JSON.parse(readFileSync(file, "utf-8"))
+  } catch {
+    return {}
+  }
+}
+
+function saveCache(cache: Cache) {
+  const file = cacheFile()
+  mkdirSync(path.dirname(file), { recursive: true })
+  writeFileSync(file, JSON.stringify(cache), "utf-8")
+}
+
+function getCached(modelId: string): CacheEntry | null {
+  const memory = memoryCache.get(modelId)
+  if (memory && Date.now() - memory.timestamp <= CACHE_TTL) return memory
+  const disk = loadDiskCache()[modelId]
+  if (disk && Date.now() - disk.timestamp <= CACHE_TTL) {
+    memoryCache.set(modelId, disk)
+    return disk
+  }
+  return null
+}
+
+function setCache(modelId: string, price: ModelPrice) {
+  const entry = { price, timestamp: Date.now() }
+  memoryCache.set(modelId, entry)
+  const cache = loadDiskCache()
+  cache[modelId] = entry
+  saveCache(cache)
+}
+
+function priceFromConfig(modelId: string): ModelPrice | null {
+  const override = loadConfig().pricing?.[modelId]
+  if (!override) return null
+  if (typeof override.inputPerMillion !== "number" || typeof override.outputPerMillion !== "number") return null
+  return { inputPerMillion: override.inputPerMillion, outputPerMillion: override.outputPerMillion }
+}
+
+async function fetchFromModelsDev(modelId: string): Promise<ModelPrice | null> {
+  try {
+    const response = await fetch("https://models.dev/api.json", { signal: AbortSignal.timeout(10000) })
+    if (!response.ok) return null
+    const providers = (await response.json()) as Record<string, any>
+    for (const provider of Object.values(providers)) {
+      if (!provider.models) continue
+      for (const [id, model] of Object.entries<any>(provider.models)) {
+        if (id === modelId || id.endsWith(`/${modelId}`) || modelId.endsWith(`/${id}`)) {
+          const p = model?.pricing
+          if (p && typeof p.input === "number" && typeof p.output === "number") {
+            return { inputPerMillion: p.input, outputPerMillion: p.output }
+          }
+        }
+      }
+    }
+    return null
+  } catch {
+    return null
+  }
+}
+
+export async function getModelPrice(modelId: string): Promise<ModelPrice | null> {
+  const override = priceFromConfig(modelId)
+  if (override) return override
+  const cached = getCached(modelId)
+  if (cached) return cached.price
+  const pending = inFlight.get(modelId)
+  if (pending) return pending
+  const probing = fetchFromModelsDev(modelId).then((price) => {
+    if (price) setCache(modelId, price)
+    return price
+  })
+  inFlight.set(modelId, probing)
+  try {
+    return await probing
+  } finally {
+    inFlight.delete(modelId)
+  }
+}
+
+export function estimateCost(
+  usage: { inputTokens: number; outputTokens: number },
+  price: ModelPrice | null,
+): number | null {
+  if (!price) return null
+  const cost = (usage.inputTokens / 1_000_000) * price.inputPerMillion +
+    (usage.outputTokens / 1_000_000) * price.outputPerMillion
+  return cost > 0 ? cost : null
+}
+
+export function formatCost(cost: number | null): string {
+  if (cost === null) return "--"
+  return cost >= 0.01 ? `$${cost.toFixed(3)}` : `$${cost.toFixed(4)}`
+}
+```
+
+- [ ] **Step 5: 运行测试确认通过**
+
+Run: `bun test tests/pricing.test.ts`
+Expected: PASS (6 个用例)
+
+- [ ] **Step 6: 提交**
+
+```bash
+git add src/pricing.ts src/config.ts tests/pricing.test.ts
+git commit -m "feat: 模型价格查询与成本估算"
+```
+
+---
+
+## Task 5: TuiRenderer — messageCount / truncateMessages
+
+**Files:**
+- Modify: `src/tui/index.tsx`
+
+- [ ] **Step 1: 实现**
+
+在 `src/tui/index.tsx` 的 `addMessage` 方法之后添加：
+
+```ts
+  /** Number of messages currently rendered (used by /undo). */
+  messageCount() {
+    return this.state.messages.length
+  }
+
+  /** Keep only the first `count` messages (used by /undo). */
+  truncateMessages(count: number) {
+    this.state.messages = this.state.messages.slice(0, count)
+    this.update({})
+  }
+```
+
+- [ ] **Step 2: 类型检查**
+
+Run: `npx tsc --noEmit`
+Expected: 无错误
+
+- [ ] **Step 3: 提交**
+
+```bash
+git add src/tui/index.tsx
+git commit -m "feat: TuiRenderer 支持消息截断"
+```
+
+---
+
+## Task 6: sessions.ts — renameSession
+
+**Files:**
+- Modify: `src/sessions.ts`
+- Test: `tests/sessions.test.ts`
+
+- [ ] **Step 1: 写失败测试**
+
+在 `tests/sessions.test.ts` 末尾追加：
+
+```ts
+test("renameSession updates the title", () => {
+  const id = saveSession([{ role: "user", content: "hi" }])
+  expect(renameSession(id, "new title")).toBe(true)
+  expect(loadSession(id)!.meta.title).toBe("new title")
+})
+
+test("renameSession returns false for a missing session", () => {
+  expect(renameSession("no-such-id", "x")).toBe(false)
+})
+```
+
+并更新 import 行：
+
+```ts
+import { saveSession, loadSession, listSessions, deleteSession, renameSession } from "../src/sessions.js"
+```
+
+- [ ] **Step 2: 运行测试确认失败**
+
+Run: `bun test tests/sessions.test.ts`
+Expected: FAIL — `renameSession is not a function`
+
+- [ ] **Step 3: 实现 renameSession**
+
+在 `src/sessions.ts` 的 `deleteSession` 之后添加：
+
+```ts
+export function renameSession(id: string, title: string): boolean {
+  const file = sessionPath(id)
+  if (!existsSync(file)) return false
+  try {
+    const data = JSON.parse(readFileSync(file, "utf-8")) as SessionData
+    data.meta.title = title
+    data.meta.updated = new Date().toISOString()
+    writeFileSync(file, JSON.stringify(data, null, 2), "utf-8")
+    return true
+  } catch {
+    return false
+  }
+}
+```
+
+- [ ] **Step 4: 运行测试确认通过**
+
+Run: `bun test tests/sessions.test.ts`
+Expected: PASS（原有用例 + 2 个新用例）
+
+- [ ] **Step 5: 提交**
+
+```bash
+git add src/sessions.ts tests/sessions.test.ts
+git commit -m "feat: 会话重命名"
+```
+
+---
+
+## Task 7: agent.ts — 提取 loadImageParts
+
+**Files:**
+- Modify: `src/agent.ts`（`buildUserContent` 重构，第 74-110 行）
+- Test: `tests/image-parts.test.ts`
+
+- [ ] **Step 1: 写失败测试**
+
+```ts
+import { expect, test } from "bun:test"
+import { mkdtempSync, writeFileSync, rmSync, realpathSync } from "fs"
+import os from "os"
+import path from "path"
+import { loadImageParts } from "../src/agent.js"
+
+function makeTemp(): string {
+  return realpathSync(mkdtempSync(path.join(os.tmpdir(), "min-agent-images-")))
+}
+
+test("loadImageParts returns image parts for existing files", () => {
+  const base = makeTemp()
+  try {
+    writeFileSync(path.join(base, "a.png"), "fake-png")
+    writeFileSync(path.join(base, "b.jpg"), "fake-jpg")
+    const parts = loadImageParts(["a.png", "b.jpg"], () => {})
+    expect(parts.length).toBe(2)
+    expect(parts[0]).toEqual({ type: "image", image: Buffer.from("fake-png"), mimeType: "image/png" })
+    expect(parts[1]).toEqual({ type: "image", image: Buffer.from("fake-jpg"), mimeType: "image/jpeg" })
+  } finally {
+    rmSync(base, { recursive: true, force: true })
+  }
+})
+
+test("loadImageParts resolves relative to cwd", () => {
+  const base = makeTemp()
+  try {
+    writeFileSync(path.join(base, "pic.gif"), "gif")
+    const parts = loadImageParts(["pic.gif"], () => {})
+    expect(parts.length).toBe(0)
+    const oldCwd = process.cwd()
+    process.chdir(base)
+    try {
+      const inCwd = loadImageParts(["pic.gif"], () => {})
+      expect(inCwd.length).toBe(1)
+      expect(inCwd[0]).toEqual({ type: "image", image: Buffer.from("gif"), mimeType: "image/gif" })
+    } finally {
+      process.chdir(oldCwd)
+    }
+  } finally {
+    rmSync(base, { recursive: true, force: true })
+  }
+})
+
+test("loadImageParts notifies not_found and skips", () => {
+  const base = makeTemp()
+  const events: string[] = []
+  try {
+    const parts = loadImageParts(["missing.png"], (kind, p) => events.push(`${kind}:${p}`))
+    expect(parts.length).toBe(0)
+    expect(events).toEqual(["not_found:missing.png"])
+  } finally {
+    rmSync(base, { recursive: true, force: true })
+  }
+})
+
+test("loadImageParts notifies too_large and skips", () => {
+  const base = makeTemp()
+  const events: string[] = []
+  try {
+    writeFileSync(path.join(base, "big.png"), Buffer.alloc(5 * 1024 * 1024 + 1))
+    const parts = loadImageParts(["big.png"], (kind, p) => events.push(`${kind}:${p}`))
+    expect(parts.length).toBe(0)
+    expect(events).toEqual(["too_large:big.png"])
+  } finally {
+    rmSync(base, { recursive: true, force: true })
+  }
+})
+
+test("loadImageParts notifies attached for each loaded image", () => {
+  const base = makeTemp()
+  const events: string[] = []
+  try {
+    writeFileSync(path.join(base, "ok.png"), "x")
+    const parts = loadImageParts(["ok.png"], (kind, p) => events.push(`${kind}:${p}`))
+    expect(parts.length).toBe(1)
+    expect(events).toEqual(["attached:ok.png"])
+  } finally {
+    rmSync(base, { recursive: true, force: true })
+  }
+})
+```
+
+- [ ] **Step 2: 运行测试确认失败**
+
+Run: `bun test tests/image-parts.test.ts`
+Expected: FAIL — `loadImageParts is not a function`
+
+- [ ] **Step 3: 重构 agent.ts**
+
+替换 `src/agent.ts` 第 74-110 行（`buildUserContent` 整个函数）为：
+
+```ts
+export type ImageNotify = (kind: "attached" | "not_found" | "too_large", imgPath: string, sizeBytes?: number) => void
+
+export function loadImageParts(
+  imagePaths: string[],
+  notify?: ImageNotify,
+): Array<{ type: "image"; image: Buffer; mimeType: string }> {
+  const parts: Array<{ type: "image"; image: Buffer; mimeType: string }> = []
+  for (const imgPath of imagePaths) {
+    const resolved = path.resolve(process.cwd(), imgPath)
+    if (!existsSync(resolved)) {
+      notify?.("not_found", imgPath)
+      continue
+    }
+    const size = statSync(resolved).size
+    if (size > MAX_IMAGE_BYTES) {
+      notify?.("too_large", imgPath, size)
+      continue
+    }
+    const data = readFileSync(resolved)
+    const ext = path.extname(resolved).toLowerCase()
+    const mimeMap: Record<string, string> = {
+      ".png": "image/png",
+      ".jpg": "image/jpeg",
+      ".jpeg": "image/jpeg",
+      ".gif": "image/gif",
+      ".webp": "image/webp",
+    }
+    parts.push({ type: "image", image: data, mimeType: mimeMap[ext] ?? "image/png" })
+    notify?.("attached", imgPath)
+  }
+  return parts
+}
+
+/** Build user message content, optionally with images */
+export async function buildUserContent(message: string, imagePaths?: string[]): Promise<any> {
+  if (!imagePaths || imagePaths.length === 0) return message
+  const images = loadImageParts(imagePaths, (kind, imgPath, sizeBytes) => {
+    if (kind === "not_found") {
+      console.error(`\x1b[33m  Warning: Image not found: ${imgPath}\x1b[0m`)
+    } else if (kind === "too_large") {
+      console.error(
+        `\x1b[33m  Warning: Image skipped (${((sizeBytes ?? 0) / 1024 / 1024).toFixed(1)} MB exceeds ${MAX_IMAGE_BYTES / 1024 / 1024} MB limit): ${imgPath}\x1b[0m`,
+      )
+    } else {
+      console.log(`\x1b[90m  📎 ${imgPath}\x1b[0m`)
+    }
+  })
+  return [{ type: "text", text: message }, ...images]
+}
+```
+
+- [ ] **Step 4: 运行测试确认通过**
+
+Run: `bun test tests/image-parts.test.ts`
+Expected: PASS (5 个用例)
+
+同时运行 `bun test`（确保 buildUserContent 重构没破坏现有用例）。
+
+- [ ] **Step 5: 提交**
+
+```bash
+git add src/agent.ts tests/image-parts.test.ts
+git commit -m "refactor: 提取图片加载函数供 TUI 复用"
+```
+
+---
+
+## Task 8: InputBar.tsx — 输入历史集成
+
+**Files:**
+- Modify: `src/tui/InputBar.tsx`
+
+- [ ] **Step 1: 修改 import 行（第 5 行附近）**
+
+```ts
+import { createHistory, pushInput, browseHistory, resetHistory, type HistoryState } from "./input-history.js"
+```
+
+- [ ] **Step 2: 添加历史状态（第 80 行 `const width = columns || 80` 之后）**
+
+```ts
+  const [historyState, setHistoryState] = useState<HistoryState>(() => createHistory())
+  const historyRef = useRef(historyState)
+```
+
+- [ ] **Step 3: applyEdit 内重置历史（第 87-94 行）**
+
+```ts
+  const applyEdit = useCallback(
+    (edit: (value: string, caretIndex: number) => { value: string; caretIndex: number }) => {
+      const after = edit(editingRef.current.value, editingRef.current.caretIndex)
+      editingRef.current = after
+      setEditing(after)
+      const nextHistory = resetHistory(historyRef.current, after.value)
+      if (nextHistory !== historyRef.current) {
+        historyRef.current = nextHistory
+        setHistoryState(nextHistory)
+      }
+    },
+    [],
+  )
+```
+
+- [ ] **Step 4: 添加提交与浏览函数（applyEdit 之后）**
+
+```ts
+  const submit = (text: string) => {
+    historyRef.current = pushInput(historyRef.current, text)
+    setHistoryState(historyRef.current)
+    onSubmit(text)
+  }
+
+  const browseTo = (direction: 1 | -1) => {
+    const { text, state } = browseHistory(historyRef.current, direction)
+    historyRef.current = state
+    setHistoryState(state)
+    if (text !== editingRef.current.value) {
+      const after = { value: text, caretIndex: Array.from(text).length }
+      editingRef.current = after
+      setEditing(after)
+    }
+  }
+```
+
+- [ ] **Step 5: acceptCommand 改用 submit（第 111 行）**
+
+```ts
+      submit(`/${cmd.name}`)
+```
+
+- [ ] **Step 6: Enter 提交改用 submit（第 166-168 行）**
+
+```ts
+      const text = v.trim()
+      if (text) submit(text)
+      applyEdit(() => ({ value: "", caretIndex: 0 }))
+      return
+```
+
+- [ ] **Step 7: 添加历史导航（Ctrl+J 分支之前，即 menuOpen 块之后）**
+
+```ts
+    // Input history: ↑ older, ↓ newer (only when the slash menu is closed)
+    if (key.upArrow) {
+      browseTo(1)
+      return
+    }
+    if (key.downArrow) {
+      browseTo(-1)
+      return
+    }
+```
+
+- [ ] **Step 8: 验证**
+
+Run: `npx tsc --noEmit` 和 `bun test`
+Expected: 无类型错误，全部测试通过
+
+- [ ] **Step 9: 提交**
+
+```bash
+git add src/tui/InputBar.tsx
+git commit -m "feat: 输入框历史记录导航"
+```
+
+---
+
+## Task 9: tui-chat.ts — 图片注入 + 新斜杠命令 + 成本显示
+
+**Files:**
+- Modify: `src/tui-chat.ts`
+
+本任务涉及同一文件的多处修改，按顺序执行。
+
+- [ ] **Step 1: 修改 import（文件头）**
+
+替换：
+
+```ts
+import { runOnce, runOnceWithSystem, type RunOnceCallbacks } from "./agent.js"
+```
+
+为：
+
+```ts
+import { runOnce, runOnceWithSystem, loadImageParts, type RunOnceCallbacks } from "./agent.js"
+import { getWorkingTreeDiff } from "./tui/diff-view.js"
+import { createUndoStack, pushTurn, popTurn, clearStack, type TurnRecord } from "./tui/undo-stack.js"
+import { getModelPrice, estimateCost, formatCost } from "./pricing.js"
+```
+
+- [ ] **Step 2: TuiOptions 加 images 字段**
+
+```ts
+export interface TuiOptions {
+  modelId?: string
+  resumeSessionId?: string
+  mode: "chat" | "code"
+  images?: string[]
+}
+```
+
+`runTui` 解构处改为 `const { modelId, resumeSessionId, mode, images } = opts`。
+
+- [ ] **Step 3: 添加状态变量（第 45-48 行 messages/sessionId/currentModel/tracker 之后）**
+
+```ts
+  let undoStack = createUndoStack()
+  let lastUserMessage: string | null = null
+```
+
+- [ ] **Step 4: executeAgent 记录回合边界**
+
+在 `executeAgent = async () => {` 开头（第 129 行 `abortController = new AbortController()` 之前）添加：
+
+```ts
+    const turnStart = messages.length
+    const uiStart = tui.messageCount()
+```
+
+在 `executeAgent` 的 `finally` 块（第 208-211 行）改为：
+
+```ts
+    } finally {
+      undoStack = pushTurn(undoStack, turnStart, messages.length, uiStart)
+      abortController = null
+      tui.setRunning(false)
+    }
+```
+
+- [ ] **Step 5: onRunFinish 显示成本**
+
+现有 onRunFinish（第 167-193 行）中 `tui.addMessage` 的 content 改为：
+
+```ts
+            const price = await getModelPrice(currentModel ?? "")
+            const cost = formatCost(estimateCost({ inputTokens: input, outputTokens: output }, price))
+            tui.addMessage({
+              id: `done-${Date.now()}`,
+              role: "system",
+              content: `Done in ${info.stepCount} step(s) | Tokens: ${input} in / ${output} out / ${total} total | Context: ${pct}% | 约 ${cost}`,
+              timestamp: Date.now(),
+            })
+```
+
+（`pct` 行保持原样）
+
+- [ ] **Step 6: onSubmit 记录 lastUserMessage**
+
+`onSubmit` 回调（第 65 行）中，斜杠命令处理之后、`tui.addMessage` 之前添加：
+
+```ts
+        lastUserMessage = text
+```
+
+- [ ] **Step 7: 启动时注入图片（tui.start() 之后、exitPromise 之前）**
+
+在 `tui.start()` 与 `process.on("SIGINT", requestExit)` 之间添加：
+
+```ts
+  if (images && images.length > 0) {
+    const notify = (kind: "attached" | "not_found" | "too_large", imgPath: string, sizeBytes?: number) => {
+      if (kind === "not_found") sysMsg(tui, `⚠ 图片不存在: ${imgPath}`)
+      else if (kind === "too_large") sysMsg(tui, `⚠ 图片超过 ${5} MB 限制: ${imgPath}`)
+      else sysMsg(tui, `📎 ${imgPath}`)
+    }
+    const parts: any[] = [{ type: "text", text: "" }, ...loadImageParts(images, notify)]
+    if (parts.length > 1) {
+      messages.push({ role: "user", content: parts })
+      tui.addMessage({
+        id: `user-${Date.now()}`,
+        role: "user",
+        content: `[📎 图片] ${images.join(", ")}`,
+        timestamp: Date.now(),
+      })
+      await executeAgent()
+    }
+  }
+```
+
+注意：`executeAgent` 在其定义之后调用（tui.start() 在 executeAgent 定义之后执行，顺序安全）。
+
+- [ ] **Step 8: 更新 handleSlashCommand 签名与调用**
+
+调用处（第 67 行）改为：
+
+```ts
+          const result = await handleSlashCommand(
+            text,
+            tui,
+            messages,
+            currentModel,
+            tracker,
+            (model) => {
+              currentModel = model
+              tui.setModel(model)
+            },
+            requestExit,
+            {
+              undoStack,
+              setUndoStack: (s) => { undoStack = s },
+              lastUserMessage,
+              setLastUserMessage: (t) => { lastUserMessage = t },
+              sessionId,
+              setSessionId: (id) => { sessionId = id },
+            },
+          )
+```
+
+签名改为：
+
+```ts
+interface SlashState {
+  undoStack: TurnRecord[]
+  setUndoStack: (s: TurnRecord[]) => void
+  lastUserMessage: string | null
+  setLastUserMessage: (t: string | null) => void
+  sessionId: string | undefined
+  setSessionId: (id: string | undefined) => void
+}
+
+async function handleSlashCommand(
+  input: string,
+  tui: TuiRenderer,
+  messages: ModelMessage[],
+  currentModel: string | undefined,
+  tracker: TokenTracker,
+  setModel: (model: string) => void,
+  requestExit: () => void,
+  state: SlashState,
+): Promise<"run" | void> {
+```
+
+- [ ] **Step 9: 新增斜杠命令 case（在 `case "clear"` 之后添加）**
+
+```ts
+    case "undo": {
+      const popped = popTurn(state.undoStack)
+      if (!popped) {
+        sysMsg(tui, "没有可撤销的内容")
+        break
+      }
+      state.setUndoStack(popped.stack)
+      messages.splice(popped.turn.start, popped.turn.end - popped.turn.start)
+      tui.truncateMessages(popped.turn.uiEnd)
+      sysMsg(tui, "✓ 已撤销 1 轮")
+      break
+    }
+
+    case "redo": {
+      if (!state.lastUserMessage) {
+        sysMsg(tui, "没有可重发的消息")
+        break
+      }
+      const text = state.lastUserMessage
+      tui.addMessage({
+        id: `user-${Date.now()}`,
+        role: "user",
+        content: text,
+        timestamp: Date.now(),
+      })
+      messages.push({ role: "user", content: text })
+      return "run"
+    }
+
+    case "diff": {
+      const result = getWorkingTreeDiff()
+      if (!result.ok) {
+        const msg =
+          result.reason === "not_git" ? "非 git 仓库，无法显示 diff"
+          : result.reason === "no_changes" ? "工作区无未提交变更"
+          : `diff 失败: ${result.message}`
+        sysMsg(tui, msg)
+      } else {
+        sysMsg(tui, result.diff)
+      }
+      break
+    }
+
+    case "sessions": {
+      const { listSessions } = await import("./sessions.js")
+      const sessions = listSessions()
+      if (sessions.length === 0) {
+        sysMsg(tui, "无已保存的会话")
+      } else {
+        const lines = sessions.map((s) => {
+          const current = state.sessionId === s.id ? " ← 当前" : ""
+          return `  ${s.id}  ${s.title} (${s.messageCount} msgs)${current}`
+        })
+        sysMsg(tui, `会话 (${sessions.length}):\n${lines.join("\n")}\n\n恢复: min-agent chat --resume <id>`)
+      }
+      break
+    }
+
+    case "rename": {
+      const title = arg.trim()
+      if (!title) {
+        sysMsg(tui, "用法: /rename <标题>")
+        break
+      }
+      const { saveSession, renameSession } = await import("./sessions.js")
+      let id = state.sessionId
+      if (!id) {
+        id = saveSession(messages)
+        state.setSessionId(id)
+      }
+      if (renameSession(id, title)) {
+        sysMsg(tui, `✓ 会话已重命名为: ${title}`)
+      } else {
+        sysMsg(tui, "重命名失败: 会话不存在")
+      }
+      break
+    }
+
+    case "attach":
+    case "image": {
+      const filePath = arg
+      if (!filePath) {
+        sysMsg(tui, "用法: /attach <图片路径>")
+        break
+      }
+      const notify = (kind: "attached" | "not_found" | "too_large", imgPath: string) => {
+        if (kind === "not_found") sysMsg(tui, `⚠ 图片不存在: ${imgPath}`)
+        else if (kind === "too_large") sysMsg(tui, `⚠ 图片超过 5MB 限制: ${imgPath}`)
+      }
+      const parts: any[] = [{ type: "text", text: "" }, ...loadImageParts([filePath], notify)]
+      if (parts.length <= 1) break
+      messages.push({ role: "user", content: parts })
+      tui.addMessage({
+        id: `user-${Date.now()}`,
+        role: "user",
+        content: `[📎 图片] ${filePath}`,
+        timestamp: Date.now(),
+      })
+      return "run"
+    }
+```
+
+- [ ] **Step 10: `/clear` 清空 undo 栈**
+
+`case "clear"` 内 `tui.update({ messages: [] })` 之后添加：
+
+```ts
+      state.setUndoStack(clearStack(state.undoStack))
+```
+
+- [ ] **Step 11: `/tokens` 加成本行**
+
+`case "tokens"` 的 `sysMsg` 数组改为：
+
+```ts
+        const price = await getModelPrice(currentModel ?? "")
+        const cost = formatCost(
+          estimateCost({ inputTokens: tracker.totalInputTokens, outputTokens: tracker.totalOutputTokens }, price),
+        )
+        sysMsg(tui, [
+          `Context: ${tracker.lastInputTokens} / ${ctxWindow} tokens (${pct}%)`,
+          `Total: ${tracker.totalInputTokens} in / ${tracker.totalOutputTokens} out`,
+          `Cost: 约 ${cost}`,
+          `Messages: ${messages.length}`,
+        ].join("\n"))
+```
+
+- [ ] **Step 12: `/help` 同步（`case "help"` 的命令列表）**
+
+```ts
+        "  /clear        清除对话历史",
+        "  /compact      压缩上下文",
+        "  /model [n]    交互式选择/切换模型",
+        "  /memory [t]   查看/保存记忆",
+        "  /tokens       显示 token 用量与成本",
+        "  /undo         撤销上一轮",
+        "  /redo         重发最后一条消息",
+        "  /diff         显示工作区未提交变更",
+        "  /sessions     列出已保存会话",
+        "  /rename <t>   重命名当前会话",
+        "  /attach <p>   附加本地图片",
+        "  /mcp          显示 MCP 状态",
+        "  /skills       显示可用 skills",
+        "  /path         显示工作目录",
+        "  /paste [t]    粘贴剪贴板图片 + 可选提示",
+        "  /help         显示帮助",
+        "  /exit         退出",
+```
+
+- [ ] **Step 13: 验证**
+
+Run: `npx tsc --noEmit` 和 `bun test`
+Expected: 无类型错误，全部测试通过
+
+- [ ] **Step 14: 提交**
+
+```bash
+git add src/tui-chat.ts
+git commit -m "feat: TUI 图片注入、undo/redo/diff/会话命令与成本显示"
+```
+
+---
+
+## Task 10: cli.ts — chat 分支透传 images
+
+**Files:**
+- Modify: `src/cli.ts:225-227`
+
+- [ ] **Step 1: 修改 chat 分支**
+
+```ts
+      if (!message) {
+        const { runTui } = await import("./tui-chat.js")
+        await runTui({ modelId: modelOverride, resumeSessionId: resumeId, mode: "chat", images })
+      } else {
+```
+
+- [ ] **Step 2: 验证**
+
+Run: `npx tsc --noEmit`
+Expected: 无错误
+
+- [ ] **Step 3: 提交**
+
+```bash
+git add src/cli.ts
+git commit -m "fix: chat -i 无消息时图片不再丢失"
+```
+
+---
+
+## Task 11: slash-commands.ts 菜单同步
+
+**Files:**
+- Modify: `src/tui/slash-commands.ts`
+
+- [ ] **Step 1: 修改 SLASH_COMMANDS**
+
+```ts
+export const SLASH_COMMANDS: SlashCommand[] = [
+  { name: "clear", description: "清除对话历史" },
+  { name: "compact", description: "压缩上下文" },
+  { name: "model", description: "选择/切换模型" },
+  { name: "memory", description: "查看/保存记忆", argHint: "[t]" },
+  { name: "tokens", description: "显示 token 用量与成本" },
+  { name: "undo", description: "撤销上一轮" },
+  { name: "redo", description: "重发最后一条消息" },
+  { name: "diff", description: "显示工作区未提交变更" },
+  { name: "sessions", description: "列出已保存会话" },
+  { name: "rename", description: "重命名当前会话", argHint: "<title>" },
+  { name: "attach", description: "附加本地图片", argHint: "<path>", aliases: ["image"] },
+  { name: "mcp", description: "显示 MCP 状态" },
+  { name: "skills", description: "显示可用 skills" },
+  { name: "path", description: "显示工作目录", aliases: ["pwd"] },
+  { name: "paste", description: "粘贴剪贴板图片", argHint: "[t]" },
+  { name: "help", description: "显示帮助" },
+  { name: "exit", description: "退出", aliases: ["quit", "q"] },
+]
+```
+
+- [ ] **Step 2: 验证**
+
+Run: `npx tsc --noEmit`
+Expected: 无错误
+
+- [ ] **Step 3: 提交**
+
+```bash
+git add src/tui/slash-commands.ts
+git commit -m "feat: 斜杠命令菜单同步新命令"
+```
+
+---
+
+## Task 12: README 同步
+
+**Files:**
+- Modify: `README.md`（Interactive Commands 表格）
+
+- [ ] **Step 1: 更新命令表**
+
+替换 README.md 第 44-57 行的表格：
+
+```markdown
+| Command | Description |
+|---------|-------------|
+| `/clear` | Clear history |
+| `/compact` | Force compaction |
+| `/model [name]` | Interactive model picker (↑↓ navigate, Enter confirm) |
+| `/memory [text]` | List/save memory |
+| `/tokens` | Context usage & cost |
+| `/undo` | Undo last turn |
+| `/redo` | Resend last message |
+| `/diff` | Show working tree diff |
+| `/sessions` | List saved sessions |
+| `/rename <title>` | Rename current session |
+| `/attach <path>` | Attach a local image |
+| `/paste [text]` | Clipboard image |
+| `/mcp` | MCP server status |
+| `/skills` | Available skills |
+| `/models` | List available models |
+| `/path` | Working directory |
+| `/help` | All commands |
+| `/exit` | Exit |
+```
+
+- [ ] **Step 2: 提交**
+
+```bash
+git add README.md
+git commit -m "docs: README 交互命令同步"
+```
+
+---
+
+## Task 13: 全量验证
+
+- [ ] **Step 1: 类型检查**
+
+Run: `npx tsc --noEmit`
+Expected: 无错误
+
+- [ ] **Step 2: 全量测试**
+
+Run: `bun test`
+Expected: 全部通过（含新增 4 个测试文件）
+
+- [ ] **Step 3: 手动冒烟**
+
+Run: `bun run src/cli.ts chat -i tests/fixtures/missing.png "测试"`（不存在的图片应警告并继续）
+
+手动验证清单（交互模式 `bun run src/cli.ts chat`）：
+1. ↑/↓ 浏览历史输入，Esc 恢复草稿
+2. `/undo` 撤销上一轮；连续 `/undo`；空栈提示
+3. `/redo` 重发最后消息
+4. `/diff` 在 git 仓库显示变更
+5. `/attach <png>` 附加图片并触发分析
+6. `/rename 新标题` 后 `/sessions` 显示新标题
+7. `/tokens` 显示成本行；完成消息带成本
+8. `/help` 菜单包含全部新命令
+
+- [ ] **Step 4: 提交（如有遗留改动）**
+
+```bash
+git add -A
+git commit -m "chore: 第一批验证收尾"
+```
+
+---
+
+## 自审记录
+
+**Spec 覆盖：**
+- 缺陷 1（图片丢弃）→ Task 7、9、10
+- 缺陷 2（README/help 同步）→ Task 11、12
+- 输入历史 → Task 1、8
+- /undo → Task 2、5、9（Step 9）
+- 成本估算 → Task 4、9（Step 5、11）
+- /diff → Task 3、9
+- /redo → Task 9
+- /sessions + /rename → Task 6、9
+
+**类型一致性：** `TurnRecord` 三字段（start/end/uiEnd）在 Task 2 定义，Task 5 的 truncateMessages 与 Task 9 的 undo 逻辑均一致使用；`SlashState` 接口在 Task 9 定义并用于签名与调用处。