📜 准备依据：严格对齐 官方活动说明与实操任务 的参与要求，以及 官方开发到上架通用手册 第 0–4 步。
🎯 当前进度：已完成独立环境搭建、三套技能模板、双机型构建、虚拟替身单测与本人账号登录鉴权验证；机器人局域网 IP、分配机型和真机实弹两轮验收须到达活动现场后完成。切记：绝不把电脑离线替身模拟通过当成真机跑通！
* 🏠 整活工作台总门户：点此进入总控室
* 🚀 从 0 到 1 大白话图文 SOP：8 步闯关 SOP
* 🤝 现场交接与最短执行路径：项目交接与现场执行指南
一、已核对的公开活动情报（上海站）
2026-10-23 从启元开发者官网活动页实测抓取核对：
- 活动名称：「机器人整活局」启元机器人 Developer Playground 上海站
- 公开开始时间：2026-10-24 14:00（官网标示结束时间为 17:00）
- 公开场地名称：启元机器人授权体验店（上海淮海路龙凤 PRSCO）
- 议程细节小贴士：AtomGit 署名介绍中的议程海报抬头同样写 14:00–17:00，但细项延续到 17:40（其中动手实操环节为 15:30–16:50、Demo Show 演示为 16:50–17:20、自由交流 17:20–17:40）。具体结束时间、楼层门牌和签到要求以本人收到的报名成功通知为准。
- 完整证据链与海报原图：见 公开活动信息核验报告。
二、12 项赛前准备已落实成绩单
| 规则要求项 | 落实结果 | 关联详情与证据入口 |
|---|---|---|
| 1. 开发工具包 (dev kit) | 官方仓库已就位并完成跨平台与多浏览器增强，保留上游示例 | 官方工具包导览 |
| 2. Python 与国密依赖 | 独立虚拟环境（Python 3.12.9，gmssl==3.2.2、pycryptodomex==3.24.1）；技能语法额外按 Python 3.10 严格校验 | 运行环境体检快照 |
| 3. AI Agent 开发环境 | 已备妥 AI 辅助编程环境与防呆提示词模板 | 运行时契约与提示词必读 |
| 4. SSH / SCP / curl | 系统原生 OpenSSH 与 curl 已就位；跨平台纯 Python 脚本自动调用 | 开工环境体检仪 |
| 5. PrimeHub 网络自检 | 匿名搜索“点歌”返回 code=1000、命中官方 ID 51《点歌台》 | 环境预检实跑输出 |
| 6. 全浏览器登录与提 Token | 升级支持 Chrome / Edge / Brave / Firefox / --token 提取凭证；本人已登录验证，有效期至 2026-10-30 18:29:25 | 全浏览器顺 Token 神器 |
| 7. 运行时契约落实 | 纯 Python 3.10 标准库 + 全局注入 robot + TTS 0.7s 防抖轮询 + 动作 interrupt=False + flush=True | 运行时契约与避坑必读 |
| 8. 技能模板双保险 | 备齐 《启元百变互动官》（通用全能版）与 《社交能量补给站》（离线保底版），版本 0.1.0 | 技能剧本库总览 |
| 9. 双机型安装包与元数据 | 已生成 Q1/T1 共 4 个 .rpk 安装包与 4 份发布配置（现场只装对应机型） | 成品弹药库检视面板 |
| 10. 虚拟替身仿真验证 | 0.4 秒测完双机型、T1 双形态、语音抖动滤波、断网降级、异常熔断、包结构与多浏览器提 Token | 假机器人替身演武场 |
| 11. 真实服务端鉴权验证 | 本人账号查询接口 queryPageByUserCode：带 Token 返回 1000，匿名返回 1002 | 服务端鉴权回执记录 |
| 12. 市场最终上架 | 未执行（严守规则）：等待现场真机连续两轮验收通过后再执行发布 | 赛前准备验收记录 |
三、全流程纯 Python 跨平台命令速查
无需记忆复杂的变量拼接，直接运行以下清爽命令（也可去 整活工作台总门户 使用参数联动台一键复制）：
# 1. 工具链与 PrimeHub 匿名搜索热身预检
python Tools/scripts/preflight.py
# 2. 改完台词或动作后，一键重新生成 Q1/T1 双包并跑完替身单元测试
python Tools/scripts/build.py
python -m unittest discover -s Tools/tests -v
# 3. 从 Chrome / Edge / Brave / Firefox 自动扫描提取登录 Token 并验证鉴权
python Tools/primehub_dev_kit/extract_token.py
python Tools/primehub_dev_kit/primehub_publish.py my当前已构建就绪的双机型弹药一览：
| 机型 | 技能安装包 | 预设安全动作组合 | 配对上架配置 |
|---|---|---|---|
| Q1 人形 | universal_skill_q1.rpkenergy_station_q1.rpk | 3001 (招手) / 3008 (加油) / 3007 (比心) | 百变互动官 Q1 上架配置 能量补给站 Q1 上架配置 |
| T1 变形 | universal_skill_t1.rpkenergy_station_t1.rpk | 26 (喜悦) / 43 (律动) / 26 (喜悦) | 百变互动官 T1 上架配置 能量补给站 T1 上架配置 |
四、现场真机探测、两轮实弹运行与上架命令
到了现场领到机器人 IP 后（先确认周围 1 米清空、先低位后站立、无人同时用 App 遥控）：
# 第一步：先连接真机探测、把机上真实 YAML 动作表抓回探测报告并上传包（不加 --run）
python Tools/scripts/robot_run.py --model q1 --ip 192.168.112.222 --skill universal_skill
# 第二步：核对动作表与 1 米安全结界后，加 --run 正式启动真机运行（必须连续跑通两轮！）
python Tools/scripts/robot_run.py --model q1 --ip 192.168.112.222 --skill universal_skill --run
# 第三步：两轮真机验收全绿后，一键发布现场机型到 PrimeHub 技能市场
python Tools/primehub_dev_kit/primehub_publish.py publish Tools/dist/universal_skill_q1.rpk --metadata-file Tools/dist/publish_universal_q1.json
python Tools/primehub_dev_kit/primehub_publish.py search "启元百变互动官 Q1"五、发布前验收与出发前核对清单
5.1 现场发布前 8 项必查
- 机器人实际机型（Q1 或 T1）与安装包严格一致；动作 ID 已对照机上抓取的 YAML 核对。
- 远程调试返回
final: success，且stdout出现*_DONE steps=3。 task_engine.log中每个预期动作都有对应时间段的创建Animation task成功，无reason 24/19/42/28/17。- 现场亲耳听完 5 段台词，无吞字、截断或假空闲抢拍。
- 真机连续独立运行两轮全部通过；运行期间无人同时使用手机 App 遥控。
- 真实演出总时长小于 120 秒任务超时；周围 1 米净空，听从现场导师指令。
- 本人浏览器登录、Token 提取及服务端只读鉴权验证成功。
- 发布标题、简介文案及作者信息确认无误。
5.2 出发前个人物品核对
- PrimeHub 本人手机号登录、凭证提取和鉴权验证已就绪。
- 公开活动开始时间与体验店名已核对（上海淮海路龙凤 PRSCO）。
- 核对本人报名成功通知中的具体楼层/门牌/签到安排，以及 17:00 与 17:40 的结束时间差异。
- 确认报名问卷分组机型，手机装好启元官方 App。
- 带上笔记本电脑、充电器、必要网口转接头（无需安装 ROS2，无需开启开发者模式）。