Tiny Engineer 是什么
Tiny Engineer 是一台 3D 打印的 ESP32-C3 桌面机器人:5 个舵机构成头部与手臂的表演关节,一块 0.91 寸 OLED 当脸,一只 8Ω/1W 喇叭出声。官方 README 对它的自述是「A small robot on your desk. It moves, changes its face, and rings a bell as your coding AI agent works」,口号是「Give your AI coding agent a body」——给 AI 编程助手一个身体。你用 AI 编程助手干活时,它把助手的动作演出来:助手读文件它环顾,写代码它打字,思考时抬头,任务完成敲一声铃。
事件怎么变成动作
整条链路是:AI 模型始终运行在你电脑上的编程工具和服务里;hook 脚本监听工具事件,经 Wi-Fi HTTP 或 USB 串口给机器人发一个姿态请求;板上的 ESP32-C3 运行固件,驱动舵机、屏幕和喇叭把请求演出来。机器人本体里没有大模型,也不理解代码——固件收到的只是一个动画名,事件的含义由你在电脑侧定义。
| AI 助手在做什么 | 机器人演什么 |
|---|---|
| 读文件(Reads files) | 环顾(Looks around) |
| 写代码(Writes code) | 打字(Types) |
| 思考或等待(Thinks or waits) | 抬头(Looks up) |
| 完成任务(Finishes the task) | 敲铃(Rings the bell) |
能力边界,开工前先认清
- 它是 5 个舵机加 0.91 寸 OLED 加 8Ω/1W 喇叭的桌面表演摆件,动作是环顾、打字、抬头、敲铃这一类表演姿态。
- 本体无大模型:AI 一直在电脑侧的工具和服务里运行,机器人只接收事件并表演。
- 不执行制造动作:3D 打印、焊接、烧录、组装全部由你完成,机器人不会「自己造自己」,也不会替你写代码、跑测试。
- 无语音交互:喇叭播放固件内置与自定义的音效,没有语音识别,不能对话。
- 不能行走、不能抓取:没有底盘和轮子,机械结构只支持头部与手臂的表演动作。
官方把组装难度评为 Medium:对软件工程师来说是合适的第一台硬件项目,但不是一灯一钮的入门套件,需要焊接排针、下单主控板、打印结构件并完成十九节总装。官方提供可选的入门读本「From Code to Circuits」(面向软件工程师的硬件入门),它是预习材料,不是开工门槛。
能联动哪些 AI 编程工具
官方 README 写明的接入范围是:Claude Code、Cursor、Antigravity 三家通过 npx -y tiny-engineer setup 一键装好 hook;Codex、Windsurf 以及任何能发 POST 请求的脚本,走 REST 接口 POST /anim 做自定义映射。机器人只认动画名,事件到动画的映射由你自己决定,所以不必纠结用哪家的工具——只要它能往局域网里发一个 HTTP 请求就能接上,没有 Wi-Fi 的环境也可以走 USB 串口。
双协议与商标边界,一句话版
软件(固件、集成脚本、文档)按 MIT 许可;硬件设计(3D 模型源文件、打印件、KiCad 电路板)按 CERN-OHL-S-2.0 强互惠许可——商用允许,但改动并分发时必须以同一协议开放对应的完整源文件;「Tiny Engineer」名称与 logo、AI 徽章的几何模型、带品牌的项目图片不在任何开源许可内。GitHub 把仓库许可证标为 NOASSERTION,是因为双协议无法用单一标签标注,不是无许可证。逐条对照见「事实校准」页。
两条版本线,本 wiki 锁定在
固件与命令行工具是两条独立的发布线,版本号互相独立、不能互相推算。本 wiki 全部内容锁定在下表三元组,任一变动都要重新核对官方文档:
| 线 | 锁定值 | 时间口径 |
|---|---|---|
| 固件 release | v0.2.0(Web flash 页的 latest) | 2026-10-05 发布 |
| npm 命令行工具 | 0.4.1(npm 的 latest) | 2026-11-09 发布 |
| 官方文档抓取 | 2026-11-16 | 本 wiki 事实快照 |
怎么分辨手头的版本、为什么旧固件的分区偏移和现在不一样,见「版本辨识」页。