三条线分开认:固件、CLI、舵机选型
Tiny Engineer 的版本信息分布在三条互不相干的线上:固件 release 标签、npm 上的命令行工具版本、舵机硬件选型。官方在 CLI 文档里自己写明,CLI 的发布流程「separate from firmware v* tags」——与固件 v 开头的标签相互独立。把固件 v0.2.0 当成「项目版本」或「最近更新」,或者拿固件标签去推 CLI 版本,都会出错。舵机预设则是硬件选型维度,与两个软件版本线都没有对应关系。
本 wiki 锁定的版本三元组
| 线 | 锁定值 | 时间口径 |
|---|---|---|
| 固件 release |
v0.2.0,Web flash 页默认的 latest |
2026-10-05 发布 |
| npm CLI |
0.4.1,npm dist-tags.latest |
2026-11-09 发布 |
| 事实抓取 | 官方文档与仓库元数据快照 | 2026-11-16 抓取 |
三者并列锁定:本 wiki 引用的命令、偏移、规格都是这三个值下的口径,任一漂移都要重新核对官方文档,不能拿旧教程直接套。
固件 release 线
| 标签 | 标题 | 发布时间 | 内容 |
|---|---|---|---|
v0.1.0 |
First Working Prototype | 2026-08-30 | 首个可用原型 |
v0.2.0 |
Easier to Build, Easier to Extend | 2026-10-05 | 4 个 bin 加 manifest.json,Web flash 页的 latest |
每个固件 release 附四个镜像文件(bootloader、partitions、firmware、littlefs)和给网页刷机器用的 manifest.json。v0.2.0 是 2026-11-16 抓取时 Web flash 页的 latest。
npm CLI 线
包名 tiny-engineer,命令名也是 tiny-engineer,MIT 许可,要求 Node 18 及以上(engines.node ≥ 18),0.4.x 依赖 ws ^8.22.0 与 serialport ^13.0.0。截至抓取日共发布过 7 个版本:
| 版本 | 发布时间 |
|---|---|
0.0.0-stage |
2026-10-08 |
0.1.0 |
2026-10-08 |
0.1.1 |
2026-10-08 |
0.2.0 |
2026-10-17 |
0.3.0 |
2026-10-19 |
0.4.0 |
2026-11-09 |
0.4.1 |
2026-11-09(npm latest) |
CLI 的 0.2.0 与固件的 v0.2.0 数字撞车但互不相干,判断版本时先问自己在看哪条线。旧的分体命令包 tiny-engineer-cursor、tiny-engineer-antigravity、tiny-engineer-claude-code 已弃用,新装统一用 tiny-engineer。
两个 Node 版本要求属于不同场景
CLI 的 Node ≥ 18 是跑 npx 命令的要求;用 PlatformIO 从源码构建固件时,构建过程要用 npm 打包网页界面并嵌进固件,需要 Node 20.19 以上(20.x 分支)或 22.12+。两者属于不同场景的要求,别拿其中一个去否定另一个。同理,platformio.ini 里的 esp32-c3-devkitm-1 是构建目标名,物理板仍是 Waveshare ESP32-C3-Zero(ESP32-C3FH4);C3-Zero 的 -M 版是预焊排针版。
仓库元数据,全部标抓取日期
以下是 2026-11-16 经 GitHub API 取到的快照,会随仓库变动,不是实时值:
| 字段 | 快照值 |
|---|---|
| 创建时间 | 2026-08-21 |
| 最近推送 | 2026-11-15 |
| 仓库更新 | 2026-11-16 |
| star / fork / open issue | 1181 / 140 / 5 |
| 主语言 | JavaScript |
| 默认分支 | main |
| 作者 | Krzysztof Jamroz(GitHub jamro);npm 维护者 jamropl |
最近推送(2026-11-15)晚于固件 v0.2.0 的发布时间(2026-10-05):仓库「最近更新」与固件 release 是两码事,固件 tag 停在哪个版本和代码库还在不在动互不相关。
固件版本与分区偏移的坑
每个 release 自带分区布局,镜像偏移跟着 tag 走,不能复用。当前 main 的四个镜像偏移:
| 镜像 | 偏移 |
|---|---|
| bootloader | 0x0 |
| partitions | 0x8000 |
| firmware(app0) | 0x10000 |
| littlefs(spiffs) | 0x220000 |
首次刷机四个镜像缺一不可。v0.1.0 是双 OTA 布局,它的 LittleFS 在 0x2B0000(2818048),与当前 main 的 0x220000 不同;官方明写「Do not reuse current-main offsets for an old tag」。NVS 固定在 0x9000,按旧 0x270000 偏移刷的镜像挂载不上。走 Web flash 页不会踩这个坑——网页按所选 release 自动取偏移;只有手动刷旧 tag 时才需要查它自己的 partitions.csv。展开内容见「浏览器 Web 刷机」页。
舵机预设:硬件选型,与版本无关
| 预设 | 定位 | 整机参考尺寸 | 打印件目录 |
|---|---|---|---|
| Tower Pro SG90 | 推荐首建 | 约 13×15×12 cm | parts/sg90/ |
| Feetech FS0307 | 紧凑 | 约 11×13×10 cm | parts/fs0307/ |
| EMAX ES9051 | 紧凑替代 | 官方未给参考尺寸 | parts/es9051/ |
| PowerHD HD-1370A | 仅向后兼容,新机跳过 | 官方未给参考尺寸 | parts/hd1370a/ |
四种预设是硬件选型维度:先选舵机尺寸,再定整机大小;一次买 5 只同型号,打印件目录必须与型号对应,不得混用。换任何固件 release 或 CLI 版本,都不改变这套预设。
快速自检:你手上是哪个版本
- Web flash 页选 release 时看到的 v 开头标签,是固件线。
- npm 上查到的 tiny-engineer 包版本(dist-tags.latest 为 0.4.1),是 CLI 线。
- 舵机型号与打印件目录是选型线,看实物和包装即可,与软件版本无关。