VibeCoding Key：基于 Tuya T5 的四键 AI 双模桌面键盘

一款面向办公与 AI Coding 场景的四键可编程桌面控制器。用户可通过侧边滑动开关，在“办公快捷键”和“AI 对话控制键”两套键位之间快速切换，并通过 OLED、数字麦克风和 RGB 灯获得直观的交互反馈。

一、项目信息

项目	内容
项目名称	VibeCoding Key：四键 AI 双模桌面键盘
项目类型	开源硬件 / 智能桌面外设 / AI Coding 辅助工具
主控平台	Tuya T5（T5-E1 模组）
开发框架	TuyaOpen
核心交互	四个机械按键、模式滑动开关、OLED、数字麦克风、RGB 指示灯
供电与通信	USB Type-C，预留 VBAT 输入与串口调试接口
项目提交平台	华秋开源硬件社区
开源协议	请在正式发布时按活动要求选择并填写

二、项目说明

2.1 项目背景

在日常办公和 AI 辅助编程过程中，用户需要频繁执行复制、粘贴、撤销、保存，以及发送提示词、停止生成、开启新对话等操作。普通键盘虽然可以完成这些功能，但组合键多、操作路径长，而且在办公软件与 AI Coding 工具之间切换时，用户需要反复调整操作习惯。

VibeCoding Key 将高频操作集中到四个独立按键上，并利用滑动开关切换整套键位。办公时，它是一块快捷键键盘；进入 AI Coding 场景后，它又可以成为对话和语音输入控制器。设备使用 OLED 显示当前模式与状态，降低误触和记忆成本。

2.2 解决的问题

减少高频组合键带来的操作负担，提高办公效率。
缩短 AI Coding 中“输入需求—发送—停止—继续对话”的操作路径。
使用物理模式开关区分两套键位，避免软件模式不明确导致误操作。
通过数字麦克风提供语音输入入口，便于快速描述需求或记录灵感。
通过 OLED 和 RGB 灯显示模式、联网、录音及执行状态。

2.3 目标用户

经常使用 AI 编程助手的开发者与 Vibe Coding 用户；
需要大量重复快捷键操作的办公人员、设计师和内容创作者；
希望自定义桌面工作流的极客与开源硬件爱好者；
需要低学习成本、明确状态反馈的轻量宏键盘用户。

2.4 设计目标

一键切换：通过实体滑动开关选择办公模式或 AI Coding 模式；
所见即所得：OLED 始终显示当前模式及按键状态；
交互自然：四个按键承担最常用操作，麦克风用于语音输入；
功能可扩展：按键映射由固件定义，可根据不同软件和工作流修改；
便于复现：使用常见接口和器件，并完整开源原理图、PCB 与说明文档。

三、总体设计思路

系统以 Tuya T5-E1 模组为核心。四个独立按键和模式滑动开关作为输入，ICS-43434 数字麦克风负责采集语音，OLED 与 RGB 灯负责状态输出。USB Type-C 提供供电和数据连接，板上 3.3 V 电源为主控及外设供电。

USB Type-C / VBAT
        │
        ▼
  3.3 V 电源系统
        │
        ▼
   Tuya T5-E1 主控
    ├── 四个独立按键
    ├── 模式滑动开关
    ├── I²C OLED 显示屏
    ├── I²S 数字麦克风
    ├── RGB 状态指示灯
    ├── USB 数据接口
    └── 串口调试接口

物理滑动开关直接接入主控 GPIO。固件检测开关电平后加载对应键位表，因此切换动作明确、可见，不依赖复杂菜单。按键映射采用软件配置方式，下面给出推荐的默认方案。

四、双模式交互设计

按键	办公快捷键模式（默认建议）	AI Coding 模式（默认建议）
K1	复制 `Ctrl+C`	按住语音输入，松开发送
K2	粘贴 `Ctrl+V`	发送当前提示词 / 确认
K3	撤销 `Ctrl+Z`	停止当前生成
K4	保存 `Ctrl+S`	新建对话 / 清空当前上下文

以上映射不是硬件限制。固件可以针对 VS Code、Cursor、浏览器、Office、剪辑软件等应用重新定义键值，也可以增加短按、长按和组合按键功能。

4.1 办公快捷键模式

滑动开关拨到办公模式后，OLED 显示 OFFICE 及四个键的当前功能。设备作为快捷输入终端，将常用组合键简化为单键操作。RGB 灯可使用绿色常亮或呼吸效果表示办公模式。

4.2 AI Coding 模式

滑动开关拨到 AI 模式后，OLED 显示 AI CODING、联网状态和录音状态。K1 可作为按住说话键，麦克风采集语音后由固件或上位机完成语音识别，再将文本交给 AI Coding 工具。其余按键用于发送、停止和新建对话。RGB 灯可用蓝色表示待机、红色表示录音、黄色表示处理。

4.3 建议的状态反馈

状态	OLED 显示建议	RGB 显示建议
办公模式	`OFFICE` 与键位名称	绿色
AI 待机	`AI READY`	蓝色
正在录音	`LISTENING`	红色
正在处理	`THINKING`	黄色呼吸
网络或执行异常	错误码或简短提示	红色闪烁

五、原理图设计说明

5.1 Tuya T5-E1 主控

T5-E1 是本设计的运算与连接核心，负责：

扫描四个按键和模式开关；
驱动 OLED 与 RGB 指示灯；
通过数字音频接口接收麦克风数据；
运行 TuyaOpen 固件及设备交互逻辑；
处理 USB、串口以及网络侧的数据交互。

原理图使用网络标号连接 BUTTON1～BUTTON4、MODE、SDA、SCL、SCK、SYNC、DIN、RGB、TX 和 RX 等信号，使各功能模块之间的关系清晰，便于调试和后续扩展。

5.2 USB Type-C 接口

USB Type-C 接口同时承担 5 V 供电和 USB 数据连接。CC1、CC2 各配置 5.1 kΩ 下拉电阻，用于声明设备端角色；D+、D− 数据线经过 USBLC6-2SC6 静电保护器件后接入主控，提高插拔时的抗静电能力。

PCB 布线时应保证 D+、D− 尽量短、等长、平行，减少过孔与支路，并让 ESD 保护器件靠近 Type-C 插座放置。

5.3 3.3 V 电源与 VBAT 检测

板上使用 3.3 V 稳压电路为 T5-E1、OLED、麦克风和指示灯供电，输入、输出端配置滤波与去耦电容。原理图同时预留两针 VBAT 接口，并通过电阻分压将电池电压送入 VBAT_ADC，便于固件估算剩余电量。

当前图纸中的 VBAT 部分用于电源输入和电压采样，不能等同于电池充电管理。若后续接入可充电锂电池，应增加专用充电、过充、过放及短路保护电路，或直接使用带保护板的合规电池与外部充电方案。

5.4 OLED 显示模块

OLED 使用四针接口，包含 VCC、GND、SDA 和 SCL。SDA、SCL 通过 10 kΩ 电阻上拉至 3.3 V，采用 I²C 总线与主控通信。显示内容可包括：

当前工作模式；
四个按键的功能提示；
网络连接和 AI 服务状态；
录音、发送及错误提示；
电池电量或 USB 供电状态。

5.5 ICS-43434 数字麦克风

ICS-43434 通过 SCK、SYNC/WS 和 DIN/SD 与 T5-E1 连接，输出数字音频数据，可降低模拟音频走线对噪声的敏感程度。声道选择脚按当前设计固定到相应电平。

PCB 与结构设计中应确保麦克风拾音孔无遮挡，并尽量远离按键撞击、开关摩擦和电源开关噪声源。外壳可在拾音孔周围增加密封泡棉，避免声学短路和腔体串音。

5.6 四个独立按键

K1～K4 的一端分别连接 BUTTON1～BUTTON4，另一端接地。固件开启 GPIO 内部上拉后，按键按下时读取低电平。建议在软件中加入约 10～20 ms 消抖，并对短按、长按和组合键分别处理。

5.7 滑动开关、复位与调试接口

模式滑动开关：输出 MODE 电平，用于选择办公或 AI Coding 键位表；
电源滑动开关：用于整机电源控制；
复位按键：连接 RST，便于开发和异常恢复；
串口接口：引出 TX、RX、3.3 V 与 GND，便于烧录日志和功能调试；
RGB 灯：由 RGB 信号控制，用于显示设备工作状态。

六、PCB 设计说明

6.1 布局说明

PCB 采用横向桌面键盘形态，主要布局如下：

四个大按键沿板底部等距排列，便于盲按和形成肌肉记忆；
OLED 位于板上方，处于正常视线范围内；
T5-E1 模组位于中上区域，缩短信号到各功能模块的连接距离；
电源开关与模式切换开关分别布置在板两侧，降低误操作概率；
USB、电源和调试相关器件集中在板边缘，便于插拔与测量；
四角设置安装孔，方便与底壳、面板或铜柱固定；

【涂鸦T5开源 AI】VibeCoding Key：基于 Tuya T5 的四键 AI 双模桌面键盘

PCBA

设计文件

EDA查看器

详细介绍