启元机器人（Q1 / T1）技能开发工具包——从零做出一个机器人技能，真机调试，发布到 PrimeHub 技能市场。
快速开始
unzip primehub-dev-kit.zip && cd primehub-dev-kit # 或直接 clone 本仓库
python3 primehub_publish.py search "你好" # 自检：能搜 = 网络和传输层 OK然后按 SKILL_PUBLISH_GUIDE.md 的 0→8 步走：
登录 PrimeHub → 给 AI agent 喂机器人契约 → vibe coding 改示例 → 打包 .rpk
→ 真机调试 → 提取登录 token → 一条命令发布上架里面有什么
| 文件 | 用途 |
|---|---|
SKILL_PUBLISH_GUIDE.md | 完整手册（开发顺序、调试判读、失败码表、发布流程） |
../../Example/ | 独立技能示例库（含官方 example-jukebox 点歌台、energy_station 社交能量补给站、universal_skill 通用互动模板） |
pack.py | 打包器：技能目录 → .rpk |
deploy_test.py | 真机调试 harness（scp 到机器人跑） |
primehub_publish.py | PrimeHub 发布/删除/查询客户端 |
primehub_client.py | SM4 传输层（发布客户端的依赖） |
extract_token.py | 从本机 Chrome / Edge / Brave / Chromium / Firefox 或 --token 自动提取 PrimeHub token |
环境要求
- Python 3 +
pip install gmssl curl、sshpass（Windows 可直接用系统自带ssh.exe/scp.exe/curl.exe）- 一台同网段的 Q1/T1 机器人（SSH
run） - 本机任意主流浏览器（Chrome / Edge / Firefox 等，用于 PrimeHub 登录态，发布凭证自动提取）
支持
动作 ID 表、平台约束（室内模式/音频互斥/状态轮询）等机器人侧知识都在 SKILL_PUBLISH_GUIDE.md §2 与 ../../MustRead/02_机器人运行时契约与避坑必读.md。
本地 Windows 与多浏览器兼容增强
本副本基于上游 dccf836，extract_token.py、primehub_publish.py 有本地增强：
search可匿名执行，服务器错误会明确报错。- 多浏览器 Token 提取：除 Firefox（Windows/MSIX/macOS/Linux SQLite + WAL + Snappy）外，新增支持 Chrome / Microsoft Edge / Brave / Chromium（自动拷贝
Local Storage/leveldb快照防锁库，兼容 UTF-8 与 UTF-16LE 及 Snappy 块），并支持--browser指定浏览器及--token/PRIMEHUB_TOKEN直接传入。 - 两脚本共用本 workspace 的
.local/ph_token.txt，可通过PRIMEHUB_TOKEN_FILE指定位置。 - 发布除原有 JSON 参数外，也支持
publish file.rpk --metadata-file publish.json，便于 PowerShell 使用。 my使用经过真实鉴权验证的queryPageByUserCode账号查询接口，登录过期会明确报错。
此目录的原手册仍保留 Linux 示例；本机实测命令、依赖环境和验收状态见 ../../MustRead/01_从零开发Q1_T1技能_SOP.md 与 ../../Doc/04_赛前准备状态与命令说明.md。