get_friend_list

获取 Bot 的完整好友列表。萌卡NT会自动完成分页。

v2.0.6 修复：分页使用服务端返回的完整分页凭据，以结束标记判断是否收齐。仅在整批读取成功后返回列表并更新好友数量；网络超时、分页凭据缺失或循环、响应账号不匹配、重复账号及损坏响应均返回错误，不以成功结果返回已读取的部分名单。此修复由 v2.0.6 提供。

内部单页请求调整为200条，避开较大分页响应发生记录缺口的边界；这不是最终好友数量上限，插件无需自行传递分页游标。

整批读取上限为60秒，调用方设置的更短超时仍然有效。资源保护上限为128页、100000条好友记录或64 MiB响应；触及上限时明确失败，不截断成功返回。total_count 是最终返回的好友条数，不是单页协议的结束标记。

调用

const result = await api.get_friend_list(self_id)

参数

返回值

{
  friends: [],
  total_count: 0,
  self_uin: 123456789,
}