Files
msime-windows/engine/helpcode/helpcodes/custom/README.md
T
Lu Fan(SonnyCalcr) 4375d80414 feat: 支持导入自定义辅助码,内置“加加”更名为“拼音加加” (#477)
* feat(engine): 支持 helpcodes/custom 下的自定义辅助码

custom 目录里的每个 .txt 都是一套方案,方案名为 custom/<文件名>。
文件开头的 "# name:" / "# name_en:" 注释给出中英文显示名,缺省用文件名;
兼容 BOM、CRLF 和全角冒号。方案名不能跳出 custom 目录。

* feat(engine): WebView 契约新增 openHelpcodeDirectory

设置页请求打开自定义辅助码目录,仅允许 settings 页发送。同步 ui-html/webview2/shared。

* feat(server): 设置页列出自定义辅助码并可打开其目录

配置快照带上 helpcode.custom_schemas 与 helpcode.custom_directory,每次都会重新扫描;
方案文件被删除或改名后回退到 lantian。两个设置宿主都会处理 openHelpcodeDirectory。

* feat(ui-html): 辅助码设置显示拼音加加与自定义方案

内置方案“加加”改名为“拼音加加”。自定义方案追加在内置方案之后;新增说明区,
提供“打开目录”和“刷新方案”两个按钮,刷新完成后弹出提示。

* feat(installer): 升级与迁移数据目录时保留自定义辅助码

升级清理时只清掉 helpcodes 里的内置表,保留 custom 子目录;更换数据目录时一并迁移;
安装时建出 helpcodes\custom。
2026-09-26 20:21:55 +08:00

1.3 KiB
Raw Blame History

自定义辅助码

把自己的辅助码方案放进本目录,在设置窗口「辅助码」页点「刷新方案」(或重新打开设置窗口)后,就能在双拼和全拼方案下拉框里选到它。修改正在使用的方案文件后,要切换一次方案或重启输入法才会生效。 升级安装会保留本目录里的文件;卸载输入法时会随数据目录一起删除,请自行备份。

文件要求

  • 扩展名必须是 .txt,编码必须是 UTF-8(带不带 BOM 都可以)。
  • 每行一个字:字=辅助码,辅助码取等号后的前两个小写字母(a–z),例如 妈=nm。
  • 以 # 开头的行是注释,会被忽略。
  • 方案在配置里记作 custom/<文件名去掉 .txt>,改文件名等于换了一个方案;当前选中的方案文件被删掉或改名后,会回退到蓝天小雨点。

方案名称

设置里默认按文件名显示。想换个名字,在文件开头加上注释:

# name: 我的辅助码
# name_en: My Helpcode
阿=ek
锕=jk
  • name 是中文名,设置页显示它;name_en 是英文名。
  • 只写其中一个时,另一个用同一个名字;两个都不写就用文件名。
  • 冒号用半角 : 或全角 : 都行。名称注释只在文件开头(第一个非注释行之前)生效。