From a93e255fc1d197796b19e8e9668aeab23090ab53 Mon Sep 17 00:00:00 2001 From: Guofang Date: Wed, 4 Nov 2026 23:24:40 +0800 Subject: [PATCH] Document Wubi Shift-commit behavior as a known issue Co-Authored-By: Claude Sonnet 5.5 --- README.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/README.md b/README.md index 9093d02..ba8a137 100644 --- a/README.md +++ b/README.md @@ -15,3 +15,25 @@ Post-install initialization scripts, one directory per operating system. security-sensitive settings without an explicit opt-in. - Add a new OS by creating `/` with `-init.sh` and adding a row to the table above. + +## Known Issues + +### macOS: Wubi commits the candidate when switching to English + +While composing with the built-in Wubi input method (`com.apple.inputmethod.SCIM.WBX`), +for example typing `wq` with the candidate `你` showing, pressing Shift to +switch to English commits `你` instead of the raw letters `wq`. + +- Status: open. There is no system setting for it, and the state lives in the + input method's sandbox container, so `macos-init.sh` cannot configure it. +- Workarounds: press Esc to cancel the composition before switching; press + Return (not verified); or switch to the ABC keyboard (Caps Lock or + Ctrl+Space) before typing. +- Possible fix: use Squirrel (Rime) with `ascii_composer/switch_key: Shift_L: + commit_code` in `default.custom.yaml`. It must be installed manually, as the + repository forbids `curl | sh`. +- Expected behavior: Shift during composition should commit the raw letters + and then switch to English; only Space, a number key, or Return should + confirm a candidate. +- Upstream: the input method is built into macOS and maintained by Apple. Report + it through Feedback Assistant (macOS > Input Methods).