Skip to content

upload_friend_image

上传好友聊天图片,并返回可直接传给 send_friend_msg 的图片消息段。

调用

js
const image = await api.upload_friend_image(
  self_id,
  user_id,
  file_path,
)

参数

参数类型必填说明
self_idnumber在线 Bot QQ 号
user_idnumber目标好友 QQ 号
file_pathstring后端可访问的本地路径、file:// 或 HTTP(S) 地址
文件名由后端根据图片 MD5 自动生成,图片类型由后端设置为 1000

返回值

js
{ type: 'image', data: { file_id: 'FILE_ID' } }

示例

js
const image = await api.upload_friend_image(
  3879548525,
  106030,
  'D:/Pictures/3840x2160.jpg',
)

await api.send_friend_msg(3879548525, 106030, [image])

调用前必读

协议与使用指南

Android + Linux QQ
适用协议
Android + Linux QQ
使用前准备
目标 Bot 必须属于当前插件节点并处于在线状态;涉及群或好友操作时,账号还必须具备对应 QQ 权限。
选择协议
const targetApi = api.forProtocol('linux') // 或 'android'

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

建议搭配

常见失败原因

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

注意事项

  • 同一 QQ 可同时运行 Android 与 Linux;务必显式选择协议,避免把操作发送到错误会话。
  • 本地路径按后端主机解释;插件与框架不在同一主机时,请传后端可访问的 HTTP(S) 地址。

萌卡NT 开发文档