鼠鬚管使用者設定 · 洋蔥注音 plus 版 · 2026-10-10

平常只用注音,其他文字按啟始鍵叫出來

這是你鼠鬚管的設定速查。主方案是洋蔥注音 plus 版(大千式鍵盤)。英文字典、全形、注音文、emoji 和顏文字,都能在注音裡先按啟始鍵直接打,不用切換方案。用不到的日語、韓語、拉丁音標、希臘字母、俄文和倉頡已經關掉。最後一段列了幾件要注意的事。

01

一頁看完

先記住這三件事,細節往下看。

啟用的方案
8個
主力只有「注音(洋蔥 plus 版)」,其他多半是給啟始鍵掛接用的。日韓拉希俄和倉頡已從選單拿掉。
啟始鍵
5組
在注音裡先按啟始鍵,就能接著打英文、全形、注音文、符號、emoji 和顏文字。
切到注音時
英文
你的修改檔讓注音一開始是英文模式,要打中文先按 Shift+Space。
方案選單(Control+`)其實很少需要打開:想打哪種文字,就在注音裡先按那種文字的啟始鍵。
02

啟始鍵地圖

5 組

大千式鍵盤上,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 註解掉的,把行首的 # 拿掉就會回到選單。

03

切換快捷鍵

隨時都能按,不用在打字中。下列按鍵都從部署後的設定(build/)核對過。

方案與中英

中英切換有三種按法,挑順手的用。

Control+`或F4
打開方案選單,也能在裡面切換各種開關
Control+Shift+1
直接換到下一個方案
Shift+Space
中英切換(沒在打字的時候)
左 Shift
臨時英文:字母先留在輸入區,按 Enter 上屏後自動回到中文你的設定
Control+,
切到英文;加按 Shift 切回中文
Control+Shift+2
中英來回切換

全半形、標點、簡繁

不加 Shift 是「切過去」,加 Shift 是「切回預設」,不會按錯方向。

Control+.
全形;加 Shift 回半形
Control+/
標點用半形;加 Shift 回中文全形標點
Control+;
輸出轉成簡體;加 Shift 回繁體
Control+Shift+345
依序是全半形、標點、簡繁的來回切換

洋蔥 plus 專屬開關

括號裡是部署後的預設狀態。

Control+'
字符範圍改為「完整」:字典裡的字全都出現;加 Shift 回「精簡」(預設,只出台灣常用字)
Control+[
關掉候選字後面附加的 emoji;加 Shift 打開(預設開)
Control+]
關掉外語與符號的註釋,例如音標標示;加 Shift 打開(預設開)
Control+Shift+6…0
來回切換:6 字符範圍、7 emoji、8 註釋、9 Unicode 編碼註釋、0 英漢字典排序

開關的預設狀態

切到注音時的初始狀態。

開關預設
中/英英文你的設定
字符範圍精簡
附加 emoji開
外語與符號註釋開
Unicode 編碼註釋關
英漢字典排序依字數(「個排」)
04

打字中的按鍵

正在打注音、或候選選單開著的時候才有作用。數字鍵在大千式鍵盤上是注音,所以選字改用 Shift 加字母。

選字:一頁 8 個,左右手各一組

第幾個候選12345678
左手 Shift 加 QAZW SXED
右手 Shift 加 YHNU JMIK
選單上的標籤 ⒈𝚀𝚈⒉𝙰𝙷⒊𝚉𝙽⒋𝚆𝚄⒌𝚂𝙹⒍𝚇𝙼⒎𝙴𝙸⒏𝙳𝙺
  • 規律:左手沿著 Q-A-Z、W-S-X、E-D 三排由上往下,右手是 Y-H-N、U-J-M、I-K。選單標籤上的兩個字母就是這兩組鍵。
  • 右側數字小鍵盤的 1~8 也能選字(洋蔥 wiki 的說明)。

翻頁、游標、刪除、直接輸出

翻頁與游標

翻頁只在選單開著時有效。

Shift+C/Shift+Space
上一頁/下一頁
Shift+↑/Shift+↓
上一頁/下一頁
←/→
用方向鍵進入選字後,左右鍵就是翻頁
→
打字時游標右移一整個字;Shift+→ 只移一個注音
↑或Shift+←
游標左移一個注音
Tab/Shift+Tab
跳到下一節/上一節

刪除、取消、直接輸出

Shift 加字母的鍵都是洋蔥 plus 版加的,打字中才有效。

\或Shift+⌫
刪掉一個注音符號(選單開著時)
⌫
刪掉一整個字的注音(選單開著時)
Esc或Shift+G
清掉還沒上屏的內容
Shift+Delete
把選單上反白的那個詞從自動記錄裡刪掉(Control+K 也行)
Shift+Return或Shift+O
不轉換,直接輸出按鍵上的英數符號
Control+Return或Shift+F
輸出注音符號本身
Emacs 式的游標鍵,以及 Shift 加字母的其他編輯鍵全部列表

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 等同空白鍵。

05

顏文字

11 類,347 個

洋蔥本來就有顏文字,不用另外加:先按兩下 `,再按分類鍵,選單就會列出那一類的顏文字,選字方式跟平常一樣。

按鍵分類選單裡的前幾個
``1開心^_^ ^ω^ *^_^*
``2喜歡QwQ 罒ω罒 (*/ω\*)
``3傷心T_T (>﹏<) 〒▽〒
``4生氣>o< (* ̄︿ ̄) (;`O´)o
``5驚訝⊙_⊙ ⊙▽⊙ (๑ŐдŐ)b
``6無奈=_= @_@ (ー_ー)!!
``7喜(*^ー^) (^-^*) (^u^)
``8樂(^ρ^)/ ヽ(^o^)丿 (✪ω✪)
``9怒(#`Д´)ノ 凸(= _=)凸 (눈‸눈)
``0指示和圖示(´∀`σ)σ (´・_・`)
``-回話σ(*´∀`*) σ(Д・`)
  • 每類 22~46 個,一頁 8 個,用 Shift+Space 翻頁。
  • 只按一下 ` 是系列符號與 emoji,兩下才是顏文字。
  • 資料在 symbols_bpmf.dict.yaml 的「顏文字」段,是洋蔥的檔,更新洋蔥時會被換掉,所以別直接改它。
06

檔案分工

換個角度看同一個資料夾:哪些是你的、哪些是洋蔥的、哪些是鼠鬚管自己產生的。要改設定只動「你的」那一欄。

你的

改設定只動這裡

  • default.custom.yaml:方案清單、快捷鍵、Shift 和 Caps Lock 的行為,從洋蔥的版本改來
  • bopomo_onionplus.custom.yaml:切到注音時預設英文模式,並關掉 6 組用不到的啟始鍵
  • update-onion.sh:更新洋蔥用的腳本,會跳過這一欄的檔
  • CLAUDE.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 兩邊的寫法不同,但效果一樣,都是不做事。

07

要注意的事

3 件

由重到輕排列。第一件有遇到再處理,其他知道就好。

留意

Caps Lock 改成了「不做事」

洋蔥原版設成 commit_text,註解特別提醒這裡不能拿掉,否則開著大寫鎖定時,標點可能變成中文全形。你改成 noop 之後如果沒遇過這個狀況,就不用管。

知道就好

關掉的語言和倉頡還是會編譯

注音方案把它們列為相依方案,所以部署時照樣編譯,部署時間不會變短。這不影響打字;要改的話得動洋蔥的方案檔,更新時又會被蓋回來,不值得。trash/ 裡的舊版倉頡也是同一回事,不用處理。

有新版

洋蔥有 10 月 2 日的新版,更新請用腳本

你的檔案是 9 月 18 日複製進來的(主方案版本 202606)。洋蔥的方案包裡有自己的 default.custom.yaml,照官方說明整包覆蓋會蓋掉你的設定。下載 Releases 的 ZIP 後執行 ./update-onion.sh -n 檔名.zip 試跑,沒問題再拿掉 -n 正式更新。完整步驟寫在 CLAUDE.md。

這份速查沒有涵蓋的

!
怎麼加自訂詞或自己的顏文字 要寫進 bopomo_onionplus_phrase.txt,格式和優先順序這份速查沒有整理。更新腳本不會覆蓋它。
!
Control+Shift+6 實際切換哪個開關 default.custom.yaml 和洋蔥 plus 的按鍵設定各定義了一次,前者切換注音方案裡不存在的 extended_charset,後者切換字符範圍。依 librime 的規則應該是後者生效,但沒有實際按鍵驗證過。
!
候選視窗外觀 你沒有放 squirrel.custom.yaml,用的是鼠鬚管預設外觀。洋蔥建議另外放它附的外觀檔,這份速查沒有討論。
08

附錄

要用到時再展開。

重新部署與查錯誤記錄指令

改完設定一定要重新部署才會生效。點選單列的鼠鬚管圖示 →「重新部署」,或在終端機執行:

"/Library/Input Methods/Squirrel.app/Contents/MacOS/Squirrel" --reload

部署是在背景跑的。要確認改動有沒有生效,就打開 build/ 裡對應的檔案(例如 build/bopomo_onionplus.schema.yaml)找改過的值;部署出錯時,錯誤會寫在 $TMPDIR/rime.squirrel/rime.squirrel.INFO,看有沒有 E 或 W 開頭的行。

版本資訊:鼠鬚管 1.1.2、librime 1.16.0、洋蔥主方案 202606版本

鼠鬚管 2026-01-16 更新到 1.1.2;洋蔥方案 2026-09-18 安裝,注音、日語、韓語、拉丁、希臘、俄文、全形、系列符號都是 202606 版,注音文 202405 版,英漢字典 202411 版。

洋蔥官方說明連結連結
⌘ + Enter 送出 · Esc 取消
— 我的評論