API 开源贡献者：星空花海
新接口契约基于贡献附件重新实现，随下一框架版本提供。当前官网文档提前更新；已发布的 v2.1.4 不代表支持此对象参数契约。需同步更新框架、前端及 Node.js SDK。
返回消息 JSON 段、时间、来源与事件类型。
- action：
get_pet_interaction_messages - OIDB：
interactionHistory（字段依据OIDB-API.md及专项修复说明） - 协议：Android。未提供 Linux 宠物协议验证资料，目前明确拒绝 Linux 账号。
- 使用普通插件 WS 调用链，不需要专属 Key。
send_packet的专属 Key 要求不变。
请求参数
仅接受对象参数；不兼容之前的宠物位置参数或 friend_id、food、item 等旧别名。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id |
number | 是 | 在线机器人 QQ 号 |
client_type |
string | 是 | 当前实现支持 android；须使用 Android 账号 |
limit |
number | 否 | 消息条数 1–50，默认 20 |
调用示例
const result = await api.get_pet_interaction_messages({
"self_id": 123456,
"client_type": "android"
})
返回结果
messages[]（user_id、segments、timestamp、message_id、pet_name、event_type）；segments 是已解析的 JSON 段数组。格式异常时报错，不将不明内容当作有效消息。
错误与执行约定
参数错误、SSO 错误、OIDB 业务错误、响应命令不匹配或数据损坏均返回失败。不得把超时当成未执行；写请求不会自动重试。喂食和洗护需显式调用 get_pet_vitals 回读同一目标宠物确认效果。自动化由插件控制，本接口不会循环执行。