API 开源贡献者：星空花海
新接口契约基于贡献附件重新实现，随下一框架版本提供。当前官网文档提前更新；已发布的 v2.1.4 不代表支持此对象参数契约。需同步更新框架、前端及 Node.js SDK。
优先可用职业，回退学习，按最短选项 warning 判断疲劳。
- action：
get_pet_fatigue_status - OIDB：
overview / catalog（字段依据OIDB-API.md及专项修复说明） - 协议：Android。未提供 Linux 宠物协议验证资料，目前明确拒绝 Linux 账号。
- 使用普通插件 WS 调用链，不需要专属 Key。
send_packet的专属 Key 要求不变。
请求参数
仅接受对象参数；不兼容之前的宠物位置参数或 friend_id、food、item 等旧别名。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id |
number | 是 | 在线机器人 QQ 号 |
client_type |
string | 是 | 当前实现支持 android；须使用 Android 账号 |
pet_id |
string | 是 | 宠物 ID，须按接口说明区分本人或目标；不能用 QQ 号代替 |
调用示例
const result = await api.get_pet_fatigue_status({
"self_id": 123456,
"client_type": "android",
"pet_id": "pet-own"
})
返回结果
fatigued、tier、benefitRate、todayHours、reason、warnings[]、known、activity、option_name。tier 为 0 / 8 / 12，倍率为 1 / 0.25 / 0.1。todayHours 仅在文案明确给出今日累计时返回数值，否则为 null；未识别提示时 known=false，fatigued/tier/benefitRate=null，不能据此自动继续任务。
错误与执行约定
参数错误、SSO 错误、OIDB 业务错误、响应命令不匹配或数据损坏均返回失败。不得把超时当成未执行；写请求不会自动重试。喂食和洗护需显式调用 get_pet_vitals 回读同一目标宠物确认效果。自动化由插件控制，本接口不会循环执行。
专项修复说明优先于 OIDB 总览中旧的“冒险疲劳”描述：先找可用打工职业，无可用选项才回退学习，选最短时长选项的 warning。附件未包含所引用的 parseFatigueWarning 完整源码或真实提示样本，因此不识别的文案明确返回未知状态。