Rime-frost项目中实现置顶候选词标记⚡️符号的技术方案

背景分析

在Rime输入法框架中，rime-frost项目通过lua过滤器实现了对候选词的标记功能。其中is_in_user_dict.lua模块已经能够为不同类型的候选词添加特定标记符号，如用户词库显示'*'、整句联想显示'∞'。但用户发现通过pin_cand_filter.lua置顶的候选词尚未支持显示'⚡️'标记。

技术原理

Rime的候选词对象包含type属性标识词条来源：

• user_phrase：用户自造词
• sentence：整句联想
• user_table：用户表（包含置顶词）

lua过滤器通过修改cand.comment属性实现可视化标记，这是Rime输入法框架提供的标准扩展方式。

实现方案

方案一：修改pin_cand_filter.lua

在置顶逻辑处理完成后添加标记代码：

function filter(input, env)
    -- 原有置顶逻辑...
    for cand in input:iter() do
        if 是置顶词的条件判断 then
            cand.comment = '⚡️'
        end
        yield(cand)
    end
end

方案二：增强is_in_user_dict.lua

取消原注释代码并完善类型判断：

-- 用户置顶词标记
if cand.type == "pinned" or cand.type == "user_table" then
    cand.comment = '⚡️'
end

技术细节

1. 标记优先级：当多个过滤器同时修改comment时，后执行的过滤器会覆盖之前的标记
2. 类型判断：需要确认pin_cand_filter实际设置的type值，可能是"pinned"或保留"user_table"
3. 符号显示：建议使用等宽符号保证排版整齐，如'⚡'比'⚡️'占位更稳定

最佳实践

推荐采用方案二集中管理所有标记逻辑，保持代码维护性：

1. 在is_in_user_dict.lua中统一处理所有标记类型
2. 通过env.name_space判断当前schema决定是否启用标记
3. 使用条件编译避免符号编码问题

兼容性考虑

需测试不同平台（Windows/macOS/Linux）对特殊符号的渲染支持，必要时可回退到ASCII符号如"^"替代。对于移动端输入法，建议使用更醒目的emoji符号。

扩展思考

这种标记系统可以进一步扩展为：

• 分级标记（不同优先级使用不同符号）
• 动态标记（根据使用频率变化）
• 主题化标记（允许用户自定义符号）