這是你鼠鬚管的設定速查。主方案是洋蔥注音 plus 版（大千式鍵盤）。英文字典、全形、注音文、emoji 和顏文字，都能在注音裡先按啟始鍵直接打，不用切換方案。用不到的日語、韓語、拉丁音標、希臘字母、俄文和倉頡已經關掉。最後一段列了幾件要注意的事。
先記住這三件事，細節往下看。
大千式鍵盤上，3、4、6、7 是聲調鍵，不會出現在注音開頭，洋蔥就拿它們當啟始鍵；`、=、[、]、' 這幾個不是注音的鍵也一樣。你用不到的 4、6、7 和 = 已經關掉，在字首按會直接輸出那個字元。
| 啟始鍵 | 叫出什麼 | 字尾加的後綴 | 例子 |
|---|---|---|---|
| 3 | 英漢字典：88 萬單字和片語，選單附中文解釋 | ; 首字母大寫、;; 全大寫；片語裡的空格打 ./ |
3terra → terra 開頭的單字；3terra; → Terra |
| ][ | 英數全形，編碼跟拉丁字母相同 | / 小寫、; 大寫；也能打全形數字 |
./ → 全形空格 |
| ` | 系列符號與 emoji | 只打 ` 會列出各類符號的說明，再輸入項目名稱每個字的第一個注音 |
打 ` 看說明；``1～``- 是顏文字，見第 05 段 |
| '; | 注音文：一般和特殊注音符號 | 接著打注音按鍵 | 打不出來的特殊注音符號從這裡找 |
| '/ | 特殊功能集：日期時間、計算機、Unicode 內碼、說明頁 | 只打 '/ 會列出完整功能選單 |
'/f → 年月日；'/t → 時:分:秒；'/kk → 快捷鍵說明 |
3 和 '/，其他啟始鍵開的段落都能打 ' 結束，再接著打注音。ㄏㄠˇ 之後再按 3 就進英漢字典；只打 ㄏㄠ 再按 3，只會打出三聲 ㄏㄠˇ。啟始鍵是在 bopomo_onionplus.custom.yaml 關掉的，一個鍵一行，例如 "recognizer2/patterns/japan": null 就是日語的 6。刪掉那一行再重新部署，那個啟始鍵就回來了。對照：european 4 拉丁、japan 6 日語、cyr2 66 俄文、korea 7 韓語、gr2 77 希臘、reverse2_lookup = 倉頡反查。
方案選單裡的項目是在 default.custom.yaml 的 schema_list 註解掉的，把行首的 # 拿掉就會回到選單。
隨時都能按，不用在打字中。下列按鍵都從部署後的設定（build/）核對過。
中英切換有三種按法，挑順手的用。
不加 Shift 是「切過去」，加 Shift 是「切回預設」，不會按錯方向。
括號裡是部署後的預設狀態。
切到注音時的初始狀態。
| 開關 | 預設 |
|---|---|
| 中／英 | 英文你的設定 |
| 字符範圍 | 精簡 |
| 附加 emoji | 開 |
| 外語與符號註釋 | 開 |
| Unicode 編碼註釋 | 關 |
| 英漢字典排序 | 依字數（「個排」） |
正在打注音、或候選選單開著的時候才有作用。數字鍵在大千式鍵盤上是注音，所以選字改用 Shift 加字母。
| 第幾個候選 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 |
|---|---|---|---|---|---|---|---|---|
| 左手 Shift 加 | Q | A | Z | W | S | X | E | D |
| 右手 Shift 加 | Y | H | N | U | J | M | I | K |
| 選單上的標籤 | ⒈𝚀𝚈 | ⒉𝙰𝙷 | ⒊𝚉𝙽 | ⒋𝚆𝚄 | ⒌𝚂𝙹 | ⒍𝚇𝙼 | ⒎𝙴𝙸 | ⒏𝙳𝙺 |
翻頁只在選單開著時有效。
Shift 加字母的鍵都是洋蔥 plus 版加的，打字中才有效。
default.custom.yaml 另外定義了一組 Emacs 式按鍵，打字中可用：Control+P／N 上下、Control+B／F 左右、Control+A／E 到開頭／結尾、Control+D 刪後一個、Control+H 退格、Control+G 取消、Control+V／Alt+V 下一頁／上一頁。
洋蔥 plus 版另外還有：Shift+P 退格、Shift+T 刪後一個、Shift+V／B 到開頭／結尾、Shift+R 輸出選項的註釋、Shift+L 等同空白鍵。
洋蔥本來就有顏文字：先按兩下 `，再按分類鍵，選單就會列出那一類的顏文字，選字方式跟平常一樣。另外加了一份詞表：打出「開心」這類詞時，選單也會直接附上顏文字。
| 按鍵 | 分類 | 選單裡的前幾個 |
|---|---|---|
| ``1 | 開心 | ^_^ ^ω^ *^_^* |
| ``2 | 喜歡 | QwQ 罒ω罒 (*/ω＼*) |
| ``3 | 傷心 | T_T (＞﹏＜) 〒▽〒 |
| ``4 | 生氣 | >o< (*￣︿￣) (;｀O´)o |
| ``5 | 驚訝 | ⊙_⊙ ⊙▽⊙ (๑ŐдŐ)b |
| ``6 | 無奈 | =_= @_@ (ー_ー)!! |
| ``7 | 喜 | (*＾ー＾) (^-^*) (^u^) |
| ``8 | 樂 | (^ρ^)/ ヽ(^o^)丿 (✪ω✪) |
| ``9 | 怒 | (#`Д´)ﾉ 凸(= _=)凸 (눈‸눈) |
| ``0 | 指示和圖示 | (´∀`σ)σ (´･_･`) |
| ``- | 回話 | σ(*´∀`*) σ(Д･`) |
symbols_bpmf.dict.yaml 的「顏文字」段，是洋蔥的檔，更新洋蔥時會被換掉，所以別直接改它。打出下面這些詞時，選單會在 emoji 後面接著列出幾個顏文字（下方樣張裡的橘色字）。跟 emoji 共用開關，Ctrl+Shift+7 會一起開關。
opencc/my_kaomoji.txt，更新洋蔥不會被蓋掉。每行是「詞、Tab、詞本身、空格、顏文字…」；第一個值一定要是詞本身，顏文字裡的空格要用不換行空格。改完重新部署。3okay 這種較長的英文字都不會。換個角度看同一個資料夾：哪些是你的、哪些是洋蔥的、哪些是鼠鬚管自己產生的。要改設定只動「你的」那一欄。
改設定只動這裡
default.custom.yaml：方案清單、快捷鍵、Shift 和 Caps Lock 的行為，從洋蔥的版本改來bopomo_onionplus.custom.yaml：切到注音時預設英文模式、關掉 6 組用不到的啟始鍵、打詞附顏文字opencc/my_kaomoji.txt：打詞附顏文字的詞表update-onion.sh：更新洋蔥用的腳本，每月 1 號自動執行，會跳過這一欄的檔backup-rime.sh：每週日備份這一欄的檔和選字記錄到 Google DriveCLAUDE.md：給 Claude 看的說明docs/rime-cheatsheet.html：這份速查用 update-onion.sh 更新時會被換成新版
*.schema.yaml、*.dict.yaml：方案和詞庫element_bopomo.yaml、punct_bopomo.yaml：共用按鍵與標點rime.lua、lua/：Lua 寫的各種功能opencc/：註釋與轉換用的對照表*_phrase.txt：自訂詞，目前跟上游一樣；更新腳本不會覆蓋本機已有的custom檔_日語jpnin1精簡/：日語變體範本，日語關掉後用不到交給鼠鬚管管理
build/：部署後的編譯結果，想知道設定實際長怎樣就看這裡*.userdb/：你的詞頻記錄trash/：被淘汰的檔案，裡面是洋蔥附的舊版倉頡installation.yaml、user.yaml：安裝與部署資訊.onion-backup/、.onion-upstream/：更新腳本留下的舊檔備份和上游原版default.custom.yaml 跟洋蔥原版只差這兩段schema_list:- - schema: hangeul_hnc / jpnin1 / latinin1- - schema: greek / cyrillic / cangjie5+ # 六個都註解掉 ← 方案選單剩 8 個 ascii_composer/switch_key:- Shift_L: noop+ Shift_L: inline_ascii ← 左 Shift 變成臨時英文- Caps_Lock: commit_text+ Caps_Lock: noop ← Caps Lock 不再切換中英
右 Shift 和左 Control 兩邊的寫法不同，但效果一樣，都是不做事。
由重到輕排列。第一件有遇到再處理，其他知道就好。
洋蔥原版設成 commit_text，註解特別提醒這裡不能拿掉，否則開著大寫鎖定時，標點可能變成中文全形。你改成 noop 之後如果沒遇過這個狀況，就不用管。
注音方案把它們列為相依方案，所以部署時照樣編譯，部署時間不會變短。這不影響打字；要改的話得動洋蔥的方案檔，更新時又會被蓋回來，不值得。trash/ 裡的舊版倉頡也是同一回事，不用處理。
每月 1 號 10:00，排程會從洋蔥的 git repo 拉最新版、打包、複製進來（跳過你的檔），再部署並檢查。有更新或失敗時會跳 macOS 通知，過程記在 ~/Library/Logs/onion-update.log。想馬上更新就執行 ./update-onion.sh，加 -n 只列出會改哪些檔。照官方說明整包覆蓋會蓋掉你的 default.custom.yaml，所以不要手動覆蓋。完整說明寫在 CLAUDE.md。
每週日 12:00 把你的設定檔和選字記錄備份到 Google Drive 的 我的雲端硬碟/05_Assets/App-Configs/Rime/。選字記錄是用鼠鬚管的「同步用戶資料」匯出的文字快照，不是直接複製資料庫。換電腦時照那個資料夾裡的 README.md 還原。手動備份執行 ./backup-rime.sh。
bopomo_onionplus_phrase.txt，格式和優先順序這份速查沒有整理。更新腳本不會覆蓋它。顏文字詞表的寫法見第 05 段。
Control+Shift+6 實際切換哪個開關
default.custom.yaml 和洋蔥 plus 的按鍵設定各定義了一次，前者切換注音方案裡不存在的 extended_charset，後者切換字符範圍。依 librime 的規則應該是後者生效，但沒有實際按鍵驗證過。
squirrel.custom.yaml，用的是鼠鬚管預設外觀。洋蔥建議另外放它附的外觀檔，這份速查沒有討論。
要用到時再展開。
改完設定一定要重新部署才會生效。點選單列的鼠鬚管圖示 →「重新部署」，或在終端機執行：
"/Library/Input Methods/Squirrel.app/Contents/MacOS/Squirrel" --reload
部署是在背景跑的。要確認改動有沒有生效，就打開 build/ 裡對應的檔案（例如 build/bopomo_onionplus.schema.yaml）找改過的值；部署出錯時，錯誤會寫在 $TMPDIR/rime.squirrel/rime.squirrel.INFO，看有沒有 E 或 W 開頭的行。
鼠鬚管 2026-01-16 更新到 1.1.2；洋蔥方案 2026-09-18 安裝、2026-10-10 更新到 10 月 7 日的版本：注音是 202610 版；日語、韓語、拉丁、希臘、俄文、全形、系列符號是 202606 版；注音文 202405 版，英漢字典 202411 版。