项目>Tiny Engineer>版本辨识:固件 release、CLI 版本与舵机选型别混成一条线

版本辨识:固件 release、CLI 版本与舵机选型别混成一条线

摘要:分开认清固件 release 标签、npm 命令行工具版本和 4 种舵机选型三条独立的线,锁定抓取日期,避免照着过期教程刷错分区或装错环境。

三条线分开认:固件、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 线。
  • 舵机型号与打印件目录是选型线,看实物和包装即可,与软件版本无关。

资料来源

  • 官方 README
  • GitHub 版本发布记录
  • npm 包元数据
  • 舵机选购官方页
  • 命令行工具说明