diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 030d2de1..b2401e3d 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -23,6 +23,7 @@ Closes # - [ ] 修正错误 - [ ] 更改依赖 - [ ] 更改工作流 +- [ ] 补充提醒 - [ ] 其他(请在更改描述里面填写类型) --- diff --git a/src/api/v1/msg.md b/src/api/v1/msg.md index 36773dae..27fc251b 100644 --- a/src/api/v1/msg.md +++ b/src/api/v1/msg.md @@ -368,6 +368,7 @@ POST /v1/msg/list-message-by-seq ::: warning 由于没有所有消息情况,因此此处响应相关内容(尤其是指令等测试群不常见部分)可能会有缺失/错误,见谅.同时建议参照 proto 文件理解相关内容.也欢迎来 PR 补充. +距离最新消息大于 30 个只会返回最新消息,不会返回指定 `msgSeq` 之前的消息. ::: 请求头: diff --git a/src/full.proto b/src/full.proto index faf7e260..a4abf4cc 100644 --- a/src/full.proto +++ b/src/full.proto @@ -37,6 +37,12 @@ enum ContentTypeTextOnly { TEXT_markdown = 2; TEXT_html = 3; } + +enum VipStatus { + VIP_STATUS_NONE = 0; // 未开通 + VIP_STATUS_ACTIVE = 1; // 开通且未过期 + VIP_STATUS_EXPIRED = 2; // 开通且已过期 +} // 枚举结束 // 响应状态 @@ -71,7 +77,7 @@ message RemarkInfo { message ProfileInfo { string last_active_time = 1; // 该用户上次活跃时间 string introduction = 2; // 简介 - int32 gender = 3; // 性别(1-男,2-女,3-其他) + int32 gender = 3; // 性别: 1-男,2-女,3-其他 uint64 birthday_timestamp = 4; // 生日时间戳 string city = 5; // 城市 string district = 6; // 地区 @@ -233,7 +239,6 @@ message Cmd { message UserInfo { Status status = 1; message Data { - // 11是描述手机号长整数的,懒得解析了 string id = 1; // 用户 ID string name = 2; // 用户名 string avatar_url = 4; // 头像 URL @@ -243,6 +248,7 @@ message UserInfo { double coin = 8; // 金币数 bool is_vip = 9; // 是否为 VIP int64 vip_expired_time = 10; // VIP 过期时间 + VipStatus vip_status = 11; // VIP 开通状态 string invitation_code = 12; // 邀请码 } @@ -270,8 +276,8 @@ message GetUserResponse { repeated MedalInfo medal = 6; // 勋章信息 string register_time = 7; // 注册时间,格式: YYYY-MM-DD hh:mm:ss uint64 ban_time = 10; // 封禁结束时间(时间戳) - uint64 online_day = 11; // 在线天数 - uint64 continuous_online_day = 12; // 连续在线天数 + int32 online_day = 11; // 在线天数 + int32 continuous_online_day = 12; // 连续在线天数 bool is_vip = 13; // 是否为 vip uint64 vip_expired_time = 14; // VIP 过期时间(时间戳) RemarkInfo remark_info = 18; // 备注信息 @@ -344,12 +350,12 @@ message ListMsgBySeqRequest { message ListMsgResponse { Status status = 1; repeated MsgData data = 2; // 消息数据 - uint64 total = 3; // 消息数 + int32 total = 3; // 消息数 message MsgData { string msg_id = 1; // 消息 ID Sender sender = 2; - string direction = 3; // 消息位置,左边/右边 + string direction = 3; // 消息位置: 左边 left/右边 right ContentType content_type = 4; MsgContent content = 5; uint64 send_time = 6; // 时间戳(毫秒) @@ -365,7 +371,7 @@ message ListMsgResponse { // 通过列出消息 // #region ListMsgRequest message ListMsgRequest { - uint64 msg_count = 2; // 获取消息数 + int32 msg_count = 2; // 获取消息数 string msg_id = 3; // 从指定消息 ID 开始 ChatType chat_type = 4; // 对象类型 string chat_id = 5; // 对象 ID @@ -379,7 +385,7 @@ message ListMsgByMidSeqRequest { ChatType chat_type = 4; string chat_id = 5; uint64 unknown = 6; // 不知道干啥的 - uint64 msg_count = 7; + int32 msg_count = 7; // 获取的消息数 string msg_id = 8; } // #endregion ListMsgByMidSeqRequest @@ -535,7 +541,7 @@ message ConversationListRequest { message ConversationListResponse { Status status = 1; repeated Data data = 2; - uint64 total = 3; // 列表中对话的数量 + int32 total = 3; // 列表中对话的数量 string md5 = 4; // 对话列表的 md5 message Data { @@ -552,7 +558,7 @@ message ConversationListResponse { uint64 send_timestamp = 12; // 消息发送时间戳(秒) AtData at_data = 14; // @数据 string name = 15; // 用户真实名称 - int32 certification_level = 16; // 认证,1 是官方 2 是地区 + int32 certification_level = 16; // 认证,1-官方, 2-地区 message AtData { uint64 unknown = 1; // 似乎是名称 ID @@ -814,7 +820,7 @@ message GetBotInstructionResponse { uint64 command_id = 1; // 指令 id string bot_id = 2; // 机器人 id string command_name = 3; // 指令名称 - uint64 instruction_type = 5; // 指令类型: 1-普通指令,2-直发指令,5-自定义输入指令 + int32 instruction_type = 5; // 指令类型: 1-普通指令,2-直发指令,5-自定义输入指令 string command_default_text = 7; // 指令输入框默认文本 string command_settings_json = 10; // 指令设置 JSON(表单指令,自定义输入指令) }