set_self_longnick

设置或清空当前 QQ Bot 的个性签名。实现严格复用 QQ Android 9.2.70 的真实链路：先通过 Signature.auth 审核内容，再把服务端返回的 key 和审核后签名内容写入 ProfileService.SetRichSig。清空签名使用客户端独立的 OidbSvc.0x510_0 请求。

调用

const result = await api.set_self_longnick(self_id, longNick)

参数

参数	类型	必填	说明
self_id	number	否	在线 Bot QQ 号；当前连接只管理一个 Bot 时可省略
longNick	string	是	新个性签名；显式传入空字符串时清空签名

兼容参数名 long_nick，但新插件建议统一使用 longNick。

返回值

{
  success: true,
  summary_card: {
    sign: '新的个性签名'
  }
}

保存成功后框架会读取一次最新 QQ 名片。若 QQ 名片服务短暂延迟，接口仍返回 success: true，并在 readback_warning 中说明读取失败原因；可稍后调用 get_summary_card 再确认。

示例

// 设置签名
await api.set_self_longnick(123456789, '今天也要开心')

// 清空签名
await api.set_self_longnick(123456789, '')

内容会经过 QQ 审核

审核未通过时接口直接返回失败，不会继续发送保存请求。框架不会使用原始文本绕过审核，也不会把审核前的 RichStatus 数据直接写入 QQ。