插件安装与实践

本页提供了在几维输入法中部署第三方输入方案、Lua 脚本与定制词库的标准操作规程（SOP）。

部署输入方案

第三方输入方案通常由配置入口（.schema.yaml）和核心码表（.dict.yaml）组成。几维引擎支持以下两种标准的部署流。

方式一：使用东风破 (plum) 命令行部署

对于熟悉命令行的极客用户，推荐使用 Rime 官方维护的包管理工具 plum。它能自动处理依赖解析并将其注入引擎。

# 从 GitHub 拉取并安装指定的输入方案
bash rime-install scheme-name

方式二：手动结构化导入

1. 获取资源：从开源仓库下载方案包。
2. 物理落盘：将解压后的所有 .yaml 文件复制至 用户目录\ 根级路径。
3. 注册方案：创建或编辑 default.custom.yaml，向 schema_list 节点注册新方案。

patch:
  schema_list:
    - schema: luna_pinyin      # 朙月拼音
    - schema: double_pinyin_flypy # 小鹤双拼
    - schema: wubi86           # 五笔 86

4. 热重载：执行 重新部署，使引擎重建内部拓扑。

部署 Lua 脚本

Lua 脚本通过运行时虚拟机动态挂载，无需重启操作系统。

1. 落盘：将 .lua 源码文件放入 用户目录\lua\ 目录下。
2. 挂载节点：在对应的输入方案配置文件（如 witcraft.custom.yaml）中，依据脚本类型将其注入引擎的特定管线。

patch:
  engine/translators/+:
    - lua_translator@date_time  # 注入日期转换器
  engine/filters/+:
    - lua_filter@charset_filter # 注入字符集过滤器

3. 生效：保存配置并执行 重新部署。

词库集成与管理

词库的导入流已深度集成至几维的 Web UI 管理后台。

1. 准备标准格式的词库文件（.dict.yaml 或 .txt），必须确保使用 UTF-8 编码。
2. 进入设置中心，导航至 字典管理 面板。
3. 将文件拖拽至上传区域。后台将自动执行格式校验并将其分配至 用户目录\dicts\ 的对应域内。
4. 在面板中勾选并设定字典的合并优先级。
5. 提交保存并执行 重新部署。

编译性能提示

引擎在部署词库时会将其序列化为高压缩比的二进制索引文件（.bin）。对于包含百万级词条的超大型语料库，首次冷编译过程可能消耗 10–30 秒。在此期间请勿强制中断输入法进程。

社区高频脚本参考矩阵

以下是 Rime 社区中部署率最高的基础增强脚本示例：

功能域	典型输入/触发	预期输出效果
动态时间戳	rq / sj	2025-01-01 / 14:30:00
内联计算器	=123+456	579 (支持基础运算与括号层级)
纠错补偿	自动静默生效	利用编辑距离算法修复局部击键偏移。
字符集限缩	自动静默生效	将候选项强制锁定在 GB2312 范围内。
文本宏模板	email	username@example.com

高级环境：多词库挂载策略

在特定的主码架构下，可利用引擎的并行合并机制加载多域语料：

• Witcraft 架构：允许在 witcraft/primary 节点下同时挂载通用主码字典与行业专有字典。
• Witset 架构：通过在 translator/dictionary/import_tables 中声明数组，可并发引入 base（基础词元）、poetry（古诗词）与 place（结构化地名）。

欲深入了解引擎调度逻辑，请查阅 字典管理。