2024 – 2025 · 第一代 / 第二代 · 已归档

让电脑
自己动手

一台以标准 USB 键盘与鼠标身份工作的小设备:把编排好的操作真实地按出来, 目标软件不需要任何接口,电脑上也不需要安装客户端。

这里是它的前两代——固件源码、网页上位机、串口协议与开发备忘,按当年的最终版本开源。

MITSTM32F103C8T6USB HID 复合设备9600 串口已归档
Quileg 设备多种外壳版本合影:白色、蓝色、黄色外壳,以及紫色多机组合
左:白 / 蓝 / 黄三种外壳(第一代) 右:紫色多机组合(内置 USB HUB)

先说明白:这是已停止维护的历史项目,前两代当年未公开发布,现在按“原样”开源,用于学习、复刻与留档。不提供技术支持与维护,也不提供任何补丁。

能力

屏幕上能手动做的,它就能替你做

不注入、不破解、不修改目标软件——只是代替手指去按键、去移动鼠标。

硬件级键鼠模拟

设备以标准 HID 键鼠身份出现,无需安装驱动。电脑眼里它就是一键盘加一鼠标。

不依赖软件接口

没有 API、老系统、专用客户端——只要是屏幕上能点的操作,就能被流程复现。

完整键鼠能力

字母/数字/符号/功能键,修饰键任意组合,最多 6 键同按;左中右键、X/Y 位移、滚轮、拖拽。

流程即文件

流程是纯文本 .quileg:一行一条指令 + 中文注释,可导入导出、可版本管理。

原理

三段式:编排 → 串口 → USB 报告

所有逻辑都在上位机,板子只负责“把收到的指令变成真实的按键与位移”。

1

网页助手编排

在 Chrome / Edge 里打开单文件网页,用 Web Serial 连上设备,拖拽编辑流程。

2

12 字节串口帧

9600 8N1,FF + 10 字节 + FE。键盘、鼠标、蜂鸣器各一种类型。

3

USB HID 报告

固件把指令转成键盘/鼠标 HID 报告,通过 USB 发给电脑——系统看到的是真实输入。

一帧长这样:⌘ + H(按住 100 ms)
FF 01 08 0A 0B 00 00 00 00 00 00 FE
│  │  │  │  └─ 键码 0x0B = h
│  │  │  └─ 按住 0x0A × 10ms = 100ms
│  │  └─ 修饰键 0x08 = 左 GUI(⌘)
│  └─ 键盘命令
└─ 帧头

设备执行完会把同一帧回显回来,可当作 ACK。

上位机

一个网页,就是控制台

不用装客户端:桌面版 Chrome / Edge 打开一个 HTML,用 Web Serial 连上设备就能用。没有后端、没有账号,流程也不上传。

Quileg 助手主界面:左侧连接与暂存夹,右侧是可拖拽的操作流
主界面:左边连接设备 / 暂存夹,右边是可拖拽、可嵌套的操作流。截图里载入的是页面自带的苹果设备范例。
软键盘面板:Mac / Windows 布局,点键直接生成十六进制指令
软键盘:Mac / Windows 两套布局,点一个键就生成对应帧,可设按住时长后加入流程。
鼠标面板:归位、移动到目标区域、滚轮与按键
鼠标面板:归位到四角、按目标区域位移、滚轮与按键,都能一键加进操作流。

流程拖拽 + 嵌套

一行一条 hex,拖拽排序;嵌套一层就是"一组操作",读起来像脚本。

预设 + 批量

空操作 / 返回主页 / 截屏等常用帧是按钮;粘贴一大段 hex 可以批量生成条目。

纯前端

单个 HTML,没有服务器;连接串口需要浏览器授权,页面不会自己连。

截图是在没有连接设备的情况下跑起来的——界面本身可以随便点;真正执行需要插上板子,并在 Chrome / Edge 里授权串口。

两代

同一个内核,两次演进

都是 STM32F103 + USB HID 复合键鼠,差别在外壳、屏幕、按键与上电自检。

2024 · 第一代

Quileg 程控键鼠模拟器

  • STM32F103C8T6 + 0.96" 128×64 OLED(中景园 ZJY096I0400WG01,SSD1306,软件 I²C,实时显示位移/按键/滚轮)
  • 7 个面板按键、LED、USB 有线键鼠
  • 做过黄 / 白 / 蓝三种外壳
2025 · 第二代

去屏、加蜂鸣器、支持多机

  • 去掉屏幕,新增 蜂鸣器(PA4)与 PA0 板上开关
  • 外壳内置 USB HUB:多块板子并排/堆叠,一根线出到电脑,上位机开多个页面分别控制
  • 固件带一段上电自检(会按一次截屏快捷键;不提供补丁,需自行改源码)
四台第一代 Quileg 设备通电使用,OLED 显示运行状态
第一代通电使用中。OLED 上的 S H: / V: / B L R M / W / K 就是固件里写死的标签。
第二代紫色外壳的一端:两个 USB-C 接口与一个三档旋钮
第二代紫色外壳:一端 2 个 USB-C + 三档旋钮,另一端 1 个 USB-C。旋钮用来切换内置 HUB 的连接方式(关机 / 被控 / 自控);硬件已在生产机上做出来,配套应用软件未开发。

开始

从零到能按,三步

不需要画 PCB:主控板用的是现成的 Nano STM32 V1.1(慧勤智远,60×50mm)。

  1. 准备硬件

    Nano STM32 V1.1(慧勤智远,60×50mm)或同规格 STM32F103C8T6 板:8 MHz + 32.768 kHz 晶振、原生 USB(键鼠)、CH340X 串口。OLED、7 个按键、蜂鸣器按文档引脚表接到扩展排针。

    第一代有屏;第二代无屏但有蜂鸣器。板载 LED0 = PA8、WK_UP = PA0。

  2. 编译并烧录

    用 STM32CubeIDE 打开 firmware/gen2-2025/,Build,再用 ST-Link 烧录。

    ⚠️ 若在 CubeMX 里点过 Generate Code,必须用仓库里的 usbd_hid 覆盖文件替换,否则只剩键盘或鼠标。

  3. 打开网页助手

    用桌面版 Chrome / Edge 打开 tools/web-assistant/quileg-assistant.html,连接串口,导入 examples/ 里的示例流程。

    首次打开需要联网(前端库走 CDN)。

第二代用户注意:上电自检会移动鼠标并按下截屏快捷键。归档版不提供补丁;要当日常设备用,请自行修改 Core/Src/main.c 并重新编译。

协议

四种命令,12 字节一帧

协议两代完全一致——同一份流程文件、同一个网页助手,两代都能用。

0x01 键盘

[1] 修饰键位图 · [2] 按住时长(×10ms,0 = 按住不放) · [3]–[8] 最多 6 个键码 · [9] 重复次数

0x02 鼠标

[1] 按键(左 0x01 / 右 0x02 / 中 0x04) · [2] X · [3] Y · [4] 滚轮(有符号 8 位)

0x03 蜂鸣器

响 30 ms,并翻转一次 LED。其余字节忽略。

0x00 空操作

保留。可用于占位或给上位机控制节奏。

⚠️ 串口收包是单缓冲、键盘按住会阻塞主循环——上位机必须按节奏发送,不能连发。 另外坐标是相对的(每帧 ≤ ±127),所以流程里要先“归位”再相对移动。

文档

该讲的都写了

从引脚、协议、架构,到编译烧录、救砖、迭代史与开发备忘。

常见问题

你可能想问

还能买到成品吗?

不能。前两代从未公开发布,也没有量产销售。这是当年源码的归档。

能自己做一台吗?

能。买一块 STM32F103C8T6 最小系统板,按引脚表接 OLED / 按键 / 蜂鸣器 / LED 即可,不需要画 PCB。仓库不提供原理图、PCB、BOM 与外壳文件。

支持 Windows / Linux 吗?

设备是标准 USB HID 键鼠,理论上三大系统都认。当年主要在 macOS 上使用,Windows / Linux 未做系统验证。

中文能输入吗?

不能直接打中文——设备只会发 HID 键码,等于敲 ASCII。当年的做法是用系统输入法选词,或先把中文放进剪贴板再 ⌘/Ctrl + V 粘贴。

官网说的“多机并联”是怎么实现的?

靠外壳内置的 USB HUB:多块板子各自作为独立 HID 设备枚举,一根线出到电脑。固件没有主从协议,网页助手在「连接」时选不同串口、开多个浏览器页面分别控制。

会被平台判定为作弊 / 封号吗?

从设备角度它发出的是真实 USB 键鼠事件,与人工输入在系统层面没有区别;但平台仍可能按行为特征做风控。请只在你有权操作的设备与账号上使用,并遵守平台条款。

为什么不再维护了?

这是 2024–2025 年的最终版本,按“原样”归档公开,用于学习、复刻与留档:不出补丁、不提供技术支持与维护。

源码、上位机、协议,都在仓库里

MIT 许可(ST 组件保留原许可)。已归档,不再维护,但足够你把一台设备做出来。