API 开源贡献者：星空花海
新接口契约基于贡献附件重新实现，随下一框架版本提供。当前官网文档提前更新；已发布的 v2.1.4 不代表支持此对象参数契约。需同步更新框架、前端及 Node.js SDK。
模式 4；过滤无效条目，单页最多 100 条。
- action：
get_pet_pk_strangers - OIDB：
pkFriendList（字段依据OIDB-API.md及专项修复说明） - 协议：Android。未提供 Linux 宠物协议验证资料，目前明确拒绝 Linux 账号。
- 使用普通插件 WS 调用链，不需要专属 Key。
send_packet的专属 Key 要求不变。
请求参数
仅接受对象参数；不兼容之前的宠物位置参数或 friend_id、food、item 等旧别名。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id |
number | 是 | 在线机器人 QQ 号 |
client_type |
string | 是 | 当前实现支持 android；须使用 Android 账号 |
cursor |
string | 否 | 服务端返回的下一页游标 |
调用示例
const result = await api.get_pet_pk_strangers({
"self_id": 123456,
"client_type": "android"
})
返回结果
friends[]（pet_id、pet_name、user_id、nickname、displayed_pk_power）、next_cursor、has_more。过滤标记为 0 的条目，每次最多返回 100 条。
错误与执行约定
参数错误、SSO 错误、OIDB 业务错误、响应命令不匹配或数据损坏均返回失败。不得把超时当成未执行；写请求不会自动重试。喂食和洗护需显式调用 get_pet_vitals 回读同一目标宠物确认效果。自动化由插件控制，本接口不会循环执行。