对不上的地方先摆出来,别急着替官方改口径
中文教程常给出对不上的系统说法、偏低 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、命令、型号与官方对不上时先回官方仓库搜证,仓库里没有的就当不存在。