中文九键

如何启用『中文九键』

启用条件

更新内置输入方案

进入「rime」页面，点击「方案重置」旁的「运行」按键，并选择『确认』，此操作将内置雾凇方案更新到支持中文九键的版本。
更新内置键盘皮肤

点击『键盘皮肤』中右上角『…』菜单，选择『重置内置键盘』，并选择『确认』。

启用步骤

设置中文九键匹配的方案

如果您想使用其他输入方案来配合九键的使用，可参考下面的『RIME 方案如何配置中文九键』修改方案。

内置的雾凇输入方案中包含有支持中文九键的方案，以下步骤已内置的雾凇方案为例：
- 点击『RIME-方案列表管理』，按住『中文九键』右侧 ≡ 符号，拖拽它，将其排列到首个位置并点击『保存』按键（出现”警告”信息可忽略），点击确认保存；
- 点击『输入方案』，检查并确认『中文九键』方案排列在首位（如果没有，请按上一步重新操作）。
进入皮肤页面，选择『T9』皮肤。
- 如果没有找到『T9』皮肤，请按前置条件中的步骤重置皮肤。
- T9 是元书内置的支持九键功能的皮肤，您也可以使用第三方九键皮肤。

RIME 方案如何配置中文九键

在全拼的方案文件中添加 t9 配置参数

1
t9:
2
  # 是否显示 rime 中原始的预编辑文本，默认为 true
3
  # true: 对 preedit 不做处理，显示 rime 返回的原始 preedit 值。
4
  #       如果想通过 lua 自己调整 preedit 的显示，可以设置为 true。
5
  # false: 根据候选字 comment 显示转换后的 preedit 内容。
6
  #        注意：请务必保证候选字 comment 有效且正确，否则可能导致预编辑文本显示异常。
7
  isDisplayOriginalPreedit: false

在上一步修改的方案文件中的 processors 添加 t9_processor

t9_processor 会用来处理九键输入的字符，如回车键、删除键等。

1
engine:
2
  processors:
3
    - t9_processor
4
    #其他 processors

在上一步修改的方案文件中的 speller 添加 t9 映射

此步骤将词库中的 ASCII 小写字母派生为数字，如 “abc” 映射为 “2”等，输入数字可模糊匹配词库，输入 ASCII 小写字母可精确匹配词库。

1
speller:
2
  # 注意: 这里添加了 0123456789
3
  alphabet: zyxwvutsrqponmlkjihgfedcbaZYXWVUTSRQPONMLKJIHGFEDCBA0123456789
4
  initials: zyxwvutsrqponmlkjihgfedcbaZYXWVUTSRQPONMLKJIHGFEDCBA0123456789
5
  algebra:
6
    # ### 超级简拼(可选)
7
    - abbrev/^([a-z]).+$/$1/ # 超级简拼
8
    - abbrev/^([zcs]h).+$/$1/ # 超级简拼中，zh ch sh 视为整体（ch'sh → 城市），而不是像这样分开（c'h's'h → 吃好睡好）。
9
    - derive/^([nl])ve$/$1ue/
10
    - derive/^([jqxy])u/$1v/
11
    - derive/un$/uen/
12
    - derive/ui$/uei/
13
    - derive/iu$/iou/
14
    - derive/([aeiou])ng$/$1gn/
15
    - derive/([dtngkhrzcs])o(u|ng)$/$1o/
16
    - derive/ong$/on/
17
    - derive/ao$/oa/
18
    - derive/([iu])a(o|ng?)$/a$1$2/
19
    # ### 九宫格映射(必须)
20
    - derive/[abc]/2/
21
    - derive/[def]/3/
22
    - derive/[ghi]/4/
23
    - derive/[jkl]/5/
24
    - derive/[mno]/6/
25
    - derive/[pqrs]/7/
26
    - derive/[tuv]/8/
27
    - derive/[wxyz]/9/

上面的『九宫格映射』部分可以进一步优化为：

1
- derive/^(.*)$/\U$1/
2
- xform/[ABC]/2/
3
- xform/[DEF]/3/
4
- xform/[GHI]/4/
5
- xform/[JKL]/5/
6
- xform/[MNO]/6/
7
- xform/[PQRS]/7/
8
- xform/[TUV]/8/
9
- xform/[WXYZ]/9/

这样可以生成更少体积的 prism 文件，但在不同的输入方案下，效果不太一样。具体使用那种配置，自己可以都尝试看看效果，哪种效果好用哪个。

在上一步修改的方案文件中，屏蔽对候选字 comment 处理的 Lua 脚本

常见问题

为什么我使用九键皮肤后输入的是数字

九键皮肤必须与对应的方案匹配，否则会出现输入数字的情况。方案配置请参考『RIME 方案如何配置中文九键』。

为什么九键输入后有中文候选字，但不显示拼音，而是显示数字

这里存在两种情况：

方案中存在 lua 脚本将候选字的 comment 信息屏蔽了，导致预编辑文本无法正确显示。
没有为方案添加 isDisplayOriginalPreedit 选项或者选项值不对。

无论是哪种情况，都请参考『RIME 方案如何配置中文九键』中的步骤，检查方案的配置。

如何屏蔽候选字右侧显示的拼音

点击「键盘设置」，在候选文字区域内，关闭「候选 Comment」选项。

方案配置示例

以下以雾凇方案 t9.schema.yaml 为例，展示完整配置：

1
# Rime schema
2
# encoding: utf-8
3

4
# 中文九键输入方案配置
5
#
6
# 可选，支持英文：
7
# 1. 解开 `engine/translators` 下的注释
8
# 2. 将 `others/Hamster/melt_eng.custom.yaml` 里的文件拷贝至配置目录，该补丁转写了英文的拼写规则到九宫格；
9

10
__include: rime_ice.schema.yaml:/
11

12
schema:
13
  schema_id: t9
14
  name: 中文九键
15
  version: "3.0.0"
16
  author:
17
    - Dvel
18
    - "[morse.hsiao](https://github.com/imfuxiao)"
19
  description: |
20
    中文九键·T9
21
  dependencies:
22
    - melt_eng # 英文输入，作为次翻译器挂载到拼音方案
23

24
engine:
25
  processors:
26
    - t9_processor
27
    - ascii_composer
28
    - recognizer
29
    - key_binder
30
    - speller
31
    - punctuator
32
    - selector
33
    - navigator
34
    - express_editor
35
  segmentors:
36
    - ascii_segmentor
37
    - matcher
38
    - abc_segmentor
39
    - punct_segmentor
40
    - fallback_segmentor
41
  translators:
42
    - punct_translator
43
    - script_translator
44
    - lua_translator@*date_translator # 时间、日期、星期
45
    - table_translator@custom_phrase # 自定义短语 custom_phrase_t9.txt
46
    # - table_translator@melt_eng     # 英文输入
47
    - lua_translator@*calc_translator # 计算器
48
  filters:
49
    - simplifier@emoji # Emoji
50
    - simplifier@traditionalize # 简繁切换
51
    - uniquifier # 去重
52

53
calculator:
54
  prefix: "=" # 计算器前缀
55
  show_prefix: true
56

57
# 处理符合特定规则的输入码，如网址、反查
58
recognizer:
59
  import_preset: default # 从 default.yaml 继承通用的
60
  patterns: # 再增加方案专有的：
61
    calculator: "^=.*$" # 响应 lua_translator@*calc_translator，计算器。前缀设定项 calculator/prefix
62

63
translator:
64
  prism: t9
65
  spelling_hints: 100
66
  comment_format: []
67

68
# 自定义短语：custom_phrase_t9.txt
69
# ⚠️ 编码要用数字
70
custom_phrase:
71
  dictionary: ""
72
  user_dict: custom_phrase_t9
73
  db_class: stabledb
74
  enable_completion: false
75
  enable_sentence: false
76
  initial_quality: 99
77

78
# 九宫格 1 键上的符号序列
79
punctuator:
80
  half_shape:
81
    "1": [1, "@", ".", "/", ":", "_", "-", "#"]
82
    "@": [1, "@", ！, ：, 、, ……, ～]
83
    "#": [0, "#", "$", "%", "^", "&", "*", "(", ")"]
84

85
t9:
86
  isDisplayOriginalPreedit: false
87

88
# 输入时按 1 可以分词
89
key_binder:
90
  bindings:
91
    - { when: has_menu, accept: 1, send: apostrophe }
92

93
speller:
94
  alphabet: zyxwvutsrqponmlkjihgfedcbaZYXWVUTSRQPONMLKJIHGFEDCBA0123456789
95
  initials: zyxwvutsrqponmlkjihgfedcbaZYXWVUTSRQPONMLKJIHGFEDCBA0123456789
96
  algebra:
97
    # ### 超级简拼
98
    - abbrev/^([a-z]).+$/$1/ # 超级简拼
99
    - abbrev/^([zcs]h).+$/$1/ # 超级简拼中，zh ch sh 视为整体（ch'sh → 城市），而不是像这样分开（c'h's'h → 吃好睡好）。
100
    - derive/^([nl])ve$/$1ue/
101
    - derive/^([jqxy])u/$1v/
102
    - derive/un$/uen/
103
    - derive/ui$/uei/
104
    - derive/iu$/iou/
105
    - derive/([aeiou])ng$/$1gn/
106
    - derive/([dtngkhrzcs])o(u|ng)$/$1o/
107
    - derive/ong$/on/
108
    - derive/ao$/oa/
109
    - derive/([iu])a(o|ng?)$/a$1$2/
110
    # ### 九宫格映射
111
    - derive/[abc]/2/
112
    - derive/[def]/3/
113
    - derive/[ghi]/4/
114
    - derive/[jkl]/5/
115
    - derive/[mno]/6/
116
    - derive/[pqrs]/7/
117
    - derive/[tuv]/8/
118
    - derive/[wxyz]/9/