网页设备配置
在网页中配置三个按键、TX 灯光与无操作休眠，无需安装软件。
打开网页配置配对管理和手动固件升级仍使用 PC 工具。
VOICE KB / SUPPORT
开始使用。
继续创造。
工具、指南与外壳模型，把你的设备变得更顺手。
01 / DOWNLOADS
配置与下载
Voice KB PC 工具
配置三个按键、灯光和休眠，管理配对，以及通过 USB 手动升级固件。
下载源码预览包当前提供源码预览包，尚未提供独立 EXE 安装包。
固件与升级
发射端与接收端分别通过 USB 直连，手动选择对应固件包进行升级。
请使用适合当前硬件版本的正式发行包。
02 / MAKE YOUR OWN
3D 打印外壳文件
打印喜欢的颜色
将提供外壳 3D 打印文件。你可以选择喜欢的打印材料颜色，制作自己的外壳，也可以基于文件做二次开发。
从模型继续设计
让颜色、外形和个性细节更贴近你的使用习惯。公开的模型文件会成为你进一步设计的起点。
具体模型版本、修改范围及使用许可将随文件说明提供。这里展示的是外壳模型的二次开发能力。
查看外壳实拍 ↗03 / QUICK START
第一次使用
- 连接 USB 接收器。在 Windows 系统或语音工具里，选择 Voice KB 对应的麦克风输入设备。
- 确认语音工具的快捷键。根据你使用的输入法或语音软件，确定需要映射的热键。
- 配置实体按键。在桌面版 Chrome 或 Edge 打开网页配置页连接 RX，读取后调整并保存；也可使用 PC 工具。
- 设置 TX 灯光与休眠。连接设备本体，在网页配置页切换到“设置灯与休眠”。
- 开始输入与操作。使用你的语音工具进行识别，再用实体键触发已经配置的操作。
语音识别由所用软件完成，是否需要联网、账号或付费由该软件决定。实体键的动作也取决于应用快捷键设置。
运行 PC 源码工具
解压下载包后，在文件夹中打开终端。确认已安装 Python 3.10 或更高版本及 Tkinter，再执行：
python -m pip install -r requirements.txt
python pc/vkb_pc_tool.py设置按键时连接接收器；设置灯光和休眠时通过 USB 连接发射端。升级时直接连接需要升级的设备，并选择匹配的本地固件包。
04 / COMPATIBILITY
系统与连接说明
| 项目 | 当前说明 |
|---|---|
| 网页配置 | 需桌面版 Chrome 或 Edge、HTTPS（localhost 可用于本地调试）及 USB HID 权限。 |
| Windows | 当前 PC 工具与使用指南优先面向 Windows。 |
| macOS / 其他系统 | 音频、按键与配置工具能力需分别验证，当前未提供完整兼容承诺。 |
| 接收器 USB | 电脑侧音频与键盘输入，以及接收器配置和升级。 |
| 发射端 USB | 充电、配置与手动升级；当前不作为有线音频输入模式介绍。 |
| 语音输入软件 | 需支持相应麦克风输入及配置的热键；操作方式随应用而异。 |
05 / HELP
常见问题
为什么按了语音键，没有出现文字？
检查语音工具是否运行、麦克风输入设备与权限是否正确，以及实体键映射是否与该软件快捷键一致。
工具连接到哪一个设备？
按键映射配置保存在接收端；灯光与休眠设置通过发射端 USB 读取和保存。按工具的设备角色与提示选择目标。
如何取得模型和正式固件？
此初版已预留下载位置。正式模型与固件文件尚未加入，文件到位后会在对应区域提供下载与说明。