web-terminal/public/shortcuts.ts

/**
 * public/shortcuts.ts — Claude Code keyboard cheat-sheet (⌨ toolbar button).
 *
 * Opens an overlay listing the common Claude Code shortcuts grouped by purpose,
 * each labeled with what it does. Keys also present on the bottom touch key bar
 * are tagged "键栏". Source: official Claude Code interactive-mode docs.
 */

interface Shortcut {
  keys: string
  desc: string
  onBar?: boolean // also available on the bottom key bar
}

interface ShortcutGroup {
  title: string
  items: Shortcut[]
}

const GROUPS: ShortcutGroup[] = [
  {
    title: '常用 General',
    items: [
      { keys: 'Esc', desc: '打断 Claude / 关闭弹窗', onBar: true },
      { keys: 'Esc Esc', desc: '有输入→清空存草稿;空→打开回溯菜单', onBar: true },
      { keys: 'Ctrl+C', desc: '中断运行;无运行时清空,再按退出', onBar: true },
      { keys: 'Ctrl+D', desc: '退出会话 (EOF)', onBar: true },
      { keys: 'Shift+Tab', desc: '循环权限模式 (default/acceptEdits/plan…)', onBar: true },
      { keys: 'Ctrl+R', desc: '反向搜索命令历史', onBar: true },
      { keys: 'Ctrl+O', desc: '切换 transcript(详细工具调用)视图', onBar: true },
      { keys: 'Ctrl+L', desc: '重绘屏幕(显示错乱时救场)', onBar: true },
      { keys: 'Ctrl+T', desc: '切换任务列表', onBar: true },
      { keys: 'Ctrl+B', desc: '把命令/agent 转到后台(tmux 按两次)', onBar: true },
      { keys: '↑ / ↓', desc: '移动光标 / 翻命令历史', onBar: true },
      { keys: 'Tab', desc: '补全建议 / 接受提示', onBar: true },
      { keys: '/', desc: '命令与 skill 启动器', onBar: true },
    ],
  },
  {
    title: '行内编辑 Editing',
    items: [
      { keys: 'Ctrl+A', desc: '光标到行首' },
      { keys: 'Ctrl+E', desc: '光标到行尾' },
      { keys: 'Ctrl+K', desc: '删除到行尾' },
      { keys: 'Ctrl+U', desc: '删除到行首' },
      { keys: 'Ctrl+W', desc: '删除前一个词' },
      { keys: 'Ctrl+Y', desc: '粘回被删除的内容' },
      { keys: 'Alt+B / Alt+F', desc: '按词左移 / 右移' },
    ],
  },
  {
    title: '多行输入 Multiline',
    items: [
      { keys: '\\ + Enter', desc: '换行(任何终端都行)' },
      { keys: 'Shift+Enter', desc: '换行(iTerm2/WezTerm/Kitty… 原生)' },
      { keys: 'Ctrl+J', desc: '换行(无需配置,任何终端)' },
    ],
  },
  {
    title: 'macOS(需 Option 当 Meta)',
    items: [
      { keys: 'Option+P', desc: '切换模型' },
      { keys: 'Option+T', desc: '开关 extended thinking' },
      { keys: 'Option+O', desc: '开关 fast mode' },
    ],
  },
  {
    title: '前缀 Prefixes',
    items: [
      { keys: '! 开头', desc: 'shell 模式,直接跑命令并入上下文' },
      { keys: '@', desc: '文件路径补全' },
    ],
  },
]

export function mountShortcuts(toolbar: HTMLElement): void {
  const overlay = document.createElement('div')
  overlay.id = 'shortcutsmodal'
  overlay.style.display = 'none'
  const card = document.createElement('div')
  card.className = 'sc-card'
  overlay.appendChild(card)
  document.body.appendChild(overlay)

  const hide = (): void => {
    overlay.style.display = 'none'
  }
  overlay.addEventListener('click', (e) => {
    if (e.target === overlay) hide()
  })
  document.addEventListener('keydown', (e) => {
    if (e.key === 'Escape' && overlay.style.display !== 'none') hide()
  })

  const build = (): void => {
    card.replaceChildren()
    const title = document.createElement('div')
    title.className = 'sc-title'
    title.textContent = 'Claude Code 快捷键'
    card.appendChild(title)

    for (const group of GROUPS) {
      const gh = document.createElement('div')
      gh.className = 'sc-group'
      gh.textContent = group.title
      card.appendChild(gh)

      for (const sc of group.items) {
        const row = document.createElement('div')
        row.className = 'sc-row'

        const key = document.createElement('span')
        key.className = 'sc-key'
        key.textContent = sc.keys

        const desc = document.createElement('span')
        desc.className = 'sc-desc'
        desc.textContent = sc.desc

        row.append(key, desc)
        if (sc.onBar) {
          const tag = document.createElement('span')
          tag.className = 'sc-tag'
          tag.textContent = '键栏'
          row.appendChild(tag)
        }
        card.appendChild(row)
      }
    }
  }
  build()

  const toggle = document.createElement('button')
  toggle.className = 'toolbtn'
  toggle.textContent = '⌨'
  toggle.title = 'Claude Code 快捷键速查'
  toggle.setAttribute('aria-label', 'Keyboard shortcuts')
  toggle.addEventListener('click', () => {
    overlay.style.display = overlay.style.display === 'none' ? 'flex' : 'none'
  })
  toolbar.appendChild(toggle)
}