偏好設定
本文的原始 markdown 可以點此存取，以便使用者轉交給各種 AI 服務代為閱讀講解。
本文對應至少唯音輸入法 4.7.4 版（SwiftUI 偏好設定介面，需 macOS 14 以上）。本文逐頁、逐選項講解偏好設定介面當中每一個選項的作用、影響、以及可能用來滿足的使用者需求。
macOS 10.13 與 10.14 系統使用的是舊版 AppKit 偏好設定介面（外觀與互動細節不同，但選項集合基本一致）。舊版介面會隱藏少數需要較新系統版本的選項（例如需要 macOS 10.15 / 12 的通知相關選項），相關差異會在文末〈舊版介面差異〉一節統整。
介面概觀
偏好設定視窗採側邊欄＋內容區的雙欄式設計。側邊欄自上而下依序為橫幅圖片、搜尋框（⌘F）、十二個頁面圖示列表、版本編號、與官方網站連結。內容區為當前選中頁面的表單。預設進入時選中的是「一般設定」。
側邊欄列表順序如下，本文亦按此順序逐頁講解：
| 頁面 | 側邊欄圖示 | 主要用途 |
|---|---|---|
| 關於唯音 | info.circle.fill | 顯示版本資訊與授權條款，無可調整選項 |
| 一般設定 | wrench.and.screwdriver.fill | 整體性設定：語言、注音糾錯、ㄅ半一鍵設定、自動更新等 |
| 選字設定 | filemenu.and.selection | 選字窗外觀、字型大小、排列方式（橫向／縱向）、動畫開關 |
| 行為設定 | switch.2 | 按鍵行為（空格、Tab、Shift、Caps Lock 等）、中英混打、通知 |
| 輸出設定 | text.append | 文字轉換（康熙正體、JIS 新字體、注音符號標記等） |
| 辭典設定 | text.book.closed.fill | 使用者片語目錄、候選字排序、全字庫、繁簡過濾、漸退記憶 |
| 語彙編輯 | tablecells.badge.ellipsis | 直接編輯自訂詞彙、濾除清單、關聯詞語等 |
| 磁帶設定 | externaldrive.fill.badge.plus | 掛載 CIN 表格（行列、倉頡、嘸蝦米等） |
| 鍵盤設定 | keyboard.macwindow | 注音排列（大千、倚天、許氏、拼音等）、熱鍵開關 |
| 客體設定 | square.and.pencil | 管理哪些 App 需要啟用浮動組字窗（例如 Steam、LINE、ChatGPT） |
| 服務設定 | gearshape.fill | 編輯選字窗內的服務選單（查字典、搜尋引擎等） |
| 開發道場 | pc | 偵錯模式、安全防護、偏好設定 JSON 匯入匯出 |
「語彙編輯」「客體設定」「服務設定」三個頁面不會在頁面內顯示搜尋欄，但仍然可被全域搜尋（⌘F 搜尋表單）找到。
每個選項後方若有灰色小字，即為該選項的官方說明文字；本文會一併引用。下文表格中「預設」欄標示的是出廠預設值。
頁面 1：關於唯音
此頁面僅展示版本資訊與授權聲明，不含可調整的選項。
| 項目 | 內容 |
|---|---|
| 應用名稱 | vChewing for macOS |
| 版本資訊 | 版本號、Build 編號、簽署日期 |
| 捐贈訊息 | 請考慮對敝專案捐贈，詳情 https://vchewing.github.io |
| 著作權標籤 | 著作權聲明 |
| 研發成員 | 唯音 macOS 程式研發、詞庫維護、DAG-DP 組句算法實作等資訊 |
| 授權合約 | 麻理去商標授權合約（MIT-NTL License），可捲動閱讀並選取文字 |
| 免責補記 | Homa 組字引擎採 LGPLv3（對 Swift 靜態鏈接另有准許）；先鋒語料庫由多個外部資源組成、其建置程式以 3-Clause BSD 釋出 |
| 網站連結 | 連往 https://vchewing.github.io/ |
| 故障提報連結 | 連往 https://vchewing.github.io/BUGREPORT.html |
「自動檢查軟體更新」開關並非位於此頁，而是位於「一般設定」頁。
頁面 2：一般設定
匯集最常被調整的整體性選項。頁面頂端有一段灰色提示：
• 請利用滑鼠滾輪檢視頁面。也請洽輸入法選單內的熱鍵指南。 • 注意：Mac 鍵盤的「Delete ⌫」鍵在此被稱作「BackSpace 退格鍵 ⌫」以與 PC 鍵盤的真正的「Delete ⌦」鍵彼此區分開。若您想在沒有數字小鍵盤的 Mac 電腦上使用真正的「Delete ⌦」按鍵的話，請改用「Fn+⌫」。
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 介面語言: | 依系統設定 | 變更輸入法介面語言（依系統設定 / 簡體中文 / 繁體中文 / 和文 / 英文）。變更後會自動重啟輸入法以套用新語言。 | 多語系使用者依偏好切換介面語言。 |
| 要唸讀的組音區內容 | 不唸讀 | 控制是否以語音朗讀組音區（注拼槽）內容，磁帶模式下無效。選項：不唸讀 / 僅在用聲調鍵確認時 / 實時唸讀組音區的任何變化。 | 視障輔助、或在敲注音時以聽覺確認讀音。 |
| 敲字時自動糾正讀音組合 | 開 | 自動糾正注音讀音組合；在中英混合輸入回退時不起作用以確保相容性。 | 減少因誤觸導致的讀音錯誤。 |
| 拼音並擊（組字區內顯示漢語拼音） | 關 | 使用拼音輸入時，在組字區內顯示漢語拼音（並擊模式）。 | 拼音使用者即時核對所敲拼音。 |
| 允許對無效的讀音使用 BackSpace 編輯 | 關 | 允許用 BackSpace 繼續編輯無效讀音，而非直接丟棄。 | 想逐步修正錯誤讀音的使用者。 |
| 亦使用「\」或「¥」鍵啟用漢音鍵盤符號模式 | 關 | 啟用漢音時代的鍵盤符號模式熱鍵（\ 或 ¥）。 | 習慣漢音鍵盤符號模式的使用者。 |
| 模擬 90 年代前期注音逐字選字輸入風格 | 關 | 啟用 SCPC（逐字選字）輸入風格。針對年長使用者的習慣而提供。 | 想重現早期 Windows「ㄅ半」逐字選字體驗。 |
| 廉恥模式 // 取消勾選的話，敲錯字時會有異音 | 開 | 僅 4 月 1 日出現。取消勾選時會彈出警告，確認後敲錯字的提示音會改成放屁聲。 | 愚人節彩蛋。 |
| 自動檢查軟體更新 | 關 | 啟用後定期自動檢查新版本。 | 不願手動檢查更新的使用者。 |
| 偵錯模式 | 關 | 啟用偵錯／診斷模式，提供更多運行資訊。 | 回報問題時配合開發者診斷。 |
| 我姓ㄅ…（ㄅ半懶人設定按鈕） | — | 點擊後彈出確認框，確認後一次性套用：啟用逐字選字、啟用關聯詞語、停用「空格確認高亮候選字」、選字鍵設為 123456789、選字窗改縱向佈局、啟用「對逐字選字模式強制單行選字窗佈局」。 | 一鍵把輸入法調成「ㄅ半」風格，免去逐一設定。 |
頁面 3：選字設定
控制選字窗的外觀與游標行為。選項較多，分述如下。
游標與選字窗定位
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 選字游標: | 將游標置於詞語前方 | 選擇觸發選字時游標的相對位置。將游標置於詞語前方（macOS 內建注音風格）/ 將游標置於詞語後方（Windows 微軟新注音風格）。 | 對齊不同作業系統的選字游標習慣。 |
| 候選字確認後的游標位置: | 向前推進一格 | 選字窗確認候選字後游標應位於何處。不調整 / 向前推進一格 / 復原呼出選字窗之前的游標位置。推進距離會受選字游標操作樣式影響。 | 細控選字後的編輯游標位置。 |
| 根據當前位置的字詞長度，自動調整選字窗的位置 | 開 | 依當前位置字詞長度動態調整選字窗位置。僅在「選字游標設為前方」時可調（後方模式下停用）。 | 避免選字窗遮擋或位置不當。 |
| 糾正不合理的端點選字游標位置 | 開 | 糾正不合理的端點選字游標位置。 | 防止游標在邊界出現異常。 |
| 選字窗內的 JKHL 鍵行為: | 未指派 | ⚠ 啟用後將自動禁止 JKHL 用作選字鍵；在磁帶模式「%quick」快速選字狀態下無效。未指派 / JK 移動組字區游標；HL 翻選字窗行列 / HL 移動組字區游標；JK 翻選字窗行列。 | Vim 風格鍵盤導航使用者。 |
| 允許在選字窗內也使用「Shift+?」叫出服務選單 | 開 | 允許在選字窗內用 Shift+? 叫出服務選單。 | 選字時直接查詢候選字詞。 |
選字鍵與佈局
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 選字鍵: | 123456 | 自訂用來選字的按鍵組合（自訂組合需敲 Enter 生效）。會同時影響選字窗每行/每列最多顯示的候選字數量；輸入無效組合會重置為預設。 | 想用數字鍵以外的選字鍵（如 ASDF）。 |
| 選字窗佈局: | 橫向佈局 | 縱向佈局 / 橫向佈局（單選鈕）。 | 對齊個人偏好的選字窗方向。 |
| 選字窗字號: | 16 | 變更選字窗字型大小（範圍 12–196）。 | 老花眼或高解析度螢幕下的可讀性。 |
| 僅以單行/單列來陳列候選字 | 關 | 停用預設的四列/四行陳列。縱排輸入時一律單列顯示、無視此設定；單行面積有限，最多僅顯示一筆字根反查結果。 | 想用大字號又不想佔過多螢幕空間。 |
| 對逐字選字模式強制單行選字窗佈局 | 開 | 啟用後逐字選字模式（SCPC）始終使用單行選字窗佈局。 | 讓 SCPC 體驗更接近傳統ㄅ半。 |
| 選字窗移動/變更大小時啟用動畫效果 | 開 | 選字窗移動或縮放時的動畫。 | 偏好或厭惡動畫的使用者。 |
| 始終自動展開多行選字窗 | 關 | 始終展開多行選字窗（僅在非單行模式下可調）。 | 想固定展開多行選字窗。 |
| 橫向多列選字窗最低單元寬度: | 兩個漢字 | 兩個漢字 / 兩個繪文字（更寬）（僅在非單行模式下可調）。 | 繪文字較寬時避免排版錯位。 |
| 遵循客體應用或系統全域的強調色偏好設定 | 開 | 使田所選字窗高亮候選字背景改用客體應用或系統強調色。JIS／康熙文字轉換模式下不生效。 | 與 macOS 內建輸入法一致的強調色體驗。 |
雜項與實驗性
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 在選字窗內顯示當前候選字的萬國碼碼位 | 開 | 在選字窗顯示候選字的 Unicode 碼位。 | 排版／字型工作者核對字元碼位。 |
| 在選字窗內顯示可用的字根反查結果 | 開 | 顯示取自 CIN 磁帶模組的字根反查結果。 | 磁帶模式下核對字根。 |
| 以固定順序來陳列選字窗內的候選字 | 關 | 阻止漸退記憶模組影響候選字陳列順序。 | 想要穩定不變的候選字排序。 |
| 在使用選字窗選字時，自動鞏固上下文 | 開 | 選字時自動鞏固前後文，避免選字後出現非預期的自動選字結果（例如「章太炎」改「太」為「泰」時，鞏固後才會得到「章泰炎」）。 | 邊選字邊修正時保持上下文正確。 |
| 候選字詞唸讀模式: | 總是關閉 | 設定何時以語音朗讀候選字詞，並會查詢可自訂的關聯詞語資料庫嘗試說明各字。總是關閉 / 總是開啟 / 僅在 VoiceOver 開啟時。 | 視障輔助、用聽覺確認候選字。 |
| 浮動組字窗字號: | 18 | 調整浮動組字窗字型大小（範圍 18–40）。 | 浮動組字窗可讀性。 |
| 「IMK 選字窗去哪了？」按鈕 | — | 點擊後彈出說明，解釋 IMK 選字窗已終止支援的原因。 | 了解為何移除 IMK 選字窗。 |
頁面 4：行為設定
控制各種按鍵與互動行為，是選項最多、也最需要逐項理解的頁面。
通知與音效
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 通知飄窗配色外觀: | 不指定 | 強制通知飄窗的外觀。淺色模式 / 不指定 / 深色模式（需 macOS 10.14）。 | 不跟隨系統外觀的使用者。 |
| 以 Caps Lock 切換輸入法/中英模式時顯示通知 | 開 | 用 Caps Lock 切換時顯示通知（需 macOS 12）。 | 想確認切換狀態。 |
| 以 JIS 英數鍵切換輸入法/中英模式時顯示通知 | 開 | 用 JIS 英數鍵切換時顯示通知。說明：☠️ 這可能會讓您難以快速識別目前的 ASCII 模式開/關狀態。 | 日規鍵盤使用者。 |
| 以 Shift 切換輸入法/中英模式時顯示通知 | 開 | 用 Shift 切換時顯示通知（需 macOS 10.15）。說明同上。 | 想確認 Shift 切換狀態。 |
| 始終使用橫排來顯示工具提示視窗 | 關 | 縱排輸入時工具提示內的按鍵名稱會以符號顯示。英文介面下此項被停用。 | 縱排書寫時偏好橫排提示。 |
| 在剛剛對接輸入客體時，以內文提示提醒當前的打字模式 | 關 | 勾選後，每次唯音開始服務某個輸入客體（例如切換到唯音輸入法、或以 Caps Lock 切回中文模式）時，會以內文提示顯示目前使用的打字模式，該提示會在數秒後自動消失。注意：部分客體軟體在沒有接收文字輸入時也會謊報文字輸入區的位置，提示可能出現在非預期的位置。 | 剛切換輸入法時想確認目前的打字模式。 |
| 蜂鳴音效 | 使用唯音音效 | 敲錯字時的提示音來源。靜音 / 使用系統音效 / 使用唯音音效。 | 不想被打擾或想用自帶音效。 |
混合輸入
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 啟用中英混合輸入回退 | 關 | 將注音排列可覆蓋的 ASCII 鍵暫時視為注音；序列不再構成可發音讀音時回退為原始 ASCII。拼音輸入或磁帶模式下不可用。啟用後可能需到辭典頁篩除某些原廠辭典結果；半形標點需求請改開半形標點模式。 | 已適應某電腦廠牌中英混打體驗的使用者。 |
按鍵行為
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 空格鍵對內文組字區的行為: | 呼出選字窗 | 插入空格 / 呼出選字窗 / 輪替候選字（正向順延）（輪替時 Shift+Space 反向）。 | 個人化空格鍵用途。 |
| 就地輪替強度偏好 | 一律使用弱輪替 (優先保護已選內容) | 自 v4.5.4 引入「弱輪替」保護機制：使用鍵盤快捷鍵（如 Space/Tab）進行就地輪替時，若目標為多音節候選且其範圍會覆蓋到「非當前游標位置」且「已被手動選定」的字詞，系統將跳過該候選，以防止已選內容受到意外影響。此設定僅影響鍵盤觸發的就地輪替，與選字窗選字無關。一律使用強輪替 (優先候選結果) / 僅在 (Shift+)Space 輪替時啟用弱輪替 / 一律使用弱輪替 (優先保護已選內容)（預設）。 | 保護「逐字選字」使用者的已選內容不被就地輪替意外覆蓋。 |
| 敲 ESC 鍵以清空整個組字緩衝區 | 開 | 開：ESC 清空整個緩衝區；關：ESC 先清除未組成的讀音/字根，沒有的話才遞交當前組字區內容。 | 細控 ESC 的清除範圍。 |
| 允許使用 Enter 確認當前選中的關聯詞語 | 關 | 不勾選的話就只能用選字鍵選取關聯詞語。 | 想用 Enter 直接確認關聯詞語。 |
| Shift+退格鍵: | 析構游標正後方的字音，且剔除其聲調 | 析構游標正後方的字音，且剔除其聲調 / 像 Shift+Delete 那樣清空當前組字區內容 / 始終剔除游標正後方的字音。析構僅對漢字讀音索引有效。 | 細控 Shift+BackSpace。 |
| (Shift+)Tab: | 輪替候選字 | 指定 (Shift+)Tab 在選字窗內的輪替對象。輪替候選字 / 輪替頁面（單選鈕）。 | 選字窗內翻字或翻頁偏好。 |
| (Shift+)空格鍵 (選字窗): | Shift+空格鍵 換下一頁，空格鍵 換選下一個候選字 | 指定 (Shift+)空格鍵 對候選字詞的輪替對象。Shift+空格鍵 換下一頁，空格鍵 換選下一個候選字 / 空格鍵 換下一頁，Shift+空格鍵 換選下一個候選字。逐字選字模式下不帶 Shift 的空格鍵始終翻頁；若啟用「空格確認高亮候選字」則該設定優先。 | 對齊個人的空格/翻頁習慣。 |
| 在逐字選字模式當中使用空格鍵確認當前高亮候選字 | 關 | 僅逐字選字模式（SCPC）下生效。啟用後選字窗可見時按空格確認高亮候選字。 | SCPC 下用空格選字。 |
特殊遞交與字母／數字鍵
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| Command+Option+Ctrl+Enter: | 遞交括弧註解標記 | 定義該熱鍵組合遞交什麼。遞交括弧註解標記 / 遞交 HTML Ruby 註解標記 / 遞交國語點字 (1947) / 遞交國通盲文 (GF0019-2018) / 遞交 ButKo BPMFVS 注音標記 / 遞交國語點字 ASCII (1947) / 遞交國通盲文 ASCII (GF0019-2018)。磁帶模式下改為遞交括弧註解標記；點字需求建議用專門軟體；BPMFVS 與點字 / 盲文 ASCII 需另裝專用字型。 | 教材排版、點字／盲文、注音標記輸出。 |
| 在組字區同步反映 ButKo BPMFVS | 關 | 僅在上一項設為 ButKo BPMFVS 時生效，讓組字區與候選預覽顯示 BPMFVS 投影結果。下方有「→ BPMFVS @ GitHub」連結。 | BPMFVS 輸出時所見即所得。 |
| Shift+字母鍵: | 直接鍵入內文組字區 | 直接鍵入內文組字區 / 始終直接遞交小寫字母 / 始終直接遞交大寫字母 / 直接遞交小寫字母，除非組字區不為空 / 直接遞交大寫字母，除非組字區不為空。 | 控制大寫字母直接輸入行為。 |
| 數字小鍵盤: | 始終以半形文字直接遞交 | 始終以半形文字直接遞交 / 始終以全形文字直接遞交 / 以半形文字插入組字區 / 以全形文字插入組字區 / 直接遞交半形文字，除非組字區不為空 / 直接遞交全形文字，除非組字區不為空。 | 全形數字／財務數字輸入需求。 |
聲調鍵
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 聲調鍵: | 嘗試對游標正後方的字音覆寫聲調，且重設其選字狀態 | 注拼槽為空時聲調鍵的行為。嘗試對游標正後方的字音覆寫聲調，且重設其選字狀態 / 僅在鍵入的聲調與游標正後方的字音不同時，嘗試覆寫 / 始終在內文組字區內鍵入聲調符號。中英混合回退時被無視。 | 調整聲調覆寫與輸入符號的取捨。 |
| 在個別情況下，允許聲調前置鍵入 | 開 | 防呆功能，應對失手前置聲調鍵；無法用於拼音；優先權低於聲調覆寫（除非後者停用）；中英混合回退時被無視。 | 偶爾會先敲聲調的使用者。 |
Caps Lock / Shift / 英數模式
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 不使用唯音輸入法內建的 Caps Lock 處理 | 關 | 停用唯音自帶的 Caps Lock 處理（需 macOS 10.15）。不影響 macOS 10.14 起的系統內建同名功能。 | 完全交給系統處理 Caps Lock。 |
| 對所有客體應用共用中英文輸入切換狀態 | 關 | 僅用於以 Shift 或 JIS 英數鍵切換的場合。 | 想讓所有 App 共用同一中英狀態。 |
| 允許使用左側的 Shift 鍵切換英數輸入模式 | 開 | 允許左 Shift 切換英數（需 macOS 10.15）。 | 從 Windows 轉來的使用者硬性需求。 |
| 允許使用右側的 Shift 鍵切換英數輸入模式 | 開 | 允許右 Shift 切換英數（需 macOS 10.15）。 | 同上。 |
| 使「Shift 鍵 / JIS 英数鍵」英數模式的關閉狀態與 Caps Lock 的關閉狀態保持彼此同步 | 開 | （需 macOS 10.15）勾選後：Caps Lock 關掉時連帶關掉 Shift／英數鍵控制的英數模式；用 JIS 英數鍵關英數時也會關掉 Caps Lock。唯音無法在 Caps Lock 亮燈時感知 Shift 單擊。 | 讓 Shift／英數與 Caps Lock 狀態一致。 |
上述兩個 Shift 切換開關下方有一段共用說明：該功能需 macOS 10.15；只需對 macOS 輸入法框架傳入的 NSEvent 做上下文分析，無需系統全域鍵盤監聽權限；此 Shift 開關在 CapsLock 燈亮時無效。
狂拼模式
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 啟用狂拼模式（連續拼音打字） | 開 | 狂拼模式（Furious Typing Mode）是為了方便習慣「智能狂拼（ChineseStar）」「搜狗拼音（Sogou）」「昇陽拼音（SunPinyin）」或「紫光拼音/華宇拼音（Unispim）」連續組句輸入的使用者。僅對拼音輸入（任一拼音排列）生效，對磁帶、逐字選字（SCPC）、內碼、漢音鍵盤符號與羅馬數字等輸入方法不適用。啟用後連續敲擊拼音字母即可組句，無需逐音節敲聲調或空格鍵確認；注拼槽內尚未完成的拼音會以語言模型試算整句、即時預覽於組字區，尾段候選窗亦同步顯示，可循「Shift+選字鍵」就地選字（預覽期間原始拼音改以提示框顯示，候選窗顯示時自動讓位、避免重疊）。狂拼預覽中按空格會將當前讀音插入組字器（不再兼任候選輪替）；注拼槽尚有未完成拼音時按 Enter 亦僅固化當前讀音（或就地確認高亮候選）並停留於組字狀態，待注拼槽清空後再按 Enter 才遞交整句。 | 從搜狗/昇陽/狂拼/紫光等連續組句輸入法遷移而來、習慣「先連續敲、後回頭改」的使用者。詳細用法請見《寫給搜狗拼音/昇陽拼音/智能狂拼/紫光拼音的使用者》。 |
頁面 5：輸出設定
控制遞交出去的文字如何被轉換與整理。
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 漢字轉換模式 | 不轉換（當代繁體） | 在當代繁體／康熙／JIS 之間輪替漢字轉換。僅對繁體中文輸出模式有效；「當代繁體中文」即為不轉換（輸出維持標準繁體中文）。 | 印刷／古籍排版、日文環境檢索等需求。 |
| Ctrl(+Option)+Command+Enter 輸出漢語拼音而非注音 | 關 | 該熱鍵組合輸出改為漢語拼音（實際內容受行為設定影響）。 | 需要輸出拼音的場合。 |
| 在遞交時清理未完成拼寫的讀音或字根 | 開 | 遞交時清掉未完成的讀音／字根。 | 避免遞交殘留的無效讀音。 |
| 羅馬數字輸出格式 | ASCII 大寫 | 羅馬數字輸入模式（敲 Opt+符號選單鍵切換，支援 1–3999）的輸出格式。ASCII 大寫 / ASCII 小寫 / 萬國碼羅馬數字(大寫) / 萬國碼羅馬數字(小寫)。輸入完成或失敗後自動關閉該模式。 | 選擇羅馬數字字元種類。 |
實驗性
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 在縱排書寫時，強制轉換標點為縱排形式（不推薦） | 關 | ⚠ 僅當排版字型不支援縱排標點動態顯示時才有用。一旦使用，已輸入標點會被永久轉為靜態縱排標點，即使改成橫排也仍是縱排字元。 | 少數不支援縱排標點的字型。 |
頁面 6：辭典設定
管理使用者資料夾、辭典來源、過濾與匯入。
使用者資料夾
| 項目 | 內容 |
|---|---|
| 使用者資料夾路徑 | 指定使用者片語辭典目錄；可拖入資料夾、用「…」按鈕選取（按住 Option 則在 Finder 顯示）、用「↻」按鈕重設為預設。無效值會被忽略。說明：⚠️💀 請避免使用由 iCloud 代管的「Documents」與「Desktop」目錄，這些位置的 sandbox bookmark 可能在重新開機或系統更新後失效。更換目錄時會詢問是否合併舊資料到新路徑。 |
| 自動偵測並載入使用者片語檔案變更 | 預設開。下方有安全說明：使用者片語檔案不支援 shell script。 |
辭典／語言模型選項
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 對所有單漢字候選字強制施加倚天中文DOS系統排序 | 開 | 對候選字順序有強烈手動調整需求的使用者（多為倚天 DOS 老用戶）。逐字選字模式始終遵循此排序、不受此開關影響。 | 倚天 DOS 候選字排序習慣。 |
| 盡量使用外置原廠辭典檔案 | 關 | 優先使用 vChewing-VanguardLexicon 的 make install 部署的原廠辭典。 | 進階使用者自管辭典檔。 |
| 僅繁體中文: 原廠辭典僅傳回符合全字庫讀音的結果 | 關 | 不符合全字庫讀音的單漢字候選會被降權至列表尾端（而非移除）。 | 繁體審音嚴格的使用者。 |
| 濾除掉與輸入模式不相符的漢字候選 | 關 | 移除僅存在於相反輸入模式的單漢字候選；倚天與 CNS 全字庫漢字不受影響；過濾範圍僅限 Unicode 1.0.1 漢字。 | 不想在繁體模式看到簡體特有字（反之亦然）。 |
| 啟用 CNS+GBEX 模式支援 | 關 | 啟用 CNS11643 全字庫與 GB18030-2022 擴充 C/D/E/F（GBEX）資料支援。 | 需要全字庫收字範圍；GBEX 字亦需額外字型支援。 |
| 啟用包括少許繪文字在內的符號輸入支援 | 開 | 啟用符號輸入（含少量 Emoji）。 | 符號／Emoji 輸入。 |
| 以使用者提供的 symbols.dat 資料完全取代層級符號選單內容 | 開 | 未按修飾鍵單擊符號選單鍵時觸發層級符號選單。啟用後僅顯示使用者 symbols.dat 內容；關閉則改為追加至出廠符號選單根節點末尾。 | 完全自訂符號選單。 |
| 啟用語彙置換表 | 關 | 對指定候選字詞整詞取代；啟用時會載入使用者語彙置換表。 | 批量替換特定詞彙。 |
| 停用原廠假名音節資料 | 關 | 原廠辭典不再供應假名音節資料。中英混輸回退時若嫌假名候選干擾可開啟。 | 不需要假名候選的使用者。 |
漸退記憶模組（POM）
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 啟用漸退記憶的學習與自動建議 | 開 | 啟用後，漸退記憶（POM）模組會觀察您的選字行為以累積臨時記憶，並在敲字時自動以這些記憶提供建議（套用至組句結果、或置頂於候選窗）；既有的記憶亦會以統計方式參與組句。記憶記錄會隨時間逐漸衰減失效，您亦可隨時藉由輸入法選單清除全部記憶。關閉本選項可停止此類自動建議、新的記憶學習、以及既有記憶以統計方式參與組句。 | 自動學習近期常用字詞。 |
| 啟用急速遺忘模式 | 關 | 遺忘週期從約一週降至 12 小時內，更快清除不常用記錄。 | 不想被近期偶用詞干擾。 |
自奇摩輸入法匯入
提供兩個按鈕：用「…」選取 .txt／.db 檔匯入，或「直接匯入」互動式動式匯入。匯入完成後顯示找到與實際匯入的筆數，未全部匯入時另顯示後續注意事項。
頁面 7：語彙編輯
這是一個內嵌的語彙編輯器，用來直接編輯使用者各類詞彙資料檔。詳細的檔案格式請另見《使用者片語辭典目錄》。
工具列
| 按鈕 | 作用 |
|---|---|
| 輸入模式選單 | 切換編輯簡體或繁體的資料（依當前輸入法模式排序）。 |
| 資料類型選單 | 切換編輯哪一類資料（見下表）。 |
| 重新載入 | 重新讀取磁碟上的檔案內容。 |
| 整理 | 執行整理（去重、排序）；對「自訂語彙」另會標記與原廠重複的條目。 |
| 存檔 | 將編輯內容寫回磁碟並重載語言模型（⌘S）。 |
| … | 先存檔，再以外接程式開啟該檔（按住 Option 用 TextEdit，否則用 Finder 顯示）。 |
可編輯的資料類型
| 類型 | 標籤 | 一筆記錄格式 |
|---|---|---|
| 自訂語彙 | 自訂語彙 | 候選字詞 讀音-讀音 [權重] [#註解] |
| 濾除清單 | 濾除清單 | 候選字詞 讀音-讀音 [#註解] |
| 語彙置換 | 語彙置換 | 要替換的詞 替換成的詞 [#註解] |
| 關聯詞語 | 關聯詞語 | 首字 候選1 [候選2 候選3 ...]（不支援行內註解） |
| 繪文字符號 | 繪文字符號 | 候選字詞 讀音-讀音 [#註解] |
添入欄位與說明
編輯器下方有添入欄位（標籤會依資料類型變動）：詞語、讀音/字根、權重、註釋。權重欄僅在「自訂語彙」顯示，其說明：
不填寫權重的話，預設權重為最高值「0」。理想的權重範圍在 [-9.5, 0] 這個閉區間內，可以被組句算法自動抓到。例外就是懲戒權重「-114.514」，屬於極端降權。這種情況下，除非是唯一結果，否則會被組句算法忽略掉。
? 按鈕會顯示當前資料類型的範例格式。
編輯器內開關
| 選項 | 預設 | 作用與影響 |
|---|---|---|
| 僅限該編輯器：自動讀入來自該編輯器外部的檔案內容修改 | 開 | 當外部程式修改該檔案時自動重新讀入。 |
頁面 8：磁帶設定
管理 CIN 磁帶檔案與磁帶模式細節。磁帶模式類似雅虎奇摩輸入法的 CIN 支援，可掛載五筆、倉頡、嘸蝦米等 CIN 表格。
磁帶檔案路徑
| 項目 | 內容 |
|---|---|
| 磁帶檔案路徑 | 指定 CIN 磁帶檔（支援 cin2/cin/vcin）；可拖入、用「…」選取（按住 Option 在 Finder 顯示）、用「×」清除。說明：⚠️💀 請避免使用由 iCloud 代管的「Documents」與「Desktop」目錄，sandbox bookmark 可能在重新開機或系統更新後失效。 |
| 啟用磁帶模式，會停用注音輸入 | 預設關。啟用磁帶模式；若路徑為空會buzz、重置路徑、取消勾選並顯示存取失敗警告。 |
磁帶模式細節
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 在已經敲出最長可能碼的時候自動組字 | 開 | 敲出最長可能碼時自動組字。 | 提升磁帶輸入效率。 |
| 在組字區內顯示字根、而非原始鍵盤碼 | 開 | 不啟用則以原始鍵盤按鍵名稱顯示字根；字根定義見 CIN 的 %keyname。 | 用字根而非原始碼閱讀。 |
| 繁簡轉換: | 對磁帶模式禁用繁簡轉換 | 僅影響磁帶模式，依此選項與當前簡繁模式轉換。對磁帶模式禁用繁簡轉換 / 依當前簡繁模式強制轉換 / 僅在簡體模式轉換至簡體 / 僅在繁體模式轉換至繁體。 | 控制磁帶輸出的繁簡。 |
頁面 9：鍵盤設定
設定注音／拼音排列與基礎鍵盤佈局，以及各功能熱鍵開關。
快速設定
頁面頂端有「直接設定:」與三個預設按鈕：
↻ㄅ 大千傳統：注音排列設為大千、基礎鍵盤設為ZhuyinBopomofo。↻ㄅ 倚天傳統：注音排列設為倚天、基礎鍵盤設為ZhuyinEten。↻Ａ：注音排列設為漢語拼音、基礎鍵盤設為ABC。
排列與佈局
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 注音排列: | 大千排列 (微軟標準/王安/零壹/仲鼎/國喬) | 指定注音模式下所用的注音排列。可選：大千傳統 / 倚天傳統 / IBM / 神通 / 精業 / 偽精業 / 酷音大千二十六鍵 / 倚天忘形 26 鍵 / 許氏國音自然 / 星光 / 劉又銘擬音注音。 | 各種注音排列習慣，詳見《注音鍵盤排列參考清單》。 |
| 拼音輸入種類: | 漢語拼音+數字標調 | 指定拼音模式下所用的拼音輸入種類。說明：在拼音輸入模式下，若前後半徑 ±10 掃描範圍內各讀音單位的可能讀音數乘積（笛卡爾積規模）超過預算（625），組字引擎會套用「最長 4 個讀音」的候選組字上限，以免組字過程被笛卡爾積卡死；全拼（帶聲調）輸入、以及笛卡爾積規模在預算之內的輸入（含免聲調的 4 音節以下組合），不會套用此上限。可選：漢語拼音+數字標調 / 國音二式+數字標調 / 耶魯拼音+數字標調 / 華羅拼音+數字標調 / 通用拼音+數字標調 / 韋氏拼音+數字標調。 | 各種拼音輸入習慣。 |
| 基礎鍵盤佈局: | ZhuyinBopomofo | 選 macOS 基礎鍵盤佈局。注音打字與拼音打字現為可隨時互相切換的打字模式：拼音打字時，此佈局決定實際按鍵輸出（非 QWERTY 英數佈局亦適用）；注音打字時，按鍵一律依標準鍵位翻譯，螢幕鍵盤亦隨之顯示。 | 拼音使用者選用 Dvorak 等佈局。 |
| 英數鍵盤佈局: | ABC | 僅用於 Shift 英數輸入模式的鍵盤佈局。 | 英數模式用特定佈局。 |
鍵盤熱鍵
下方為十個熱鍵開關（兩欄），控制各功能熱鍵是否啟用，預設皆為開：
| 左欄 | 右欄 |
|---|---|
| 模擬逐字選字輸入 | 拼音 / 注音打字模式切換 |
| 關聯詞語模式 | 半形標點模式 |
| CNS+GBEX 模式 | 大寫漢字數字輸出 |
| 輪替漢字轉換（當代繁體/康熙/JIS） | CIN 磁帶模式 |
| 注音反查 | 簡體/繁體中文輸入模式切換 |
關於這些功能本身的作用，請參見《文字切換(半形/中英…)》與《鍵盤熱鍵使用手冊》。
頁面 10：客體設定
管理兩類客體應用：1) 不遵守 IMKTextInput 協定；2) 有濫用內文組字區嫌疑。可勾選客體以啟用浮動組字窗、並對組字區內容設容量上限（最多二十個讀音）。
操作
| 按鈕 | 作用 |
|---|---|
登記新客體（+） | 開啟輸入框貼入 Bundle Identifier（每行一筆），登記為受管理客體。 |
直接選取…（app.badge.checkmark） | 用檔案選擇器挑選 .app，登記後會詢問是否對該客體啟用浮動組字窗。 |
移除所選（-） | 移除選中的客體條目。 |
也可將 .app 直接拖入表格來登記。表格中每列顯示一個 Bundle Identifier 與一個開關：開＝對該 App 啟用受管理客體緩解措施。
預設已登記的客體：
com.valvesoftware.steam、jp.naver.line.mac、com.openai.chat。
頁面底部說明：
請在此管理這兩類客體應用：1) 不遵守 IMKTextInput 協定；2）有濫用內文組字區的嫌疑。您可以勾選上述客體應用、以啟用下述特性：啟用浮動組字窗、且對組字區內容設定容量上限（最多二十個讀音）。
頁面 11：服務設定
編輯選字窗內可由「(Shift+)符號選單鍵」呼出的服務選單內容。呼出服務選單時，原選字窗高亮選中的候選字詞會成為各功能的處理參數；若無可用服務，該熱鍵在選字窗內會改為輔助翻頁。
操作
| 按鈕 | 作用 |
|---|---|
新增服務（+） | 開啟輸入框貼入服務定義。 |
移除所選（-） | 移除選中條目。 |
| 上移／下移 | 調整服務在選單中的順序。 |
| 全部拷貝到剪貼簿 | 將所有服務以 名稱\t定義 格式拷貝。 |
填寫指引（?） | 顯示資料填寫規則。 |
| 恢復原廠設定 | 將服務清單重置為出廠預設。 |
表格兩欄：「選單條目名稱」與「定義資料值」。也可拖入文字檔以追加條目。
填寫規則
每行一筆定義，選單條目名稱與定義資料值以 Tab 字元分割。選單名稱當中的「%s」會在使用服務時被置換成傳入的參數；若參數只有一個字元，則程式會自動在選單名稱結尾用括弧追加顯示其萬國碼碼位。定義資料值的開頭是「@SEL:」（呼叫唯音內部預先定義的功能，須以西文半形冒號結尾）或「@WEB:」／「@URL:」（緊接著填網址，網址中的「%s」會被置換成參數）。
出廠預設服務
預設包含：Unicode Metadata、macOS Dict、Bing、DuckDuckGo、Ecosia、Google、MoeDict、Wikitonary、Unihan、Zi-Hi、HTML Ruby Zhuyin／Pinyin、Zhuyin／Pinyin Annotation、Braille 1947／2018、Baidu、BiliBili、Genshin BiliWiki、HSR BiliWiki 等共 20 筆。
頁面 12：開發道場
警告：該頁面僅作未來功能測試所用。在此列出的功能並非處於完全可用之狀態。
該頁面某些先前曾經有過的選項已被移往其它頁籤。
選項
| 選項 | 預設 | 作用與影響 | 滿足的需求 |
|---|---|---|---|
| 針對所有客體軟體啟用強化型組字區安全防護 | 關 | 阻止任何客體擅自存取尚未遞交的組字區內容；會全域啟用浮動組字窗。 | 機敏環境防止組字區被窺探。 |
| 對基於 Electron 技術構建的客體軟體一律強制啟用浮動組字窗 | 開 | Electron 客體的 IMKTextInput 實作行為難以預測，故預設開啟。 | 規避 Electron App 的 IMK 相容問題。 |
| 針對被管理的客體，在標記模式下禁用分段式粗型下劃線 | 關 | 部分 Web 前端客體無法正常繪製分段式粗型下劃線；此選項阻止輸入法傳達該繪製請求，僅影響內文組字區。 | 修正 Web 客體的下劃線顯示異常。 |
| 主動偵測正在濫用 SecureEventInput API 的後檯執行緒 | 開 | 該濫用會使所有第三方輸入法在選單內變灰無法使用。開啟後主動偵測此狀況。 | 找出導致輸入法失效的元兇。 |
| 暫時停用使用者片語資料庫 | 關 | 忽略使用者片語辭典目錄內所有可編輯資料（關聯詞語除外）。開發者可能請您啟用以協助診斷組句故障。 | 診斷組句問題是否與使用者資料有關。 |
| 允許對單個漢字進行升權或排除 | 關 | ⚠️💀 可能妨礙組句函式使其無法給出正確結果；開發者極力勸阻啟用。 | 進階玩家手動調整單字權重。 |
偏好設定 JSON 交換
提供「匯出」與「匯入」按鈕，可將偏好設定匯出為 vChewing_Preferences.json 或從 JSON 匯入。說明：
允許將目前的偏好設定匯出為 JSON 檔案、或從 JSON 檔案匯入偏好設定。涉及沙箱安全權限的路徑設定與介面語言設定不在交換範圍內。
匯入後會顯示成功筆數與失敗筆數，並列出每筆失敗的鍵與原因。
舊版介面差異
macOS 10.13 與 10.14 使用舊版 AppKit 偏好設定介面。其頁面集合與順序與新版完全相同（十二個頁面、同樣的標題與順序），主要差異如下：
- 呈現方式：舊版為自訂
NSWindow＋左側欄＋右側捲動內容區（10.13 不包捲動視窗以避免輸入法行程凍結）；新版為 SwiftUINavigationSplitView與Form。舊版部分頁面（行為、選字、辭典、開發道場）以NSTabView子分頁（Ａ–Ｅ）分組，新版則攤平為表單區段。 - 圖示：舊版在 10.13/10.14 使用傳統模板 PNG（
PrefToolbar-<名稱>），因 SF Symbols 需 macOS 11 以上。 - 因系統版本而隱藏的選項（舊版直接隱藏、新版則保留但停用）：
通知飄窗配色外觀：需 macOS 10.14（10.13 隱藏）。以 Caps Lock 切換…顯示通知：需 macOS 12（10.13/10.14 隱藏）。以 Shift 切換…顯示通知：需 macOS 10.15（10.13/10.14 隱藏）。允許使用左/右 Shift 切換英數輸入模式：需 macOS 10.15（10.13/10.14 隱藏）。
- 以「需 macOS 10.15」標註但仍可互動的選項（舊版渲染時自動在下方加註系統需求文字）：
不使用唯音輸入法內建的 Caps Lock 處理、使「Shift 鍵／JIS 英数鍵」英數模式關閉狀態與 Caps Lock 同步。新版在 10.15 以下會將這些選項停用並把需求寫在區段註腳。 - 位置差異：
廉恥模式（4 月 1 日彩蛋）在舊版位於「行為設定」，新版則移至「一般設定」。 - 細節差異：舊版「行為設定」的 BPMFVS 選項下方無 GitHub 連結；新版在英文介面下會停用「始終使用橫排來顯示工具提示視窗」。
$ EOF.
