项目>Tiny Engineer>Tiny Engineer 是什么:给 AI 编程助手一个会表演的桌面身体

Tiny Engineer 是什么:给 AI 编程助手一个会表演的桌面身体

摘要:认清 Tiny Engineer 是 5 舵机加屏幕加喇叭的桌面表演摆件,把编程助手的事件演成动作,本体里没有大模型、不执行制造动作,并知道本 wiki 覆盖到哪、不覆盖到哪。

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 事实快照

怎么分辨手头的版本、为什么旧固件的分区偏移和现在不一样,见「版本辨识」页。

资料来源

  • Tiny Engineer 官方 README
  • 官方许可说明
  • 官方商标说明
  • 快速上手官方页
  • 证据包 v1 校准条目