From f16ef591f6e1dd8a38509b4b208bfe9512393afb Mon Sep 17 00:00:00 2001 From: JianFeeeee <109188060+JianFeeeee@users.noreply.github.com> Date: Sun, 17 Aug 2025 11:39:53 +0800 Subject: [PATCH] =?UTF-8?q?=E5=90=8C=E6=AD=A5=E6=9B=B4=E6=96=B0=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3=EF=BC=88=E5=A2=9E=E5=8A=A0=E4=B8=8A=E4=BC=A0=E6=96=87?= =?UTF-8?q?=E4=BB=B6=E6=96=B9=E6=B3=95=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 32 +++++++++++++++++--------------- src/modules/user_module.py | 4 ++++ 2 files changed, 21 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index a3d0648..a3128dd 100644 --- a/README.md +++ b/README.md @@ -158,26 +158,28 @@ timeout = 30 #### **2. 用户相关 (`ctx.user`)** -| 属性/方法 | 类型 | 说明 | 示例 | -| --------------------------- | ----------------- | --------------------------------------------- | --------------------------------------- | -| `user.user_id` | `str` | 用户唯一ID | `uid = ctx.user.user_id` | -| `user.nickname` | `Optional[str]` | 用户昵称(自动从API获取) | `greet = f"Hi {ctx.user.nickname}"` | -| `user.messages` | `List[dict]` | 用户历史消息记录(需 `after_load`后才有值) | `last_msg = ctx.user.messages[-1]` | -| `user.send_message()` | `method` | **发送私聊消息** | `ctx.user.send_message("Hello")` | -| `user.set_input_status()` | `method` | 设置用户输入状态(如"typing") | `ctx.user.set_input_status("typing")` | +| 属性/方法 | 类型 | 说明 | 示例 | +| --------------------------- | ----------------- | --------------------------------------------- | ------------------------------------------------- | +| `user.user_id` | `str` | 用户唯一ID | `uid = ctx.user.user_id` | +| `user.nickname` | `Optional[str]` | 用户昵称(自动从API获取) | `greet = f"Hi {ctx.user.nickname}"` | +| `user.messages` | `List[dict]` | 用户历史消息记录(需 `after_load`后才有值) | `last_msg = ctx.user.messages[-1]` | +| `user.send_message()` | `method` | **发送私聊消息** | `ctx.user.send_message("Hello")` | +| `user.set_input_status()` | `method` | 设置用户输入状态(如"typing") | `ctx.user.set_input_status(1)(为用户正在输入)` | +| `user.send_file()` | `method` | 上传文件 | `ctx.user.set.send_file("/path",filename)` | #### **3. 群组相关 (`ctx.group`)** > *仅当消息来自群聊时可用* > -> | 属性/方法 | 类型 | 说明 | 示例 | -> | ------------------------ | ----------------- | ------------------------------------- | --------------------------------------- | -> | `group.group_id` | `str` | 群组唯一ID | `gid = ctx.group.group_id` | -> | `group.nickname` | `Optional[str]` | 群名称(自动从API获取) | `print(ctx.group.nickname)` | -> | `group.users` | `List[dict]` | 群成员列表 | `members = ctx.group.users` | -> | `group.current_user` | `User` | 当前发言用户(即 `ctx.user`的引用) | `sender = ctx.group.current_user` | -> | `group.send_message()` | `method` | **发送群消息** | `ctx.group.send_message("@all 通知")` | -> | `group.messages` | `List[dict]` | 群聊历史消息 | `last_msg = ctx.group.messages[-1]` | +> | 属性/方法 | 类型 | 说明 | 示例 | +> | ------------------------ | ----------------- | ------------------------------------- | ------------------------------------------------------ | +> | `group.group_id` | `str` | 群组唯一ID | `gid = ctx.group.group_id` | +> | `group.nickname` | `Optional[str]` | 群名称(自动从API获取) | `print(ctx.group.nickname)` | +> | `group.users` | `List[dict]` | 群成员列表 | `members = ctx.group.users` | +> | `group.current_user` | `User` | 当前发言用户(即 `ctx.user`的引用) | `sender = ctx.group.current_user` | +> | `group.send_message()` | `method` | **发送群消息** | `ctx.group.send_message("@all 通知")` | +> | `group.messages` | `List[dict]` | 群聊历史消息 | `last_msg = ctx.group.messages[-1]` | +> | `group.upload_file` | `method` | 上传群文件 | `ctx.group.upload_file("/path",filename,group_path)` | 注:在群聊消息中current_user中的message存储了用户在群里的近十条消息。 diff --git a/src/modules/user_module.py b/src/modules/user_module.py index 1dc71aa..40233c4 100644 --- a/src/modules/user_module.py +++ b/src/modules/user_module.py @@ -24,6 +24,8 @@ class User: def send_message(self, message): print(f"send message{0}".format(message)) + def send_file(self,dir,name): + print("发送了文件{0},路径为{1}".format(name,dir)) class Group: def __init__(self, group_id,user=None,users=None): @@ -40,3 +42,5 @@ class Group: def send_message(self,message): print(f"send message{0}".format(message)) + def upload_file(self,dir,name,id): + print("发送了文件{0},路径为{1},上传至群聊文件夹{2}".format(name,dir,id))