项目>Reachy Mini>官方口径冲突与中文常见误传对照

官方口径冲突与中文常见误传对照

摘要:逐条看清官方文档里互相打架的 11 处口径和中文内容里常见的 20 个误传,并知道遇到冲突时该以哪份官方材料为准。

对不上的地方先摆出来,别急着替官方改口径

中文教程常给出对不上的系统说法、偏低 Python 门槛、过时价格,以及一整套不存在的接口;官方自己也打架:安装页 3.10–3.12,包元数据 >=3.11;核心概念页身体转动限位 [-160°, +160°],排障 FAQ [-180°, 180°]。下面把官方内部 11 处冲突、中文 20 个说法逐条列清,交代该信哪份、为什么不能自己「纠正」官方原文。

先说许可证边界。检索字段带了「开源」二字,但不等于全开源、也不等于可自由商用:软件 Apache-2.0,硬件设计文件 CC BY-SA-NC(非商业),硬件带 NC 限制不能商用,笼统当成「全部开放、随便商用」就错了。这条边界首页与本页各写一次,校对列为必检项,误区表也单列一条。

官方内部 11 处口径冲突:逐条并列,不裁决

每处都是官方自己给出的两三种说法,并列留痕、不裁决、不替官方改写。抓取日期统一 2026-11-15。

冲突项 A 面口径 B 面口径 遇到时怎么办
Python 版本 安装页 3.10–3.12,推荐 3.12 pyproject.toml / PyPI 1.14.0 >=3.11 以实际安装的版本元数据为准,三值并列标 2026-11-15,不裁决
组装时长 README / 上手页 2–3 小时 产品页约 2.5 小时;FAQ 1.5–2 小时、最多 4 小时 三值并列各标来源,别把经验区间当承诺
Body Yaw 限位 核心概念页 [-160°, +160°] 排障 FAQ [-180°, 180°] 两值并列,以运行时 clamp 为准
软模式 API 名 核心概念页 enable_gravity_compensation()(需 Placo) FAQ make_motors_compliant() 两名并列,不推断是否别名
天线抖动 10° 偏移已是默认(PR #952) 同页手动调 PID:P→180、不行 D→10 并列,不写「必须手动调」
产品页功能表列错位 表头 Reachy Mini Lite 该列写 CM4 / Wi-Fi / Battery Built in 等 Wireless 特征 判为抓取呈现错位,只留痕,不据此推断规格
电机型号口径 硬件手册三种:XC330-M288-PG、XL330-M077-T、XL330-M288-T 中文「9 颗 XL330」 以官方 datasheet 为准,简化说法列误区表
Reachy Mini 命名歧义 产品线名,含 Lite / Wireless / Simulation Wireless 上手页标题即 Reachy Mini (Wireless),也作单机名 提具体机器带 Lite / Wireless 后缀,不用项目名代指 Wireless
三套版本号 SDK 1.14.0 FAQ 的 1.2.3+ 是机器人软件下限、2.1.4+ 是板卡固件 互不换算,不写「固件 1.14.0」
Windows 支持 安装页 Linux / macOS / Windows 全列 Supported Seeed 中文「即将推出」 以官方英文为准,中文过时列误区表,不写「即将支持」
Testbench 前置动作 主分支 motors_diagnosis.md:设置里关 motor backend 停 daemon HF 繁中镜像站:Reachy Mini Lite 先 reachy-mini-daemon --no-autostart 再开 dashboard 镜像站版本不同步,并列不裁决;以主分支为准,注明入口位置随版本可能不同

中文常见说法逐条回官方核

左列照录中文说法,中列给官方事实,右列给出处与判定。有的整句错,有的只缺边界或前置,有的只是跨日期,不能一刀切成「错误」。误传字面只在本表出现。

中文常见说法 官方事实 官方出处(或依据)
「3D 打印 65 小时」「从零 DIY 打印全部部件」 套件发售,2–3 小时装配、工具全含、No soldering;仅缺件可打印官方 STL 应急,不是完全不能打印 README / FAQ / 产品页,事实错误
「安装 Raspbian」「刷树莓派系统」 Reachy Mini Wireless 是 CM4 加官方镜像(有重刷 ISO 指南),Reachy Mini Lite 接电脑跑本地 daemon;无 Raspbian 流程 硬件与上手页 / FAQ,事实错误
「全开源可商用」 软件 Apache-2.0,硬件设计文件 CC BY-SA-NC(非商业),两者授权不同 README / 文档首页 License 段,许可证边界错误
「$299 / $449」「百元级入门」 产品页 Lite $399 / Wireless $499(DAP 不含税运);$299 是 2026-08 购买页源码旧值被搜索引擎沿用 产品页 2026-11-15 抓取,价格过期或误传
GitCode 镜像 GitHub_Trending/re/reachy_mini 当官方仓库 官方仓库 pollen-robotics/reachy_mini,文档在 huggingface.co/docs/reachy_mini/,源文件在整仓 docs/source/ 官方 README / 整仓,来源误认
「Python 3.8 以上即可」 安装页 3.10–3.12(推荐 3.12);1.14.0 包元数据 >=3.11 安装页 / PyPI 元数据,版本漂移或过时
「Python 3.10+」 1.2.7 时代确为 >=3.10,主线 1.14.0 已变,须标版本 安装页 / PyPI JSON,部分过时
「三种形态 SDK 完全一致」 仿真等同 Lite(localhost)、Wireless 走 network,脚本不改但连接位置不同;仿真无 XMOS 硬件回声消除、改软件 AEC 核心概念 / 仿真页,部分正确缺边界
「daemon 内置人脸识别,一行 start_head_tracking()」 python-sdk.md 确有 start_head_tracking(weight=...),但示例需 media_backend="default" Python SDK 官方页,有据但省略前置
「三套运动学引擎 NN / Analytical / Placo」 核心概念页只提 Placo(需额外安装并指定引擎);NN / Analytical 未在本次冻结官方页列出,可能来自源码或其他版本文档 核心概念官方页,待核,此处不作结论
「5 个舵机 / five servo motors」 官方 9 个:1 底座 + 6 Stewart 平台 + 2 天线,对应 9 dof 双平台硬件手册,数量错误
「Windows 不支持 / 即将支持」 安装页 Linux / macOS / Windows 全列 Supported,含 PowerShell 激活脚本章节 安装指南官方页,过时或错误
「Raspberry Pi 4 / 4B」 官方是 CM4 计算模块 CM4104016(4GB RAM / 16GB flash),非 Pi 4B 单板 Wireless 硬件手册,型号错误
「200+ 应用、近 10,000 台在野」(2026-05 二手口径) 产品页 2026-11-15 为 530+ apps / 14,000+ makers 产品页 2026-11-15 抓取,跨日期数字各标日期不互相覆盖
「从零构建」「3D 打印机器人」「DIY 手搓」类标题 官方定位是 sold as kits 的套件组装,不是自购零件从零制造 README / 文档首页 Hardware Overview,语义误导
GitCode 应用开发指南给出的整套接口(清单见下) 官方文档与整仓中均不存在这些命令、方法与文件类型 应用构建官方页 / README / 整仓,凭空捏造的 API
「官方承诺 2 小时装完」 FAQ 是测试者经验区间(1.5–2 小时、最多 4 小时),README / 上手页 2–3 小时,产品页约 2.5 小时 FAQ / README / 产品页,把经验区间写成承诺,三值并列留痕

这一行牵出整套捏造的接口,下面每一条在官方仓库中都不存在:

python -m reachy_mini.apps package
deploy --space
publish --official
head.look_at()
antenna.set_position()
body.set_yaw()
camera.capture_image()
web_interface="static/index.html"
web_port=8080
.rmapp 应用包

官方真实契约是 reachy-mini-app-assistant create(Never create app folders manually)与 check、ReachyMiniApp.run(reachy_mini, stop_event)、wrapped_run()、custom_app_url(自动起 FastAPI 服务 static/,端口 8042)、entry-point 组 reachy_mini_apps、daemon 子进程 python -u -m your_app.main 与 SIGINT 优雅退出。

别把这几条当成错误:官方本来就写着

有三条中文说法常被当成「套用旧项目」划掉,其实官方一手文档里明明白白有。上一轮取证曾判成待核,拿到整仓源文件后已订正,按订正后口径写,不列为错误。

  • 「调 PID 参数让运动平滑」:排障页有 Tuning PID values(P→180、D→10),hardware_config.yaml 每个电机都有 pid 字段。
  • 「电机 ID 10–18、波特率 1000000、scan_motors」:诊断页写明 IDs must be from 10 to 18、detected at baudrate 1000000;hardware_config.yaml 逐条 ID 10–18 且 baudrate: 1000000,页里也提到 scan_motors.py。
  • 「9 个电机全部单独寻址」:9 个电机 ID 10–18,hardware_config.yaml 逐个配置。

版本与命名口径:哪些不能混着写

口径项 怎么写
项目层与命名 项目名 Reachy Mini、alias reachy-mini、URL 与检索标题不带 Lite / Wireless / V2;Reachy Mini 既是产品线名也指 Wireless 单机,正文提具体机器带后缀
内容层三平台 Reachy Mini Lite(USB 接电脑、墙电、无电池无 IMU)、Reachy Mini Wireless(CM4 / 电池 / Wi-Fi / IMU / daemon 自启)、Simulation(MuJoCo 零硬件),由 version-id 页区分
代次 官方无 V2 代次命名;Wireless 与 Lite 是并列在售两版,不是新旧两代
主线版本与日期 锁 SDK 1.14.0(PyPI 上传 2026-11-05 / tag v1.14.0 发布 2026-11-03),抓取日期 2026-11-15;PyPI 79 个 release、GitHub 70 个 release / 86 个 tag 按该日期留痕,不写实时值
包名与版本号 PyPI 名 reachy-mini、import 名 reachy_mini、仓库名 reachy_mini、命令 reachy-mini-daemon 不混写;SDK 1.14.0 / 机器人软件下限 1.2.3+ / 板卡固件 2.1.4+ 互不换算
自由度与营销数字 9 自由度 = Head 6(3 旋转 + 3 平移)+ Body 1 + Antennas 2,对应 9 个电机 ID 10–18;530+ apps / 400+ moves / 14,000+ makers / 1,500+ posts 标「官方产品页 2026-11-15 抓取」,不作实时统计

价格与购买口径:认准产品页当日数字

项目 官方口径(产品页 2026-11-15 抓取)
整机价格 Reachy Mini Lite $399 / Reachy Mini Wireless $499;DAP 不含运费、进口关税与税费
发货表述 产品页原文 Ships within 90 days of purchase, often sooner;不据此判断库存或到货时间
配送地区 EU/UK 与 US/Canada 直发,其他地区经 Seeed Studio
组装与随附 About 2.5 hours、Everything in the box、No soldering、螺丝刀随附
配件边界 Hoverboard $149、NFC 配件包 $35 只提一句,不展开玩法

页面旧值 $299 是 2026-08 购买页源码残留被搜索引擎沿用,不是官方现行定价,以产品页当日 $399 / $499 为准;不换算人民币,不写成实时值。

遇到冲突时的处理顺序

  • 以官方一手材料为准:整仓 docs/source/ 下的 Markdown 源文件是文档站渲染源,高于二手中文稿与镜像站转述。
  • 官方自己不一致时把各值并列留痕、各标来源,不裁决,也不替官方补定义句把矛盾抹平;所有版本、价格、生态与日期数字带抓取日期 2026-11-15。
  • 中文稿的 API、命令、型号与官方对不上时先回官方仓库搜证,仓库里没有的就当不存在。

资料来源

  • 证据包 v1 官方冲突条目
  • 证据包 v1 中文误传条目
  • 官方 README
  • 安装指南官方页
  • 官方产品页

相关内容

Reachy Mini 深拆:399 美元的开源桌面机器人实践