项目>Tiny Engineer>事实校准:双协议、商标边界与中文常见误传逐条对照

事实校准:双协议、商标边界与中文常见误传逐条对照

摘要:逐条看清软件 MIT 与硬件强互惠协议的分路径、名称和标识不授权的范围,校准中文里把机器人当成 AI 动手造硬件、许可证二选一、配置落点错写、成本串台等常见说法。

中文说法与官方口径逐条对齐

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 把散在官方多篇文档里的版本坑、供电安全、双协议与商标边界收进同一条实操链;逐症状的定位与可执行命令见下一页故障排查。

资料来源

  • 证据包 v1 校准条目
  • 官方许可说明
  • 官方商标说明
  • 官方 README
  • GitHub 版本发布记录