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

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

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

01

一頁看完

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

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

啟始鍵地圖

11 組

大千式鍵盤上,3、4、6、7 是聲調鍵,不會出現在注音開頭,洋蔥就拿它們當啟始鍵;`、=、[、]、' 這幾個不是注音的鍵也一樣。

啟始鍵 右上角是大千式的注音位置 空白鍵是一聲
啟始鍵叫出什麼字尾加的後綴例子
3 英漢字典:88 萬單字和片語,選單附中文解釋 ; 首字母大寫、;; 全大寫;片語裡的空格打 ./ 3terra → terra 開頭的單字;3terra; → Terra
4 拉丁字母:萬國音標、KK 音標、帶調拼音 / 小寫、; 大寫、;; 組合變音符號 4suen → sūn;4zf → Ʒ
6 日語:羅馬字輸入 , 平假名、. 片假名、; 漢字、// 半形片假名等 6nanami → ななみ;6sake; → 酒
66 西里爾字母(俄文) / 小寫、; 大寫、;; 組合變音符號 標點也能打:,. → ?、/. → !
7 韓語:HNC 鍵位 / 基礎字母、// 舊字母、; 漢字 7daiman → 대만;7dai; → 大
77 希臘字母 / 小寫、; 大寫 引號:,,/ → «、../ → »
][ 英數全形,編碼跟拉丁字母相同 / 小寫、; 大寫;也能打全形數字 ./ → 全形空格
= 倉頡反查:用倉頡碼打字,選單顯示注音 可以連打,當成第二套輸入法用 =oiar → 倉(人戈日口)
` 系列符號與 emoji 只打 ` 會列出各類符號的說明,再輸入項目名稱每個字的第一個注音 打 ` 看說明;打 `` 看第二頁說明
'; 注音文:一般和特殊注音符號 接著打注音按鍵 打不出來的特殊注音符號從這裡找
'/ 特殊功能集:日期時間、計算機、Unicode 內碼、說明頁 只打 '/ 會列出完整功能選單 '/f → 年月日;'/t → 時:分:秒;'/kk → 快捷鍵說明
  • 結束一段:除了 3 和 '/,其他啟始鍵開的段落都能打 ' 結束,再接著打注音。
  • 注音打到一半也能插入其他文字,但前一個字要先打完聲調:ㄏㄠˇ 之後按 6 就進日語;只打 ㄏㄠ 再按 6,會變成二聲 ㄏㄠˊ。
  • 用啟始鍵打字時,請用上下鍵或選字鍵選字。中途用左右鍵切分再選,那次選字不會被記進詞頻。
各種文字的完整編碼表(拉丁、希臘、俄文、韓文、日文)延伸閱讀

啟始鍵後面的編碼規則都是洋蔥自己設計的,完整對照表在上游:

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

日語變體

目前沒有套用

日語方案 jpnin1,也就是注音裡按 6 叫出的日語,有兩個官方修改檔可以選,同一時間只能套用一個。兩邊用的是同一份編譯結果,所以套用後 jpnin1 方案和注音裡的 6 會一起改變。

比較項目現況(沒套用)只出假名精簡轉寫
不加後綴時,選單出現什麼 假名和漢字混在一起 只有假名 假名和漢字混在一起
想要漢字 直接出現 字尾加 ; 直接出現
漢字的促音、拗音替代拼法
(例:kixyou 也能打出「京」)
可以 可以 不行,只認標準拼法 kyou
小寫假名用 l 開頭(la → ぁ) 可以 可以 不行,改用 xa
部署時間 較長 較長 較短(拿掉了最耗時的轉寫規則)

怎麼套用

STEP 1

挑一個

兩個修改檔都在 custom檔_日語jpnin1精簡/ 底下,資料夾名稱就是變體名稱。

STEP 2

複製進來

把那個資料夾裡的 jpnin1.custom.yaml 複製到 ~/Library/Rime/。

STEP 3

重新部署

點選單列的鼠鬚管圖示 →「重新部署」,或用下面的指令。

STEP 4

想還原

刪掉 ~/Library/Rime/jpnin1.custom.yaml,再部署一次。

# 套用「只出假名」(要精簡轉寫就換成 jpnin1精簡轉寫修改檔)
cp ~/Library/Rime/custom檔_日語jpnin1精簡/jpnin1只出假名修改檔/jpnin1.custom.yaml ~/Library/Rime/
"/Library/Input Methods/Squirrel.app/Contents/MacOS/Squirrel" --reload

# 還原成現況
rm ~/Library/Rime/jpnin1.custom.yaml
"/Library/Input Methods/Squirrel.app/Contents/MacOS/Squirrel" --reload
06

檔案分工

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

你的

改設定只動這裡

  • default.custom.yaml:方案清單、快捷鍵、Shift 和 Caps Lock 的行為,從洋蔥的版本改來
  • bopomo_onionplus.custom.yaml:切到注音時預設英文模式
  • CLAUDE.md:給 Claude 看的說明
  • docs/rime-cheatsheet.html:這份速查

洋蔥上游

更新洋蔥時會整包覆蓋

  • *.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:安裝與部署資訊

你的 default.custom.yaml 跟洋蔥原版只差這一段

 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 之後如果沒遇過這個狀況,就不用管。

知道就好

倉頡方案用的是鼠鬚管內建版

洋蔥附的倉頡五代設定檔是 v0.29,鼠鬚管內建的是 v0.30。部署時舊的那份被自動移進了 trash/,現在生效的是內建版,不用處理。

有新版

洋蔥上游 10 月 7 日有新的提交

你的檔案是 9 月 18 日複製進來的(主方案版本 202606)。要更新的話,先另存 default.custom.yaml,覆蓋後再把 Shift 和 Caps Lock 那段改回來。完整步驟寫在 CLAUDE.md。

這份速查沒有涵蓋的

!
各種文字的完整編碼表 見第 02 段的延伸閱讀,或在輸入法裡打 '/k 開頭的說明頁。
!
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 取消
— 我的評論