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
qfjtp` 用三个简码打出「庆丰收」。
`` ` 不是韵码，它不进码表、不参与查询，所以它能对所有方案通用，而永远不会与方案自己的字母打架。连按两次等同一次。
码表模式（顶字上屏／自动上屏）下这个键没有段界可画，于是它在那里是另一件事——快捷造词。
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） | ✗ | ✓ |
| 登入时自动启动（托盘勾选） | ✓ | —— |
| 需要管理员权限安装 | ✗ | ✓ |
其余功能完全一致。