输入处理系统深度分析

┌─────────────────────────────────────────────────────────────┐
│                     Ink 终端输入流                            │
│              (stdin → input-event.ts → useInput)             │
├────────────────────────┬────────────────────────────────────┤
│   Keybinding System    │         Vim Mode                   │
│   18 上下文 + 和弦支持   │   可切换的 NORMAL/INSERT 模式       │
│   配置驱动 (JSON)       │   纯函数状态机                     │
│   热重载 (chokidar)    │   Cursor 对象操作                  │
├────────────────────────┴────────────────────────────────────┤
│              React 组件层 (useKeybinding / useInput)         │
└─────────────────────────────────────────────────────────────┘

Global         → 全局生效，无论焦点
Chat           → 聊天输入框聚焦时
Autocomplete   → 自动补全菜单可见时
Confirmation   → 确认/权限对话框显示时
Help           → 帮助覆盖层打开时
Transcript     → 查看对话记录时
HistorySearch  → 搜索命令历史时（ctrl+r）
Task           → 前台任务运行时
ThemePicker    → 主题选择器打开时
Settings       → 设置菜单打开时
Tabs           → Tab 导航激活时
Attachments    → 图片附件选择时
Footer         → 底部指示器聚焦时
MessageSelector→ 消息选择器（回滚）打开时
DiffDialog     → Diff 对话框打开时
ModelPicker    → 模型选择器打开时
Select         → 选择/列表组件聚焦时
Plugin         → 插件对话框打开时

                    ┌──────────────┐
         初始状态    │   无待定键    │
                    └──────┬───────┘
                           │
              按下 "ctrl+k" │ (有更长的和弦前缀匹配)
                           ▼
                    ┌──────────────┐
                    │ chord_started│ ← pending = [ctrl+k]
                    │   等待第二键  │    启动 1s 超时
                    └──────┬───────┘
                           │
            ┌──────────────┼──────────────┐
            │              │              │
     按下 "ctrl+s"   按下 Escape    按下其他键 / 超时
            │              │              │
            ▼              ▼              ▼
     ┌──────────┐  ┌────────────┐  ┌──────────────┐
     │  match   │  │ chord_     │  │ chord_       │
     │ action=X │  │ cancelled  │  │ cancelled    │
     └──────────┘  └────────────┘  └──────────────┘

~/.claude/keybindings.json 修改
         │
    chokidar 检测 (稳定性阈值 500ms, 轮询间隔 200ms)
         │
    handleChange() 被调用
         │
    loadKeybindings() 异步重新加载
         │
    更新 cachedBindings + cachedWarnings
         │
    keybindingsChanged.emit(result)
         │
    subscribeToKeybindingChanges 回调触发
         │
    KeybindingSetup.setState({ bindings, warnings })
         │
    通知用户 (如果验证有警告)

useInput (Ink)
    │
    ├── ChordInterceptor (最先注册，拦截和弦)
    │       │
    │       ├── resolveKeyWithChordState()
    │       │       │
    │       │       ├── chord_started → setPendingChord, stopPropagation
    │       │       ├── match (in chord) → invoke handler, stopPropagation
    │       │       ├── chord_cancelled → setPendingChord(null)
    │       │       ├── unbound → setPendingChord(null), stopPropagation
    │       │       └── none → (不处理，继续传播)
    │       │
    │       └── handlerRegistry (Map<action, Set<HandlerRegistration>>)
    │
    ├── useKeybinding('app:toggleTodos', handler)
    │       │
    │       ├── 注册 handler 到 registry
    │       ├── 构建上下文列表
    │       ├── 调用 resolve()
    │       └── 匹配则调用 handler + stopImmediatePropagation
    │
    └── 其他 useInput 处理器 (Vim 模式等)

                    ┌──────────────────────────────┐
                    │         idle                  │
                    │    (等待第一个按键)            │
                    └───────┬──────────────────────┘
                            │
        ┌───────────────────┼───────────────────────┐
        │                   │                       │
   [1-9] 输入          [d/c/y]                [f/F/t/T]
        │                   │                       │
        ▼                   ▼                       ▼
 ┌─────────────┐   ┌──────────────┐   ┌─────────────────┐
 │   count     │   │  operator    │   │     find        │
 │ {digits:"3"}│   │ {op:'delete'}│   │ {find:'f',cnt:1}│
 └──────┬──────┘   └──────┬───────┘   └─────────────────┘
        │                  │
   非数字键            ┌────┼──────┬──────────┐
        │              │    │      │          │
        ▼         [motion] [i/a] [f/F/t/T]  [0-9]
   继续 normal   ┌──────┘   │      │          │
   输入处理      │    ┌─────┘      │          │
                 │    │    ┌───────┘          │
                 │    │    │    ┌─────────────┘
                 ▼    ▼    ▼    ▼
              执行  operator  operator  operator
              操作  TextObj   Find      Count

fromIdle        → count / operator / find / g / replace / indent / 直接执行
fromCount       → 继续累积数字 / 执行 normal 输入
fromOperator    → dd/cc/yy（行操作）/ motion / textObj / find / operatorCount
fromOperatorCount → 继续累积 / 执行带 count 的操作
fromOperatorFind  → 执行 find-based 操作
fromOperatorTextObj → 执行文本对象操作
fromFind        → 执行字符查找
fromG           → gj/gk/gg
fromOperatorG   → 操作符 + gj/gk/gg
fromReplace     → 执行替换
fromIndent      → 执行缩进

useInput 事件流
    │
    ├── ChordInterceptor (最快) ── 拦截和弦序列
    │
    ├── useKeybinding 处理器 ──── 解析上下文绑定
    │
    └── Vim 模式处理器 ────────── 仅在 NORMAL/INSERT 模式时处理
            │
            ├── INSERT: 字符直接插入（或记录到 insertedText）
            ├── NORMAL: transition() 状态机处理
            └── Escape: 在 NORMAL 模式中不被快捷键系统处理
                        （Chat 上下文的 escape → chat:cancel 仅在非 vim 时生效）

用户按键 → Ink stdin → input-event.ts → useInput
  → ChordInterceptor.handleInput()
    → resolveKeyWithChordState(input, key, contexts, bindings, pending)
      → buildKeystroke(input, key)          // resolver.ts:82
      → chordPrefixMatches()                 // resolver.ts:123 (前缀检测)
      → chordExactlyMatches()                // resolver.ts:140 (精确匹配)
      → keystrokesEqual()                    // resolver.ts:107 (alt/meta 合并)
      → { type: 'chord_started'|'match'|... }
  → setPendingChord() / invoke handler / stopImmediatePropagation()

用户按键 → useInput → vim handler
  → transition(state, input, ctx)            // transitions.ts:59
    → fromXxx(state, input, ctx)             // 各状态处理函数
      → resolveMotion(key, cursor, count)    // motions.ts:13
      → executeOperatorMotion(op, motion, count, ctx)  // operators.ts:42
        → getOperatorRange()                 // operators.ts:429
        → applyOperator()                    // operators.ts:493
          → ctx.setText() / ctx.setOffset() / ctx.setRegister()
        → ctx.recordChange()                 // dot-repeat 记录

启动 → KeybindingSetup.useState(initializer)
  → loadKeybindingsSyncWithWarnings()        // loadUserBindings.ts:259
    → readFileSync(~/.claude/keybindings.json)
    → parseBindings(blocks)                  // parser.ts:191
    → [...defaultBindings, ...userParsed]    // last wins
    → validateBindings()                     // validate.ts:425
  → initializeKeybindingWatcher()            // chokidar
  → subscribeToKeybindingChanges(callback)
    → file change → loadKeybindings() → emit → setState()