set_friend_remark

修改机器人通讯录里指定好友的备注。支持 Android、Linux QQ；多协议账号请显式指定协议。

调用方式

await api.forProtocol('android').set_friend_remark({ self_id, user_id, remark })

// 显式空字符串表示清空，不要省略 remark。
await api.forProtocol('linuxqq').set_friend_remark({ self_id, user_id, remark: '' })

参数

参数	类型	必填	说明
self_id	number	是	执行操作的在线 Bot QQ 号
user_id	number	是	好友 QQ 号
remark	string	是	新备注；传空字符串会清除备注
client_type	string	否	android 或 linuxqq；SDK 可通过 forProtocol 指定

返回值

成功时返回空数据：

null

备注提交后回读好友列表，确认备注一致时返回成功。

缺少 remark、传 null、数字、布尔值或其他非字符串会在发送前被拒绝，不会清空已有备注。字符串按原值提交。控制台调试页需要清空时，也可在补充 JSON 中明确填写 {"remark":""}。

该操作修改的是 self_id 对 user_id 的备注，不会修改对方客户端里保存的机器人名称。如果写入后回读超时、好友不存在或备注不一致，接口返回错误；请求可能已经发送，请先调用 get_friend_list 核对，不要因为超时自动重发。

目标不是好友或无法解析其 UID 时返回错误。