Rocom-query-eggs Skill

概述

此技能用于查询洛克王国世界中宠物蛋的孵化结果。用户输入蛋径（高度）和蛋重，技能调用公开API查询可能孵出的宠物，返回包含匹配度、置信度、属性和进化链的详细结果。

何时使用

此技能应在以下场景触发：

• 用户提及"查蛋"、"孵蛋查询"、"蛋径蛋重查宠物"等意图
• 用户询问洛克王国世界中某个蛋径/蛋重能孵出什么宠物
• 用户提供蛋径和蛋重数值并希望查询对应宠物

工作流程

1. 解析用户输入

从用户消息中提取蛋径和蛋重数值。输入格式支持：

• 纯数字：0.35 7.64
• 带单位：0.35m 7.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. 注意事项提醒

查询结果展示后，提醒用户：置信度不代表宠物的准确概率，请自行判断。

结果格式化指南

置信度颜色映射

特殊处理

• 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能孵出什么？

助手: 提取参数后执行查询，展示结果并附上置信度提醒。