# 内部接口清单（HttpClient）

本文档整理当前项目内 `HttpClient` 封装的低层接口（直接对应 HTTP API）。
一般插件请优先使用 `WechatHookClient`，仅在需要更底层控制时再使用 `HttpClient`。

说明：
- 这些方法会直接向 Hook HTTP API 发请求。
- 返回值大多为 `bool` 或 `dict`（详见方法注释与实现）。

## 基础

- `await http_client.post(endpoint, data=None)`  发送 POST 请求（低层）
- `await http_client.get(endpoint, params=None)`  发送 GET 请求（低层）
- `await http_client.close()`  关闭客户端
- `await http_client.sqlite_exec(db_name, sql_fmt)`  执行 SQLite 查询（新接口）
- `await http_client.get_db_handle()`  获取数据库句柄列表（新接口）

## 消息发送

- `await http_client.send_text(wxid, msg)`  发送文本
- `await http_client.send_image(wxid, image_path)`  发送图片
- `await http_client.send_file(wxid, file_path)`  发送文件
- `await http_client.send_voice(wxid, voice_path)`  发送语音（新接口为 silkPath）
- `await http_client.send_at_text(room_id, msg, wxids)`  群聊 @ 文本
- `await http_client.send_card(wxid, card_wxid)`  发送名片
- `await http_client.send_xml(wxid, xml)`  发送 XML
- `await http_client.send_app_msg(wxid, appmsg_content, msg_type)`  发送 appmsg（如链接卡片）
- `await http_client.revoke_message(new_msg_id)`  撤回消息

## 好友管理

- `await http_client.get_friend_list()`  获取好友列表
- `await http_client.get_friend_info(wxid)`  获取好友资料（网络）
- `await http_client.get_friend_info_cache(wxid)`  获取好友资料（缓存）
- `await http_client.add_friend(wxid, verify_msg="", scene=3)`  添加好友
- `await http_client.accept_friend(v3, v4, scene)`  同意好友请求
- `await http_client.delete_friend(wxid)`  删除好友
- `await http_client.set_friend_remark(wxid, remark)`  修改好友备注

## 群聊管理

- `await http_client.get_chatroom_members(room_id)`  获取群成员列表
- `await http_client.get_chatroom_info(room_id)`  获取群信息
- `await http_client.get_group_member_contact(room_id, member_wxid)`  获取群成员详细信息（含头像）
- `await http_client.create_chatroom(wxid_list)`  创建群聊
- `await http_client.invite_to_chatroom(room_id, wxid_list)`  邀请进群
- `await http_client.remove_chatroom_member(room_id, wxid_list)`  踢出群成员
- `await http_client.quit_chatroom(room_id)`  退出群聊
- `await http_client.set_chatroom_announcement(room_id, announcement)`  修改群公告

## 媒体下载

- `await http_client.cdn_download_image(fileid, aeskey, save_path, img_type=1, timeout=60.0)`  CDN 下载图片
- `await http_client.download_image(to_user, from_user, msg_id, total_len, save_path)`  下载图片
- `await http_client.download_video(msg_id, new_msg_id, total_len, save_path)`  下载视频

## 初始化与个人信息

- `await http_client.wechat_init()`  微信初始化好友/群列表缓存
- `await http_client.get_self_info()`  获取本人信息（缓存）
- `await http_client.set_nickname(nickname)`  修改自己昵称