Files
msime-windows/engine/helpcode
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
..

公共辅助码

供 Windows、Apple 和 Linux 共用的辅助码数据。

所有辅助码文件统一放在 helpcodes\ 目录下。当前 server 使用的方案和文件为:

  • lantian:helpcode.txt(蓝天小雨点)
  • ziranma:zrm_helpcode_big_unique.txt(自然码)
  • shouyou2_0:shouyou2_0_helpcode.txt(首右2.0)
  • shouyouplus:shouyouplus_helpcode.txt(首右plus)
  • xiaohe:xiaohe_helpcode.txt(小鹤)
  • jiajia:jiajia_helpcode.txt(拼音加加)

公共数据位于 Engine 的 helpcode/helpcodes/,平台打包时复制需要的文件到应用资源目录。运行时路径由平台传给引擎,不依赖作者机器的绝对路径。合仓后的消费端无需再单独检出 HelpCode 仓库。

helpcodes\custom\ 是留给用户的目录:运行时放进去的每个 .txt 都是一套方案,方案名为 custom/<文件名>,由 HelpcodeUtils::list_custom_helpcode_schemas 扫描。文件开头的 # name: / # name_en: 注释给出中英文显示名,缺省用文件名。面向用户的格式说明见 helpcodes/custom/README.md,它随安装包一起放进用户的数据目录。安装器升级时保留这个目录。

取码规则

各方案的取码规则不同,写文档时不要互相套用:

  • jiajia(加加):按笔顺拆出前两个部件,各取读音首字母(妈 = 女 n + 马 m = nm,暗 = 日 r + 音 y = ry)。 部件按拼音加加的俗称读音取音:亻=d(单人旁)、扌=t(提手旁)、纟=j(绞丝旁)、忄=s(竖心旁)、 攵=f(反文旁)、夂=z(折文儿)、刂=l(立刀旁)、彳=s(双人旁)。
  • jiajia 的独体字与部首字取「本字声母 + 起笔笔画」(h 横、s 竖、p 撇、n 点/捺、z 折),共 138 个字。 这是与拼音加加原表刻意保留的差别:加加对这些字给的是另一套拆法(笔画码或不同的部件拆分)。来源与授权见 NOTICE.md。

参考