输入框 PromptInput.tsx（2650 行）本身不处理按键——它是"编排层"，负责拼装模式/建议/粘贴/历史/渲染。真正逐键编辑在 useTextInput（src/hooks/useTextInput.ts）。分层：

底层编辑用不可变的 Cursor 对象（src/utils/Cursor.ts）。每次按键产出一个新 Cursor，而不是改旧的。看真实代码里的用法（useTextInput.ts:203）：

const newCursor = cursor.insert(text)   // 插入 → 返回新 Cursor（不改旧的）
// 删除、移动光标、删词……每个操作都返回新 Cursor

输入框最微妙的判断：按回车是"换行"还是"提交"？真实代码 handleEnter（useTextInput.ts:248）：

function handleEnter(key: Key) {
  // ① 反斜杠 + Enter → 换行（删掉反斜杠）
  if (multiline && cursor.offset > 0 && cursor.text[cursor.offset - 1] === '\\') {
    markBackslashReturnUsed()
    return cursor.backspace().insert('\n')
  }
  // ② Meta(Option)+Enter 或 Shift+Enter → 换行
  if (key.meta || key.shift) {
    return cursor.insert('\n')
  }
  // ③ Apple Terminal 不支持自定义 Shift+Enter，用原生 macOS 修饰键检测
  if (env.terminal === 'Apple_Terminal' && isModifierPressed('shift')) {
    return cursor.insert('\n')
  }
  // ④ 普通 Enter → 提交
  onSubmit?.(originalValue)
}

由 useTypeahead（PromptInput.tsx:1281）驱动。输入变化时判断触发字符：

• / 开头 → 斜杠命令补全（Day 11 的命令列表）。
• @ → 文件/agent 补全。
• # → slack 频道等。

接受方式：Tab/→ 接受、↑↓ 选择、Esc 关闭。护栏：有建议显示时，普通 Enter 不提交（而是接受当前建议）。

往终端粘贴（尤其大段文本/图片）要特殊处理，分三层：

1. 检测层 usePasteHandler：靠按键事件的 isPasted 标志（括号粘贴模式）判定，分块累积 + 100ms 超时合并；拖入的图片路径 → 读图。
2. 业务层 onTextPaste（PromptInput.tsx:1374）：清理 ANSI、\r→\n；超过阈值就不塞全文，而是存进 pastedContents、只在输入框插一个占位引用。
3. 截断层 inputPaste.ts：>10000 字保留首尾各 500 字、中间折叠。

键位系统核心在 @anthropic/ink，仓库侧 src/keybindings/ 多为再导出。默认绑定表 defaultBindings.ts:32 按上下文分组：

• Ctrl+O → 切 transcript 视图；Ctrl+R → 历史搜索；Shift+Tab → 切权限模式（Day 09）。
• 用户可用 ~/.claude/keybindings.json 覆盖默认。
• Ctrl+C/Ctrl+D 登记但不可重绑（走时间敏感的双击处理）。

vim 模式（src/vim/ + useVimInput.ts）：完整实现了 NORMAL/INSERT 模式、移动（motions）、操作符（d/c/y）、文本对象（iw/ap）、. 重复上次修改（dot-repeat）。NORMAL 模式把按键交给状态机 transition。

权限卡、模型选择、成本确认……这些浮层怎么管？不是"组件栈"，而是"队列 + 一个优先级仲裁函数"。核心是 getFocusedInputDialog()（REPL.tsx:2414）——按固定优先级返回"当前唯一活跃"的对话框：退出态最高 → message-selector → 用户正在打字时（1500ms 内）抑制打断式弹窗 → 各类权限/对话框。

✋ 动手：对着真实代码读一遍

# 1. 换行 vs 提交（L03，本页精华）
sed -n '248,268p' src/hooks/useTextInput.ts

# 2. Cursor 不可变编辑（L02）
grep -n "cursor.insert\|cursor.backspace\|newCursor" src/hooks/useTextInput.ts | head

# 3. 键位默认表 + vim（L06）
sed -n '32,60p' src/keybindings/defaultBindings.ts

# 4. 对话框优先级仲裁（L07）
sed -n '2414,2470p' src/screens/REPL.tsx | head -50

# 5. 实操：贴一大段文本看占位、开 vim、Shift+Tab 切权限
bun run dev