企业官网建设流程全解析

简介：这份配置包面向使用 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 能不能跑 Lua

dateTime 滤镜依赖 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-6，0 是周日 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_filter@date_time_filter

逻辑说明：engine/filters是一个列表，@before 0表示插到列表最前面。lua_filter@date_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_filter@date_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_filter@date_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_filter@date_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各测一次，确认日期和时间都对，然后才去写别的。这个习惯帮我省了很多「改了但没生效」的来回折腾。希望帮到你。

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