
这是什么
一台可以自己攒出来的 ESP32-S3 键盘:九个机械按键、一个拨动开关、一个旋转编码器和一块 76×284 的 LCD,通过 USB 以键盘和鼠标的身份工作。仓库里放着做出一台所需的全部东西——Arduino 固件、一个通过串口配置键位并写入 EEPROM 的 Python 工具、LCEDA 工程文件、Gerber 与原理图 PDF,以及 3D 打印外壳的 SketchUp 源文件和 STL。
谁做的在博客 GeekLogic 上记录自己项目的硬件玩家,2012 年就注册了 GitHub。他的二十个仓库大多是复古计算硬件:TRS-80 Model 100 复刻机、Apple II 的 SD 卡接口、可烧录的 MSX 卡带、DRAM 测试仪、ZX81 的 ULA 替换件,还有一个播放 Amiga MOD 音乐的木头盒子。他的博客由一颗国产龙芯 3A6000 提供算力。
制作过程
7 个阶段- 01
源头是一张梗图
作者是在一张网上流传的图里看到这个想法的:一把被标为「Vibe Coding 专用」的玩笑键盘。他形容它一半是玩笑,一半是对未来的隐喻,而他从图里带走的问题是——如果这种「感觉」被实体化,会是什么样。这个项目就是那个问题的字面回答。他在 2026 年 4 月 26 日发布的公告文章里写明,所有代码和建模都在那个仓库里开源。
- 02
这个东西到底是什么
设备是 ESP32-S3,选它是因为自带原生 USB 接口;它驱动一块 76×284 的 ST7789 屏、九个机械按键、一个拨动开关,以及一个支持顺时针、逆时针和按下的旋转编码器,对外表现为 USB HID 键盘和鼠标。按键通过一个 Python 桌面工具配置,工具经串口与键盘通信并把结果写入 EEPROM,共支持十套键位方案。每个按键带一个最多七字符的短名称、一种触发模式(同时触发、顺序触发、粘滞触发),以及最多五个 HID 键值。README 把每个部件的 GPIO 都列了出来,接线不需要靠猜。
- 03
仓库本身就是一份物料清单
让它「能做出来」而不只是「能演示」的是那份文件清单:LCEDA 工程文件、两个用于制板的 Gerber 压缩包、两份原理图 PDF,以及一个同时提供 SketchUp 源文件和 STL 的 3D 模型目录——上盖、底壳、显示屏外壳、开关帽和空格卫星轴定位板。整个仓库二十五个文件,而全部历史只有九次提交。
- 04
一位读者发现了 5V 接线问题,当天就改掉了
issue #1 问的是:CH340C 是 5V 器件,直接连到 ESP32-S3 的 TX 和 RX 上,而 ESP32 的引脚都是 3.3V 耐压,这样不会烧坏吗。作者回复说实际使用一直没出问题,但为保险起见会加一个电平转换电路,随后更新了原理图和 PCB 制板文件。仓库的最后一次提交(2026 年 4 月 17 日)就是这个改动。这是这个项目公开记录里最具体的一件事:一位读者发现了电路问题,原理图和制板文件在大约两小时后就被改正。
- 05
数字长什么样
2026 年 4 月 1 日到 17 日之间九次提交,全部来自同一位作者,之后再无动作。没有 release,也没有 tag。README 标注的版本是 0.1,日期写的是 2026 年 2 月 8 日,比第一次提交早约七周。共有三个 issue:电平转换那个问题;一个索要 BOM 以便交给制板厂做贴片的请求(作者回复了从 EDA 工具导出 BOM 的菜单路径);以及一个仍然开着的请求——把板子改成四麦克风阵列做定向拾音,提出者表示愿意负责软件部分。236 颗星、32 个 fork,而这个项目在五个月前就停下来了。
- 06
同一个前提,各自想到的
同年晚些时候,GitHub 上又出现两个面向 AI 编程工作流的 ESP32-S3 桌面控制器:2026 年 6 月的 JoeShi/ki-board,围绕五块小屏在多个编程 agent 之间切换;以及 7 月的 zerob13/vibe-keyboard,一个配 428×142 板子的 macOS 控制器。两者都没有引用这个仓库,硬件也不一样——ki-board 用的是微雪(Waveshare)模块,不是自制板。它们共享的是同一个前提:桌上放一个小实体,它的职责是跟编程 agent 说话,而不是打字给它。
- 07
README 自己怎么说收尾
README 的收尾部分更像一句说明而不是路线图:这个项目就是做着玩的,代码是手搓的、结构化不好,作者欢迎别人一起完善,并希望有人加上蓝牙和 WiFi,把它做成无线键盘,或者找到新的用途。复用遵循 GPL-3.0,附带的要求是保留作者信息和许可声明。