检测浏览器…

插上键盘,自动识别,一键改键

VIA 与 ZMK Studio 统一入口 —— 不用记网址、不用翻说明书,识别到什么键盘就给什么工具。

DC / DS 系列 → VIA · DZ 系列 → ZMK Studio

点击后在弹窗中选择你的 CZM 键盘并点「连接」。需要 Chrome / Edge 浏览器(WebHID)。
当前浏览器不支持自动识别。
请使用电脑版 ChromeEdge 浏览器打开本页(不支持 Safari / Firefox / 手机浏览器)。仍可使用下方的手动入口。
尚未连接键盘 —— 插入键盘后点上方按钮,本页会显示型号和对应的配置入口。

手动选择工具

知道自己键盘系列的话,直接进;自动识别结果里也会给出对应入口。

VIA DC / DS 系列

CH585 / QMK 方案键盘使用。网页版实时改键、宏、灯效,改完立即生效,无需刷固件。

  1. 用 USB 线连接键盘
  2. 打开 VIA,点 Authorize Device 授权
  3. 若识别不到键盘,加载本站的键位定义 JSON(见下方支持表)
打开 VIA 网页版 →

ZMK DZ 系列

NRF52840 + ZMK 方案键盘使用。ZMK Studio 实时改键并写入键盘,支持多设备切换。

  1. 用 USB 线连接键盘(蓝牙改键需 Linux 客户端)
  2. 打开 ZMK Studio,选择键盘对应的串口
  3. 首次使用需要触发键盘上的 &studio_unlock 解锁键
打开 ZMK Studio →

支持型号

插键盘自动匹配;VIA 定义 JSON 可下载后手动加载到 VIA。新型号陆续更新。

CZM 键盘产品与配置工具对照表
型号系列 / 方案VID : PID配置工具VIA 键位定义
DS22R6 数字小键盘DS · CH585 双模 8K0x4A17 : 0x4A40VIAds22r6_via.json
DS17R3 数字小键盘DS · CH5850x4A17 : 0x4A18VIAds17r3_via.json
CZMAO EC8787 键 · QMK0x4A17 : 0x0004VIAec87_via.json
left6464 键 · QMK0x7F89 : 0x4A35VIA随固件提供
DZ 系列(DZ17 等)DZ · NRF52840 + ZMK0x4A17 : 自动识别ZMK Studio
DC 系列三模 8KDC · CH585M 三模0x4A17 : 自动识别VIA随固件提供

三步开始

整个过程不用安装任何软件。

STEP 1

USB 连接键盘

用数据线把键盘插到电脑上(充电线可能没有数据功能,建议用原装数据线)。

STEP 2

点「连接键盘」

在浏览器弹窗里选中 CZM 键盘并授权,页面会显示型号和配置入口。

STEP 3

打开工具改键

VIA 或 ZMK Studio 打开后即可图形化改键,修改实时保存,无需重新刷固件。

常见问题

遇到问题先看这里,也可以联系淘宝客服。

VIA 打开后一直显示 Searching for devices / 看不到键盘布局

说明 VIA 还没有这把键盘的键位定义。操作:1) 在本页「支持型号」表里下载你键盘对应的 .json 文件;2) 打开 VIA → 右上角 Settings(齿轮)→ 打开 Show Design tab 开关;3) 切到新出现的 Design 标签页,把 JSON 文件拖进去加载;4) 回到 Configure 标签页,点 Authorize Device 授权即可。

ZMK Studio 提示找不到设备 / 串口列表为空

DZ 系列需要键盘固件开启 ZMK Studio 功能(出厂固件默认开启)。打开 zmk.studio 后选择 USB 串口;若键盘有多个串口,选非蓝牙的那个。首次连接需按一次键盘上的 &studio_unlock 解锁键(默认在功能层)。Linux 用户如提示无权限,需把当前用户加入 dialout 用户组。详见 ZMK Studio 官方文档

点「连接键盘」后弹窗里没有我的键盘

检查:1) 数据线是否支持数据传输;2) 浏览器是否为电脑版 Chrome / Edge(Safari、Firefox、手机浏览器均不支持 WebHID);3) 三模键盘请切到有线模式或插线使用。确认无误仍看不到,可直接用上方「手动选择工具」。

改完的键位会丢吗?

不会。VIA / ZMK Studio 的修改都直接写入键盘自身存储,换电脑、拔插键盘都保留,不依赖本页面。本页只负责识别和引导,不读取、不上传你的任何键位数据。

自动识别准确吗?识别错了怎么办?

识别依据是键盘的 USB 厂商标识(VID/PID)和产品名,CZM 自有产品 VID 为 0x4A17(left64 特例 0x7F89)。若显示「未登记设备」,按你的键盘系列手动选择上方工具即可,并联系客服更新识别库。