jamro/tiny-engineer

硬件与物联网

把 AI 编程 Agent 的读文件、思考、写代码变成桌面小机器人动作和铃声的 3D 打印硬件项目。

869
108
C++
NOASSERTION
上线 2 个月

上手判断: 这是一个要自己动手做的桌面摆件,不是装个软件就能用。如果你经常跑很久的 Agent 任务,想要一个抬眼就能看到的物理进度提示,并且愿意接受一块 ESP32 控制板加多个模块的组装,它值得考虑。

解决什么问题

现在的编程 Agent 一次任务常常跑好几分钟,唯一反馈就是终端在滚。你要么不停切窗口看进度,要么就让任务默默跑完。Tiny Engineer 改的是输出这一端:通过挂在 Cursor、Claude Code 或 Antigravity 上的 hook 脚本,把姿态指令经 Wi-Fi 发给桌上的小机器人——读文件时它转头看,写代码时它做出敲键盘动作,思考等待时它抬头,任务结束它摇铃。结果是一个隔几米也能看懂的辅助状态指示器。

有什么不同

这不是一个纯软件的指示灯。项目把可打印外壳、开源的 KiCad 主控板、ESP32-C3 固件和 Node hook 客户端拼在一起,主控板的设计让 ESP32、5 个 SG90 舵机、OLED 和喇叭直接插上去,不需要焊接。动作由姿态消息驱动,走 HTTP 或带帧的 USB 串口,所以任何能发 POST 的脚本都能控制它;README 除了给三个 Agent 提供一条 npx 命令的安装方式,还指向 HTTP API 和集成指南。语音播放是单独的接口,这让它即便不配合编程 Agent,也能当一个小型通知设备用。

代价是范围:作者把难度标为「中等」,说它对软件工程师算是一个合适的第一个硬件项目,而不是焊一个 LED 那种入门套件。你需要找工厂下单 PCB、打印或订购零件,再把舵机和螺丝装起来。默认客户端是一个 npm 包,所以开箱即用的路径要求机器上有 Node;HTTP 和串口接口是给其他环境的退路。授权是分开的:软件 MIT,CAD 和 PCB 设计用 CERN-OHL-S-2.0,名称和 logo 明确不在授权范围内。

谁值得试

适合已经在 Cursor、Claude Code 或 Antigravity 里跑长任务、想要一个抬眼可见的桌面状态提示,并且把打板和打印当作乐趣一部分的开发者。有 3D 打印机、能熟练把模块插到板子上的��,收益最大。不适合只想要一个软件状态灯的人,也不适合等成品的人:装配好的板子目前只是讨论区里的一个意向征集,现在还买不到。没有打印机的话,文档给了「下单打印」这条替代路径,多一步,但不影响参与。

使用条件与边界

硬件清单很具体:主控板,外加 ESP32、5 个 SG90 舵机、OLED、喇叭、M2 螺丝,以及至少 2 A 的 5 V 电源。你还需要 3D 打印机和耗材,或者外发打印。组装难度被定为中等,项目也为不熟悉电路的软件工程师准备了入门材料。软件这边,默认的 npx 客户端只面向 Cursor、Claude Code 和 Antigravity;Codex、Windsurf 以及其他工具要走 HTTP API 或串口协议,配置会多一些。日常维护意味着集成方式变化时,固件和 hook 脚本要跟着更新;路线图里写的「更多 Agent 集成」和「简化搭建」是后续计划,不是现有功能。

HotRepo 点评

HotRepo 记录到 2026-10-24 为 862 星、2026-10-25 为 865 星,有两天出现在日榜;样本太短,无法判断热度能否持续。仓库创建于 2026-08-21,项目还很年轻。决定动手前,建议对照采购清单确认零件在本地能买到,并确认你用的 Agent 出现在集成文档里。

本文由 AI 根据项目 README 生成,更新于 2026年10月25日,以项目官方文档为准。