YUME·宇夢輸入系統
下載地址
- GitHub 發佈頁——版本最全、最新。
- 永碩網盤——訪問 GitHub 不便時。
- QQ 交流羣文件——點此加羣。
找 Rime，或者别的安裝方式？
本頁講的是宇浩自研的輸入法程序（宇夢）。Rime 掛載方案，以及各平臺上的其他安裝辦法，在《各平臺下載和安裝》那一頁。
開篇：宇夢是什麼
宇夢（YUME）是宇浩自研的原生輸入法程序：一個 Rust 內核，加上各平臺的原生界面。它不依賴 Rime，也不依賴任何第三方輸入法。下載即用，不需要部署，不需要編輯配置文件。
它與《各平臺下載和安裝》所講的 Rime 掛載方案是並列關係，而非取代關係。想要 Rime 的生態與可配置性，走那條路；想要開箱即用、設置全在菜單裏，走這條路。碼表、拆分、字集三者，兩邊同源。
靈明、星陳、卿雲、日月、拼音五個方案內置，隨時切換；也可以上傳自己的碼表，當場編成一個可用的方案。
一句話點題：確定帶來自由。每個漢字基本對應唯一編碼，打字不必停下來挑字。
一、安裝
1.1 選哪個版本
| 版本 | 是否需要安裝 | 適合 |
|---|---|---|
| Windows 便攜版 | 解壓即用 | 絕大多數人；公司電腦、無管理員權限、U 盤 |
| Windows 安裝版（TSF） | 需管理員，一次性 | 想要內嵌輸入欄、想讓系統把它當正式鍵盤 |
| macOS 版 | 拖進文件夾 | Mac 用户 |
拿不定主意就用便攜版。兩者功能已經齊平，差別只有內嵌輸入欄一項。
1.2 Windows 便攜版：解壓即用
- 下載
Yume-Portable-*.zip，把整個Yume文件夾解壓到可寫的位置（桌面、文檔、U 盤皆可）。 - 雙擊
YumePortable.exe。 - 任務欄右下角出現紫色「宇」圖標即已就緒，直接在任何輸入框打字。
- 右鍵該圖標即是全部設置。
不要解壓到 C:\Program Files
便攜版要在自己的文件夾裏寫設置和詞庫，那個位置沒有寫權限。直接在壓縮包的預覽窗口裏運行，同理。程序會當場報錯，而不是默默把你的設置丟掉。
1.3 Windows 安裝版（TSF）
- 下載
Yume-Setup-*.exe並運行。SmartScreen 會攔一次，點「更多信息 ▸ 仍要運行」——安裝包沒有做代碼簽名。 - 設置 ▸ 時間和語言 ▸ 語言和區域 ▸ 中文 ▸ 語言選項 ▸ 鍵盤 ▸ 添加鍵盤 ▸ 宇浩。
- 按
Win+空格切到宇浩。托盤圖標爲藍色。
1.4 macOS
- 把
Yume.app拖進~/Library/Input Methods/。 - 註銷重新登入一次。只有首次安裝需要，以後更新不必。
- 系統設置 ▸ 鍵盤 ▸ 輸入法 ▸ ＋ ▸ 中文 ▸ 靈明 ▸ 添加。
按 ⌃空格 切換。設置菜單在系統菜單欄的輸入法圖標下。
1.5 更新與卸載
- 便攜版：托盤菜單「檢查本輸入法更新包」只做提示並打開下載頁——它蓋不掉正在運行的自己。下了新包後把
Resources\和 exe 覆蓋舊的即可。UserData\不在壓縮包內，設置和詞庫不會丟。 卸載就是删掉文件夾。 - 安裝版：托盤菜單「檢查本輸入法更新包」直接下載並安裝。卸載走「應用和功能」。
- macOS：菜單裏檢查更新，自動下載安裝。
1.6 其他平臺
網頁版 https://yume.shurufa.app 免安裝，可以先試手感，功能是桌面版的子集。
Linux（fcitx5）內核已經就緒，界面尚未實作。
二、開始輸入
2.1 先認清你的方案屬於哪一類
宇浩四個形碼方案分兩家，分界是一個字的編碼怎麼結束。兩家的打字節奏不同，後面的上屏模式和手動切分還要各用一次這條分界，所以放在最前。
| 星陳・卿雲 | 靈明・日月 | |
|---|---|---|
| 類型 | 限長方案 | 自定碼方案（前綴碼） |
| 最大碼長 | 4 | 靈明 4、日月 5 |
| 一個字怎麼結束 | 打滿最大碼長，或按空格 | 末碼是韻碼，編碼自報結束 |
| 編碼分割 | 不唯一，需分隔 | 唯一 |
| 手感近於 | 五筆、鄭碼 | —— |
拼音方案不在此表——它只走整句模式。
2.2 限長方案：星陳、卿雲
- 全碼四碼。打滿四碼自動上屏，不必再按空格。
- 不滿四碼的簡碼，按空格上屏。這裏的空格既是分隔符，也可以看作簡碼的最後一碼。
以星陳打「不用等候」爲例：
| 字 | 編碼 | 碼長 | 怎麼上屏 |
|---|---|---|---|
| 不 | v | 一級簡碼 | 按空格 |
| 用 | sy | 二級簡碼 | 按空格 |
| 等 | gh | 二級簡碼 | 按空格 |
| 候 | eubj | 全碼 | 滿四碼，自動上屏 |
整串按鍵是 v␣sy␣gh␣eubj。
2.3 自定碼方案：靈明、日月
字根的末碼落在 a e i o u 五個韻碼上。韻碼與輔音兩區互斥，所以編碼自己知道自己在哪裏結束——連續敲下去就行，中途不需要空格。
舉例
靈明連打 eioua，屏幕上依次出現「的是我不了」。五個字一氣呵成，中間一次停頓也沒有。
韻碼之外，打滿最大碼長同樣自動上屏（靈明 4、日月 5）。
這就是首頁所説的「確定帶來自由」。
2.4 候選、選重與翻頁
分家到此爲止，以下各節兩類方案通用。
| 鍵 | 作用 |
|---|---|
1–9 | 選第 1–9 個候選 |
; | 選第 2 個候選 |
' | 選第 3 個候選 |
- = | 上／下一頁 |
← → | 上／下一頁（豎排佈局） |
↑ ↓ | 上／下一頁（橫排佈局） |
宇浩重碼極低，多數字一次到位，選重鍵平時用不上。
2.5 空格與回車
- 空格：有候選則上屏高亮候選；有編碼但沒有候選（半段碼）則原樣上屏編碼；沒有編碼則打出一個空格。
- 回車：緩衝非空時，一律把編碼原樣上屏。打英文單詞時很順手。
- 退格：逐碼删。Esc：清空。
這幾個鍵各自做什麼並不是寫死的，Esc Tab ; ' ` 等等也一樣，都可以在功能鍵設置裏改，見第四章。
2.6 中英與標點
- 單擊 Shift 切中／英。
- 組字中打大寫字母：出廠檔位是「上屏高亮候選並切換臨時英文模式」——先把已經打好的字送出去，再讓你打那個英文詞，空格上屏之後自己回中文，不必爲了一個詞來回按兩次 Shift。
- 空緩衝時打數字：出廠是直接上屏，而緊跟數字的
. , :由下一鍵決定寬度——3.14出半角，我今年30。出全角，同一串按鍵。 - 中文模式下英文標點自動轉全角中文標點，引號自動開合。有編碼時先上屏首選，再出標點。
大寫字母與數字鍵各有五檔（設置面板「上屏」一節）
大寫字母：
| 檔位 | 打完之後停在哪裏 |
|---|---|
| 上屏高亮候選並切換英文模式 | 留在英文，自己按 Shift 回 |
| 上屏輸入編碼並切換英文模式 | 同上，但上屏的是原碼 |
| 臨時英文模式 | 字母攢進緩衝，空格纔上屏 |
| 上屏高亮候選並切換臨時英文〔出廠〕 | 這一串打完自己回中文 |
| 上屏高亮候選及本字母 | 不切語言，下一鍵仍是漢字 |
最後一檔是爲 IBM電腦、A股、第X章 這種夾在漢字裏的單個大寫字母而設的：切過去再切回來是多餘的。
數字鍵：
| 檔位 | 數字後那個 . , : |
|---|---|
| 直接上屏，標點由下一鍵定〔出廠〕 | 下一鍵是數字則半角，否則全角 |
| 直接上屏，數字後的標點用半角 | 一律半角，零延遲 |
| 直接上屏，標點寬度跟隨全局定義 | 不作判斷 |
| 直接上屏，並切換至英文模式 | 隨英文模式 |
| 不直接上屏，數字進入緩存區 | 數字先攢在編碼區 |
半角標點模式下這幾檔沒有分別——那裏所有標點本來就是半角。
2.7 用 z 反查拼音、叫回歷史
空緩衝按 z 進拼音反查，可以整句解碼；註釋欄會告訴你這個字的形碼編碼，所以它同時是一件學習工具：想不起某個字怎麼打，用拼音把它找出來，順手就看到了編碼。
z 也可以叫回最近上屏過的內容。
2.8 按鍵速查表
| 鍵 | 空緩衝時 | 組字中 |
|---|---|---|
a–y | 開始編碼 | 繼續編碼 |
z | 拼音反查／叫歷史 | （方案自用） |
1–9 | 打出數字 | 選第 1–9 個候選 |
; | 快捷字符面板 | 選第 2 個候選 |
' | 標點 | 選第 3 個候選 |
/ | 斜線命令面板 | 循環注解檔位 |
` | 標點 | 手動切分／快捷造詞 |
- = | 臨時數字模式／標點 | 上／下一頁 |
| 空格 | 打出空格 | 上屏高亮候選 |
| 回車 | 換行 | 原樣上屏編碼 |
| 退格 | 交還程序 | 删一碼 |
Esc | 交還程序 | 清空編碼 |
單擊 Shift | 中／英切換 | 中／英切換 |
Tab | 交還程序 | 查閱面板 |
⇧Tab | 交還程序 | 相似部件面板 |
← → ↑ ↓ | 交還程序 | 翻頁／更多候選面板 |
Ctrl+空格 | 暫停／恢復輸入法 | 暫停／恢復輸入法 |
這張表是出廠值，不是死規矩
除了字母與數字，上表每一個鍵在每一種情形下做什麼，都在功能鍵設置裏改得動。
Ctrl+空格僅 Windows：macOS 的 ⌃空格 是系統的輸入源切換鍵，輸入法看不見它。
三、常用設置
3.1 三條路通同一個開關
| 入口 | 怎麼用 | 適合 |
|---|---|---|
| 設置面板 | Ctrl+Shift+O，或托盤菜單「設置」 | 第一次設置、看全貌 |
| 斜線命令 | 空緩衝打 /，再打命令名，如 /mode | 打字中途、手不離鍵盤 |
| 快捷鍵 | Ctrl+Shift+ 某鍵 | 高頻切換 |
三條路改的是同一個值，改完立刻生效，沒有確認按鈕。
設置面板共十二節：輸入方案、拼音設置、上屏、整句、字集、自定義字集、詞語、候選外觀、注解、功能鍵、快捷字符、關於。面板上的每一行永遠畫得出、設得動；某一項此刻管不管用，由節首的一句話説明，不靠灰掉或藏起來——一個此刻不生效的值仍然存得下，換個方案、換個佈局就當場作數。
3.2 方案
內置五個方案：靈明、星陳、卿雲、日月四個宇浩系列形碼，加一個拼音（全拼，可切雙拼）。
Ctrl+Shift+N在形碼方案間循環，/schema。Ctrl+Shift+I進出拼音，/pinyin。
各方案的字根與規則見《靈明》《星陳》《日月》等既有頁面，本文不重複。
3.3 上屏模式：三選一
這一節決定打字手感，值得看清楚。
| 模式 | 行爲 | 適合 |
|---|---|---|
| 頂字上屏模式〔出廠〕 | 延遲一字，下一字的編碼把前一字「頂」上屏 | 絕大多數人 |
| 自動上屏模式 | 編碼一旦唯一確定即上屏 | 追求無停頓、盲打 |
| 整句輸入模式 | 連打一串，由語言模型切分成句，一次上屏 | 長句、詞語多、拼音方案 |
Ctrl+Shift+M 循環，/mode。
整句模式下，兩類方案的行爲不同
這是 2.1 那條分界線的第二次現身。
限長方案（星陳、卿雲）在整句模式下默認只認全碼，簡碼不進整句。原因是沒有韻碼作邊界，簡碼只是全碼的前綴，整句無從判斷它到哪裏結束。
自定碼方案（靈明、日月）沒有這個限制，簡碼照用。
要在整句裏用簡碼，有兩條路：打開下一節的空格鍵分割，或者用第六章的手動切分符親手畫一道界。
3.4 整句：字集軌、空格鍵與語言模型
設置面板「整句」一節。這一節只在整句輸入模式下起作用（拼音方案強制整句），另外 z 反查也走這一套；形碼逐字輸入時它們不起作用。
整句字集軌
一條軌就是一個字集，次序即優先級。
- 不屬於本軌字集的漢字被降權，但仍然打得出來——是降權，不是過濾。
- 首軌決定預編輯欄的切分和候選列表；每多開一軌就多出一句候選（簡繁同形時自動去重），於是同一串編碼可以一次看到簡體與傳統兩句。
- 停用不需要的軌可以少算一些，延遲更低。
下一節的字集過濾與排序管的是逐字輸入的候選，整句的候選出自這裏，兩處不要混——整句網格按軌的罰分排序，並不硬過濾。
空格鍵分割
整句模式下，空格鍵除了上屏之外，還可以告訴分詞器「我打的這一段編碼到此爲止」。同一個位置只能宣告一次：第一下是分割，第二下就是上屏。
三檔：不使用空格鍵分割〔出廠〕／只用空格鍵分割未完成的編碼段／用空格鍵分割所有編碼段。
「未完成的編碼段」是什麼意思
指這一段編碼不是自定（字分割）的——不以自分割字母（韻碼）結尾，且沒有打滿最大碼長。靈明的 hde（可以）是自定的，卿雲的 yd（现在）不是。
第二檔只允許空格鍵提示非字分割的編碼，所以句末如果打的是全碼，不必多按一下空格；第三檔允許空格鍵提示一切編碼段，故而上屏需要再按一下空格。傳統的限長方案（星陳、卿雲）本來就不是自定的，因此這兩檔對它們沒有區別。
只有開啓了空格分割，簡碼字詞纔進得了整句（但同一個簡碼位只允許碼表裏排在最前的那一條）。本設置只作用於形碼；有些方案中空格鍵本身就是編碼，那時空格會先認定爲普通編碼。
語言模型
整句要判斷一串編碼該切成哪幾個詞，靠的是語言模型：模型越大，整句越準。它是編譯好的二進制文件，運行時佔用的內存基本等於文件大小，所以出廠自帶的是小的那一份。
「掛載模型……」可以換上更大的一份（.ygram 文件），掛載時宇夢會把它複製一份到自己的目錄；「用出廠模型」隨時退回去。
3.5 字集：過濾與排序
兩個獨立的開關，不要混爲一談：過濾是不顯示，排序是顯示但後置。
- 過濾：全部漢字／僅常用漢字／僅簡化漢字／僅傳統漢字／僅自定義字集。
Ctrl+Shift+0循環，/charset。 - 排序：原始排序／常用字優先／簡化字優先／傳統字優先／自定義字集優先。沒有快捷鍵，走菜單。
兩個常見配法
只打現代簡體，過濾選「僅簡化漢字」；打古籍，過濾選「全部」，再加排序「傳統字優先」。
同一節還有兩項：顯示變體漢字（/variation），以及字形選項。後者是説，同一個字在陸臺港拆得不一樣時，碼表把每種拆法的編碼都收了——「今」既是 ntwi（人丶），也是 nfwi（人一）——這一組勾選決定候選列表留哪幾種：主要拆分、臺灣拆分、香港拆分，至少留一項。
3.6 單字派
三檔：字詞同出／主單副詞／嚴格單字。Ctrl+Shift+D，/word。
這一項存了兩份
逐字輸入與整句輸入各記一份。出廠值逐字是「字詞同出」，整句是「嚴格單字」——整句本來就會自己組詞，詞語候選再擠進來反而更差，這是量出來的。
「主單副詞」下具體顯示哪幾類詞語，另有五個勾選，見第四章。
3.7 注解
注解是候選旁邊那一小行字。檔位是自己定的：一檔就是一組勾選，七欄任選——拆分、全息拆分、編碼、拼音、字義、字集、統一碼碼位。出廠給了兩檔：二重注解（拆分＋分節碼）和多重注解（再加讀音、字義、字集、碼位）。
Ctrl+Shift+/ 在各檔之間循環，/comment；組字中單按 / 也可以循環（拼音方案除外）。
「關閉注解」不是一檔
它是一欄都不勾。所以每一檔至少要留一欄——取消最後一欄等於關閉注解，那是另一回事。
設置面板「注解」一節可以增删檔位，最多八檔。某一檔勾的欄目在當前方案下無從顯示（例如拼音方案沒有拆分），該檔自動從菜單與循環中隱去。
學習期建議開多重。
3.8 候選面板外觀
這幾項都是設一次就不動的。
- 候選佈局：傳統豎排／簡約橫排／極簡內嵌。
Ctrl+Shift+L，/layout。極簡內嵌僅安裝版與 macOS 有。 - 每頁候選數 3–9：
Ctrl+Shift+3到Ctrl+Shift+9。 - 序號欄、註腳欄的顯隱：
/index、/foot；註釋欄只在設置面板裏開關。 - 半角／全角標點：
Ctrl+Shift+.，/punc。 - 預測候選（僅差韻碼即成字的提示）：
Ctrl+Shift+Y。 - 空格簡碼、變體漢字的顯隱：
Ctrl+Shift+K、/variation。 - 空空如也（完全隱藏候選面板）：
Ctrl+Shift+H。
欄位受佈局限制
註腳欄與註釋欄只有傳統豎排畫得出來，極簡內嵌連序號欄也不畫。那幾項此刻設了不顯示，換回豎排就回來。
3.9 輸入欄畫在哪裏
本節僅適用於 Windows 安裝版與 macOS
便攜版靠全局鍵盤鈎子工作，宿主程序裏沒有可供繪製的預編輯區，所以沒有「內嵌輸入欄」「內嵌時預覽首選」「極簡內嵌佈局」三項。這是設計取捨，不是缺陷；便攜版其餘功能與安裝版齊平。
正在打的那串編碼畫在哪裏，是個二選一：內嵌輸入欄畫在光標處（/preedit），表頭輸入欄畫在候選面板的頂上（/head）。
畫什麼又是一個二選一（/preview）：保持編碼，或預覽首選——把首選漢字而不是編碼畫在那裏。
四項都走菜單，沒有快捷鍵。
3.10 還原默認與恢復出廠
兩個不同的東西，都在設置面板「關於」一節裏，也都要確認一次。
| 動作 | 抹掉什麼 |
|---|---|
還原默認設置（/default） | 只把設置退回出廠值。不動你的數據——用户詞庫、自定義方案、自定義字集、快捷字符表都留着 |
| 恢復出廠設置 | 連數據一起抹掉：用户詞庫、自定義方案、自定義字集、快捷字符表、自定義雙拼佈局、歷史輸入，以及下載過的數據更新包 |
恢復出廠設置抹的是文件
那些文件會進廢紙簍／回收站，還撿得回來。抹完宇夢會重啓，並彈出「輸入方案管理」讓你重新挑方案。
四、進階功能
4.1 快捷字符
空緩衝按 ; 打開 26 鍵對照面板，再按一個字母就上屏一段文本——標點、符號、漢字或整段話都可以。面板另有 ; , . $ 四個固定條目。
菜單「編輯快捷字符表」自定義。26 條全部留空即關閉此功能。
4.2 功能鍵設置
菜單「功能鍵設置……」，或 /key。一張表，回答一件事：每個鍵在三種情形下各做什麼。
三種情形是：沒有編碼、正在組字但沒有候選（打錯字、半段碼）、正在組字且有候選。多數鍵在後兩種情形下做同一件事，那一行就只有一個下拉，第三欄寫「同前列」。改完即時生效，「默認」按鈕一鍵還原。
表裏收十七個鍵：左右 Shift、左右 Control、大寫鎖定、Esc、回車、空格、Tab，加上 / ; ' ` , . - = 八個標點鍵。方向鍵與數字鍵 1–9 不在表內——它們的行爲與候選佈局綁死（豎排用 ←→、橫排用 ↑↓）。
可綁的二十四個動作
中英切換、臨時英文模式、清除編碼、清除編碼分節、上屏輸入編碼、上屏首選、上屏高亮候選、上屏高亮候選並切換英文模式、上屏輸入編碼並切換英文模式、選第二候選、選第三候選、上一頁、下一頁、命令模式、切換注解模式、切換字集過濾、快捷字符、分割編碼、反查／歷史輸入、臨時數字模式、中文標點、查閱面板。
另有兩個特殊值：**「本鍵」把這一鍵原樣交還宿主程序，「無動作」**吃掉它。
三條要留意的規矩：
- 綁定是全局一份，不按方案各記一份。
- 方案佔用讓位：方案拿某個鍵當編碼鍵時（微軟／紫光雙拼佈局的
;、用掉了z的自定義碼表的`），那一鍵照舊進編碼。面板照畫不灰，只標一句説明。 - 「選第二／第三候選」自帶回退：候選不夠時落回同一鍵「正在組字」那一欄的動作——所以
;在候選少於兩個時仍舊開快捷字符，'在候選少於三個時仍舊出標點。
大寫鎖定在有的平臺攔不掉，那時該鍵只能附帶動作，面板上會説明。
4.3 符號與 Unicode
/引導符號命令：/tab插一個制表符、/version打出版本號等。//後接十六進制碼位，直接輸出該 Unicode 字符。
宇浩系列另有 fh jm py bd dy yj kk 等編碼引導符，與 Rime 方案相同，見《各平臺下載和安裝》，此處不重複。
4.4 三個浮動面板
都在候選高亮時按。
| 鍵 | 面板 | 用途 |
|---|---|---|
Tab | 查閱面板 | 單字查字統網，詞語查漢典 |
⇧Tab | 相似部件九宮格 | 按拆分字根的子序列檢索同部件字，學習利器 |
←→ 或 ↑↓ | 更多候選格狀面板 | 一屏鋪開全部候選 |
查閱面板一次按鍵、兩路並發：本地的宇浩字料（拆分／各方案編碼／統一碼碼位／字集）先到，在線字典的結果接在分隔線下方。
4.5 用户詞庫
菜單「編輯用户詞庫」，或 Ctrl+Shift+U、/user。
表格式編輯：「字詞」列填內容，「用户編碼」列可以留空（自動編碼），也可以填多個（空格分隔）。
每個方案各有一份，自定義方案也一樣。用户詞庫中的詞語不受單字派限制，一律顯示。
快捷造詞
詞是在打字時想起來的，面板卻在打字之外，於是想起來的那個詞多半就算了。不必開面板：碼表模式（頂字上屏／自動上屏）下，緩衝裏已經有碼時按 `，這一段就當整句打——照常一個一個選字，選完那串字自動進用户詞庫。
舉例
靈明打 ksdo`fi，選「知」、選「一」，「知一」就進了詞庫。按 Esc 放棄。
整句模式與拼音沒有快捷造詞：那兩處的 ` 本來就是手動切分符，而用户詞庫是形碼的東西。
4.6 更多詞語功能設置
承接單字派那一節。主單副詞模式下，勾選要顯示哪幾類詞語：兩字／三字／四字／四字以上／白名單。出廠五項全關，即開箱只出單字，要哪類自己勾。
靈明方案另有「使用傳統構詞法」一項，其他方案看不到。
4.7 自定義字集
菜單「編輯自定義字集」。可以勾七個現成字集（通用規範漢字、調和傳統漢字、香港常用字、常用與次常用國字、古籍通用規範漢字等）和 Unicode 區塊，再加白名單、黑名單。
面板自帶「測試」框：把字符粘進去，它逐字告訴你會不會顯示、是哪一條勾選在起作用。
定好之後配合「僅自定義字集」使用。
4.8 拼音與雙拼
Ctrl+Shift+I 進出拼音方案。
雙拼有七種預設：自然碼、微軟、搜狗、紫光、拼音加加、智能 ABC、國標。另有自定義佈局編輯器，可以配出任意方案。
z 反查與拼音方案共用同一套佈局設置。
4.9 幾個順手的小功能
- 注解上屏
Ctrl+Shift+A：把高亮候選的注解（拆分、讀音、碼位等）當文本上屏。寫教程、發羣消息時很方便。 - 截圖候選面板
Ctrl+Shift+J：把當前候選面板 2× 重繪後複製到剪貼板。查閱面板打開時按Ctrl+Shift+Alt+J，只截本地那一半，不含在線字典。本文的候選面板圖就是這麼來的。 - 暫停／恢復輸入法
Ctrl+Space（僅 Windows）：所有按鍵直通程序，托盤圖標轉灰。打遊戲、用快捷鍵密集的軟件時用。 - 登入時自動啓動（僅便攜版）：托盤菜單勾選，只寫一個註册表值，取消即淨。
4.10 便攜版引擎（安裝版用户）
安裝版托盤菜單有「使用便攜版引擎」一項，把打字交給便攜版助手——用於文字服務驅動不了的程序。
開啓時會提示你把系統鍵盤佈局切到英文，否則系統選中的另一個輸入法仍會疊加自己的中英狀態和候選窗。高權限窗口下該開關會被拒絕並説明原因。
4.11 模態編輯器（helix、vim）
模態編輯器的 normal 模式裏，h j k l w b 是命令不是字。輸入法不知道這回事，照樣把它們收進編碼區，於是每進出一次 normal 模式就要手動切一次中英。
宇夢提供一條命令，讓編輯器在換模式時自己把輸入法支開、再叫回來。兩個平臺寫法完全一樣：
yume-mode off # 掛起
yume-mode on # 恢復
yume-mode once # 醒一次，上屏過就自動掛回去Windows 安裝版把安裝目錄寫進 PATH。macOS 的 install.sh 建一個指向 app 內可執行文件的軟鏈接——用戶域放 ~/.local/bin，--system 放 /usr/local/bin——裝完會告訴你放在哪裏；那個目錄不在 PATH 上時它也會説。
掛起是整個讓開，不是切英文模式
宇夢自己的快捷鍵（單擊 Shift 切中英、Ctrl+Shift+ 那一排、Ctrl+Space）在掛起期間一併交還編輯器。它也不動中英狀態——掛起前是英文模式，恢復後仍是英文模式。
不想用軟鏈接就寫全路徑，macOS 上是 ~/Library/Input Methods/Yume.app/Contents/MacOS/YumeIME，參數同樣是 off／on（--suspend／--resume 是它們的同義詞）。
先包一層 shell 函數
寫進 ~/.zshrc（或 .bashrc、PowerShell 的 profile）：
hx() { yume-mode off; command hx "$@"; yume-mode on; }這一步別省，它管住 keymap 管不到的兩頭：
- 剛打開編輯器那一下。 helix 起手就在 normal 模式，可還沒有任何鍵被按過，keymap 裏的
yume-mode off從沒機會跑，輸入法是醒着的。 - 退出。
:wq退出時如果停在 normal 模式，掛起就留在終端上沒人來解——那個終端會整個打不出中文。函數裏退出後那個on收尾，:q!、崩潰、Ctrl-C一併覆蓋。
zsh 再加兩行，補上 Ctrl-Z——它把 helix 丟回後臺時上面那個函數還沒返回，掛起會留在終端上：
yume_mode_release() { yume-mode on 2>/dev/null }
precmd_functions+=(yume_mode_release)回到提示符就意味着前臺沒有編輯器在等着打字，那就不該有掛起。
再寫 keymap
寫進 config.toml（Windows 在 %AppData%\helix\，macOS 在 ~/.config/helix/）。[keys.normal] 和 [keys.select] 要各放一份，內容完全一樣——select 模式的入口與 normal 相同，只綁一半的話一進 v 就漏。
[keys.normal] # [keys.select] 照抄同一份
# 進插入模式：一直醒着，靠 [keys.insert] 的 esc 收工
i = [":sh yume-mode on", "insert_mode"]
a = [":sh yume-mode on", "append_mode"]
I = [":sh yume-mode on", "insert_at_line_start"]
A = [":sh yume-mode on", "insert_at_line_end"]
o = [":sh yume-mode on", "open_below"]
O = [":sh yume-mode on", "open_above"]
c = [":sh yume-mode on", "change_selection"]
"A-c" = [":sh yume-mode on", "change_selection_noyank"]
# prompt：helix 沒有 prompt 的鍵位表，進去時得自己叫醒，否則搜不了中文。
# 用 once —— 上屏過就自動掛回去，因爲用 Enter 接受搜索之後沒有任何事件可綁。
"/" = [":sh yume-mode once", "search"]
"?" = [":sh yume-mode once", "rsearch"]
":" = [":sh yume-mode once", "command_mode"]
s = [":sh yume-mode once", "select_regex"]
S = [":sh yume-mode once", "split_selection"]
# 等一個字符：打完那個字直接回 normal 模式，同樣沒有事件
r = [":sh yume-mode once", "replace"]
f = [":sh yume-mode once", "find_next_char"]
F = [":sh yume-mode once", "find_prev_char"]
t = [":sh yume-mode once", "find_till_char"]
T = [":sh yume-mode once", "till_prev_char"]
esc = ["normal_mode", ":sh yume-mode off"]
[keys.insert]
esc = ["normal_mode", ":sh yume-mode off"]改完在 helix 裏敲 :config-reload。
once 的一個限制
一次 prompt 只打得了一段中文。 / 之後第一段上屏就掛回去了，想在同一個搜索裏再打一段，先解掛。
這是沒辦法的事——Enter 那一下終端機直接吞掉了，輸入法根本看不見，所以「上屏」是唯一認得出來的收工信號。
vim / neovim
vim 有模式事件，不必逐鍵綁：
autocmd InsertEnter * silent !yume-mode on
autocmd InsertLeave * silent !yume-mode off幾點説明
- 掛起只管那一個程序，而且切走再切回來仍然有效。 在終端裏掛起，瀏覽器照常打中文；⌘⇥ 出去回來，終端裏還是掛起的，不必重按一次
i。 - helix 的 prompt（
:命令行、/搜索）綁不了鍵，這是 helix 目前的限制。所以那幾個入口只能在按下去的那一下叫醒輸入法，靠once的「上屏即收工」回到掛起。 - Windows 上
once等同於on：那一端還沒有「上屏即收工」，搜完仍要按Esc收工。兩個平臺因此可以共用同一份配置。 - 管理員身份運行的終端無效：系統不允許普通權限的程序向高權限窗口發消息。
- helix 進入插入模式的路子不止上面幾條（
m子模式的 surround 等），漏綁一條的後果只是那一次要手動切，不會出錯。
萬一卡在掛起態
配置漏了哪個入口、編輯器崩在 normal 模式，都會讓那個程序一直放行按鍵——既打不出中文，也切不了中英，因爲掛起把每一個鍵都讓出去了。回來的路：
- macOS：連按兩下
⌥。 - Windows：按
Ctrl+Space（掛起期間它是解掛鍵）。 - 任何平臺：跑一次
yume-mode on，或者關掉那個終端窗口重開。
别的程序不受影響。macOS 用的是連按兩下修飾鍵而不是一顆組合鍵，因爲終端機會把 ⌥Space、⌃Space 這類直接當控制序列吞掉，輸入法根本看不見。
五、自定義方案：用自己的碼表
5.1 能做到什麼
上傳一份碼表文件，宇夢當場編譯成一個可用方案：最大碼長、自分割字母、字根編碼、取碼規則全部由碼表反推（Zhu Bootstrapping Algorithm），不需要你寫任何配置。
編好之後與內置方案同等待遇——有自己的用户詞庫，能用注解，能切換。
5.2 碼表格式
每行 漢字 <Tab> 編碼，或者 編碼 <空格> 漢字，UTF-8 編碼。文件名第一個點之前就是方案名。
5.3 三步走
- 上傳。 方案管理面板裏選碼表文件。
- 確認參數。 帶「⚠」的幾項是碼表自己也説不清的，最該過目。
- 編譯完成。 報告最大碼長、自分割字母、碼表條目數、還原率。
5.4 給得越多，推得越準
| 你提供的 | 系統還要推的 | 拆分注解質量 |
|---|---|---|
| 只有碼表 | 拆分 ＋ 字根編碼 ＋ 取碼規則 | 反推，還原率約八成 |
| 碼表 ＋ 拆分表 | 字根編碼 ＋ 取碼規則 | 拆分完全以你的表爲準 |
| 碼表 ＋ 拆分表 ＋ 字根表 | 只剩取碼規則 | 編碼一個字母都不會被推翻 |
- 拆分表：每行
漢字<Tab>拆分序列。宇浩自家的chaifen.txt可以直接用。 - 字根表：每行
字根<Tab>編碼。字根寫法必須與拆分表一致——一邊寫「氵」一邊寫「水」就對不上。
5.5 方案管理
命名、重新上傳、配置、撤銷（只能退一步）、删除、從方案列表隱藏、注解中隱藏拆分或編碼，都在方案管理面板裏。槽位有上限。
六、細節與疑難
6.1 整句模式：用反引號手動切分
這是 2.1 那條分界線的第三次現身。整句模式下引擎要自己把一串字母切成段：**自定碼方案（靈明、日月）**的切分由韻碼決定，引擎不必猜；限長方案（星陳、卿雲）沒有韻碼，字母是真歧義，引擎只能猜。
按反引號 `（數字 1 左邊那個鍵）就能親手畫一道段界，把猜測變成事實。它與 Rime 方案的精確造詞是同一個鍵、同一個意思。
它做兩件事：
- 這個字到此爲止——沒有任何單字候選能跨過這道界。
- 界前那一段是完整的，因此「限長方案整句只認全碼」就此解除，簡碼重新可用。例如卿雲的
um`qf`jtp用三個簡碼打出「庆丰收」。
` 不是韻碼，它不進碼表、不參與查詢，所以它能對所有方案通用，而永遠不會與方案自己的字母打架。連按兩次等同一次。
碼表模式（頂字上屏／自動上屏）下這個鍵沒有段界可畫，於是它在那裏是另一件事——快捷造詞。
6.2 打錯了，整段編碼留在原地
現象：輸入非法或死路編碼時，整段原樣留在編碼區，不被切碎。
原因：宇夢不做空碼回退。
怎麼辦：退格改。這是刻意設計——寧可讓你自己改，也不把一段編碼切成不合法的分段。
6.3 候選面板被開始菜單擋住
現象：在開始菜單、任務欄搜索框裏打字，面板看不見。
原因：那些界面畫在比普通窗口更高的層級上。
怎麼辦：不必做什麼。兩個 Windows 版都已改爲讓位——把面板挪到旁邊而不是疊上去，輸入正常。徹底蓋過去需要簽名的高權限進程，屬於未來工作。
6.4 便攜版與安裝版同時運行
現象：每個按鍵被處理兩次，中英狀態各自翻轉、對不齊。
原因：兩者都掛了鍵盤鈎子。
怎麼辦：只留一個。便攜版啓動時偵測到安裝版會主動詢問。
托盤圖標的顏色就是身份
紫色是便攜版、藍色是安裝版、灰色是已暫停，一眼就知道是誰在打字。
6.5 便攜版的文件放在哪
Resources\唯讀，隨更新覆蓋。UserData\是你的設置和詞庫，不在壓縮包內，更新不會碰它。
托盤菜單「打開用户文件夾」直達。U 盤拔插後只要相對位置不變就能用。
6.6 高權限窗口下打不了字
現象：在以管理員身份運行的程序裏，便攜版沒有反應。
原因：Windows 的權限隔離不讓普通權限的鈎子看到高權限窗口的按鍵。
怎麼辦：改用安裝版。
6.7 剛更新完，某個程序還是舊行爲
僅安裝版會這樣。
原因：Windows 把輸入法 DLL 常駐在每一個用過它的進程裏。
怎麼辦：重開那個程序。
6.8 出了問題怎麼反饋
- 診斷日誌
yume.log：便攜版在UserData\下，安裝版和 macOS 在用户數據文件夾下（菜單「打開用户文件夾」直達）。 - GitHub Issues
- QQ 交流羣
附錄
附錄 A 全部快捷鍵
macOS 把 Ctrl+Shift 讀作 ⌃⇧，字母完全相同。下面兩張表是組合鍵；單個鍵在各種情形下做什麼，見功能鍵設置那一節。
設置類
| 快捷鍵 | 作用 |
|---|---|
Ctrl+Shift+O | 打開設置面板 |
Ctrl+Shift+U | 編輯用户詞庫 |
Ctrl+Shift+M | 上屏模式循環 |
Ctrl+Shift+N | 形碼方案循環 |
Ctrl+Shift+I | 進出拼音方案 |
Ctrl+Shift+D | 單字派循環 |
Ctrl+Shift+0 | 字集過濾循環 |
Ctrl+Shift+/ | 注解檔位循環 |
Ctrl+Shift+L | 候選佈局循環 |
Ctrl+Shift+3–9 | 每頁候選數 3–9 |
Ctrl+Shift+H | 空空如也（隱藏候選面板） |
Ctrl+Shift+K | 空格簡碼顯隱 |
Ctrl+Shift+Y | 預測候選開關 |
Ctrl+Shift+. | 半角／全角標點 |
操作類
| 快捷鍵 | 作用 |
|---|---|
Ctrl+Space | 暫停／恢復輸入法（僅 Windows） |
Ctrl+Shift+A | 注解上屏 |
Ctrl+Shift+Enter | 注解上屏（備用鍵） |
Ctrl+Shift+J | 截圖候選面板到剪貼板 |
Ctrl+Shift+Alt+J | 截圖查閱面板本地那一半 |
組字中的單鍵見 2.8 的速查表。
附錄 B 全部斜線命令
空緩衝打 /，再打命令名。每族都有若干别名（拼音全稱、縮寫），下表只列主名。
| 命令 | 作用 |
|---|---|
/set | 打開設置面板 |
/mode | 上屏模式 |
/schema | 方案切換 |
/pinyin | 進出拼音 |
/ziran | 雙拼佈局 |
/word | 單字派 |
/charset | 字集過濾 |
/comment | 注解檔位 |
/layout | 候選佈局 |
/menu | 每頁候選數 |
/index | 序號欄顯隱 |
/head | 表頭輸入欄顯隱 |
/foot | 註腳欄顯隱 |
/empty | 空空如也 |
/preedit | 內嵌輸入欄 |
/preview | 內嵌時預覽首選 |
/punc | 半角／全角標點 |
/space | 空格簡碼顯隱 |
/variation | 變體漢字顯隱 |
/user | 編輯用户詞庫 |
/mabiao | 自定義方案（碼表） |
/key | 功能鍵設置 |
/info | 方案資料 |
/update | 檢查更新 |
/default | 還原默認設置 |
/tab | 插入一個制表符 |
/version | 打出版本號 |
附錄 C 便攜版與安裝版功能對照
| 功能 | 便攜版 | 安裝版 |
|---|---|---|
| 內嵌輸入欄、內嵌預覽、極簡內嵌 | ✗ | ✓ |
| 高權限窗口下輸入 | ✗ | ✓ |
模態編輯器掛起（yume-mode） | ✗ | ✓ |
| 登入時自動啓動（托盤勾選） | ✓ | —— |
| 需要管理員權限安裝 | ✗ | ✓ |
其餘功能完全一致。