无线版改键软件

无线版与经典版现在共用同一套 BinaryKeyboard Studio，但改键时仍必须通过 USB 连接。

浏览器要求

浏览器	版本要求	支持
Chrome	≥ 89	✅
Edge	≥ 89	✅
Opera	≥ 75	✅
Firefox	-	❌
Safari	-	❌

重要

改键需要通过 USB-C 连接，蓝牙、2.4G 模式下暂时无法进行配置。

使用步骤

1. 切换到 USB 模式

1. 用 USB-C 连接键盘到电脑
2. 键盘会自动切换到 USB 模式
3. 此时蓝牙连接会断开

2. 连接改键工具

1. 打开改键工具页面
2. 点击"连接设备"按钮
3. 在弹出的设备选择框中选择你的键盘
4. 授权浏览器访问 USB 设备

功能说明

CH592F 无线版在 Studio 中支持完整配置面：

• 多层键位映射
• FN 键配置
• RGB 灯效配置
• 宏编辑器 - 通过图形界面编辑和管理宏
• 电池状态
• HID 日志 / Debug Terminal

TIP

配置写入后会保存在键盘内部，无论 USB 还是蓝牙模式都会生效。

固件更新

CH592F 固件更新分成两条路径：

1. 日常更新：直接在 Studio 里点

设备正常连接 Studio 时，使用这一条路径：

1. 用 USB 连接键盘
2. 打开设备信息卡片
3. 点“更新到最新版本”或“重刷当前版本”
4. Studio 会自动下载当前协议对应的最新 bin
5. 写入完成后设备重启，高地址 IAP 会自动把新固件搬到运行区

2. 首次烧录 / 恢复：走 WCHISP

首次烧录或恢复时，使用以下整包：

• CH592F-5KEY-<version>-full.hex
• CH592F-KNOB-<version>-full.hex

这两个 -full.hex 用于 ISP 首刷与恢复。

WARNING

普通 CH592F-<MODEL>-<version>-app.bin 是 OTA 包，不是首刷包。

TIP

如果 Studio 已显示新版本，但更新按钮仍提示下载文件未准备好，通常表示 Pages 上的固件镜像仍在同步。

宏编辑器使用指南

宏编辑器允许你创建和管理键盘宏。每个宏最多可以包含 8 个槽位（0～7），每个槽位最多 2KB 的数据。

宏管理面板

在左侧面板的"宏管理"区域，显示 8 个宏槽位：

• 数字编号（1～8）：槽位号
• 文字标签："空" 表示该槽位无宏，否则显示宏名称
• 颜色标识：有宏的槽位会高亮显示

点击任意槽位按钮即可打开对应的宏编辑器。

编辑器界面

头部区域

• 宏编辑器 标题和 槽位号
• 宏名称输入框：输入宏的名字（最多 255 字节，支持 UTF-8）
• 字符计数：显示当前名称占用的字节数（如 5/255）

动作编辑区

这是主要的编辑区域，显示宏中的所有动作卡片。

空状态：当宏为空时，显示提示信息"点击下方按钮添加动作，或录制一段操作"

动作卡片布局：

┌─ [拖拽] [图标] [分类] [描述]              [延时输入] [删除]
├─────────────────────────────────────────────────────────
└─ [拖拽] [图标] [分类] [描述]              [延时输入] [删除]

卡片组成：

元素	说明
拖拽按钮	六线图标，点击并拖动可重新排序动作
分类图标	根据动作类型显示不同颜色： 🔵 键盘（蓝）、🟢 鼠标（绿）、🟠 媒体（橙）
分类标签	显示动作类别：键盘、修饰键、鼠标、滚轮、媒体
描述文本	显示具体动作内容（如"按下 A"、"左键"）
延时输入	所有动作的延时值（毫秒，10～10000ms，步进 10）
删除按钮	点击删除该卡片

延时说明：

• 每个动作后都可以设置延时
• 延时在该动作执行完成后生效
• 用于控制宏执行速度，模拟真实的人类操作节奏

统计信息

编辑区下方显示宏的统计数据：

X 卡片 · Y 动作 · Z / 2048 字节

• 卡片数：当前有多少个动作卡片
• 动作数：实际的输入/输出事件数（一个卡片可能包含多个事件）
• 数据大小：宏占用的字节数 / 最大限制（2048 字节）

超限提示

如果数据大小超过限制，数字会变成红色，保存按钮也会被禁用。此时需要删除一些动作。

页脚 - 操作栏

添加动作按钮（左侧）：

• 按键：添加键盘按键动作（默认为 Space 键，需手动修改）
• 鼠标：打开鼠标按键菜单
  • 可以选择左键、右键、中键、后退、前进
  • 滚轮菜单：向上、向下
• 媒体：打开媒体按键菜单
  • 常见多媒体键：播放/暂停、音量增加、音量减少、下一曲等
• 录制：开始/停止录制模式
  • 按红色"停止"按钮结束录制
  • 此时不能点击其他按钮

动作按钮（右侧）：

• 删除宏（仅在该槽位有现存宏时显示）：删除当前槽位的整个宏
• 取消：放弃编辑，关闭编辑器，不保存更改
• 保存：保存当前宏到键盘

添加动作的方法

方法 1：手动添加（单个动作）

1. 点击"按键"、"鼠标"或"媒体"按钮
2. 对于"按键"，会自动添加"按下"和"释放"两个卡片，然后进入按键捕获模式
3. 按下你想要的键，宏编辑器会自动识别并填充
4. 或者从鼠标/媒体菜单选择一个动作

方法 2：录制功能

1. 点击"录制"按钮，按钮变成红色状态
2. 在键盘上执行你想要录制的操作序列
   • 支持按键按下、释放
   • 支持修饰键组合（Ctrl、Shift、Alt、Win）
   • 宏编辑器会自动计算按键间的延时
3. 按 Esc 或点击"停止"按钮结束录制
4. 录制的按键序列会自动添加到宏中

录制建议

• 正常操作速度即可，不需要很快
• 录制会自动计算按键之间的间隔时间
• 可以多次按 Esc 或使用停止按钮来调整录制结果

方法 3：修改现有动作

1. 点击卡片上的描述文本（如"按下 A"）
2. 进入按键捕获模式（按钮变成红色）
3. 按下新的按键替换
4. 对于修饰键组合，按住 Ctrl/Shift/Alt/Win 再按其他键，宏编辑器会自动生成修饰键的前置和后置卡片

常见操作示例

示例 1：输入一个固定短语

1. 新建一个空宏
2. 逐个添加字母按键：按键 A → 按键 B → 按键 C
3. 调整延时为适当的间隔（如 50ms）
4. 保存

示例 2：快捷键组合

1. 点击"按键"添加动作
2. 进入编辑模式后，按 Ctrl+S（保存快捷键）
3. 宏编辑器自动生成：
   • 按下 LCtrl（延时 0）
   • 按下 S（延时 50）
   • 释放 S（延时 0）
   • 释放 LCtrl（延时 0）
4. 微调延时后保存

示例 3：鼠标点击序列

1. 点击"鼠标" → 选择"左键"
2. 点击"鼠标" → 选择"向下"（滚轮）
3. 点击"鼠标" → 选择"右键"
4. 调整各步骤的延时，保存

动作卡片编辑

修改动作

• 点击描述文本：进入编辑模式，可以修改该动作的具体参数
• 修改延时：直接在延时输入框中修改，支持键盘 Tab 切换和手动输入
• 拖拽排序：点击左侧的拖拽按钮，可以改变动作执行顺序

关键顺序约束

键盘和鼠标的"按下"和"释放"必须是成对的，不能出现"释放"在"按下"前的情况。拖拽时编辑器会验证顺序。

删除动作

点击卡片右侧的删除按钮（✕），该动作会被移除。

宏命名规范

• 支持中文、英文、数字、符号等任意 UTF-8 字符
• 每个宏最多 255 字节
• 建议使用有意义的名称，便于记忆和管理

保存和应用

1. 所有编辑完成后，点击"保存"按钮
2. 宏编辑器会验证：
   • 动作顺序是否合法
   • 数据大小是否超限
3. 验证通过后，宏会被写入键盘内存
4. 写入成功后编辑器自动关闭

测试和调试

虽然编辑器中无法直接测试，但可以：

1. 保存宏后关闭工具
2. 在实际应用中使用宏（通过键盘的相应按键触发）
3. 如果效果不理想，重新打开编辑器进行微调

调试建议

• 编辑好后先用较长的延时（如 100ms）测试
• 确认功能正确后，逐步减少延时以加快速度
• 观察实际执行效果，调整参数

常见问题

宏相关

Q: 如何制作快捷键宏？

A: 点击"按键"后进入编辑模式，按下你想要的快捷键组合（如 Ctrl+S）。编辑器会自动生成修饰键的前置/后置卡片。

Q: 宏可以互相嵌套吗？

A: 不能。每个宏是独立的按键/鼠标/媒体事务序列。

Q: 如何删除整个宏？

A: 打开宏编辑器后，点击左下角的"删除宏"按钮（仅在宏存在时显示）。

Q: 宏有大小限制吗？

A: 有。每个槽位最多 2048 字节。编辑器会实时显示当前大小和限制。

Q: 成对的键盘按键可以乱序吗？

A: 不能。"按下"必须在"释放"前面。如果顺序不对，保存时会提示错误。

常见问题

TODO