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。
27 lines
1.3 KiB
Markdown
27 lines
1.3 KiB
Markdown
# 自定义辅助码
|
||
|
||
把自己的辅助码方案放进本目录，在设置窗口「辅助码」页点「刷新方案」（或重新打开设置窗口）后，就能在双拼和全拼方案下拉框里选到它。修改正在使用的方案文件后，要切换一次方案或重启输入法才会生效。
|
||
升级安装会保留本目录里的文件；卸载输入法时会随数据目录一起删除，请自行备份。
|
||
|
||
## 文件要求
|
||
|
||
- 扩展名必须是 `.txt`，编码必须是 UTF-8（带不带 BOM 都可以）。
|
||
- 每行一个字：`字=辅助码`，辅助码取等号后的前两个小写字母（`a`–`z`），例如 `妈=nm`。
|
||
- 以 `#` 开头的行是注释，会被忽略。
|
||
- 方案在配置里记作 `custom/<文件名去掉 .txt>`，改文件名等于换了一个方案；当前选中的方案文件被删掉或改名后，会回退到蓝天小雨点。
|
||
|
||
## 方案名称
|
||
|
||
设置里默认按文件名显示。想换个名字，在文件开头加上注释：
|
||
|
||
```text
|
||
# name: 我的辅助码
|
||
# name_en: My Helpcode
|
||
阿=ek
|
||
锕=jk
|
||
```
|
||
|
||
- `name` 是中文名，设置页显示它；`name_en` 是英文名。
|
||
- 只写其中一个时，另一个用同一个名字；两个都不写就用文件名。
|
||
- 冒号用半角 `:` 或全角 `：` 都行。名称注释只在文件开头（第一个非注释行之前）生效。
|