教程目录：rime中州韵小狼毫须鼠管安装配置教程 保姆级教程 100+增强功能配置教程
在 rime中州韵小狼毫 自定义词典 一文中，我们分享了如何在rime中州韵小狼毫须鼠管输入法中定义用户自定义词典；通过自定义词典，我们可以很方便的在输入法中加入个性化的词组。
根据 rime中州韵小狼毫 滤镜与字典的区别 一文所分析，通过自定义词典所定义和管理的个性化词组，会受到输入方案的耦合影响，这导致我们无法方便的直接的分享我们的自定义词典配置；并且对于一些动态词组（例如实时时间，实时日期，电脑信息等），也无法通过配置自定义词典来实现。
本文分享rime中州韵小狼毫须鼠管输入法的一个联想词组滤镜配置。该滤镜可以在候选列表中出现关键词组时，抛出附加的新的词组，例如下图👇中带有💡标记的词组，即为联想词组：
联想词组字典
联想词组字典的目的是提供有联想关系的词组，例如由词组“夫妻”，联想到词组“伉俪”，再如由词组“进步”，联想到词组“进步开始于起步”。
联想词组字典是txt的文档，lua滤镜脚本支持多个txt文档分类管理不同的联想词组，且滤镜脚本会自动进行去重处理。
联想词组字典文档内支持以符号#开头的行作为注释行，以提升词组管理的便捷性。
联想词组文档内的文本分为2列，以tab制表符分隔。第1列为关键词组，关键词组可以有多个，以空格分隔。第2列为联想词组，联想词组可以有多个，以空格分隔。联想词组的联想是意向的，即只能由第1更的关键词组联想到第2列的联想词组，但是可以通过使第1列与第2列相等来实现相互联想，例如 “夫妻 伉俪 →夫妻 伉俪”，这样可以使“夫妻”和“伉俪”相互联想。
phraseExt commonPhrase.txt
phraseExt commonPhrase.txt文档用于管理一般性的公共性的联想词组，phraseExt commonPhrase.txt词组定义截取如下👇：
# 支持使用   来定义空格，而正常的空格被用于分词
# 常用链接
知乎 https://www.zhihu.com
百度 度娘 www.baidu.com
淘宝 www.taobao.com
谷歌 谷哥 谷姐 www.google.com
画图 几何 画板 https://webgeo-8gn07v0t78c4ca57-1308819187.tcloudbaseapp.com
# 常用称呼
运气 华盖 运气 华盖
南冠 囚犯 南冠 囚犯
伉俪 夫妻 伉俪 夫妻
丝竹 音乐 丝竹 音乐
烽烟 战争 狼烟 战争 烽烟 狼烟
phraseExt esAppEmoji.txt
phraseExt esAppEmoji.txt文档用于管理一些应用专属的emoji表情，例如我们可以在微信聊天中输入 [微笑]，则微信会将其自动转换成 emoji 表情符号 🙂。我们在phraseExt esAppEmoji.txt文档中定义了一系列的此类emoji表情词组。phraseExt esAppEmoji.txt词组定义截取如下👇：
done 完成 搞定 esFs[完成] esDt[Done]
get 了解 知道 esFs[了解] esDt[Get]
no 不行 esFs[No] esFs[叉号] esDt[打叉]
错 错误 esFs[叉号] esDt[打叉]
ok 行 好的 好吧 可以 esFsWxDt[OK]
好 好的 esFs[Yes] esWx[好的]
行 esFs[我看行] esFs[好的]
okr 绩效 esFsDt[OKR]
👆如上，phraseExt esAppEmoji.txt 文档中的联想词组，以AppName作为前缀，不同的App应用，前缀符号映射👇如下：
| 应用 | 前缀 |
|---|---|
| 微信 | Wx |
| 飞书 | Fs |
| 钉钉 | Dt |
💣注意：
特别的，AppEmoji的联想，需要配置应用开关才可以使用，关于应用开关的配置，请参考 rime中州韵小狼毫 weasel.custom.yaml 配置 之 输入环境识别 一文。
phraseExt esUnicode.txt
在Unicode字符集中，存在着丰富的 emoji符号，如果不善于利用，则实在可惜。phraseExt esUnicode.txt文档专门用来管理与 Unicode 表情符号有关的联想词组，phraseExt esUnicode.txt联想词组定义截取如下👇：
垃圾 垃圾桶 🚮
开水 🚰
轮椅 残疾 无障碍 ♿
厕所 🚻 🚾
厕所 男人 男厕 🚹
厕所 女人 女厕 🚺
善于使用 Unicode 表情符号，会使你成为一个高情商的人。
phraseExt personal.txt
顾名思义，phraseExt personal.txt文档是用来管理一些个人和，私有的联想词组的，例如你的电话号码，例如你的邮寄地址，再如你的爱情口头禅。phraseExt personal.txt联想词组定义示例如下👇：
# 支持使用   来定义空格，而正常的空间被用于分词
# 这个字典用于管理 个人/私人 信息，以便在共享/分享rime配置时，可以方便的将个人信息进行隔离
# 常用联系方式
电话 手机 123456789AB 123456789AC
快递 地址 湖南省长春市快乐区开心社区2栋305室
# 常用办公信息
工号 000000
邮箱 san.zhang@aibaba.com
快递 地址 浙江省杭州市阿里马马集团2号快递收发室
# 其它常用信息
博客 https://www.myblogs.com
如果你与它人分享你的rime输入法的配置方案，phraseExt personal.txt 的存在将使得你可以快速的将个人/私人信息与配置方案进行隔离。
phraseExt_Module.lua
phraseExt_Module.lua 是一个lua脚本文档，phraseExt_Module.lua脚本文档的使用是将以上👆所管理的联想词组加载到lua程序中，并提供合适的检索方法接口，以便rime引擎可以使用联想词功能。phraseExt_Module.lua脚本内容如下👇：
-- myPhrase.lua
-- Copyright (C) 2023 yaoyuan.dou <douyaoyuan@126.com>
local M={}
local dict={}
local dictPhraseList={}
local dbgFlg = false
--引入系统变更处理模块
local ok, sysInfoRes = pcall(require, 'sysInfo')
local currentDir = sysInfoRes.currentDir
--设置 dbg 开关
local function setDbg(flg)
dbgFlg = flg
sysInfoRes.setDbg(flg)
print('myPhrase dbgFlg is '..tostring(dbgFlg))
end
--将这附串拆散成 table
local function stringSplit(str,sp,sp1)
sp=(type(sp)=="string") and sp or " "
if 0==#sp then
sp="([%z\1-\127\194-\244][\128-\191]*)"
elseif 1==#sp then
sp="[^"..(sp=="%" and "%%" or sp).."]*"
else
sp1=sp1 or "^"
str=str:gsub(sp,sp1)
sp="[^"..sp1.."]*"
end
local tab={}
for v in str:gmatch(sp) do
if ''~=v then
table.insert(tab,v)
end
end
return tab
end
--将文档处理成行数组
local function files_to_lines(...)
if dbgFlg then
print("--->files_to_lines called here")
end
local tab=setmetatable({},{__index=table})
local index=1
for i,filename in next,{...} do
local fn = io.open(filename)
if fn then
for line in fn:lines() do
if not line or #line > 0 then
tab:insert(line)
end
end
fn:close()
end
end
if dbgFlg then
print("--->files_to_lines completed here")
end
return tab
end
local function dictload(...) -- filename)
if dbgFlg then
print("-->dictload called here")
end
local lines=files_to_lines(...)
local thisDict={}
for i,line in next ,lines do
if not line:match("^%s*#") then -- 第一字 # 为注释行
local keys,val = string.match(line,"(.+)\t(%C+)")
if nil ~= keys then
--尝试对关键字进行空格分割
local keyList = stringSplit(keys,' ')
local key=''
for idx=1,#keyList do
key = keyList[idx]
if nil ~= thisDict[key] then
--如果该key已经存在，追加在后面，注意加一个空格
thisDict[key] = thisDict[key]..' '..val
else
thisDict[key] = val
end
end
end
end
end
if dbgFlg then
print("-->dictload completed here")
end
return thisDict
end
--===========================test========================
local function test(printPrefix)
if nil == printPrefix then
printPrefix = ' '
end
if dbgFlg then
print('myPhrase test starting...')
end
sysInfoRes.test(printPrefix..' ')
for k,v in pairs(dict) do
if dbgFlg then
print(printPrefix..k..'\t'..v)
end
end
end
--获取字典中的phraseList
local function getPhraseList(k)
if nil == k then
return {}
elseif '' == k then
return {}
end
--尝试获取 dictPhraseList 中 k 的列表
local phraseList = dictPhraseList[k]
if nil == phraseList then
--phraseList 获取失败，尝试获取 dict 中 k 的字符串
local thisPhrase = dict[k]
if nil == thisPhrase then
--这个 k 在dict中不存在
phraseList={}
elseif thisPhrase == '' then
--这个 k 在dict中是空的
phraseList={}
else
--将获取的 thisPhrase 序列化到 dictPhraseList 中
dictPhraseList[k]=stringSplit(thisPhrase,' ')
--再次从 dictPhraseList 中获取 k 的序列
phraseList = dictPhraseList[k]
end
end
return phraseList
end
function M.init(...)
local files={...}
--文件名不支持中文，其中 # 开始的行为注释行
table.insert(files,"phraseExt commonPhrase.txt")
table.insert(files,"phraseExt esAppEmoji.txt")
table.insert(files,"phraseExt esUnicode.txt")
table.insert(files,"phraseExt personal.txt")
for i,v in next, files do
files[i] = currentDir().."/".. v
end
dict= dictload(table.unpack(files))
--抛出功能函数
M.getPhraseList = getPhraseList
M.setDbg = setDbg
M.test = test
end
M.init()
return M
👆以上脚本中，我们在M.init() 方法中看到了联想词组字典的加载方法：table.insert(files,"phraseExt personal.txt")，你如果有其它的联想词组字典，你也可以很方便的加载它们。
phraseExt_Module.lua 脚本提供了一个名为getPhraseList方法，该方法可以根据指定的关键词组，从联想词组字典对象dict中检索并返回对应的联想词组。
phraseExt_Filter.lua
phraseExt_Filter.lua脚本实现了匹配rime引擎的Filter滤镜，phraseExt_Filter.lua脚本定义并返回了phraseExt_Filter滤镜方法，phraseExt_Filter.lua脚本内容如下👇：
-- myPhrase_Filter.lua
-- Copyright (C) 2023 yaoyuan.dou <douyaoyuan@126.com>
local dbgFlg = false
local ok, res = pcall(require, 'phraseExt_Module')
local getPhraseList = res.getPhraseList
--最长的comment长度限制
local maxLenOfComment = 250
--设置 dbg 开关
local function setDbg(dbgFlg)
res.setDbg(dbgFlg)
end
--过滤器
local function phraseExt_Filter(input, env)
--获取选项增强开关状态
local on = env.engine.context:get_option("phraseExt")
--获取应用程序标记状态[由于飞书暂不支持文本转表情的输入，帮使用 and false 将其关闭]
local feishuFlg = env.engine.context:get_option("feishuFlg") and false
local wechatFlg = env.engine.context:get_option("wechatFlg")
local qqFlg = env.engine.context:get_option("qqFlg")
local dingdingFlg = env.engine.context:get_option("dingdingFlg")
local minttyFlg = env.engine.context:get_option("minttyFlg")
local cmdFlg = env.engine.context:get_option("cmdFlg")
local pycharmFlg = env.engine.context:get_option("pycharmFlg")
local vscodeFlg = env.engine.context:get_option("vscodeFlg")
local matchedTxt = ''
local esType = ''
local esTxt = ''
local cands={}
local thisTxt
for cand in input:iter() do
--提交默认选项
if nil == cands[cand.text] then
yield(cand)
cands[cand.text]=true
end
if on then
local candTxt = cand.text:gsub("%s","") or ""
if candTxt ~= "" then
--获取增强选项
local phraseList = getPhraseList(candTxt)
if #phraseList > 0 then
local idx
for idx=1,#phraseList do
thisTxt=phraseList[idx]
if nil == cands[thisTxt] then
cands[thisTxt]=true
esType,esTxt = string.match(thisTxt,"^es(.+)(%[.+%])$")
if nil ~= esType then
esType = string.lower(esType)
--这是一个表情选项
if feishuFlg and nil ~= string.find(esType,'fs') then
--这是一个 feishu 表情，且当前在 feishu 中输入
if nil ~= esTxt then
yield(Candidate("word", cand.start, cand._end, esTxt, '😃'))
end
elseif wechatFlg and nil ~= string.find(esType,'wx') then
--这是一个 wechat 表情，且当前在 wechat 中输入
if nil ~= esTxt then
yield(Candidate("word", cand.start, cand._end, esTxt, '😃'))
end
elseif qqFlg and nil ~= string.find(esType,'qq') then
--这是一个 QQ 表情，且当前在 QQ 中输入
if nil ~= esTxt then
yield(Candidate("word", cand.start, cand._end, esTxt, '😃'))
end
elseif dingdingFlg and nil ~= string.find(esType,'dt') then
--这是一个 dingtalk 表情，且当前在 钉钉 中输入
if nil ~= esTxt then
yield(Candidate("word", cand.start, cand._end, esTxt, '😃'))
end
end
else
--这不是一个表情选项
if string.lower(string.sub(thisTxt, 1, 4)) == 'git-' then
-- 这是一个以 git 开头的选项，这被认为是一个 git 命令
if minttyFlg or cmdFlg then
-- 修剪选项
thisTxt = string.sub(thisTxt, 5)
-- git 命令选项只在 cmd 窗口或者是 mitty 窗口才允许输出，以避免造成干扰
yield(Candidate("word", cand.start, cand._end, thisTxt:gsub(" "," "), '💡'))
end
elseif string.lower(string.sub(thisTxt, 1, 3)) == 'py-' then
-- 这是一个以 py- 开头的选项，这被认为是一个 python 关键字
if pycharmFlg or vscodeFlg then
-- 修剪选项
thisTxt = string.sub(thisTxt, 4)
-- python 关键字选项只在 pycharm 或者 vscode 中才允许输出， 以避免造成干扰
yield(Candidate("word", cand.start, cand._end, thisTxt:gsub(" "," "), '💡'))
end
else
yield(Candidate("word", cand.start, cand._end, thisTxt:gsub(" "," "), '💡'))
end
end
end
end
end
end
end
end
end
return phraseExt_Filter
👆以下脚本代码中，我们可以看到一组开关状态获取代码，如下👇：
这些开关变量，使得一些特定的词组（例如App表情）只会在对应的应用程序环境下才会出现。例如只有在微信中进行录入时，才会出现微信专有的emoji词组，而在txt环境下录入时，则不会出现微信专属的emoji词组，这大大提升了输入法的录入体验。
💣注意：
以上👆所述文档 phraseExt commonPhrase.txt、phraseExt esAppEmoji.txt、phraseExt esUnicode.txt、phraseExt personal.txt、phraseExt_Filter.lua、phraseExt_Module.lua 共6个文档，应该位于 用户文件夹下的 lua 文件夹内，如下👇：
rime.lua
rime.lua脚本的内容如下👇：
help_translator = require("help")
inputShow_translator = require("inputShow")
inputShow_Filter = require("inputShow_Filter")
Upper_Filter = require("Upper_Filter")
dic_4w_Filter = require("dic_4w_Filter")
phraseReplace_Filter = require("phraseReplace_Filter")
pinyinAdding_Filter = require("pinyinAdding_Filter")
dateTime_Filter = require("dateTime_filter")
dynamicPhrase_Filter = require("dynamicPhrase_Filter")
phraseExt_Filter = require("phraseExt_Filter")
👆述脚本，在最后一行中，我们加载了phraseExt_Filter滤镜。
wubi_pinyin.custom.yaml
以上， 我们完成了 phraseExt_Filter 滤镜的所有的功能定义，我们现在需要做的就是在我们的输入方案中配置使用该 phraseExt_Filter 滤镜。此处以五笔・拼音输入方案为例，展示如何配置使用 phraseExt_Filter 滤镜。
在 五笔・拼音 输入方案的方案文档 wubi_pinyin.schema.yaml 的补丁文档 wubi_pinyin.custom.yaml中，我们增加如下的Filters配置：
# encoding:utf-8
patch:
switches/+: #增加以下开关
- name: phraseExt # 候选词扩展开关
reset: 1
states: [Off, phraseExt]
engine/filters: # 设置以下filter
- simplifier
- lua_filter@phraseExt_Filter # 自定义短语滤镜，针对响应的关键字，添加新的选项进来
注意，以上👆配置并不是wubi_pinyin.custom.yaml的全部配置，此处仅展示了与phraseExt_Filter有关的部分。
文档获取
👆以上所述配置文档，你可以在 rime中州韵小狼毫须鼠管输入法 联想词组滤镜配置包.zip 下载取用。
如果你可以访问gitHub，你也可以在 dyyRime 中找到完全版本的配置包。
小结
文章分享了一种在rime中州韵小狼毫须鼠管输入法中配置联想词组滤镜的方法。通过分别在phraseExt commonPhrase.txt、phraseExt esAppEmoji.txt、phraseExt esUnicode.txt、phraseExt personal.txt四个文档中分类整理定义了不同的联想词组，然后在phraseExt_Filter.lua、phraseExt_Module.lua两个脚本文档中实现了phraseExt_Filter 滤镜功能。最后以五笔・拼音输入方案为例，展示了如何在 五笔・拼音 输入方案中配置使用 phraseExt_Filter 滤镜的方法，最实现了预期的功能效果。
![[IDE]vscode显示文件路径](https://img-blog.csdnimg.cn/direct/f0ca977ac40a40d785588867983208fc.png)
