Rocom-query-eggs Skill
概述
此技能用于查询洛克王国世界中宠物蛋的孵化结果。用户输入蛋径(高度)和蛋重,技能调用公开API查询可能孵出的宠物,返回包含匹配度、置信度、属性和进化链的详细结果。
何时使用
此技能应在以下场景触发:
- 用户提及"查蛋"、"孵蛋查询"、"蛋径蛋重查宠物"等意图
- 用户询问洛克王国世界中某个蛋径/蛋重能孵出什么宠物
- 用户提供蛋径和蛋重数值并希望查询对应宠物
工作流程
1. 解析用户输入
从用户消息中提取蛋径和蛋重数值。输入格式支持:
- 纯数字:
0.357.64 - 带单位:
0.35m7.64kg
若用户只提供了部分参数,主动询问缺失的参数。
2. 执行查询
使用 scripts/query_eggs.py 脚本执行API查询:
python3 scripts/query_eggs.py <蛋径> <蛋重>
示例:
python3 scripts/query_eggs.py 0.35 7.64
python3 scripts/query_eggs.py 0.35m 7.64kg
添加 --json 参数可获取原始JSON响应:
python3 scripts/query_eggs.py 0.35 7.64 --json
> 注意:脚本依赖 httpx 库,若未安装需先执行 pip3 install httpx。
3. 格式化展示结果
将查询结果以清晰易读的方式展示给用户,包含:
- 基本信息:蛋径、蛋重、匹配总数
- 每个匹配项:
- 排名序号
- 宠物名称(蛋类型带🥚标记)
- 匹配度百分比
- 置信度(高🟢/中🟡/低🔴)
- 属性类型
- 进化链
如需了解API返回数据的详细格式,查阅 references/api_docs.md。
4. 注意事项提醒
查询结果展示后,提醒用户:置信度不代表宠物的准确概率,请自行判断。
结果格式化指南
置信度颜色映射
| confidence | 标记 | 颜色 |
|---|---|---|
| high | 🟢 | #52C41A |
| medium | 🟡 | #FAAD14 |
| low | 🔴 | #FF4D4F |
特殊处理
source_kind为"egg"的记录:无pet_preview详情,属性显示"蛋",进化链显示"🥚 蛋形态"evolution_chain为空时:使用display_name作为进化链显示pet_preview为null时:按 egg 类型处理
示例交互
用户: 查蛋 0.35 7.64
助手: 执行 python3 scripts/query_eggs.py 0.35 7.64,然后将结果格式化展示。
用户: 蛋径0.35m蛋重7.64kg能孵出什么?
助手: 提取参数后执行查询,展示结果并附上置信度提醒。