set_qq_profile

设置当前 QQ Bot 的昵称、性别和个性签名。昵称与性别使用 QQ Android 9.2.70 的资料编辑协议；个性签名使用内容审核与富签名保存链路，并支持重复提交同一个值。

调用

js

const result = await api.set_qq_profile(self_id, nickname, personal_note, sex)

参数

参数	类型	必填	说明
`self_id`	number	否	在线 Bot QQ 号；当前连接只管理一个 Bot 时可省略
`nickname`	string	是	新 QQ 昵称，不能为空
`personal_note`	string	否	新个性签名；显式传入空字符串时清空签名
`sex`	number \| string	否	`0` 未知、`1` 男、`2` 女；省略时不修改

返回值

js

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

框架在写入后重新读取 QQ 名片。QQ 当前把个性签名放在 richSign 中时，框架会自动解析并同步到标准 sign 字段。重复提交相同签名会直接返回成功，不会把 QQ 审核服务的重复内容回执误报为失败。

示例

js

await api.set_qq_profile(123456789, '萌卡机器人', '今天也要开心', 1)

资料修改会真实同步到 QQ

昵称、性别和个性签名都是账号级资料。调用前应明确提示管理员，并避免在定时任务中反复修改。

适用协议: 仅 Android
使用前准备: 目标 Bot 必须属于当前插件节点并处于在线状态；涉及群或好友操作时，账号还必须具备对应 QQ 权限。

选择协议

const androidApi = api.forProtocol('android') // 省略时也默认 Android

原始 action 请求只使用附件约定的 client_type: 'android' | 'linuxqq'；省略时选择 Android。

建议搭配

get_bot_info

常见失败原因

bot 不属于本节点
bot 未在线或账号状态不符合要求
client_type 无效或目标协议不支持该 action

注意事项

省略协议选择器时默认 Android；若指定 Linux，框架会明确拒绝，不会转交同 QQ 的 Android 实例。
本地路径按后端主机解释；插件与框架不在同一主机时，请传后端可访问的 HTTP(S) 地址。
该操作会修改 QQ 侧状态；调用前校验目标 ID，并避免在失败重试时重复执行。