Skip to content

get_pet_fatigue_status

读取 QQ 宠物学习/打工目录下发的疲劳警示,并解析当前疲劳档位和收益倍率。

框架会同时读取可用打工职业和当前学习阶段的目录,合并两边所有非空 warning,并采用其中最严重的疲劳档位。疲劳来源是目录选项的 warning,不是 unavailable_reason

调用

js
const result = await api.get_pet_fatigue_status(self_id)

参数

参数类型必填说明
self_idnumber在线 Bot QQ 号

返回值

js
{
  fatigued: true,
  tier: 8,
  benefitRate: 0.25,
  todayHours: 8,
  reason: '今日已打工8小时,后续收益为25%',
  warnings: ['今日已打工8小时,后续收益为25%'],
}
字段说明
fatigued是否进入疲劳收益档位
tier8 表示 8 小时档,12 表示 12 小时档,未疲劳为 0
benefitRate当前收益倍率:10.250.1
todayHours从服务端警示文本中解析出的今日累计小时数
reason最严重疲劳档位对应的原始警示;只有非档位警示时取首条,无警示时为“未检测到疲劳警示”
warnings打工和学习目录中的所有非空警示,去重并保留服务端原文

调用前必读

协议与使用指南

仅 Android
适用协议
仅 Android
使用前准备
目标 Bot 必须属于当前插件节点并处于在线状态;涉及群或好友操作时,账号还必须具备对应 QQ 权限。
选择协议
const androidApi = api.forProtocol('android') // 省略时也默认 Android

原始 action 请求只使用附件约定的 client_type: 'android' | 'linuxqq';省略时选择 Android。

建议搭配

常见失败原因

  • bot 不属于本节点
  • bot 未在线或账号状态不符合要求
  • client_type 无效或目标协议不支持该 action

注意事项

  • 省略协议选择器时默认 Android;若指定 Linux,框架会明确拒绝,不会转交同 QQ 的 Android 实例。
  • 查询结果可能受 QQ 服务端分页、缓存与权限影响,不应假设一次调用返回全部数据。

萌卡NT 开发文档