该开源项目 Wonkle 是面向节奏游戏《osu!》玩家的自研游戏硬件开源项目，Wonkle 项目试图通过开源硬件方案，为玩家提供高性价比、可自定义的专业游戏外设，填补商用数位板在游戏场景的适配短板。

一. 项目定位与背景

• 项目口号：Made by osu! players, for osu! players（由 osu! 玩家打造，服务于 osu! 玩家）

• 核心痛点：商用 Wacom 等数位板基于 电磁感应 (EMR) 技术，延迟高、压感曲线为绘画优化，不适配 osu! 高速点击、精准滑动的游戏需求；市面游戏外设选择极少、价格昂贵。

• 技术路线：采用霍尔效应传感器 (Hall Effect) 替代传统电磁感应，大幅降低输入延迟、提升定位精度，专为游戏场景优化。

• 开源协议：软硬件全部采用 OSI 认证开源协议，硬件原理图、PCB、3D 模型、固件代码完全开放，支持自由修改、复刻、二次开发。

• 项目前身：早期项目名pompyboard，后正式更名为 Wonkle，完成品牌与架构升级。

二、核心硬件产品（两大产品线）

项目主要开发两类 osu! 专用外设，均基于霍尔传感器方案：

1. 游戏数位板（核心产品）

• 设计目标：纯游戏向，不兼顾绘画，优化点击、滑动、急停操作

• 核心优势：

  • 霍尔传感器无电磁干扰，延迟远低于商用数位板

  • 自定义压感曲线、坐标响应，适配 osu! 高速节奏

  • 轻量化机身、专用游戏按键，可自定义快捷键

• 硬件文件：仓库内hw、pcb目录提供完整 PCB 板图、外壳 3D 模型、原理图，可直接打板制作

2. 专用小键盘（Keypad）

• 适配 osu! 多模式（Standard/Taiko/Catch/Mania）

• 低延迟机械轴、可自定义布局，配合数位板实现精准操作

三、仓库技术架构与目录解析

1. 代码技术栈

• 前端 / 网页：TypeScript(75.05%)、CSS、JavaScript，用于项目官网、配置工具

• 固件：嵌入式 C/C++，适配霍尔传感器、USB HID 协议

• 硬件：KiCad PCB 设计文件、STEP/STL 3D 外壳模型

• 文档：Markdown 格式文档、FAQ、贡献指南

2. 核心目录功能

四、软件与固件核心特性

1. 超低延迟优化：直接读取霍尔传感器原始数据，无冗余滤波，原生适配 USB 2.0 高速协议

2. 参数高度自定义：玩家可自行修改压感曲线、坐标偏移、死区、按键响应速度

3. 多系统兼容：Windows/macOS/Linux 全平台适配，原生支持 osu! 游戏输入

4. 开源可修改：固件代码完全开放，玩家可定制专属按键逻辑、操作模式

五、项目价值与行业意义

1. 玩家层面：打破商用外设垄断，玩家可低成本复刻高性能游戏数位板，获得媲美高端定制设备的操作体验

2. 开源硬件层面：开创霍尔传感器游戏数位板开源先例，为节奏游戏外设提供全新技术路线

3. 社区层面：玩家、开发者共同迭代，持续优化延迟、精度，形成专属 osu! 的硬件生态

六、License

MIT license

七、项目地址

https://github.com/wonkleio/wonkle