中文说法与官方口径逐条对齐
Tiny Engineer 的中文介绍数量不少,质量分布很不均:头部长文把官方八步链、Web Flash、双协议边界写得相当完整,微信公众号「noknook」的一篇长文还主动写明了编程 AI 仍在电脑对应的工具和服务里运行、小人不需要在身体里再装一个大模型、看见它打字并不代表它理解了代码;失真集中在少数聚合站短介绍、标题党和几个具体技术口径。本页把证据包 C1–C12 全部 12 条校准项按主题分组,逐条给出「中文常见说法、官方事实、官方出处」对照:中文说法只列在对照表里,正文一律按官方口径陈述。全部数据以 2026-11-16 抓取的官方原文为准,固件 release 最新为 v0.2.0(2026-10-05 发布),npm 命令行工具最新为 0.4.1(2026-11-09 发布),下文仓库数据均为抓取时点值,不写实时值。
能力边界:机器人只把编程助手的事件表演成动作
官方 README 的自述:桌面上的一个小机器人,你的 AI 编程 agent 工作时,它动起来、变表情、敲铃。原理是 agent 或 hook 脚本通过 Wi-Fi HTTP 或 USB 串口把姿态发给机器人,板上的 ESP32-C3 运行固件,驱动 5 个舵机、0.91 英寸 OLED 和 8Ω/1W 喇叭。编程 AI 始终运行在电脑侧的工具与服务里,机器人本体内没有大模型,不执行任何打印、烧录、组装等制造动作;它没有语音交互,不能行走,不能抓取。看到它打字只说明收到了对应事件,与它是否理解代码无关。
| 中文常见说法 / 样本 | 官方事实 | 官方出处 |
|---|---|---|
| 「模型写好的代码,能直接驱动真实硬件动作」「把软件智能体和实体设备之间的最后一截手动环节自动化」「AI 从写代码延伸到动手做」(C1) | 机器人只把 agent 的读文件、写码、思考、完成等事件表演成环顾、打字、抬头、敲铃等动作;本体无大模型、不执行制造动作,编程 AI 仍在电脑侧 | 官方 README |
| 微信公众号「noknook」长文:「编程 AI 仍在电脑对应的工具和服务里运行,小人不需要在身体里再装一个大模型」「看见它打字,表示收到了对应事件,并不代表它理解了代码」(C2) | 与官方口径一致,属中文自校而非失真;中文头部长文普遍写对了能力边界,不能一概说「中文都错了」 | 官方 README |
| 「30 分钟搭一个会说话能走的桌面机器人」「桌宠」(C9) | 5 舵机桌面表演摆件:无语音交互、不能行走、不能抓取;与桌宠、Stack-chan、小智固件链、ESP-SparkBot 等项目无关 | 官方 README |
双协议:软件 MIT,硬件 CERN-OHL-S-2.0 分路径授权
官方许可说明(LICENSING.md)开头写明:仓库同时包含软件和硬件设计文件,两者分开授权。「MIT 还是 CERN 二选一」的问法对不上仓库的实际结构,正确的问法是哪个文件走哪个协议。
| 协议 | 覆盖路径 | 内容 |
|---|---|---|
| MIT(软件) |
src/、include/、lib/、test/
|
固件 |
| MIT(软件) |
packages/、scripts/、package.json
|
集成与工具 |
| MIT(软件) |
data/、assets/
|
固件文件系统资产(含 WAV 音频) |
| MIT(软件) |
docs/(含接线图与硬件指南)、.cursor/、platformio.ini、partitions.csv、REUSE.toml 及其余未列入硬件的文件 |
文档与构建配置 |
| CERN-OHL-S-2.0(硬件,强互惠) |
3d_models/cad/(.f3d 源 CAD)、3d_models/parts/(.3mf 打印件)、mods/*/3d_models/、hardware/boards/(KiCad PCB) |
机械与 PCB 设计文件 |
两个文档豁免容易被漏掉:3d_models/README.md、mods/README.md、hardware/README.md 属软件文档,仍为 MIT;mod 目录中 3d_models/ 之外的文件同样为 MIT。
商用口径照官方原话执行:这些硬件设计的商用是允许的;如果你基于这些设计修改并分发产品,CERN-OHL-S-2.0 的互惠条款要求你在同一协议下公开对应的 Complete Source。分发具体修订版时,Source Location 须链接到对应的 tagged release 或 commit(官方举例 tree/v0.1.0/3d_models);机械设计源在仓库的 3d_models 目录,PCB 源在 hardware 目录。REUSE.toml 按路径做了 SPDX 标注,3d_models/LICENSE、3d_models/NOTICE、hardware/LICENSE、hardware/NOTICE 载明版权、免责与 Source Location 展示义务。
GitHub 仓库页许可证一栏显示 NOASSERTION 的原因也要校准:仓库采用自定义双协议,GitHub 无法用单一 SPDX 标识标注,这是标注机制的限制,不是仓库没有许可证。README 的 License 段自身写明软件 MIT、硬件 CERN-OHL-S-2.0、名称与 logo 不授权;「全开源可自由商用」「单一 MIT」「单一 CERN」「随便用」这类概括都越界。
| 中文常见说法 / 样本 | 官方事实 | 官方出处 |
|---|---|---|
| 「MIT License」或「CERN Open Hardware Licence v2」二选一;「全开源、可自由商用、随便用」(C3) | 软件 MIT 与硬件 CERN-OHL-S-2.0 分路径;商用允许但改动并分发须同协议开放 Complete Source;名称、logo、AI emblem、品牌图片不在任何开源许可内;GitHub 显示 NOASSERTION 是无法单一标注,不是无许可证 | 官方许可说明、官方商标说明、官方 README |
商标边界:名称、logo、AI emblem 与品牌图片不授权
官方商标说明(TRADEMARK.md)列出四类不在 MIT、CERN-OHL-S-2.0 或任何其他开源许可内的保留标记:
- 名称 Tiny Engineer
- Tiny Engineer logo 与视觉识别
- AI emblem 的几何文件
3d_models/parts/sg90/3mf/AiEmblem.3mf(其他舵机目录下的同类件同样保留) - docs/ 中带 Tiny Engineer 品牌的项目图片
设计文件按 CERN-OHL-S-2.0 授权允许你制造、修改和分发实体零件,版权许可不授予商标权。允许的用法是不构成背书暗示的事实性引用,官方给的示例:「Based on the Tiny Engineer open hardware design」「Compatible with Tiny Engineer firmware」、在文档或 README 中署名。未经书面许可禁止:把 Tiny Engineer 用于产品名、公司名或域名以暗示官方产品;用 logo、emblem 或项目图片暗示背书或赞助;声称或暗示你的产品是官方 Tiny Engineer 产品。
版本口径:v0.2.0 是固件 release,不是项目版本也不是最近更新
这个仓库有两条互相独立的版本线,官方在 CLI 文档里写明 CLI 发布与固件 v* tag 分开。中文把 v0.2.0 当成项目版本或仓库最近更新,属于跨线混用。
| 版本线 | 最新值(2026-11-16 抓取) | 发布日期 | 说明 |
|---|---|---|---|
| 固件 release |
v0.2.0「Easier to Build, Easier to Extend」 |
2026-10-05 | 4 个 bin 加 manifest.json,Web Flash 默认选它 |
| npm CLI | 0.4.1 |
2026-11-09 | license=MIT,要求 Node 18 及以上,bin 名 tiny-engineer |
| 中文常见说法 / 样本 | 官方事实 | 官方出处 |
|---|---|---|
| 「最后更新 2026-11-03」「项目版本 v0.2.0」「主语言 C++」「MIT 许可」(C4) | 抓取时点仓库最后推送 2026-11-15、元数据更新 2026-11-16、主语言 JavaScript、许可证标注 NOASSERTION;v0.2.0 是固件 release tag(2026-10-05),不是仓库最近更新;CLI 另有 npm 0.4.1(2026-11-09) | GitHub 仓库元数据、GitHub 版本发布记录、npm 包元数据 |
配置落点:连接偏好在用户级 config,不在项目 .env
CLI 的连接偏好(transport、URL、端口、token)写在用户级配置文件:macOS 和 Linux 是 ~/.config/tiny-engineer/env,Windows 是 %APPDATA%\tiny-engineer\env,可用环境变量 TINY_ENGINEER_CONFIG_DIR 改位置。加载顺序是:命令行 flag、进程环境变量、项目 .env(可覆盖)、用户级 env、默认值。setup 从不编辑项目根目录的 .env;找不到或想改连接配置时先看用户级 env,别翻项目目录。
| 中文常见说法 / 样本 | 官方事实 | 官方出处 |
|---|---|---|
| 「全部写进项目根目录 .env(TINY_ENGINEER_TRANSPORT、TINY_ENGINEER_URL)」(C6) | 连接偏好写 user config ~/.config/tiny-engineer/env(Windows 为 %APPDATA%\tiny-engineer\env);setup 从不编辑项目 .env;项目 .env 只是加载顺序中的可选覆盖层 |
集成指南官方页、命令行工具说明 |
集成范围:npx setup 一键只管三家 IDE,其余走 REST
官方 README 的接入范围:Claude Code、Cursor、Antigravity 经由 npx -y tiny-engineer setup 一键装 hook;Codex、Windsurf 和任何能发 POST 的脚本同样可以接入,走 REST POST /anim 自定义映射,映射由你自己定,机器人只认 name 参数。精确的表述是:Codex 与 Windsurf 可以接 Tiny Engineer,接入方式是 REST,不在 npx setup 一键范围内。
| 中文常见说法 / 样本 | 官方事实 | 官方出处 |
|---|---|---|
| 「npx 一条命令把 Codex / Windsurf 直接接入」、把 setup 说成支持全部 IDE(C5) | setup 一键仅 Cursor / Claude Code / Antigravity 三家;Codex、Windsurf 与任意脚本走 REST POST /anim 自定义映射 |
官方 README、集成指南官方页、命令行工具说明 |
硬件路线与舵机选型:默认是主控板加 Web Flash
官方默认路线:打样 Tiny Engineer 主控板(开源 PCB,CERN-OHL-S-2.0),板载 PCA9685、MAX98357A 和 USB-C,刷机用浏览器 Web Flash,不需要安装 PlatformIO、不需要 clone 仓库。分模块散接(PCA9685 驱动板加 MAX98357A 模块加 USB-C 转接板)和 PlatformIO 构建属于 advanced 路线:可行,但焊接量与腔内板数更多。两条路线混着写,容易让玩家以为必须自己焊分模块、必须装 PlatformIO 才能刷机。
舵机官方给了 4 种预设,先选尺寸再定整机大小,一次买 5 只同型号,打印件目录必须与舵机型号对应:
| 舵机 | 定位 | 整机尺寸参考 | 打印件目录 |
|---|---|---|---|
| Tower Pro SG90 | 推荐首建 | 约 13×15×12 cm | 3d_models/parts/sg90/ |
| Feetech FS0307 | 紧凑机型 | 约 11×13×10 cm | 3d_models/parts/fs0307/ |
| EMAX ES9051 | 紧凑替代 | 官方未给整机尺寸 | 3d_models/parts/es9051/ |
| PowerHD HD-1370A | 仅向后兼容,新机跳过 | 官方未给整机尺寸 | 3d_models/parts/hd1370a/ |
| 中文常见说法 / 样本 | 官方事实 | 官方出处 |
|---|---|---|
| BOM 表直接列「PCA9685 16 路驱动板 / MAX98357A 模块 / USB-C 转接板」并附逐针接线表与 PlatformIO 命令,不说明这是 advanced 路线(C7) | 官方默认是打样主控板加浏览器 Web Flash(免 PlatformIO);分模块散接与 PlatformIO 属 advanced 路线 | 主控板说明官方页、接线官方页、刷机指南官方页 |
| 「5 个 SG90 舵机」作为唯一选型(C8) | 官方 4 种预设(SG90 / FS0307 / ES9051 / HD-1370A);SG90 是首建推荐但非唯一选型;HD-1370A 仅向后兼容、新机跳过;打印目录必须对应舵机型号 | 舵机选购官方页 |
成本口径:官方未给整机总成本
官方没有给出整机总成本数字。README 里的「~$15–20 assembled board」是官方讨论区成品主控板意向投票的价格区间:它既不是售价,也不是整机 BOM 合计,购买渠道、打样费用与运费都要玩家自行询价。
| 中文常见说法 / 样本 | 官方事实 | 官方出处 |
|---|---|---|
| 「$15–20 组装一台」「整机成本 ~$5–15」(C10) | 官方未给整机总成本;README 的 ~$15–20 是成品板意向投票价,不是售价也不是 BOM 合计;「~$5–15」的出处实为单个 ESP32 模块的参考价,不是整机 | 官方 README |
取证勘误与本项目补齐的增量
最后两条校准项,一条是本项目取证通道的勘误,一条是中文内容的整体缺口,如实记录:
| 中文常见说法 / 样本 | 官方事实 | 官方出处 |
|---|---|---|
| 2026-11-16 上午一轮核查记录 docs/README.md 抓取失败(network unreachable),一度记为疑似缺失(C11) | 同日重抓成功(HTTP 200,2,795 字节),该文件为官方 docs 索引;属通道抖动,非文件缺失 | 官方 docs 索引 |
| 中文普遍停在「八步链 / Web Flash / 90 度居中」,较少提版本坑(C12) | 官方还写明:先刷机居中、总装完到 §20 才配网的硬顺序;启动红闪码 1(PCA9685 未找到)与 2(MAX98357A / I2S 失败);首刷四个 bin 缺一不可及各自偏移;v0.1.0 的 LittleFS 在 0x2B0000,与当前 main 的 0x220000 不同,不能复用偏移 | 刷机指南官方页、装配指南官方页、硬件测试官方页 |
中文内容缺的往往不是大方向,而是「每步做完该看到什么」与版本差异的系统整理。本 wiki 把散在官方多篇文档里的版本坑、供电安全、双协议与商标边界收进同一条实操链;逐症状的定位与可执行命令见下一页故障排查。