From d04d4193be98bdf8c91addc6ef807385ac09831c Mon Sep 17 00:00:00 2001
From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com>
Date: Wed, 13 Mar 2024 03:02:27 +0800
Subject: [PATCH] update

---
 .vuepress/theme/layouts/Layout.vue      |   2 +-
 README.md                               |   1 +
 docs/history&toview/history.md          |   4 +
 docs/message/private_msg.md             | 604 ++++++++++++++----------
 docs/message/private_msg_content.md.txt |  57 +++
 docs/user/relation.md                   |  26 +-
 6 files changed, 437 insertions(+), 257 deletions(-)
 create mode 100644 docs/message/private_msg_content.md.txt

diff --git a/.vuepress/theme/layouts/Layout.vue b/.vuepress/theme/layouts/Layout.vue
index 8e1f791..42ed824 100644
--- a/.vuepress/theme/layouts/Layout.vue
+++ b/.vuepress/theme/layouts/Layout.vue
@@ -2,7 +2,7 @@
   <ParentLayout>
     <template #page-bottom>
       <footer style="text-align: center">
-        Copyright © 2020-2023
+        Copyright © 2020-2024
         <a href="https://github.com/SocialSisterYi/">SocialSisterYi</a> |
         <a
           href="https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/LICENSE"
diff --git a/README.md b/README.md
index a169926..2b8c406 100644
--- a/README.md
+++ b/README.md
@@ -87,6 +87,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
 - [ ] [消息中心](docs/message)
     - [ ] [通知类消息](docs/message/msg.md)
     - [ ] [私信](docs/message/private_msg.md)
+        - [ ] [私信消息类型、内容说明](docs/message/private_msg_content.md)
     - [ ] 设置
 - [ ] [用户](docs/user)
     - [x] [基本信息](docs/user/info.md)
diff --git a/docs/history&toview/history.md b/docs/history&toview/history.md
index 8e7a6f2..a12c3f9 100644
--- a/docs/history&toview/history.md
+++ b/docs/history&toview/history.md
@@ -10,6 +10,8 @@
 
 注：`max`、`business`、`view_at`参数用于历史记录列表的 IFS (无限滚动)，其用法类似链表的 next 指针
 
+本接口也可以返回已失效稿件的信息
+
 **url参数：**
 
 | 参数名   | 类型 | 内容                     | 必要性 | 备注                                                         |
@@ -349,6 +351,8 @@ curl -G 'https://api.bilibili.com/x/web-interface/history/cursor' \
 
 认证方式：Cookie (SESSDATA)
 
+本接口也可以返回已失效稿件的信息
+
 **url参数：**
 
 | 参数名 | 类型 | 内容     | 必要性 | 备注    |
diff --git a/docs/message/private_msg.md b/docs/message/private_msg.md
index e3241f1..417c6e2 100644
--- a/docs/message/private_msg.md
+++ b/docs/message/private_msg.md
@@ -1,5 +1,52 @@
 # 私信
 
+## 对象说明
+
+### 会话对象
+
+待补充……
+
+### 私信主体对象
+
+注：私信主体对象≠[私信内容对象](private_msg_content.md)
+
+| 字段             | 类型 | 内容               | 备注                                                           |
+| ---------------- | ---- | ------------------ | -------------------------------------------------------------- |
+| sender_uid       | num  | 发送者mid          |                                                                |
+| receiver_type    | num  | 接收者类型         | 1：用户<br />2：粉丝团                                         |
+| receiver_id      | num  | 接收者id           | `receiver_type` 为 `1` 时表示用户 mid，为 `2` 时表示应援团 id  |
+| msg_type         | num  | 消息类型           | 详见[私信消息类型、内容说明](private_msg_content.md)           |
+| content          | str  | 消息内容           | [私信内容对象](private_msg_content.md)经过 JSON 序列化后的文本 |
+| msg_seqno        | num  | 消息序列号         | 按照时间顺序从小到大                                           |
+| timestamp        | num  | 消息发送秒级时间戳 |                                                                |
+| at_uids          | 有效时：array<br />无效时：null | at的成员mid        | 在粉丝团时有效；此项为 `null` 或 `[0]` 均表示没有 at 成员      |
+| msg_key          | num  | 消息唯一id         | 部分库在解析JSON对象中的大数时存在数值的精度丢失问题，因此在处理私信时可能会出现问题，建议使用修复了这一问题的库（如将大数转换成文本） |
+| msg_status       | num  | 消息状态           | 0：正常<br />1：被撤回（接口仍能返回被撤回的私信内容）<br />2：被系统撤回（私信将不会显示在前端，B站接口也不会返回被系统撤回的私信）<br />51：（？） |
+| notify_code      | str  | 通知代码           | 发送通知时使用；若这条私信非通知则为空文本                     |
+| new_face_version | num  | 表情包版本         | 为 `0` 或无此项表示旧版表情包，此时 B 站会自动转换成新版表情包，例如 `[doge]` -> `[tv_doge]`；`1` 为新版 |
+| msg_source       | num  | 消息来源           | 见[消息来源列表](#消息来源列表)                                |
+
+### 消息来源列表
+
+| 代码 | 含义                      | 备注 |
+| ---- | ------------------------- | ---- |
+| 1    | iOS                       |      |
+| 2    | Android                   |      |
+| 3    | H5                        |      |
+| 4    | PC客户端                  |      |
+| 5    | 官方自动推送              | 包括：官方向大多数用户发送的私信等 |
+| 6    | 自动推送/发送             | 包括：特别关注时稿件的自动推送、因成为契约者而自动发送的私信、包月充电回馈私信、官方发送的特定于自己的消息等 |
+| 7    | Web                       |      |
+| 8    | 自动回复 - 被关注回复     |      |
+| 9    | 自动回复 - 收到消息回复   |      |
+| 10   | 自动回复 - 关键词回复     |      |
+| 11   | 自动回复 - 大航海上船回复 |      |
+| 12   | 自动推送 - UP 主赠言      | 在以前稿件的自动推送与其附带的 UP 主赠言是 2 条不同的私信（其中 UP 主赠言的消息来源代码为 12），现在 UP 主赠言已被合并成为稿件自动推送的一部分 |
+| 13   | 应援团系统提示            | 如：应援团中的提示信息“欢迎xxx入群” |
+| 17   | 互相关注                  | 互相关注时自动发送的私信“我们已互相关注，开始聊天吧~” |
+| 18   | 系统提示                  | 如：“对方主动回复或关注你前，最多发送1条消息” |
+| 19   | AI                        | 如：给[搜索AI助手测试版](https://space.bilibili.com/1400565964/)发送私信时对方的自动回复 |
+
 ## 未读私信数
 
 > https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread
@@ -12,24 +59,30 @@
 
 根对象：
 
-| 字段    | 类型 | 内容     | 备注                        |
-| ------- | ---- | -------- | --------------------------- |
-| code    | num  | 返回值   | 0：成功<br />-6：账号未登录 |
-| message | str  | 错误信息 | 默认为ok                    |
-| ttl     | num  | 1        |                             |
-| data    | obj  | 信息本体 |                             |
+| 字段    | 类型 | 内容     | 备注                          |
+| ------- | ---- | -------- | ----------------------------- |
+| code    | num  | 返回值   | 0：成功<br />-101：账号未登录 |
+| msg     | str  | 错误信息 | 默认为0                       |
+| message | str  | 错误信息 | 默认为0                       |
+| ttl     | num  | 1        |                               |
+| data    | obj  | 信息本体 |                               |
 
 `data` 对象：
 
-| 字段            | 类型 | 内容                 | 备注 |
-| --------------- | ---- | -------------------- | ---- |
-| unfollow_unread | num  | 未关注用户未读私信数 |      |
-| follow_unread   | num  | 已关注用户未读私信数 |      |
-| _gt_            | num  | 0                    |      |
+| 字段                    | 类型 | 内容                   | 备注         |
+| ----------------------- | ---- | ---------------------- | ------------ |
+| unfollow_unread         | num  | 未关注用户未读私信数   |              |
+| follow_unread           | num  | 已关注用户未读私信数   |              |
+| unfollow_push_msg       | num  | 未读推送消息数         |              |
+| dustbin_push_msg        | num  | 被拦截的未读推送消息数 |              |
+| dustbin_unread          | num  | 被拦截的未读私信数     |              |
+| biz_msg_unfollow_unread | num  | （？）                 | 作用尚不明确 |
+| biz_msg_follow_unread   | num  | （？）                 | 作用尚不明确 |
+| custom_unread           | num  | 未读客服消息数         |              |
 
 **示例：**
 
-以下信息代表了为未关注用户未读私信数为`1`条，已关注用户未读私信数为`6`条
+以下信息代表未关注用户未读私信数为`1`条，已关注用户未读私信数为`6`条
 
 ```shell
 curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
@@ -42,273 +95,107 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
 ```json
 {
 	"code": 0,
-	"msg": "ok",
-	"message": "ok",
+	"msg": "0",
+	"message": "0",
+        "ttl": 1,
 	"data": {
 		"unfollow_unread": 1,
 		"follow_unread": 6,
-		"_gt_": 0
+		"unfollow_push_msg": 0,
+		"dustbin_push_msg": 0,
+		"dustbin_unread": 0,
+		"biz_msg_unfollow_unread": 0,
+		"biz_msg_follow_unread": 0,
+		"custom_unread": 0
 	}
 }
 ```
 
 </details>
 
-## 发送私信（web端）
-
-> https://api.vc.bilibili.com/web_im/v1/web_im/send_msg
-
-*请求方式：POST*
-
-认证方式：Cookie（SESSDATA）
-
-**正文参数（application/x-www-form-urlencoded）：**
-
-| 参数名              | 类型                                  | 内容                     | 必要性 | 备注                                   |
-| ------------------ | ------------------------------------ | ------------------------ | ------ | -------------------------------------- |
-| msg[sender_uid]    | num                                  | 发送者mid                | 必要   |                                        |
-| msg[receiver_id]   | num                                  | 接收者mid                | 必要   |                                        |
-| msg[receiver_type] | num                                  | 1                        | 必要   | 固定为1                                |
-| msg[msg_type]      | num                                  | 消息类型                 | 必要   | 1:发送文字<br>2:发送图片<br>5:撤回消息      |
-| msg[msg_status]    | num                                  | 0                        | 非必要 |                                        |
-| msg[dev_id]        | string                               | 372778FD-E359-461D-86A3-EA2BCC6FF52A | 必要 |  **获取方式在下面**            |
-| msg[timestamp]     | num                                  | 时间戳（秒）               | 必要 |                                         |
-| msg[new_face_version]       | num     | 表情包版本    | 非必要   | **详见下表**                             |
-| msg[content]       | 发送文字时：str<br />撤回消息时：num     | 消息内容                 | 必要   | **详见下表**                             |
-| csrf        | str                                  | CSRF Token（位于cookie） | 必要   |                                        |
-
----
-
-**dev_id的获取**
-
-以JS为例：
-
-```javascript
-const deviceid = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (function (name) {
-  let randomInt = 16 * Math.random() | 0;
-  return ("x" === name ? randomInt : 3 & randomInt | 8).toString(16).toUpperCase()
-}));
-```
-
-代码来自 [andywang425/BLTH](https://github.com/andywang425/BLTH/blob/45fe93e31754ca8bf07059d46266398e787dbf45/B%E7%AB%99%E7%9B%B4%E6%92%AD%E9%97%B4%E6%8C%82%E6%9C%BA%E5%8A%A9%E6%89%8B.js#L6618)
-
-以Java为例
-
-```java
-public class Util{
-    private String getDevId() {
-        char[] b = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'};
-        char[] s = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".toCharArray();
-        for (int i = 0; i < s.length; i++) {
-            if ('-' == s[i] || '4' == s[i]) {
-                continue;
-            }
-            int randomInt = (int) (16 * Math.random());
-            if ('x' == s[i]) {
-                s[i] = b[randomInt];
-            } else {
-                s[i] = b[3 & randomInt | 8];
-            }
-        }
-        return new String(s);
-    }
-}
-```
----
-
-`msg[content]`消息内容：
-
-当发送文字时（`msg[msg_type]=1`）：
-
-该参数为json序列字串
-
-根对象：
-
-| 字段    | 类型 | 内容     | 备注 |
-| ------- | ---- | -------- | ---- |
-| content | str  | 私信内容 |      |
-
-当发送图片时（`msg[msg_type]=2`）：
-
-该参数为json序列字串
-
-根对象：
-
-| 字段     | 类型 | 内容     | 备注                                          |
-| -------- | ---- | -------- | :-------------------------------------------- |
-| url      | str  | 图片url  | 默认为B站相簿图片上传通道<br />也可用三方图床 |
-| width    | num  | 图片的宽 | 单位：像素（非必要）                          |
-| height   | num  | 图片的高 | 单位：像素（非必要）                          |
-| type     | str  | 图片格式 | （非必要）                                    |
-| original | num  | 1        | **作用未知**（非必要）                        |
-| size     | num  | 文件大小 | 单位：千字节（非必要）<br>__向上取整__        |
-
-当撤回消息时（`msg[msg_type]=5`）：
-
-该参数为数值，为目标消息的` msg_key `
-
-**json回复：**
-
-根对象：
-| 字段    | 类型 | 内容     | 备注        |
-| ------- | ---- | -------- | ----------- |
-| code    | num  | 返回值   | 0：成功<br> |
-| message | str  | 错误信息 | 默认为ok    |
-| ttl     | num  |  | 默认为1    |
-| data    | obj  | 主体     | 出错时为空  |
-
-`data`对象：
-
-| 字段          | 类型 | 内容       | 备注         |
-| ------------- | ---- | ---------- | ------------ |
-| msg_key| num  | 消息唯一id |              |
-| msg_content   | str  | 发送的消息 |              |
-| key_hit_infos | obj  |            | 作用尚不明确 |
-
-**示例：**
-
-给目标用户`mid=1`发一条文字私信：
-
-> up主你好，
->
-> 催更[doge]
-
-```shell
-curl 'https://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \
---data-urlencode 'msg[sender_uid]=293793435' \
---data-urlencode 'msg[receiver_id]=1' \
---data-urlencode 'msg[receiver_type] =1' \
---data-urlencode 'msg[msg_type]=1' \
---data-urlencode 'msg[dev_id] =372778FD-E359-461D-86A3-EA2BCC6FF52A' \
---data-urlencode 'msg[timestamp] =1626181379' \
---data-urlencode 'msg[content]={"content":"up主你好，\n催更[doge]"}' \
---data-urlencode 'csrf=xxx' \
--b 'SESSDATA=xxx'
-```
-
-<details>
-<summary>查看响应示例：</summary>
-
-```json
-{"code":0,
-"message":"0",
-"ttl":1,
-"data":{"msg_key":6984393491767669026,
-	"msg_content":"up主你好，\n催更[doge]",
-	"key_hit_infos":{}}}
-```
-
-</details>
-
-给目标用户`mid=1`发一条图片私信：
-
-> <img src="https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg" style="zoom:50%;" >
-
-```shell
-curl 'https://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \
---data-urlencode 'msg[sender_uid]=293793435' \
---data-urlencode 'msg[receiver_id]=1' \
---data-urlencode 'msg[receiver_type] =1' \
---data-urlencode 'msg[msg_type]=2' \
---data-urlencode 'msg[content]={"url":https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg}' \
---data-urlencode 'csrf_token=xxx' \
--b 'SESSDATA=xxx'
-```
-
-<details>
-<summary>查看响应示例：</summary>
-
-```json
-{
-    "code":0,
-    "msg":"ok",
-    "message":"ok",
-    "data":{
-        "msg_key":6852570013146024354,
-        "_gt_":0
-    }
-}
-```
-
-</details>
-
 ## 私信消息记录
 
 > https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs
 
 *请求方式：GET*
 
-此接口有设计缺陷，能够获取已经撤回，无法显示（如 发送私信 中msg[msg_type]:3）的消息
+此接口有设计缺陷，可以获取已经撤回的私信内容
 
 认证方式：Cookie（SESSDATA）
 
 **url参数：**
 
-| 参数名 | 类型 | 内容     | 必要性       | 备注               |
-| ------ | ---- | -------- | ------------ | ------------------ |
-| sender_device_id  | num  | 发送者设备 | 可选 | 1 |
-| talker_id   | num  | 聊天对象的UID | 必要 | -------------- |
-| session_type   | num  | 聊天对象的类型 | 必要 | 1为用户，2为粉丝团 |
-| size   | num  | 列出消息条数 | 可选 | 默认是20，最大为200 |
-| build   | num  | 未知 | 可选 | 默认是0 |
-| mobi_app   | str  | 设备 | 可选 | web |
-| begin_seqno   | num   | 开始的序列号 | 可选 | 默认0为全部 |
-| end_seqno   | num   | 结束的序列号 | 可选 | 默认0为全部 |
+| 参数名            | 类型 | 内容             | 必要性 | 备注                                                   |
+| ----------------- | ---- | ---------------- | ------ | ------------------------------------------------------ |
+| talker_id         | num  | 聊天对象的id     | 必要   | `session_type` 为 `1` 时表示用户 mid，为 `2` 时表示应援团 id |
+| session_type      | num  | 聊天对象的类型   | 必要   | 1：用户<br />2：粉丝团                                 |
+| size              | num  | 返回消息数量     | 非必要 | 默认为 20，最大为 200                                  |
+| begin_seqno       | num  | 开始的序列号     | 非必要 | 提供本参数时返回以本序列号开始（不包括本序列号）的消息 |
+| end_seqno         | num  | 结束的序列号     | 非必要 | 提供本参数时返回以本序列号结束（不包括本序列号）的消息 |
+| sender_device_id  | num  | 发送者设备       | 非必要 | 默认为 `1`                                             |
+| build             | num  | 客户端内部版本号 | 非必要 | 默认为 `0`                                             |
+| mobi_app          | str  | 平台标识         | 非必要 | 可为 `web` 等；**若本参数值为 `web`，则返回新版表情包** |
 
 **json回复：**
 
 根对象：
 
-| 字段    | 类型   | 内容     | 备注                         |
-| ------- | ------ | -------- | ---------------------------- |
-| code    | num    | 返回值   | 0：成功 <br />-400：请求错误 |
-| msg | str    | 错误信息 | 默认为0                      |
-| message | str    | 错误信息 | 默认为0                      |
-| ttl     | num    | 1        |                  |
-| data    | array | 数据列表 |                              |
+| 字段    | 类型 | 内容     | 备注                                              |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code    | num  | 返回值   | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
+| msg     | str  | 错误信息 | 默认为0                                           |
+| message | str  | 错误信息 | 默认为0                                           |
+| ttl     | num  | 1        |                                                   |
+| data    | obj  | 数据本体 |                                                   |
 
-`data`数组：
+`data`对象：
 
-| 项   | 类型 | 内容          | 备注 |
-| ---- | ---- | ------------- | ---- |
-| messages    | array  | 聊天记录列表    |      |
-| has_more    | num  | 0 |      |
-| min_seqno   | num  | 所有消息最小的序列号（最早）          |   |
-| max_seqno   | num  | 所有消息最大的序列号（最晚）    |      |
-| e_infos   | array  | 聊天表情列表    |      |
+| 字段      | 类型  | 内容                           | 备注                                |
+| --------- | ----- | ------------------------------ | ----------------------------------- |
+| messages  | 有私信时：array<br />无私信时：null | 私信列表                       | 按发送时间顺序反向排序              |
+| has_more  | num   | 是否有更多私信                 |                                     |
+| min_seqno | num   | 所有消息中最小的序列号（最早） | 若无私信则为 `18446744073709551615` |
+| max_seqno | num   | 所有消息中最大的序列号（最晚） | 若无私信则为 `0`                    |
+| e_infos   | array | 聊天表情列表                   | 若私信列表中无表情则无此项          |
 
 `messages`数组：
 
-| 项   | 类型 | 内容          | 备注 |
-| ---- | ---- | ------------- | ---- |
-| sender_uid    | num                                  | 发送者uid                |           注意名称是sender_uid                             |
-| receiver_type   | num                                  |  与session_type对应              |        1为用户，2为粉丝团                        |
-| receiver_id  | num                                  | 接收者uid                       |    注意名称是receiver_id                               |
-| msg_type     | num                                  | 消息类型                 | 1:文字消息<br>2:图片消息<br>5:撤回的消息<br>12、13:通知      |
-| content     | str                                 | 消息内容                 | 此处存在设计缺陷     |
-| msg_seqno  | num  | 消息序列号，保证按照时间顺序从小到大     |   |
-| timestamp   | num  | 消息发送时间戳    |      |
-| at_uids   | array  | 未知   |      |
-| msg_key   | num | 未知   |      |
-| msg_status   | num | 消息状态   |   0   |
-| notify_code   |str | 未知   |      |
-| new_face_version   |num | 表情包版本 | 0或者没有是旧版，此时b站会自动转换成新版表情包，例如`[doge]` -> `[tv_doge]`；1是新版 |
+| 项   | 类型 | 内容      | 备注                              |
+| ---- | ---- | --------- | --------------------------------- |
+| 0    | obj  | 私信1     | 详见[私信主体对象](#私信主体对象) |
+| n    | obj  | 私信(n+1) |                                   |
+| ……   | obj  | ……        | ……                                |
 
 `e_infos`数组：
 
-| 项   | 类型 | 内容          | 备注 |
-| ---- | ---- | ------------- | ---- |
-| text    | str  | 表情名称  |      |
-| uri   | str  | 表情链接 |      |
-| size   | num  | 表情尺寸          |  1 |
+| 项   | 类型 | 内容      | 备注 |
+| ---- | ---- | --------- | ---- |
+| 0    | obj  | 表情1     |      |
+| n    | obj  | 表情(n+1) |      |
+| ……   | obj  | ……        | ……   |
+
+`e_infos`数组中的对象：
+
+| 字段    | 类型 | 内容        | 备注                                |
+| ------- | ---- | ----------- | ----------------------------------- |
+| text    | str  | 表情名称    | 包括左右两侧的中括号，如`[tv_doge]` |
+| uri     | str  | 表情链接    |                                     |
+| size    | num  | 表情尺寸    | 1：小<br />2：大                    |
+| gif_url | str  | 表情GIF链接 | 仅部分表情存在此项                  |
 
 **示例：**
 
-获取与目标用户`mid=123`私信记录：
+获取与目标用户`mid=123`的私信记录：
 
 ```shell
-curl 'https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs?sender_device_id=1&talker_id=123&session_type=1&size=20&build=0&mobi_app=web' \
--b 'SESSDATA=xxx'
+curl -G 'https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs' \
+    --data-urlencode 'talker_id=123' \
+    --data-urlencode 'session_type=1' \
+    --data-urlencode 'size=20' \
+    --data-urlencode 'sender_device_id=1' \
+    --data-urlencode 'build=0' \
+    --data-urlencode 'mobi_app=web' \
+    -b 'SESSDATA=xxx'
 ```
 
 <details>
@@ -336,7 +223,8 @@ curl 'https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs?sender
                 "msg_key": 7104537732714964358,
                 "msg_status": 0,
                 "notify_code": "",
-                "new_face_version": 1
+                "new_face_version": 1,
+                "msg_source": 2
             },
             {
                 "sender_uid": 2239814,
@@ -351,7 +239,9 @@ curl 'https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs?sender
                 ],
                 "msg_key": 7104186240789226795,
                 "msg_status": 0,
-                "notify_code": ""
+                "notify_code": "",
+                "msg_source": 7
+
             },
         ],
         "has_more": 0,
@@ -370,3 +260,231 @@ curl 'https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs?sender
 
 </details>
 
+## 发送私信（web端）
+
+> https://api.vc.bilibili.com/web_im/v1/web_im/send_msg
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（application/x-www-form-urlencoded）：**
+
+| 参数名                | 类型 | 内容                     | 必要性 | 备注                                                 |
+| --------------------- | ---- | ------------------------ | ------ | ---------------------------------------------------- |
+| msg[sender_uid]       | num  | 发送者mid                | 必要   |                                                      |
+| msg[receiver_id]      | num  | 接收者id                 | 必要   | `msg[receiver_type]` 为 `1` 时表示用户 mid，为 `2` 时表示应援团 id |
+| msg[receiver_type]    | num  | 接收者类型               | 必要   | 1：用户<br />2：粉丝团                               |
+| msg[msg_type]         | num  | 消息类型                 | 必要   | 详见[私信消息类型、内容说明](private_msg_content.md) |
+| msg[msg_status]       | num  | 消息状态                 | 非必要 | 恒为 `0`                                             |
+| msg[dev_id]           | str  | dev_id                   | 必要   | 实质上即 UUID（版本 4），**生成方式在下面**          |
+| msg[timestamp]        | num  | 当前时间戳（秒）         | 必要   |                                                      |
+| msg[new_face_version] | num  | 表情包版本               | 非必要 | 提供 `0` 或者未提供本参数表示旧版表情包，此时 B 站会自动转换成新版表情包，例如 `[doge]` -> `[tv_doge]`；`1` 为新版 |
+| msg[content]          | str  | 消息内容                 | 必要   | 详见[私信消息类型、内容说明](private_msg_content.md) |
+| csrf_token            | str  | CSRF Token（位于cookie） | 必要   |                                                      |
+| csrf                  | str  | CSRF Token（位于cookie） | 必要   |                                                      |
+| build                 | num  | 客户端内部版本号         | 非必要 | 默认为 `0`                                           |
+| mobi_app              | str  | 平台标识                 | 非必要 | 可为 `web` 等                                        |
+
+---
+
+**dev_id 的生成：**
+
+dev_id 实质上就是 UUID（版本 4）
+
+<details>
+<summary>查看生成 UUID 的代码</summary>
+
+**以 Python 为例：**
+
+```python
+import uuid
+
+dev_id = str(uuid.uuid4())
+```
+
+**以 JS 为例：**
+
+以下代码适用于较新版的 JS 引擎（Chrome≥92，Firefox≥95，Safari≥15.4，Node.js≥19.0.0）：
+
+```js
+const dev_id = crypto.randomUUID();
+```
+
+以下为通用代码（来自 [andywang425/BLTH](https://github.com/andywang425/BLTH/blob/45fe93e31754ca8bf07059d46266398e787dbf45/B%E7%AB%99%E7%9B%B4%E6%92%AD%E9%97%B4%E6%8C%82%E6%9C%BA%E5%8A%A9%E6%89%8B.js#L6618)）
+
+```js
+const dev_id = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (function (name) {
+  let randomInt = 16 * Math.random() | 0;
+  return ("x" === name ? randomInt : 3 & randomInt | 8).toString(16).toUpperCase()
+}));
+```
+
+**以 Java 为例：**
+
+```java
+import java.util.UUID;
+
+public class Main {
+    private String getDevId() {
+        UUID uuid = UUID.randomUUID();
+        return uuid.toString();
+    }
+}
+```
+
+</details>
+
+---
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型 | 内容     | 备注                                              |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code    | num  | 返回值   | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />21047：你最多发送1条消息，对方回复或者关注你后可以继续发消息~ |
+| message | str  | 错误信息 | 默认为0                                           |
+| ttl     | num  |          | 默认为1                                           |
+| data    | obj  | 信息本体 | 出错时无此项                                      |
+
+`data`对象：
+
+| 字段          | 类型 | 内容       | 备注                                                                |
+| ------------- | ---- | ---------- | ------------------------------------------------------------------- |
+| msg_key       | num  | 消息唯一id |                                                                     |
+| msg_content   | str  | 发送的消息 | 仅当请求参数中`msg[msg_type]`为`1`且`msg[receiver_type]`为`1`时显示 |
+| key_hit_infos | obj  | 触发的提示 | 仅当请求参数中`msg[msg_type]`为`1`且`msg[receiver_type]`为`1`时显示 |
+
+`data`对象中的`key_hit_infos`：
+
+| 字段      | 类型  | 内容         | 备注                                   |
+| --------- | ----- | ------------ | -------------------------------------- |
+| toast     | str   | 提示信息文字 | 未触发提示不显示此项                   |
+| rule_id   | num   | 触发的规则id | 未触发提示不显示此项，详细信息有待补充 |
+| high_text | array | 高亮的文本   | 未触发提示不显示此项                   |
+
+
+`data`对象中的`key_hit_infos`中的`high_text`数组：
+
+| 项   | 类型 | 内容          | 备注             |
+| ---- | ---- | ------------- | ---------------- |
+| 0    | obj  | 高亮文本1     | 详细信息有待补充 |
+| n    | obj  | 高亮文本(n+1) |                  |
+| ……   | obj  | ……            | ……               |
+
+**示例：**
+
+给目标用户`mid=1`发一条文字私信：
+
+> up主你好，
+> 催更[doge]
+
+```shell
+curl 'https://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \
+--data-urlencode 'msg[sender_uid]=293793435' \
+--data-urlencode 'msg[receiver_id]=1' \
+--data-urlencode 'msg[receiver_type] =1' \
+--data-urlencode 'msg[msg_type]=1' \
+--data-urlencode 'msg[msg_status]=0' \
+--data-urlencode 'msg[dev_id]=372778FD-E359-461D-86A3-EA2BCC6FF52A' \
+--data-urlencode 'msg[timestamp]=1626181379' \
+--data-urlencode 'msg[new_face_version]=1' \
+--data-urlencode 'msg[content]={"content":"up主你好，\n催更[doge]"}' \
+--data-urlencode 'csrf=xxx' \
+--data-urlencode 'csrf_token=xxx' \
+-b 'SESSDATA=xxx'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+  "code": 0,
+  "message": "0",
+  "ttl": 1,
+  "data": {
+    "msg_key": 6984393491767669026,
+    "msg_content": "{\"content\":\"up主你好，\n催更[doge]\"}",
+    "key_hit_infos": {}
+  }
+}
+```
+
+</details>
+
+给目标用户`mid=1`发一条图片私信：
+
+> <img src="https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg" style="zoom:50%;">
+
+```shell
+curl 'https://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \
+--data-urlencode 'msg[sender_uid]=293793435' \
+--data-urlencode 'msg[receiver_id]=1' \
+--data-urlencode 'msg[receiver_type] =1' \
+--data-urlencode 'msg[msg_type]=2' \
+--data-urlencode 'msg[msg_status]=0' \
+--data-urlencode 'msg[dev_id]=372778FD-E359-461D-86A3-EA2BCC6FF52A' \
+--data-urlencode 'msg[timestamp]=1626181379' \
+--data-urlencode 'msg[content]={"url":"https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg"}' \
+--data-urlencode 'csrf=xxx' \
+--data-urlencode 'csrf_token=xxx' \
+-b 'SESSDATA=xxx'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+  "code": 0,
+  "message": "0",
+  "data": {
+    "msg_key": 6852570013146024354
+  }
+}
+```
+
+</details>
+
+给目标用户`mid=1`发送会触发提示的私信：
+
+> 支付宝
+
+```shell
+curl 'https://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \
+--data-urlencode 'msg[sender_uid]=293793435' \
+--data-urlencode 'msg[receiver_id]=1' \
+--data-urlencode 'msg[receiver_type] =1' \
+--data-urlencode 'msg[msg_type]=1' \
+--data-urlencode 'msg[msg_status]=0' \
+--data-urlencode 'msg[dev_id]=372778FD-E359-461D-86A3-EA2BCC6FF52A' \
+--data-urlencode 'msg[timestamp]=1626181379' \
+--data-urlencode 'msg[content]={"content":"支付宝"}' \
+--data-urlencode 'csrf=xxx' \
+--data-urlencode 'csrf_token=xxx' \
+-b 'SESSDATA=xxx'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+  "code": 0,
+  "message": "0",
+  "ttl": 1,
+  "data": {
+    "msg_key": 6984393491767669026,
+    "msg_content": "{\"content\":\"支付宝\"}",
+    "key_hit_infos": {
+      "toast": "【温馨提示】为保障消费者权益，根据平台规则，如创作者在与消费者沟通中进行发布要求非法转账、欺诈转账等违规行为，平台有权对此进行处罚，感谢您的理解。",
+      "rule_id": 2,
+      "high_text": [ {} ]
+    }
+  }
+}
+```
+
+</details>
diff --git a/docs/message/private_msg_content.md.txt b/docs/message/private_msg_content.md.txt
new file mode 100644
index 0000000..79e5d89
--- /dev/null
+++ b/docs/message/private_msg_content.md.txt
@@ -0,0 +1,57 @@
+# 私信消息类型、内容说明
+
+## 文字消息（`msg_type=1`）
+
+根对象：
+
+| 字段    | 类型 | 内容     | 备注 |
+| ------- | ---- | -------- | ---- |
+| content | str  | 私信内容 |      |
+
+**示例：**
+
+```json
+{
+    "content": "Hello"
+}
+```
+
+## 图片消息（`msg_type=2`）
+
+根对象：
+
+| 字段     | 类型 | 内容       | 备注                      |
+| -------- | ---- | ---------- | ------------------------- |
+| url      | str  | 图片url    | 默认为B站相簿图片上传通道 |
+| height   | num  | 图片高度   | 单位：像素（非必要）      |
+| width    | num  | 图片宽度   | 单位：像素（非必要）      |
+| type     | str  | 图片格式   | （非必要）                |
+| original | num  | 是否为原图 | 当本参数值为`1`时，APP上会出现“下载原图”按钮（非必要） |
+| size     | num  | 文件大小   | 单位：千字节（非必要）    |
+
+**示例：**
+
+```json
+{
+    "url": "https://message.biliimg.com/bfs/im_new/c161fdf51d901c1607a15e30f10116dd425503913.jpg",
+    "height": 300,
+    "width": 300,
+    "imageType": "jpeg",
+    "original": 1,
+    "size": 55.443
+}
+```
+
+## 撤回消息（`msg_type=5`）
+
+内容为目标私信的`msg_key`，请确保发送的私信与目标私信在同一会话内；发送此私信后，目标私信的 `msg_status` 会改成 `1`
+
+**示例：**
+
+假如存在 `msg_key` 为 `7345551441311046575` 的私信 A，用户发送了 `msg_type` 为 `5` 且 `content` 为以下内容的私信 B：
+
+```json
+7345551441311046575
+```
+
+这时，私信 A 就会被撤回，并且其 `msg_status` 也会改变成 `1`
diff --git a/docs/user/relation.md b/docs/user/relation.md
index 9695adc..6cc8b06 100644
--- a/docs/user/relation.md
+++ b/docs/user/relation.md
@@ -11,7 +11,7 @@
 | 字段            | 类型                                        | 内容                       | 备注                                                         |
 | --------------- | ------------------------------------------- | -------------------------- | ------------------------------------------------------------ |
 | mid             | num                                         | 用户 mid                   |                                                              |
-| attribute       | num                                         | 对方对于**自己**的关系属性 | 0：未关注<br />1：悄悄关注（现已下线）<br />2：已关注<br />6：已互粉<br />128：已拉黑 |
+| attribute       | num                                         | 对方对于**自己**的关系属性 | 0：未关注<br />~~1：悄悄关注（现已下线）~~<br />2：已关注<br />6：已互粉<br />128：已拉黑 |
 | mtime           | num                                         | 对方关注目标用户时间       | 秒级时间戳<br />互关后刷新                                   |
 | tag             | 默认分组：null<br />存在至少一个分组：array | 目标用户将对方分组到的 id  |                                                              |
 | special         | num                                         | 目标用户特别关注对方标识   | 0：否<br />1：是                                             |
@@ -97,7 +97,7 @@
 
 | 字段    | 类型 | 内容     | 备注                                                  |
 | ------- | ---- | -------- | ----------------------------------------------------- |
-| code    | num  | 返回值   | 0：成功<br />-101：账号未登录<br />-352：请求被拦截<br />-400：请求错误<br />22007：访问超过 5 页 |
+| code    | num  | 返回值   | 0：成功<br />-101：账号未登录<br />-352：请求被拦截<br />-400：请求错误<br />22118：由于该用户隐私设置，粉丝列表不可见 |
 | message | str  | 错误信息 | 默认为 0                                              |
 | ttl     | num  | 1        |                                                       |
 | data    | obj  | 信息本体 |                                                       |
@@ -368,7 +368,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
 
 | 项   | 类型 | 内容        | 备注                                          |
 | ---- | ---- | ----------- | --------------------------------------------- |
-| 0    | obj  | 关注 1      | 与 [关系列表对象](#关系列表对象) 数据结构不同 |
+| 0    | obj  | 关注 1      | 与 [关系列表对象](#关系列表对象) 数据结构**不同** |
 | n    | obj  | 关注（n+1） | 按照添加顺序排列                              |
 | ……   | obj  | ……          | ……                                            |
 
@@ -1289,15 +1289,15 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
 
 操作代码`act`：
 
-| 代码 | 含义         |
-| ---- | ------------ |
-| 1    | 关注         |
-| 2    | 取关         |
-| 3    | 悄悄关注     |
-| 4    | 取消悄悄关注 |
-| 5    | 拉黑         |
-| 6    | 取消拉黑     |
-| 7    | 踢出粉丝     |
+| 代码 | 含义         | 备注                                             |
+| ---- | ------------ | ------------------------------------------------ |
+| 1    | 关注         | 无法对已注销或不存在的用户进行此操作             |
+| 2    | 取关         |                                                  |
+| 3    | 悄悄关注     | 现已下线，使用本操作代码请求接口会提示“请求错误” |
+| 4    | 取消悄悄关注 |                                                  |
+| 5    | 拉黑         | 无法对已注销或不存在的用户进行此操作             |
+| 6    | 取消拉黑     |                                                  |
+| 7    | 踢出粉丝     |                                                  |
 
 **json回复：**
 
@@ -1305,7 +1305,7 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
 
 | 字段    | 类型 | 内容     | 备注                                                         |
 | ------- | ---- | -------- | ------------------------------------------------------------ |
-| code    | num  | 返回值   | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22001：不能对自己进行此操作<br />22003：用户位于黑名单 |
+| code    | num  | 返回值   | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22001：不能对自己进行此操作<br />22003：用户位于黑名单<br />22013：账号已注销，无法完成操作<br />22014：已经关注用户，无法重复关注<br />40061：用户不存在 |
 | message | str  | 错误信息 | 默认为0                                                      |
 | ttl     | num  | 1        |                                                              |