Skip to content

Lua 功能

键道通过 librime-lua 内置了多个 Lua 脚本,提供超出普通词典的动态输入能力。以下各功能均已默认启用,无需额外配置。

时间与日期

输入 o 开头的短码可上屏当前时间、日期或星期。

输入码示例输出说明
oej23:50:00当前时间(时:分:秒)
oxq星期六今天星期几
orq2025年04月30日当前日期(中文)
o三者均出现前三者的合并候选

TIP

o 直接输入时,时间、星期、日期三个候选会一起出现在候选列表中,并附有简短提示帮助区分。

数字与金额

输入 = 加阿拉伯数字,可将其转换为大写金额或小写文读。支持含运算符的表达式,输入后会在候选中同时给出计算结果。

输入码示例输出说明
=123壹佰贰拾叁 / 一百二十三大写金额 / 小写文读
=1+23 / 先计算再转换
=10000壹万 / 一万万亿量级均支持

TIP

两种形式(大写/小写)同时出现在候选列表中,选择对应候选即可。

简码提示

在输入词组时,候选项右侧会自动显示该词更短的编码提示(〔...〕),提醒用户可用更少的键位完成输入。此功能由 hint_filter + keytao_filter 共同实现。

候选: 学习   〔xkx〕
候选: 学习惯例
  • 声笔笔(如 xkx):音码首码 + 两个声母的简码
  • ss 简码(如 xx):两个声母的双拼简码

INFO

提示符 〔...〕⛔️ 表示该简码已被其他词占用,上屏后会顶出该词。

单字模式

键道内置单字模式开关(danzi_mode),开启后候选列表会优先显示单字,多字词排到后面。适合需要输入大量单字的场景。

切换方式:输入法设置 → 方案选项 → 单字模式。

次选键('

按下 '(单引号)可直接上屏候选列表中的第二候选并自动提交,无需翻页或用数字键选择。

WARNING

次选项不是候选菜单中视觉上的第二项(翻页后会变化),而是该编码固定对应的第二个匹配词条。在编码不变的情况下,次选项始终恒定。

顶功

键道的顶功机制在编码达到指定长度时自动上屏前字,详见 顶功(上屏) 章节。


Lua 脚本一览

以下是键道各 Lua 脚本的对应关系,供开发者参考:

文件功能rime.lua 变量名
date_time.lua时间 / 日期 / 星期date_time_translator
xnumber.lua数字大小写 / 计算number_translator
keytao_filter.lua单字模式 + 简码提示keytao_filter
for_hint.lua声笔笔/顶功提示hint_filter
for_topup.lua顶功处理器topup_processor
smart_2.lua' 次选键smart_2