40 lines
1.7 KiB
Markdown
40 lines
1.7 KiB
Markdown
# os-init
|
|
|
|
Post-install initialization scripts, one directory per operating system.
|
|
|
|
| Directory | Target | Script |
|
|
|-----------|--------|--------|
|
|
| `debian/` | Debian 13 (GNOME desktop) | `debian13-init.sh` |
|
|
| `macos/` | macOS | `macos-init.sh` |
|
|
|
|
## Conventions
|
|
|
|
- Each OS directory is self-contained: a single script, run directly on the
|
|
target machine, plus its own `AGENTS.md` for OS-specific rules.
|
|
- Scripts must be idempotent (safe to run repeatedly) and must not change
|
|
security-sensitive settings without an explicit opt-in.
|
|
- Add a new OS by creating `<os>/` with `<os><version>-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).
|