机器人技能包能做什么——从情绪助手到迎宾讲解启元 Q1 如何用一份 JSON 定义机器人的性格与技能这篇科普不急着讲技术细节先把问题本身讲清楚机器人技能包到底是什么它能做什么为什么一份 JSON 文件就能让机器人换一种性格对于普通用户和产品经理来说技能包如何改变我们与机器人的交互方式一、从只会走路的铁疙瘩到有性格的机器人想象一个场景你走进公司大堂前台机器人看到你微笑着说早上好今天天气不错同时挥了挥手LED 灯带闪烁着温暖的橙色呼吸光。再想象另一个场景同一个机器人在下午三点看到你说加油再坚持一下双手比心灯带变成粉色慢呼吸。同一个机器人同一个人为什么会有完全不同的反应答案就是技能包。技能包让机器人从只会执行固定程序的铁疙瘩变成能根据不同场景展现不同性格的智能体。它不是硬件升级而是软件定义——一份 JSON 文件 几行代码就能让机器人换一种人格。传统机器人的局限在技能包出现之前机器人开发面临几个核心问题行为固化机器人的行为在出厂时就写死了想要改变需要重新编程、编译、烧录固件开发门槛高需要掌握 C/Python、机器人学、电机控制等专业知识迭代周期长从需求到部署一个功能可能需要几周甚至几个月缺乏个性化所有机器人表现一致无法根据不同场景定制性格技能包的出现彻底改变了这个局面。二、什么是技能包——机器人的App如果把机器人比作手机技能包就是手机上的 App。维度手机 App机器人技能包本质一个安装包APK/IPA一个压缩包.rpk本质是 ZIP内容代码 资源图片/音频代码main.py 配置JSON 元数据pkg.yaml安装从应用商店下载从 PrimeHub 下载或自己打包运行点击图标启动导入 PrimeConsole触发执行卸载删除 App删除技能包技能包的核心思想是软件定义机器人行为硬件不变通过更换技能包改变机器人的性格和技能。技能包长什么样一份典型的技能包配置skin.json如下{package_name:q1_emotion_encourage,lines:[加油再坚持一下,你可以的相信自己],motions:[3008,3007],emotion_id:3003,led:{mode:254,rgb:[255,182,193],period:2.5}}这份 JSON 定义了包名、台词池2 条、动作序列加油→双手比心、表情开心、灯效粉色呼吸 2.5 秒。机器人读取这份配置就能自动执行一整套行为。技能包 vs 传统编程维度传统机器人编程技能包方式开发语言C/Python需要编译JSON 少量 Python动作控制调用电机 API写轨迹规划填写动作编号如 3008调试方式日志 示波器PrimeConsole 仿真 真机验证部署方式烧录固件/推送二进制导入 .rpk 文件门槛需要机器人学背景产品经理/设计师可上手技能包把机器人开发从工程师专属变成了人人可创作。三、技能包能做什么——四个典型应用场景场景一情绪助手触发条件定时触发早上 8 点、下午 3 点或用户主动触发。技能包内容台词“早上好今天也要元气满满哦”动作招手 → 上半身舞蹈表情开心3003灯效橙色呼吸1.5 秒周期用户体验机器人像一个贴心的朋友在特定时间给你鼓励和陪伴。场景二迎宾接待触发条件人脸识别检测到陌生人进入大堂。技能包内容台词“欢迎光临请问有什么可以帮您”动作招手 → 挥手引导手势表情耍酷3002灯效白色常亮专业感用户体验机器人像一个专业的接待员给访客第一印象。场景三产品讲解触发条件用户站在展柜前超过 3 秒。技能包内容台词“这款产品采用了最新技术让我为您详细介绍……”动作挥手指向产品→ 双手比心表达推荐表情开心3003灯效蓝色呼吸科技感用户体验机器人像一个专业的导购主动介绍产品。场景四舞台表演触发条件活动开场或用户点击表演按钮。技能包内容台词“接下来请欣赏我的舞蹈表演”动作上半身舞蹈 1 → 上半身舞蹈 2 → 加油结束姿势表情开心3003灯效彩虹模式炫酷效果用户体验机器人像一个演员在特定场合表演节目。四、用户体验流程从触发到执行一个完整的技能包执行流程是这样的用户触发定时/人脸/按钮 ↓ PrimeConsole 加载技能包 ↓ 读取 JSON 配置台词/动作/表情/灯效 ↓ 按顺序执行四个服务1. LED 灯效LedStripCommand2. 表情切换PlayEmotion3. 台词播放PlayTts4. 动作执行SetMcPresetMotion ↓ 机器人响应声光电 动作同步注意这个顺序先亮灯再换表情然后说话最后做动作。为什么是这个顺序因为灯光和表情是氛围铺垫台词是信息传递动作是高潮呈现——就像舞台表演先打光再亮相然后开口最后起舞。代码层面怎么实现main.py 里调用四个服务客户端顺序固定fromq1_sdkimportLedStripCommand,PlayEmotion,PlayTts,SetMcPresetMotionimportjsonwithopen(skin.json,encodingutf-8)asf:skinjson.load(f)# 1. LED 灯效LedStripCommand(modeskin[led][mode],rgbskin[led][rgb],periodskin[led][period])# 2. 表情切换PlayEmotion(emotion_idskin[emotion_id])# 3. 台词播放PlayTts(textskin[lines][0])# 4. 动作执行必须用字面量编号SetMcPresetMotion(3008)# 加油SetMcPresetMotion(3007)# 双手比心这段代码展示了技能包的核心逻辑读取 JSON 配置按顺序调用四个服务。注意动作编号必须写成字面量3008不能写成变量——这是 PrimeConsole 的安全约束后续篇章会详细解释。五、技能包如何改变机器人交互从命令式到场景式传统机器人交互是命令式用户说招手机器人招手用户说跳舞机器人跳舞。用户需要知道机器人有哪些动作像在用遥控器。技能包让交互变成场景式用户不需要知道具体动作只需要触发场景比如早上 8 点或有人来了机器人自动执行一整套编排好的行为台词 动作 表情 灯效。用户像在看表演而不是在操作机器。从单一功能到人格化没有技能包时机器人是工具你让它做什么它做什么。有了技能包后机器人可以有人格情绪助手技能包 → 机器人是贴心的朋友迎宾技能包 → 机器人是专业的接待员表演技能包 → 机器人是活泼的演员同一台硬件通过更换技能包机器人可以扮演不同角色。这就是软件定义机器人的力量。从开发者专属到人人可创作技能包的设计目标是低门槛创作不需要写复杂的控制代码只需要填写一份 JSON台词、动作编号、表情 ID、灯效参数用模板工具一键打包成 .rpk导入 PrimeConsole 即可运行这意味着产品经理、设计师、甚至普通用户都可以创作技能包而不只是程序员。技能包的优势与局限优势开发效率高一份 JSON 几行代码几分钟就能创建一个技能包迭代速度快修改配置后重新打包秒级部署门槛低不需要机器人学背景产品经理/设计师可上手可分享通过 PrimeHub 社区可以下载别人的技能包也可以分享自己的作品局限灵活性受限动作编号必须字面量不能用变量或表达式仿真不完整只能验证动作轨迹不能验证声音/表情/灯效执行顺序固定不能自定义四服务的执行顺序复杂逻辑不支持如果需要动态生成动作序列应该用 Q1 SDK 写独立应用这些局限是安全与灵活性的权衡牺牲动态性换取安全性和低门槛。对于大多数场景情绪助手、迎宾接待、产品讲解、舞台表演技能包已经足够。创作工具链技能包创作涉及三个工具工具用途用户角色PrimeConsole技能包导入、仿真验证、真机执行开发者/测试人员PrimeHub技能包市场下载和分享社区作品所有用户Q1 SDK底层 API写独立应用高级专业开发者典型工作流用文本编辑器编写 skin.json 和 main.py用打包脚本生成 .rpk 文件导入 PrimeConsole 仿真验证真机测试上传 PrimeHub 分享整个流程不需要编译环境不需要机器人学背景只需要理解 JSON 结构和动作编号表。六、启元 Q1 相关工具与文档技能包创作与验证工具PrimeConsole 1.0.2技能包导入、仿真验证、真机执行PrimeHub技能包市场下载和分享社区创作的技能包Q1 SDK v1.0.0.0机器人底层 SDK技能包运行的基础文档与资源启元 Q1 开发者文档技能包格式规范、API 参考preset-actions-q1/index.jsonQ1 可用动作编号索引3001 招手、3003 碰拳、3004 挥手、3007 双手比心、3008 加油、3046 上半身舞蹈 1、3047 上半身舞蹈 2表情索引3002 耍酷、3003 开心灯效模式254 暖光呼吸、2 彩虹、255 闪烁版本信息本文基于 Q1 SDK v1.0.0.0 PrimeConsole 1.0.2后续版本可能新增动作或表情编号。访问启元机器人开发者社区获取 SDK、仿真工具、开发文档完成从代码仿真到真机落地的全流程开发https://dev.primebot.com/