Skip to content

feat(tui): 在席でも没入と同じ Ctrl-O リーダー文法を効かせる#421

Merged
kkyosuke merged 2 commits into
mainfrom
usagi/command
Jun 27, 2026
Merged

feat(tui): 在席でも没入と同じ Ctrl-O リーダー文法を効かせる#421
kkyosuke merged 2 commits into
mainfrom
usagi/command

Conversation

@kkyosuke

Copy link
Copy Markdown
Owner

目的

在席(Focus)の Ctrl-O は単独で即・切替へ戻る一方、没入(Attached)では Ctrl-O o というリーダー文法だったため、いる場所によって「切替へ戻る」キーが食い違う(在席=Ctrl-O/没入=Ctrl-O o)混乱があった。在席でも没入と同じ prefix 文法を効かせ、Ctrl-O o のマッスルメモリが両モードで通るよう統一する。

変更内容

既定の prefix 方式のとき、在席の Ctrl-O を没入と同じリーダーにし、次キーで操作する:

操作 在席(変更後)
切替へ Ctrl-O oCtrl-O Ctrl-O も)/Esc(1キー離脱は維持)
タブ前後 Ctrl-O n/pCtrl-O →/←(直キー Ctrl-N/P も併用可)
agent 起動 Ctrl-O g
メモ/サイドバー/終了確認 Ctrl-O e / Ctrl-O s / Ctrl-O qCtrl-E 直キーも)
直前セッション Ctrl-^Ctrl-O Ctrl-^ も)
  • 在席はシェルを持たないためタイムアウトは不要(次キーが必ずリーダーを解決)。
  • alt 方式では没入が Ctrl-O をリーダーにしないのに合わせ、在席の Ctrl-O従来どおり単打で切替へ戻す(非リグレッション)。
  • モード間で leader が漏れないよう enter_switch / enter_focus_surface / leave_attachedprefix_pending をクリア。
  • 在席フッターとチートシートをスキーム対応に。

主な差分

  • src/presentation/tui/home/event/handlers.rsfocus_key のリーダー化と focus_prefix_action 新設
  • src/presentation/tui/home/state/mod.rs — モード遷移での prefix_pending クリア
  • src/presentation/tui/home/ui/chrome.rs / content.rs — フッター・チートシートのスキーム対応
  • document/design/05-home.md / document/00-tutorial.md — キー操作の記述を更新

テスト・確認方法

  • cargo fmt / cargo clippy --all-targets -- -D warnings
  • cargo test 全パス ✅(在席の Ctrl-O o/二段リーダー/g/s/e/q/タブ巡回(文字・矢印)/前セッション/未知キーの swallow/alt 方式の直キー維持/フッター・チートシートのスキーム分岐をカバー)
  • カバレッジ functions 100% / lines 100%

🤖 Generated with Claude Code

在席(Focus)の Ctrl-O は単独で即・切替へ戻る一方、没入(Attached)では
Ctrl-O o というリーダー文法だったため、場所によってキー操作が食い違って
いた。prefix 方式のとき在席の Ctrl-O もリーダー化し、没入と同じ次キー
(o/n/p/g/e/s/q・→/←、Ctrl-O Ctrl-O、Ctrl-O Ctrl-^)で操作できるよう統一。
Esc は引き続き切替への 1 キー離脱として残す。alt 方式では没入が Ctrl-O を
リーダーにしないのに合わせ、在席の Ctrl-O は従来どおり単打で切替へ戻す。

在席はシェルを持たないためタイムアウトは不要(次キーが必ずリーダーを解決)。
モード間で leader が漏れないよう enter_switch / enter_focus_surface /
leave_attached で prefix_pending をクリアする。フッターとチートシートも
スキーム対応にし、design/05-home.md・00-tutorial.md を更新。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

📊 Test Coverage

🚀 いまのカバレッジ (Lines): 100.00% — この調子でいこう!

🎉✨ パーフェクト!全ファイル Lines カバレッジ 100% を達成しました 🏆🐰

@kkyosuke kkyosuke merged commit b7ea549 into main Jun 27, 2026
4 checks passed
@kkyosuke kkyosuke deleted the usagi/command branch June 27, 2026 09:36
kkyosuke added a commit that referenced this pull request Jun 27, 2026
## 目的

没入(Attached)モードで日本語 IME を ON にしたまま「切替」へ抜けられるようにする。

`Ctrl-O o` のリーダー文法は、2 段目の `o` がただの英字のため、IME 変換モードでは IME
がローマ字変換(「お」)に横取りしてしまい usagi に届かない。結果として **IME ON のまま `Ctrl-O o`
を押しても切替に行けなかった**。

## 変更内容

- 没入の `classify()` で、二重リーダー `Ctrl-O Ctrl-O` を `Ctrl-O o` と同じ
**切替へのズームアウト**(`Reserved::Detach`)に割り当て。`Ctrl-O`(`0x0f`)は制御文字なので IME
を素通しし、2 打とも制御文字 → IME 安全な経路になる。
- 在席(Focus)は #421 で既にこの挙動だったため、没入もそれに揃えて統一。
- 没入チートシートの行を「Send a literal Ctrl-O to the shell」→「Zoom out to Switch
(IME-safe second key)」に更新。
- 関連ドキュメント(`document/design/05-home.md` / `00-tutorial.md` /
`03-commands/02-tui.md`)を実態に合わせて更新。

### トレードオフ

従来 `Ctrl-O Ctrl-O` が担っていた「リテラル `Ctrl-O` をシェルへ送る」機能(readline の
operate-and-get-next 用。ほぼ未使用)は `prefix` 方式では使えなくなる。bare な `Ctrl-O`
をシェルへ送りたい場合は `alt` 方式(bare Ctrl-O がそのままシェルへ流れる)を使う旨を、コメントとドキュメントに明記した。

## テスト・確認方法

- `cargo fmt` / `cargo clippy --all-targets -- -D warnings` / `cargo
test` をパス(カバレッジ 100% 維持)。
- `pane_input.rs`
の単体テストを更新(`prefix_double_leader_zooms_to_switch_and_unknown_second_key_is_swallowed`):`Ctrl-O
Ctrl-O` の両報告形式(`'o'`+CONTROL / 生 `0x0f`)が `Reserved::Detach` になることを検証。
- 在席側の `focus_ctrl_o_double_leader_also_opens_switch` は従来どおりパス。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: test <test@example.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant