VIA 改键：下载 JSON 并在 DESIGN 中加载
VIA 可以修改键位和层。VIA JSON 是键盘定义，不是固件，也不是你保存的键位备份。 普通改键无需进入 DFU、无需刷机。
1. 连接键盘并下载匹配的 JSON
- 用 USB 数据线连接键盘，切到 USB 输出。TriChord / Command65 PE 用 LShift + RShift + U；DuoChord / 旧版 BLE 用 LShift + RShift + B 切换，直到 USB 输入正常。
- 在下载中心的 固件与 VIA JSON 下载列表，直接找到自己的产品、PCB revision 和无线后端，点击该行 JSON。不必先走固件选择器。
- 保存
.json文件，不要改扩展名。后端选你当前正在运行的版本：Bluefruit、DuoChord 或 CH592；不要因为想升级就先用另一个后端的定义。
Vial 固件请优先使用 Vial：它内置定义，通常不需要导入 VIA JSON。本站没有为某目标提供 JSON 时，不要套用相似型号的文件。
2. 显示 DESIGN 面板并加载 JSON
- 用支持 WebHID 的桌面版 Chrome / Edge 打开 VIA 网页版。
- 点击 SETTINGS（齿轮），开启 Show Design tab。
- 切换到 DESIGN 面板，点击 Load Draft Definition，选择刚才下载的键盘定义
.json。 - 如果该定义是旧格式，按界面提示启用 Use V2 definitions (deprecated) 后重新加载；不要手动修改 JSON 中的 VID / PID 来强行匹配。
- 回到 CONFIGURE，点击 Authorize device / 授权设备，在浏览器弹窗中选择用 USB 连接的键盘，点击连接。
- 看到与实际键盘匹配的布局后，再开始改键。若弹窗没有键盘，先检查数据线、USB 输出模式和其他占用设备的改键软件。
3. 改一个键并验证
- 在 CONFIGURE → KEYMAP 选择层。Layer 0 是基础层；Layer 1 等层需要 Fn / MO 等切层键才能使用。
- 点击画面中的目标键，再点击下面要赋予的新功能。修改会写入键盘，不需要再刷固件。
- 切回文本编辑器测试。先保留至少一个能进入功能层的 Fn / MO 键，避免改完无法回到需要的层。
- 用 SAVE + LOAD 保存当前键位备份。以后在同型号、兼容固件下从这里加载；不要在 DESIGN 中导入这个备份文件。
JSON 导入了仍不能改键？
| 现象 | 先检查 |
|---|---|
| 没有 DESIGN | SETTINGS → Show Design tab 是否开启 |
| JSON 报格式错误 | 是否下成了网页、键位备份或固件；旧定义是否需要 V2 开关 |
| 授权列表没有键盘 | USB 数据线、输出模式、浏览器 WebHID 支持；关闭其他 VIA / Vial 窗口再试 |
| 有设备但布局不对 | PCB revision / 后端 / JSON 是否与当前固件一致，删除错误 draft 后重新导入 |
| 无线下可以打字但 VIA 不识别 | 改用 USB 直连键盘；不要选择 2.4G 接收器替代键盘 |
界面依据：VIA 官方 DESIGN 实现与设置实现。不同版本的按钮大小写可能不同。