★ FEATURED ARTICLE 简介这份配置包面向使用 rime 中州韵小狼毫须鼠管输入法的进阶用户用于解决原生输入法缺乏日期时间联想与农历节气提示的问题。它通过 lua 脚本实现 dateTime 滤镜将日期整理、时间整理、农历计算、二十四节气推算与事件映射等六大功能接入候选词流程并在 rime.lua 中完成滤镜接口映射最终在 wubi_pinyin.custom.yaml 中启用 dateTime_Filter让输入时可直接获得增强的日期时间候选。压缩包共 9 个文件以 7 个 lua 脚本为核心辅以 1 个 txt 事件数据与 1 个 yaml 配置整体约 43KB结构紧凑、便于按模块阅读与二次修改。目前已有 448 人学习下载适合想研究 rime 滤镜机制、扩展输入法时间日期能力的用户参考可从中获取滤镜注册方式、模块拆分思路与配置挂载方法快速复现并调整出符合自身习惯的日期时间增强效果。1. 输入法里的时间魔法dateTime 滤镜到底能做什么很多人第一次听到「dateTime 滤镜」这个词是在折腾 Rime 中州韵输入法配置的时候。Rime 本身是一个高度可定制的输入法引擎小狼毫是它在 Windows 上的发行版须鼠管则是社区里流传的一套配置方案。dateTime 滤镜是 Rime 的 Lua 扩展能力之一作用非常直接当你输入特定触发词时它把当前的日期、时间、星期、甚至农历信息作为候选词直接送进输入框。听起来简单但它解决的是一个高频刚需——写日报、填表、记笔记、发消息时不用切窗口看日历敲几个字母就能把「2025年3月15日 星期六 14:32」这样的内容打出来。适合谁适合每天要写带时间戳记录的人适合懒得记快捷键的人也适合想把输入法真正变成效率工具的人。这一篇就围绕 dateTime 滤镜的配置、参数、排错和进阶玩法把能踩的坑和能抄的作业一次讲清楚。2. 从零配通 dateTime 滤镜文件放哪、开关怎么开2.1 先确认你的 Rime 能不能跑 LuadateTime 滤镜依赖 Rime 的 Lua 脚本支持。小狼毫在较新的版本里已经内置了 Lua 引擎但如果你用的是很老的安装包或者用的是某些精简版可能根本没有lua目录。判断方法很简单打开用户配置目录看有没有lua文件夹以及rime.lua文件是否存在。用户配置目录的定位方式右键任务栏小狼毫图标选择「用户文件夹」资源管理器会直接跳过去。常见路径形如%APPDATA%\Rime但不要硬记以右键跳转为准。如果目录里没有lua文件夹说明当前版本不支持 Lua 扩展需要更新到支持 Lua 的版本。这一步没有捷径版本不对后面所有配置都是白费。确认支持后目录结构大致是这样Rime/ ├── lua/ │ └── dateTime.lua ├── rime.lua ├── default.custom.yaml ├── squirrel.custom.yaml └── ...lua/dateTime.lua是滤镜的逻辑实现rime.lua是 Lua 模块的注册入口。这两个文件缺一不可。2.2 把 dateTime.lua 放进 lua 目录dateTime 滤镜的核心是一个 Lua 脚本文件。社区里流传的版本不少但结构大同小异。下面给出一份可直接使用的实现保存为lua/dateTime.lua-- dateTime.lua -- Rime dateTime 滤镜输入触发词后输出当前日期时间 local M {} -- 日期时间格式化函数 -- 参数 fmt 支持 %Y %m %d %H %M %S %A 等占位符 local function format_time(fmt) return os.date(fmt) end -- 星期映射表os.date 的 %w 返回 0-60 是周日 local week_map { [0] 日, [1] 一, [2] 二, [3] 三, [4] 四, [5] 五, [6] 六, } -- 滤镜主函数 -- input: 用户输入的原始串 -- env: 环境对象包含 engine 等 function M.filter(input, env) for cand in input:iter() do -- 如果候选文本匹配触发词则替换为时间 local text cand.text if text rq then yield(Candidate(date, cand.start, cand._end, format_time(%Y-%m-%d), 日期)) elseif text sj then yield(Candidate(time, cand.start, cand._end, format_time(%H:%M:%S), 时间)) elseif text xq then local w os.date(%w) yield(Candidate(week, cand.start, cand._end, 星期 .. week_map[w], 星期)) elseif text rqsj then local w os.date(%w) local s format_time(%Y-%m-%d %H:%M) .. 星期 .. week_map[w] yield(Candidate(datetime, cand.start, cand._end, s, 日期时间)) else yield(cand) end end end return M这段代码的逻辑说明M.filter是滤镜入口Rime 会把当前候选流传进来。input:iter()遍历每一个候选cand.text是候选的文本内容。当文本等于我们设定的触发词rq、sj、xq、rqsj时用os.date生成对应格式的时间字符串并通过yield输出一个新的Candidate对象。cand.start和cand._end沿用原候选的位置信息保证替换后光标位置正确。不匹配的候选原样yield回去不影响正常输入。参数说明os.date的格式串里%Y是四位年%m是两位月%d是两位日%H是24小时制小时%M是分钟%S是秒%w是星期数字。触发词可以按自己习惯改比如改成date、time、week但要注意别和正常拼音冲突。rq、sj这种双字母组合在拼音里几乎不会作为完整音节出现冲突概率低。2.3 在 rime.lua 里注册模块lua/dateTime.lua写好后需要在rime.lua里注册否则 Rime 不知道它的存在。rime.lua通常长这样-- rime.lua -- 注册 dateTime 滤镜模块 local dateTime require(dateTime) -- 将模块挂到全局供 YAML 配置引用 date_time_filter dateTime.filter逻辑说明require(dateTime)会加载lua/dateTime.lua返回其中的M表。我们把M.filter赋值给一个全局变量date_time_filter这个变量名就是后面在 YAML 里要引用的名字。名字可以自定义但必须和 YAML 里写的一致。参数方面没有额外配置关键是路径要对require的模块名不带.lua后缀且文件必须在lua目录下。2.4 在方案文件里挂上滤镜最后一步是在输入方案里启用这个滤镜。假设你用的是「朙月拼音」方案对应文件是luna_pinyin.schema.yaml。不要直接改这个文件而是新建一个补丁文件luna_pinyin.custom.yaml内容如下# luna_pinyin.custom.yaml patch: engine/filters/before 0: lua_filterdate_time_filter逻辑说明engine/filters是一个列表before 0表示插到列表最前面。lua_filterdate_time_filter是 Rime 的语法lua_filter是滤镜类型后面是rime.lua里注册的全局变量名。放在最前面是为了让 dateTime 优先处理候选避免被其他滤镜干扰。改完后重新部署右键小狼毫图标选择「重新部署」。部署完成后输入rq候选栏里应该出现当天日期。注意如果部署后没反应先看%TEMP%\rime.squirrel*下的日志文件里面会打印 Lua 报错。日志是排查的第一手资料比反复改配置有用得多。3. 触发词、格式串与候选排序参数怎么调才顺手3.1 触发词设计避开拼音冲突的三个原则触发词是 dateTime 滤镜的入口设计不好会出现「想打日期却打不出字」或者「正常打字被时间候选干扰」两种情况。我一般遵循三个原则第一触发词长度至少两个字母单字母冲突面太大第二触发词不要是常见完整拼音音节比如ri、shi、nian都是高危词第三触发词最好带一个不常用的辅音组合比如rq、sj、xq这种声母缩写。如果你确实想用date这种英文词也不是不行但要接受一个代价输入date时时间候选会排在英文候选前面。对于经常中英混输的人这可能会烦。折中方案是给触发词加一个前缀比如\rq反斜杠在拼音里几乎不会出现冲突概率极低。修改方法是在dateTime.lua里把text rq改成text \\rq注意 Lua 字符串里反斜杠要转义。3.2 格式串定制从「2025-03-15」到「2025年3月15日 星期六」os.date的格式串决定了输出长什么样。默认的%Y-%m-%d是 ISO 风格适合写代码注释、文件名。但很多人要的是中文习惯的「2025年3月15日 星期六 14:32」。这需要组合多个格式符并且处理星期映射。下面给出一份扩展后的dateTime.lua片段-- 中文日期2025年3月15日 local function cn_date() local y os.date(%Y) local m os.date(%m) local d os.date(%d) -- 去掉月份和日期前面的 0 m m:gsub(^0, ) d d:gsub(^0, ) return y .. 年 .. m .. 月 .. d .. 日 end -- 中文日期时间带星期2025年3月15日 星期六 14:32 local function cn_datetime_week() local w os.date(%w) local week_cn week_map[w] local h os.date(%H) local mi os.date(%M) return cn_date() .. 星期 .. week_cn .. .. h .. : .. mi end逻辑说明gsub(^0, )把月份和日期开头的0去掉让「03月」变成「3月」更符合中文书写习惯。week_map沿用前面的映射表。cn_datetime_week把日期、星期、时间拼在一起输出一个完整的时间戳。参数方面%H是24小时制如果你想要12小时制可以用%I但要注意上午下午的标记需要自己加。3.3 候选排序让时间候选出现在正确的位置dateTime 滤镜输出的候选默认会插在候选流里但具体排第几取决于滤镜链的顺序和候选的quality值。如果你发现时间候选排在很后面需要翻页才能看到有两个调整方向。第一确认lua_filterdate_time_filter在engine/filters列表的最前面before 0就是干这个的。第二在Candidate构造函数里加一个quality参数值越大排越前。修改后的yield语句yield(Candidate(date, cand.start, cand._end, format_time(%Y-%m-%d), 日期, 100))最后一个参数100就是quality。默认值通常是 0 或 1给到 100 能确保时间候选排在最前面。但要注意如果触发词和正常拼音冲突高quality会让时间候选盖住正常候选所以触发词设计和高quality要配合使用。3.4 多方案共用一份配置覆盖所有输入方案如果你同时用多个输入方案比如拼音、双拼、五笔不想每个方案都写一遍补丁可以用default.custom.yaml做全局配置。但engine/filters是方案级配置不能直接在default.custom.yaml里改。可行的做法是给每个方案写一个补丁文件或者用patch的语法批量追加。下面是一个批量补丁的示例# default.custom.yaml patch: engine/filters/: - lua_filterdate_time_filter逻辑说明表示追加到列表末尾。这种方式适合所有方案共用同一个滤镜但缺点是滤镜排在最后时间候选可能被其他滤镜影响。如果追求排序靠前还是逐个方案写before 0更稳妥。参数方面没有额外配置关键是补丁文件的命名要和方案文件对应比如luna_pinyin.custom.yaml对应luna_pinyin.schema.yaml。4. 避坑与排查dateTime 滤镜最常见的五个翻车现场4.1 部署后完全没反应候选栏里找不到时间现象输入rq候选栏里只有「热情」「日期」等正常拼音候选没有日期字符串。原因最常见的是rime.lua没有注册成功或者lua/dateTime.lua文件路径不对。解决打开%TEMP%下的 Rime 日志搜索lua关键字。如果看到module dateTime not found说明文件没放对位置如果看到attempt to call a nil value说明rime.lua里的变量名和 YAML 里引用的不一致。逐项核对文件名、变量名、路径大小写。4.2 时间候选出现了但排在最后要翻好几页现象输入rq第一页候选里没有日期翻到第三页才看到。原因滤镜链顺序不对或者quality值太低。解决检查engine/filters里lua_filterdate_time_filter是否在第一位。如果不是改成before 0。如果已经在第一位给Candidate加quality参数值设为 100 或更高。注意quality太高可能导致正常候选被挤掉建议先设 100 测试再根据实际效果微调。4.3 日期格式不对月份日期前面带 0现象输出「2025-03-05」但想要「2025年3月5日」。原因os.date的%m和%d默认补零。解决用gsub(^0, )去掉前导零或者改用%-m和%-d格式符部分平台支持。更稳妥的做法是自己在 Lua 里做字符串处理不依赖平台差异。修改后的代码参考第 3.2 节的cn_date函数。4.4 触发词和正常拼音冲突打字时频繁弹出时间候选现象输入sj想打「时间」结果候选栏第一个是当前时间正常候选被挤到后面。原因触发词太短或太常见和拼音音节重合。解决换触发词比如把sj改成sjt或\sj。如果不想换可以降低quality值让时间候选排在正常候选后面但这样又失去了快捷输入的意义。折中方案是保留短触发词但只在特定方案里启用比如只在「写作模式」方案里开 dateTime日常聊天方案不开。4.5 重新部署后配置丢失又变回默认方案现象改完配置重新部署发现 dateTime 滤镜失效方案也变回默认。原因补丁文件命名错误或者 YAML 缩进不对。Rime 的补丁文件必须叫方案名.custom.yaml且patch下的缩进必须是两个空格。解决用 YAML 校验工具检查补丁文件确认没有 Tab 缩进、没有中文冒号。另外部署时如果报错Rime 会回退到默认配置所以日志里的报错信息是关键线索。5. 进阶玩法把 dateTime 滤镜变成个人时间工具箱5.1 农历与节气用 Lua 表驱动扩展输出dateTime 滤镜的框架本身不限制输出内容只要 Lua 能算出来的都能塞进候选。农历和节气是高频需求但os.date不支持。常见做法是引入一份农历数据表用查表法换算。下面是一个简化示例只处理固定年份范围-- 农历数据表简化版仅示意结构 local lunar_data { [2025] {1, 29, 2, 28, 3, 29, 4, 28, 5, 29, 6, 28, 7, 29, 8, 28, 9, 29, 10, 28, 11, 29, 12, 28}, } -- 根据公历日期查农历示意实际需要更完整的换算逻辑 local function get_lunar(y, m, d) local data lunar_data[y] if not data then return 农历数据缺失 end -- 这里省略具体换算实际项目需要处理闰月、大小月 return 农历 .. m .. 月 .. d .. 日 end逻辑说明lunar_data按年份存储农历月份和天数实际换算需要处理闰月、大小月、春节偏移等复杂逻辑。这段代码只是示意结构不建议直接用于生产。如果你需要完整的农历功能建议找现成的 Lua 农历库或者用外部工具生成静态表。参数方面年份范围决定了表的大小覆盖 2020-2030 大约需要几十 KB 的数据。5.2 时间戳与文件名一键生成带时间的文件名写代码或整理文件时经常需要「20250315_1432」这种格式的时间戳。在 dateTime 滤镜里加一个触发词wjm文件名的拼音缩写输出适合做文件名的时间串elseif text wjm then local s os.date(%Y%m%d_%H%M) yield(Candidate(filename, cand.start, cand._end, s, 文件名时间戳))逻辑说明%Y%m%d_%H%M生成「20250315_1432」格式没有空格和特殊字符适合直接做文件名。参数方面如果你需要秒级精度加%S如果需要毫秒Lua 的os.date不支持得用os.clock或socket.gettime复杂度会上升一般场景秒级够用。5.3 验证滤镜是否生效三个快速检查点配好之后怎么确认真的生效了我一般做三个检查。第一输入触发词看候选栏有没有出现预期字符串这是最直接的。第二打开日志搜索dateTime或lua_filter看有没有加载成功的记录。第三改一下dateTime.lua里的格式串重新部署看输出有没有变化。如果改了没变化说明文件没被加载回去检查路径和注册。这三个检查点能覆盖 90% 的配置问题。5.4 性能与边界dateTime 滤镜会不会拖慢输入有人担心 Lua 滤镜会影响输入速度。实测下来dateTime 滤镜的开销可以忽略不计因为它只在候选流经过时做一次字符串比较不涉及复杂计算。真正可能拖慢输入的是农历换算或大量数据查表如果每次按键都遍历大表会有可感知的延迟。优化方法是把查表结果缓存起来同一天内不重复计算。另外滤镜链里如果挂了多个 Lua 滤镜每个都会遍历候选流叠加起来可能有影响。建议只保留必要的滤镜dateTime 这种轻量级的放最前面。我自己的习惯是每次改完配置先重新部署再输入rq和rqsj各测一次确认日期和时间都对然后才去写别的。这个习惯帮我省了很多「改了但没生效」的来回折腾。希望帮到你。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
函数)
