🗣️ 万象模糊音配置指南

万象输入法在底层的 wanxiang_algebra.yaml 文件中，已经为你预设了极丰富且精准的模糊音规则。

⚠️ 核心原则： 绝对不要直接修改 wanxiang_algebra.yaml 原文件！ 因为万象版本更新时会覆盖该文件。所有的开启与自定义操作，都应当在你的专属配置文件 wanxiang.custom.yaml 中进行。

🛠️ 第一步：预设模糊音“菜单”

你可以根据自己的方言习惯，在配置中引用对应的标识符（Key）：

标识符 (Key)	说明
`模糊音`	全家桶：开启下方所有的模糊音规则
`模糊音_nl`	`n` 和 `l` 不分
`模糊音_ry`	`r` 和 `y` 混淆 (开头)
`模糊音_hf`	`h` 和 `f` 混淆 (开头)
`模糊音_rl`	`r` 和 `l` 混淆 (开头)
`模糊音_kg`	`k` 和 `g` 混淆 (开头)
`模糊音_en_eng`	`en` 和 `eng` 前后鼻音混淆
`模糊音_in_ing`	`in` 和 `ing` 前后鼻音混淆
`模糊音_c_ch`	平翘舌 `c` 和 `ch` 混淆
`模糊音_z_zh`	平翘舌 `z` 和 `zh` 混淆
`模糊音_s_sh`	平翘舌 `s` 和 `sh` 混淆

🚀 第二步：在 Custom 中开启引用

打开你的 wanxiang.custom.yaml，找到顶部的 patch 段落，通过 __patch 路径引用你需要的规则。

配置示例：

patch:
  speller/algebra:
    __patch:
      # ✅ 正确做法：按需引用具体的套餐，可以写多行
      - wanxiang_algebra:/模糊音_nl             # 开启 n/l 模糊
      - wanxiang_algebra:/模糊音_s_sh            # 开启 s/sh 模糊
      - wanxiang_algebra:/模糊音_en_eng         # 开启 en/eng 模糊

      # 💡 引用主输入方案（必须包含一行，确保基础拼写正常）
      - wanxiang_algebra:/base/全拼            
      # 可选方案：全拼, 自然码, 小鹤双拼, 搜狗双拼, 微软双拼, 智能ABC, 紫光双拼, 国标双拼, 拼音加加, 乱序17

⚙️ 进阶：自定义专属模糊音

如果预设列表中没有你需要的特定混淆规则，你需要自行在 wanxiang.custom.yaml 中编写。

🚨 致命避坑警告（层级陷阱）

当你编写自定义段落（如 my_fuzzy:）时，该段落绝对不能写在 patch: 的缩进内部！ 它必须与 patch: 平级，通常建议写在文件的最末尾。如果放错了位置，会导致后面的配置被截断，引发输入法报错。

自定义示范：

patch:
  speller/algebra:
    __patch:
      - my_fuzzy           # 1. 在这里引用你自己定义的 Key
      - wanxiang_algebra:/base/全拼

  # 这里是你中间其他的patch内容


# 2. 关键：在文件最末尾顶格写，不要缩进！
my_fuzzy:
  __append:
    # 比如你需要把 hu 模糊成 fu
    - derive/^h/f/
    - derive/^f/h/

💡 总结

精准引用：优先使用预设的具体 Key（如 模糊音_s_sh），而不是笼统的 模糊音，除非你需要全部开启。
位置重要：引用的代码行（- wanxiang_algebra:/...）通常放在 algebra 列表的靠后位置。
保护原件：永远在 .custom.yaml 里折腾，万象的本体文件 wanxiang_algebra.yaml 动都不要动。
不生效啊：那一定是叠加了其他的错误，没有例外。