Lu Fan(SonnyCalcr)
4375d80414
* 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。
31 lines
2.1 KiB
Markdown
31 lines
2.1 KiB
Markdown
# 公共辅助码
|
||
|
||
供 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](./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](./NOTICE.md)。
|
||
|
||
## 参考
|
||
|
||
- 自然码辅助码：<https://github.com/copperay/ZRM_Aux-code>
|