---
parent: 使用手冊
sort: 7
has_toc: true
---
# 偏好設定

> 本文的原始 markdown 可以[點此存取](https://raw.githubusercontent.com/vChewing/vChewing.github.io/refs/heads/main/manual/preferences.md)，以便使用者轉交給各種 AI 服務代為閱讀講解。

本文對應至少唯音輸入法 4.5.4 版（SwiftUI 偏好設定介面，需 macOS 14 以上）。本文逐頁、逐選項講解偏好設定介面當中每一個選項的作用、影響、以及可能用來滿足的使用者需求。

> macOS 10.13 與 10.14 系統使用的是舊版 AppKit 偏好設定介面（外觀與互動細節不同，但選項集合基本一致）。舊版介面會隱藏少數需要較新系統版本的選項（例如需要 macOS 10.15 / 12 的通知相關選項），相關差異會在文末〈舊版介面差異〉一節統整。

- [偏好設定](#偏好設定)
  - [介面概觀](#介面概觀)
  - [頁面 1：關於唯音](#頁面-1關於唯音)
  - [頁面 2：一般設定](#頁面-2一般設定)
  - [頁面 3：選字設定](#頁面-3選字設定)
  - [頁面 4：行為設定](#頁面-4行為設定)
  - [頁面 5：輸出設定](#頁面-5輸出設定)
  - [頁面 6：辭典設定](#頁面-6辭典設定)
  - [頁面 7：語彙編輯](#頁面-7語彙編輯)
  - [頁面 8：磁帶設定](#頁面-8磁帶設定)
  - [頁面 9：鍵盤設定](#頁面-9鍵盤設定)
  - [頁面 10：客體設定](#頁面-10客體設定)
  - [頁面 11：服務設定](#頁面-11服務設定)
  - [頁面 12：開發道場](#頁面-12開發道場)
  - [舊版介面差異](#舊版介面差異)

## 介面概觀

偏好設定視窗採側邊欄＋內容區的雙欄式設計。側邊欄自上而下依序為橫幅圖片、搜尋框（⌘F）、十二個頁面圖示列表、版本編號、與官方網站連結。內容區為當前選中頁面的表單。預設進入時選中的是「一般設定」。

側邊欄列表順序如下，本文亦按此順序逐頁講解：

1. 關於唯音（`info.circle.fill`）
2. 一般設定（`wrench.and.screwdriver.fill`）
3. 選字設定（`filemenu.and.selection`）
4. 行為設定（`switch.2`）
5. 輸出設定（`text.append`）
6. 辭典設定（`text.book.closed.fill`）
7. 語彙編輯（`tablecells.badge.ellipsis`）
8. 磁帶設定（`externaldrive.fill.badge.plus`）
9. 鍵盤設定（`keyboard.macwindow`）
10. 客體設定（`square.and.pencil`）
11. 服務設定（`gearshape.fill`）
12. 開發道場（`pc`）

> 「語彙編輯」「客體設定」「服務設定」三個頁面不會在頁面內顯示搜尋欄，但仍然可被全域搜尋（⌘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 切換狀態。 |
| **始終使用橫排來顯示工具提示視窗** | 關 | 縱排輸入時工具提示內的按鍵名稱會以符號顯示。英文介面下此項被停用。 | 縱排書寫時偏好橫排提示。 |
| **蜂鳴音效** | 使用唯音音效 | 敲錯字時的提示音來源。`靜音` / `使用系統音效` / `使用唯音音效`。 | 不想被打擾或想用自帶音效。 |

### 混合輸入

| 選項 | 預設 | 作用與影響 | 滿足的需求 |
| - | - | - | - |
| **啟用中英混合輸入回退** | 關 | 將注音排列可覆蓋的 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 注音標記`。磁帶模式下改為遞交括弧註解標記；點字需求建議用專門軟體；BPMFVS 需另裝專用字型。 | 教材排版、點字／盲文、注音標記輸出。 |
| **在組字區同步反映 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 燈亮時無效。

---

## 頁面 5：輸出設定

控制遞交出去的文字如何被轉換與整理。

| 選項 | 預設 | 作用與影響 | 滿足的需求 |
| - | - | - | - |
| **自動將繁體中文字轉為康熙正體字** | 關 | 遞交時自動轉康熙正體；與下一項互斥（同時開啟會自動關掉另一項）。 | 印刷／古籍排版需求。 |
| **自動將繁體中文字轉為日文 JIS 新字體** | 關 | 遞交時自動轉 JIS 新字體；與上一項互斥。 | 在 Amazon Japan 等日文環境檢索。 |
| **Ctrl(+Option)+Command+Enter 輸出漢語拼音而非注音** | 關 | 該熱鍵組合輸出改為漢語拼音（實際內容受行為設定影響）。 | 需要輸出拼音的場合。 |
| **在遞交時清理未完成拼寫的讀音或字根** | 開 | 遞交時清掉未完成的讀音／字根。 | 避免遞交殘留的無效讀音。 |
| **羅馬數字輸出格式** | ASCII 大寫 | 羅馬數字輸入模式（敲 Opt+符號選單鍵切換，支援 1–3999）的輸出格式。`ASCII 大寫` / `ASCII 小寫` / `萬國碼羅馬數字(大寫)` / `萬國碼羅馬數字(小寫)`。輸入完成或失敗後自動關閉該模式。 | 選擇羅馬數字字元種類。 |

### 實驗性

| 選項 | 預設 | 作用與影響 | 滿足的需求 |
| - | - | - | - |
| **在縱排書寫時，強制轉換標點為縱排形式（不推薦）** | 關 | ⚠ 僅當排版字型不支援縱排標點動態顯示時才有用。一旦使用，已輸入標點會被永久轉為靜態縱排標點，即使改成橫排也仍是縱排字元。 | 少數不支援縱排標點的字型。 |

---

## 頁面 6：辭典設定

管理使用者資料夾、辭典來源、過濾與匯入。

### 使用者資料夾

| 項目 | 內容 |
| - | - |
| **使用者資料夾路徑** | 指定使用者片語辭典目錄；可拖入資料夾、用「...」按鈕選取（按住 Option 則在 Finder 顯示）、用「↻」按鈕重設為預設。無效值會被忽略。說明：⚠️💀 請避免使用由 iCloud 代管的「Documents」與「Desktop」目錄，這些位置的 sandbox bookmark 可能在重新開機或系統更新後失效。更換目錄時會詢問是否合併舊資料到新路徑。 |
| **自動偵測並載入使用者片語檔案變更** | 預設開。下方有安全說明：使用者片語檔案不支援 shell script。 |

### 辭典／語言模型選項

| 選項 | 預設 | 作用與影響 | 滿足的需求 |
| - | - | - | - |
| **對所有單漢字候選字強制施加倚天中文DOS系統排序** | 開 | 對候選字順序有強烈手動調整需求的使用者（多為倚天 DOS 老用戶）。逐字選字模式始終遵循此排序、不受此開關影響。 | 倚天 DOS 候選字排序習慣。 |
| **盡量使用外置原廠辭典檔案** | 關 | 優先使用 libvChewing-Data 的 make install 部署的原廠辭典。 | 進階使用者自管辭典檔。 |
| **僅繁體中文: 原廠辭典僅傳回符合全字庫讀音的結果** | 關 | 不符合全字庫讀音的單漢字候選會被降權至列表尾端（而非移除）。 | 繁體審音嚴格的使用者。 |
| **濾除掉與輸入模式不相符的漢字候選** | 關 | 移除僅存在於相反輸入模式的單漢字候選；倚天與 CNS 全字庫漢字不受影響；過濾範圍僅限 Unicode 1.0.1 漢字。 | 不想在繁體模式看到簡體特有字（反之亦然）。 |
| **啟用 CNS11643 全字庫支援** | 關 | 啟用 CNS11643 全字庫支援。 | 需要全字庫收字範圍。 |
| **啟用包括少許繪文字在內的符號輸入支援** | 開 | 啟用符號輸入（含少量 Emoji）。 | 符號／Emoji 輸入。 |
| **以使用者提供的 symbols.dat 資料完全取代層級符號選單內容** | 開 | 未按修飾鍵單擊符號選單鍵時觸發層級符號選單。啟用後僅顯示使用者 `symbols.dat` 內容；關閉則改為追加至出廠符號選單根節點末尾。 | 完全自訂符號選單。 |
| **啟用語彙置換表** | 關 | 對指定候選字詞整詞取代；啟用時會載入使用者語彙置換表。 | 批量替換特定詞彙。 |
| **停用原廠假名音節資料** | 關 | 原廠辭典不再供應假名音節資料。中英混輸回退時若嫌假名候選干擾可開啟。 | 不需要假名候選的使用者。 |

### 漸退記憶模組（POM）

| 選項 | 預設 | 作用與影響 | 滿足的需求 |
| - | - | - | - |
| **在敲字時自動套用來自漸退記憶模組的建議** | 開 | 漸退記憶模組僅持有臨時記憶，每筆記錄在六天內逐漸失效；可由輸入法選單清除全部記錄。 | 自動學習近期常用字詞。 |
| **啟用急速遺忘模式** | 關 | 遺忘週期從約一週降至 12 小時內，更快清除不常用記錄。 | 不想被近期偶用詞干擾。 |

### 自奇摩輸入法匯入

提供兩個按鈕：用「…」選取 `.txt`／`.db` 檔匯入，或「直接匯入」互動式動式匯入。匯入完成後顯示找到與實際匯入的筆數，未全部匯入時另顯示後續注意事項。

---

## 頁面 7：語彙編輯

這是一個內嵌的語彙編輯器，用來直接編輯使用者各類詞彙資料檔。詳細的檔案格式請另見《[使用者片語辭典目錄](./userPhrases.md)》。

### 工具列

| 按鈕 | 作用 |
| - | - |
| 輸入模式選單 | 切換編輯簡體或繁體的資料（依當前輸入法模式排序）。 |
| 資料類型選單 | 切換編輯哪一類資料（見下表）。 |
| 重新載入 | 重新讀取磁碟上的檔案內容。 |
| 整理 | 執行整理（去重、排序）；對「自訂語彙」另會標記與原廠重複的條目。 |
| 存檔 | 將編輯內容寫回磁碟並重載語言模型（⌘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`。

### 排列與佈局

| 選項 | 預設 | 作用與影響 | 滿足的需求 |
| - | - | - | - |
| **注音排列:** | 大千排列 (微軟標準/王安/零壹/仲鼎/國喬) | 指定普通話/國音分析器所用的注音排列，亦提供各式拼音。說明：在拼音輸入模式下，若前後半徑 ±10 掃描範圍內存在不完全拼寫（如聲調缺失）的讀音，組字引擎可能套用「最長 4 個讀音」的候選組字上限；當且僅當該範圍內所有讀音皆完整且帶聲調時才不套用。可選：大千傳統 / 倚天傳統 / IBM / 神通 / 精業 / 偽精業 / 酷音大千二十六鍵 / 倚天忘形 26 鍵 / 許氏國音自然 / 星光 / 劉又銘擬音注音 / 漢語拼音+數字標調 / 國音二式+數字標調 / 耶魯拼音+數字標調 / 華羅拼音+數字標調 / 通用拼音+數字標調 / 韋氏拼音+數字標調。 | 各種注音／拼音排列習慣，詳見《[注音鍵盤排列參考清單](./arranges.md)》。 |
| **基礎鍵盤佈局:** | ZhuyinBopomofo | 選 macOS 基礎鍵盤佈局；QWERTY 以外的英數佈局是為拼音使用者準備。若注音排列非拼音、也非受西文鍵盤影響的注音排列（倚天 26 鍵、許氏等），則此選項僅影響螢幕鍵盤。 | 拼音使用者選用 Dvorak 等佈局。 |
| **英數鍵盤佈局:** | ABC | 僅用於 Shift 英數輸入模式的鍵盤佈局。 | 英數模式用特定佈局。 |

### 鍵盤熱鍵

下方為十個熱鍵開關（兩欄），控制各功能熱鍵是否啟用，預設皆為開：

| 左欄 | 右欄 |
| - | - |
| 模擬逐字選字輸入 | 注音反查 |
| 關聯詞語模式 | JIS 新字體模式 |
| 全字庫模式 | 半形標點模式 |
| 康熙正體字模式 | 大寫漢字數字輸出 |
| CIN 磁帶模式 | 簡體/繁體中文輸入模式切換 |

> 關於這些功能本身的作用，請參見《[文字切換(半形/中英…)](./toggles.md)》與《[鍵盤熱鍵使用手冊](./shortcuts.md)》。

---

## 頁面 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 不包捲動視窗以避免輸入法行程凍結）；新版為 SwiftUI `NavigationSplitView` 與 `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.