扩展

共 115 个动作。

gocqhttp / NapCat 兼容扩展接口。用 API 首页 的搜索框可快速定位。

动作 性质 中文名
_del_group_notice 删除群公告(fid 或 notice_id 二选一)
_get_group_notice 只读 获取群公告
_get_model_show 只读 获取机型展示(兼容 mock)
_mark_all_as_read 标记全部已读(no-op,待 RE 全读 cmd)
_send_group_notice 发送群公告
_set_model_show 设置机型展示(占位)
.get_word_slices 只读 分词(未实现)
add_custom_face 添加收藏表情
bot_exit 退出机器人
cancel_group_todo 取消群待办
check_url_safely 只读 检查链接安全性
clean_cache 清理缓存
clean_stream_temp_file 清理流式传输临时文件(仅清理 stream 上传/下载目录)
click_inline_keyboard_button 点击内联键盘按钮
complete_group_todo 完成群待办
create_collection 创建收藏(未实现)
create_flash_task 创建闪传任务
delete_custom_face 删除收藏表情
delete_essence_msg 移除精华消息
delete_flash_file 删除闪传文件
delete_group_folder 删除群文件夹
download_file 下载文件(url 或 base64)到 data/downloads
download_file_image_stream 以流式方式下载图片(缓存图片 id / URL / stream 目录本地文件)
download_file_record_stream 以流式方式下载语音(缓存语音 id / URL / stream 目录本地文件)
download_file_stream 以流式方式下载文件(stream 目录本地文件 / URL / 缓存媒体)
download_fileset 解析闪传文件下载直链(不下载,由调用方实现下载)
fetch_custom_face 只读 获取自定义表情
fetch_emoji_like 只读 获取表情回应用户(NapCat 分页)
fetch_ptt_text 只读 获取语音转文字结果
forward_friend_single_msg 转发单条消息给好友
forward_group_single_msg 转发单条消息到群
friend_poke 好友拍一拍
get_ai_characters 只读 获取 AI 语音角色
get_ai_record 生成 AI 语音
get_clientkey 只读 获取 clientkey
get_collection_list 只读 获取收藏列表(占位)
get_cookies 只读 获取 Cookies
get_credentials 只读 获取凭证
get_csrf_token 只读 获取 CSRF 令牌
get_doubt_friends_add_request 只读 获取可疑好友申请
get_emoji_likes 只读 获取表情回应用户
get_essence_msg_list 只读 获取精华消息列表
get_file 只读 获取文件信息(仅图片/语音缓存;群文件请用 get_group_file_url)
get_fileset_id 只读 从分享码/链接获取 fileset_id
get_fileset_info 获取文件集信息
get_flash_file_list 获取闪传文件列表
get_flash_file_url 获取闪传文件链接
get_forward_msg 只读 获取合并转发消息(id 或 message_id)
get_friend_msg_history 只读 获取好友消息历史
get_friends_with_category 只读 获取分组好友列表
get_group_at_all_remain 只读 获取群 @全体成员 剩余次数
get_group_detail_info 只读 获取群详细信息
get_group_file_system_info 只读 获取群文件系统信息
get_group_ignore_add_request 只读 获取被忽略的入群请求(NapCat)
get_group_ignored_notifies 只读 获取被过滤的入群请求
get_group_info_ex 只读 获取群信息(扩展)
get_group_msg_history 只读 获取群消息历史
get_group_shut_list 只读 获取群禁言列表
get_group_signed_list 只读 获取群今日打卡列表
get_image 只读 获取图片信息
get_mini_app_ark 只读 获取小程序卡片 ark
get_online_clients 只读 获取在线客户端(占位,OneBot v11 形状)
get_profile_like 只读 获取资料点赞
get_recent_contact 只读 获取最近会话(占位)
get_record 只读 获取语音信息;传 out_format 则服务端转码并附带 base64
get_rkey 只读 获取下载 rkey
get_rkey_server 只读 获取 rkey 服务器信息
get_share_link 获取文件分享链接
get_unidirectional_friend_list 只读 获取单向好友列表
group_poke 群拍一拍
list_filesets 列出当前账号的所有闪传文件集
mark_group_msg_as_read 标记群消息已读
mark_msg_as_read 标记消息已读(群聊/私聊自动路由)
mark_private_msg_as_read 标记私聊消息已读
modify_custom_face 修改收藏表情备注
move_custom_face_to_front 收藏表情移到最前
nc_get_packet_status 只读 获取 packet 状态(占位)
nc_get_user_status 只读 获取用户在线/扩展状态
ocr_image 只读 OCR 图片(服务端,需图片 URL 或已缓存的图片 file_id)
rename_flash_file 重命名闪传文件
request_decrypt_key 请求数据库解密密钥
send_ark_share 只读 分享用户/群 Ark 卡片(NapCat 标准名)
send_flash_msg 发送闪传消息(私聊或群聊,引用 fileset_id 让对端下载)
send_forward_msg 发送合并转发(按 message_type/群号自动路由)
send_group_ai_record 发送 AI 语音到群
send_group_ark_share 只读 分享群 Ark 卡片(NapCat 标准名)
send_group_forward_msg 发送群合并转发
send_like 点赞
send_packet 发送原始 SSO 包(cmd + hex data)
send_poke 拍一拍(群聊/私聊自动路由)
send_private_forward_msg 发送私聊合并转发
set_diy_online_status 设置自定义在线状态
set_doubt_friends_add_request 处理可疑好友申请
set_essence_msg 设置精华消息
set_friend_remark 设置好友备注
set_group_reaction 群聊表情回应
set_group_remark 设置群备注
set_group_robot_add_option 设置群机器人加群选项
set_group_sign 群签到
set_group_todo 设置群待办
set_input_status 设置输入状态
set_msg_emoji_like 设置消息表情回应
set_online_status 设置在线状态
set_qq_avatar 设置 QQ 头像
set_qq_profile 设置 QQ 资料
set_restart 重启(不支持)
set_self_longnick 设置个性签名(longNick/long_nick,严格 string)
share_group_ex 只读 分享群 Ark 卡片
share_peer 只读 分享用户/群 Ark 卡片
test_download_stream 测试下载流(推送 10 个数据帧,验证流式传输,不触达 QQ)
trans_group_file 转存群文件
translate_en2zh 只读 英译中
upload_file_stream 以流式分块方式上传文件到机器人本地(返回可用于发送的本地路径)
upload_forward_msg 上传转发消息
upload_foward_msg 上传转发消息(别名拼写)