vibeboard — A Keypad Built for Vibe Coding
vibeboard —— 为 Vibe Coding 而生的按键板
A 3-key + knob macropad (RP2040 · QMK · VIA) that turns “open the AI, dictate, hit enter” into physical buttons. 一个 3 键 + 旋钮 的宏键盘(RP2040 · QMK · VIA),把”打开 AI、口述需求、回车提交”变成实体按键。
|
|
|
|---|---|
|
Difficulty / 难度 |
Intermediate / 中级 |
|
Time / 耗时 |
~2–4 hours / 约 2–4 小时 |
|
Cost / 成本 |
~$10–20 / 约 ¥70–150 |
|
Skills / 技能 |
Basic soldering, QMK compile, VIA / 基础焊接、QMK 编译、VIA |
TL;DR
EN. Vibe coding means steering an AI assistant instead of typing every line. The friction isn’t the typing anymore — it’s the little dance of open the AI panel → start voice input → submit. vibeboard collapses that into three keys and a knob, built as a proper QMK keyboard with VIA support: every key and the encoder are remappable live from a GUI, no recompiling. The default layout sends Win+K (open Kiro), Win+H (voice typing) and Enter, and the knob drives your cursor.
中文。 Vibe coding(氛围编程) 是你指挥 AI 助手,而不是逐行敲代码。瓶颈不再是打字,而是那套小动作:打开 AI 面板 → 启动语音输入 → 提交。vibeboard 把它压缩成三颗键加一个旋钮,做成一个标准的 QMK 键盘并支持 VIA:每颗键和旋钮都能用图形界面实时改键,无需重新编译。默认布局发送 Win+K(打开 Kiro)、Win+H(语音输入)和 回车,旋钮则控制光标。
Contents / 目录
1. The Story / 项目故事
Photo placeholder: a hero shot of your finished vibeboard next to your keyboard. 图片占位:把做好的 vibeboard 摆在键盘旁边来一张主图。
EN. I do most of my coding by talking to Kiro, an agentic AI IDE. The loop: pop open the assistant, describe what I want (usually by voice — speaking a paragraph beats typing it), submit, let it work. Each step is trivial, but repeated hundreds of times a day the keyboard gymnastics (Win+K, then Win+H, then Enter, then grab the mouse to fix the cursor) become the most annoying part.
中文。 我大部分编码都是和 Kiro(一个 agentic 的 AI IDE)对话完成的。循环是:弹出助手,描述需求(通常用语音——说一段比敲一段快),提交,让它干活。每一步都简单,但一天重复几百次后,这套键盘体操(先 Win+K,再 Win+H,再 回车,然后摸鼠标修光标)就成了最烦的部分。
EN. So I built a dedicated control surface: three switches and a rotary encoder, small enough to sit between my keyboard and coffee. I built it as a QMK + VIA keyboard on purpose — so the binding of each key isn’t frozen in firmware. With VIA I remap any key or the knob from a GUI in seconds, and the config is stored on the board itself.
中文。 于是我做了一个专用控制面板:三颗轴 + 一个旋钮,小到能塞在键盘和咖啡杯之间。我特意把它做成 QMK + VIA 键盘——这样每颗键的绑定就不会被冻死在固件里。有了 VIA,我能在图形界面里几秒钟改完任意键或旋钮,而且配置就存在板子上。
2. How It Works / 工作原理
EN. The design rule: keep the firmware a blank slate, and let VIA decide what each key does. The board is a standard USB HID keyboard running QMK. VIA talks to it over Raw HID and writes a dynamic keymap into the board’s EEPROM — so remapping is instant, survives reboots, and never needs a recompile. The only thing QMK can’t do by itself is launch an application; for that one case we hand a spare keystroke to a tiny OS-side helper (see §8).
中文。 设计准则:让固件保持一块白板,由 VIA 决定每颗键做什么。 这块板子就是个跑 QMK 的标准 USB HID 键盘。VIA 通过 Raw HID 和它通信,把动态键映射写进板子的 EEPROM——所以改键即时生效、重启不丢、永远不用重编译。QMK 唯一做不到的是启动一个应用;这一种情况,我们把一个备用键码交给系统侧的小助手处理(见 §8)。
flowchart LR
subgraph BOARD["vibeboard — QMK keyboard"]
K1["Key 1 / 键1"]
K2["Key 2 / 键2"]
K3["Key 3 / 键3"]
ENC["Knob / 旋钮"]
end
BOARD --> VIA["VIA dynamic keymap<br/>(stored in EEPROM)"]
VIA -->|"Win+K"| A1["Open / focus Kiro / 打开 Kiro"]
VIA -->|"Win+H"| A2["Voice typing / 语音输入"]
VIA -->|"Enter"| A3["Submit prompt / 提交"]
VIA -->|"arrows / Shift+arrows"| A4["Cursor nav & select / 光标导航与选择"]









暂无评论内容