企业官网建设流程全解析

简介：这是一份面向 Rime 中州韵小狼毫输入法进阶用户的 dateTime 日期时间滤镜配置包，适合希望为输入法扩展农历、节气与事件提示能力的配置爱好者。包内共 9 个文件，以 7 个 lua 脚本为核心，辅以 1 个 txt 事件数据与 1 个 yaml 配置，整体约 43KB，体积轻巧便于直接并入现有方案。脚本分别实现二十四节气计算、农历换算、事件映射、日期整理与时间整理等六大功能，并通过 rime.lua 完成滤镜接口映射，最终在 wubi_pinyin.custom.yaml 中启用 dateTime_Filter，达成日期时间增强效果。已有 448 人学习下载，读者可借此理解 Rime 滤镜的注册与调用链路，掌握 lua 模块拆分、事件列表维护及自定义配置的写法，为二次开发同类滤镜提供可复用的参考结构。

1. 输入法里的时间魔法：dateTime 滤镜到底解决什么问题

很多人第一次听到「dateTime 滤镜」这个词，是在折腾 Rime 中州韵输入法配置的时候。Rime 本身是一套跨平台的输入法引擎，小狼毫是它在 Windows 上的发行版，鼠须管对应 macOS，中州韵对应 Linux。它最大的特点是配置驱动——你想要的输入行为，几乎都能通过 YAML 配置文件改出来。而 dateTime 滤镜，就是其中一个非常实用但容易被忽略的功能：它让你在打字时直接输入当前日期、时间、星期，甚至自定义格式的时间戳。

想象一个场景：你在写日志、记笔记、填表格，需要频繁输入「2025-01-15」这样的日期。手动敲数字又慢又容易错，用系统自带的日期插入又得切换窗口。dateTime 滤镜的做法是，你输入一个触发码，候选框里直接出现格式化好的日期时间，选一下就行。它解决的不是什么高深问题，就是「少按几次键盘、少切一次窗口」这种日常琐事，但用过之后基本回不去。

这个方案适合谁？适合已经装好 Rime 任意发行版、愿意动手改配置文件、对输入效率有要求的从业者。新手跟着步骤也能跑通，熟手可以进一步定制格式和触发方式。下面从配置结构讲到具体参数，再到踩坑记录，一步步拆开。

2. dateTime 滤镜的配置结构与加载逻辑

2.1 滤镜在 Rime 配置体系里的位置

Rime 的配置文件分几个层级。最核心的是default.custom.yaml，它负责全局定制，比如挂载哪些输入方案、启用哪些滤镜。每个输入方案又有自己的.schema.yaml文件，定义该方案的翻译器、过滤器、滤镜链。dateTime 滤镜属于「滤镜」这一类，它挂在方案配置的engine.filters列表里。

滤镜的作用时机是在翻译器产出候选之后、上屏之前。也就是说，你输入的编码先经过翻译器变成候选词，再经过滤镜链处理，dateTime 滤镜会在这一步把匹配到的编码替换成日期时间字符串。理解这个顺序很重要，因为它决定了触发码不能和正常编码冲突，否则会被翻译器先吃掉。

常见做法是在default.custom.yaml里统一挂载，这样所有方案都能用；也可以只在某个方案的.schema.yaml里挂，做到按方案启用。我一般倾向后者，因为不是每个方案都需要日期输入，全局挂载反而增加维护成本。

2.2 最小可用的 dateTime 配置

先看一个能跑起来的最小配置。假设你用的是某款拼音方案，方案文件叫my_pinyin.schema.yaml，在它的engine段里加上 filters：

# my_pinyin.schema.yaml 片段 engine: filters: - simplifier - uniquifier - date_time_filter # 引用下面定义的滤镜 date_time_filter: type: date_time # 滤镜类型，固定写法 # 触发码与格式的映射 date_format: "%Y-%m-%d" time_format: "%H:%M:%S" # 触发码 date_prefix: "rq" time_prefix: "sj"

这段配置的逻辑是：定义了一个类型为date_time的滤镜，命名为date_time_filter，然后在engine.filters里引用它。date_format和time_format用的是类 strftime 的格式串，%Y是四位年，%m是两位月，%d是两位日，%H是 24 小时制小时，%M分，%S秒。date_prefix和time_prefix是触发码，输入rq就会在候选里出现当前日期。

参数说明：type必须是date_time，这是 Rime 内置的滤镜类型名，写错会直接报错不加载。date_prefix和time_prefix建议用不常见的字母组合，避免和正常拼音冲突。比如rq在拼音里可能对应「日期」「人情」等词，如果方案词库里正好有，就会和滤镜候选混在一起。后面避坑章节会细说这个问题。

2.3 触发码与候选的交互过程

当你输入rq时，翻译器先尝试把它翻译成词库里的候选。如果词库里有「日期」这个词，候选框会先显示它。同时，dateTime 滤镜也会检测到rq匹配了date_prefix，于是把当前日期作为一个候选插入。最终候选框里可能同时有「日期」和「2025-01-15」。你选哪个就上屏哪个。

这个交互过程说明两件事：第一，触发码越短越容易和词库冲突，建议用两到三个不常见字母；第二，滤镜候选的排序位置取决于滤镜在链中的顺序和 Rime 的候选排序规则，通常滤镜候选会靠前，但不是绝对的。如果发现日期候选被挤到后面，可以调整滤镜在filters列表里的位置，或者换一个更冷门的触发码。

还有一个细节：dateTime 滤镜是「无状态」的，它不依赖你之前输入了什么，只看当前编码是否匹配触发码。所以它不会干扰正常的输入流程，也不会因为上下文变化而失效。这一点比某些需要前缀状态的滤镜要省心。

3. 自定义日期时间格式与多格式共存

3.1 格式串的常用占位符与组合

dateTime 滤镜的格式串支持大部分 strftime 占位符，常用的有这些：

组合起来可以做出很多花样。比如%Y年%m月%d日输出「2025年01月15日」，%H:%M输出「14:30」，%Y-%m-%d %H:%M:%S输出完整时间戳。注意%A和%a的输出语言取决于系统 locale，在中文系统上可能是「星期三」，在英文系统上是「Wednesday」。如果要做中文星期，更稳妥的做法是用多个触发码分别对应固定中文，而不是依赖 locale。

3.2 配置多个触发码对应不同格式

一个触发码只能对应一种格式，但你可以配置多个滤镜实例，每个实例有自己的触发码和格式。比如同时要日期、时间、完整时间戳、中文星期：

# 多个 date_time 滤镜实例 engine: filters: - date_only - time_only - full_stamp - week_cn date_only: type: date_time date_format: "%Y-%m-%d" date_prefix: "rq" time_only: type: date_time time_format: "%H:%M" time_prefix: "sj" full_stamp: type: date_time date_format: "%Y-%m-%d %H:%M:%S" date_prefix: "rqsj" week_cn: type: date_time date_format: "星期%u" # %u 是 ISO 星期，1=周一 date_prefix: "xq"

这里有个容易翻车的点：week_cn用了%u，输出是数字 1 到 7，不是「一」到「日」。要输出中文星期，得用%A配合中文 locale，或者干脆写死映射。我一般会在方案里加一个lua_filter做自定义转换，但那超出 dateTime 滤镜本身的范围了。如果只是要数字星期，%u够用。

参数说明：每个滤镜实例的type都是date_time，但实例名不能重复。date_prefix和time_prefix在同一个实例里可以只写一个，另一个不写就不触发。多个实例的触发码不能互相包含，比如rq和rqsj同时存在时，输入rqsj会优先匹配更长的那个，但具体行为取决于滤镜链的顺序，建议避免这种前缀包含关系。

3.3 验证配置是否生效的三种方法

配置写完不是就完了，得验证。第一种方法最直接：重新部署后，在任意输入框输入触发码，看候选框有没有出现日期。如果没有，先检查default.custom.yaml或方案文件有没有语法错误，YAML 对缩进极其敏感，多一个空格少一个空格都会导致整段失效。

第二种方法是看日志。小狼毫和鼠须管都有日志输出，在用户目录下能找到rime.weasel或rime.squirrel的日志文件。搜索date_time关键字，如果看到filter not found或unknown filter type，说明滤镜没加载成功。日志里还会显示滤镜链的加载顺序，可以确认你的滤镜有没有被正确引用。

第三种方法是用一个最小方案测试。新建一个只包含 dateTime 滤镜的方案文件，不挂任何词库，部署后输入触发码。如果这样能出日期，说明滤镜本身没问题，问题出在原方案的配置冲突上。这个方法我排错时经常用，能快速定位是滤镜问题还是方案问题。

4. 避坑记录：触发码冲突与格式失效的排查

4.1 触发码被词库候选淹没

现象：输入rq后，候选框里全是「日期」「人情」「热气」等词，日期候选排在很后面甚至看不到。

原因：触发码太短或太常见，和词库里的词高度重合。Rime 的候选排序里，词库候选通常优先于滤镜候选，除非滤镜在链中位置很靠前。

解决：换一个更冷门的触发码，比如rqdt、date、;rq（带符号前缀）。带符号前缀的好处是几乎不可能和拼音冲突，缺点是输入时多按一个键。我一般用rq加一个不常用字母，比如rqq，冲突概率极低。

4.2 格式串写错导致输出异常

现象：输入触发码后，候选里出现的是%Y-%m-%d原样字符串，或者日期数字不对，比如月份变成1而不是01。

原因：格式串里的占位符拼写错误，或者用了 dateTime 滤镜不支持的占位符。比如%M是分钟，%m是月份，大小写写反就会输出错误结果。另外，某些 Rime 版本对%e、%k这类非标准占位符支持不一致。

解决：先用最简单的%Y-%m-%d测试，确认滤镜工作正常，再逐步加复杂格式。每次只改一个占位符，改完重新部署验证。如果某个占位符输出不对，查 Rime 文档确认是否支持，不支持就换等价写法。

4.3 多滤镜实例导致加载失败

现象：配置了多个 date_time 滤镜后，重新部署报错，或者只有第一个生效，后面的全失效。

原因：YAML 里同一个键不能重复定义。如果你在engine.filters里写了多个滤镜名，但每个滤镜的配置段用了相同的键名，后面的会覆盖前面的。另外，滤镜实例名如果和 Rime 内置滤镜重名，也会导致加载异常。

解决：每个滤镜实例用唯一的名字，比如date_only、time_only，不要都用date_time_filter。engine.filters列表里按顺序写实例名，确保每个名字都有对应的配置段。部署后看日志，确认所有滤镜都加载成功。

4.4 部署后不生效的缓存问题

现象：改完配置，重新部署，输入触发码还是没反应，或者输出的还是旧格式。

原因：Rime 有编译缓存，部署时会把 YAML 编译成二进制缓存文件。如果缓存没更新，或者部署操作没真正触发重新编译，改动就不会生效。

解决：先确认部署操作执行了——小狼毫右键菜单里有「重新部署」，鼠须管在菜单里也有对应项。如果还不行，手动删除用户目录下的build文件夹，再重新部署。这个文件夹里是编译缓存，删掉后 Rime 会重新编译所有配置。注意删之前确认你的配置文件不在build里，否则会丢配置。

4.5 跨平台格式差异

现象：同样的配置，在 Windows 上输出正常，在 macOS 上日期格式不对，或者星期语言不对。

原因：不同平台的 C 库对 strftime 的实现有差异，locale 设置也不同。比如%A在中文 Windows 上输出「星期三」，在英文 macOS 上输出「Wednesday」。某些占位符在某个平台上不支持，会原样输出。

解决：尽量用数字占位符，避免依赖 locale 的%A、%a、%B、%b。如果必须用中文星期，用多个触发码分别对应「星期一」到「星期日」，虽然笨但跨平台稳定。或者用 Lua 滤镜做自定义转换，但那需要额外配置。

5. 进阶：用 Lua 滤镜扩展 dateTime 的能力边界

dateTime 滤镜本身能做的事有限，格式串就那些占位符，触发方式也只有前缀匹配。如果你想要更灵活的时间输入，比如「输入+3d得到三天后的日期」「输入nextmon得到下个月一号」，就得靠 Lua 滤镜来扩展。Rime 支持在滤镜链里挂 Lua 脚本，脚本可以访问当前时间、做日期运算、返回任意字符串作为候选。

一个常见的做法是写一个date_math.lua，在engine.filters里用lua_filter@date_math引用。脚本里定义一个函数，接收输入编码，用正则匹配+Nd、-Nd、nextmon这类模式，用os.date和os.time做运算，返回格式化结果。这样你就能在输入法里直接算日期，不用切到计算器或日历。

配置上要注意，Lua 滤镜的加载顺序会影响候选排序。如果 dateTime 滤镜和 Lua 滤镜同时存在，建议把 Lua 滤镜放在 dateTime 之后，这样简单日期由 dateTime 处理，复杂运算由 Lua 处理，互不干扰。另外，Lua 脚本里的错误不会导致 Rime 崩溃，但会在日志里报错，调试时多看日志。

验证 Lua 滤镜是否生效，可以用一个最简单的脚本，只返回固定字符串，确认能出现在候选里，再逐步加逻辑。我踩过的坑是脚本文件路径写错，Rime 找不到文件但不会明确报错，只是滤镜静默失效。后来养成习惯，每次改完 Lua 脚本，先看日志里有没有lua相关的加载信息，确认脚本被读到了再往下调。

还有一个实用技巧：把常用的日期格式做成多个 Lua 函数，用不同的触发码区分。比如rq出日期，rq+出明天，rq-出昨天。这样比配置多个 dateTime 实例更灵活，因为 Lua 里可以做条件判断，根据输入的不同返回不同结果。代价是脚本维护成本高一些，但一旦跑通，后续加功能就是改几行代码的事。

最后说一个我自己的习惯：所有日期时间相关的配置，我都会单独放在一个date_time.custom.yaml文件里，用 patch 的方式合并到主配置。这样升级 Rime 或换方案时，只要把这个文件带走，日期输入功能就能快速恢复。配置这东西，写的时候嫌麻烦，丢的时候才后悔没备份。希望帮到你。

本文还有配套的精品资源，点击获取