Merge pull request #21 from foxzool/new_websocket_example

new_websocket_example

Author: foxzool

.github/workflows/api-consistency-check.yml

@@ -12,6 +12,11 @@ on:
       - 'src/service/**/*.rs'
       - 'src/core/**/*.rs'
 
+permissions:
+  contents: read
+  pull-requests: write
+  issues: write
+
 jobs:
   check-api-consistency:
     runs-on: ubuntu-latest

CHANGELOG.md

@@ -9,6 +9,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- **WebSocket IM事件增强**: WebSocket客户端示例新增完整的IM事件监控功能
+  - **✅ 消息撤回事件** - 支持 `p2_im_message_recalled_v1` 事件监听和处理
+  - **✅ 群聊生命周期事件** - 支持群聊创建、更新、解散事件监听
+    - `p2_im_chat_created_v1` - 群聊创建事件
+    - `p2_im_chat_updated_v1` - 群聊更新事件
+    - `p2_im_chat_disbanded_v1` - 群聊解散事件
+  - **✅ 群成员管理事件** - 支持群成员变更事件监听
+    - `p2_im_chat_member_user_added_v1` - 群成员添加事件
+    - `p2_im_chat_member_user_deleted_v1` - 群成员移除事件
+  - **🎯 增强用户体验** - 中文日志输出、性能计时、结构化错误处理
+  - **📊 详细事件信息** - 显示事件ID、操作者、时间戳等完整上下文信息
+
 - **Task v2**: 支持在 `CreateTaskRequest` 中指定 `tasklist_guid`，并新增 `TaskService::add_tasklist` 帮助方法，便于将既有任务加入指定清单。
 - **文档**: 更新任务模块文档，补充任务加入清单的示例和能力说明。
 

Cargo.toml

@@ -192,6 +192,11 @@ path = "tools/api_compatibility_tester.rs"
 name = "client_setup"
 path = "examples/basic/client_setup.rs"
 
+[[example]]
+name = "event_handler"
+path = "examples/basic/event_handler.rs"
+required-features = ["websocket", "im", "contact", "cloud-docs", "calendar", "vc", "approval"]
+
 [[example]]
 name = "acs_example"
 path = "examples/api/acs_example.rs"

README.md

@@ -565,6 +565,7 @@ match result {
 ### 长连接机器人
 
 - [x] 接收事件推送
+- [x] 完整IM事件监控 (消息撤回、群聊管理、成员变更等)
 
 ### 云文档
 
@@ -705,8 +706,12 @@ match result {
         - [x] 富文本
         - [x] 图片
         - [x] 卡片
-- 事件
+- 事件 (IM)
     - [x] 接收消息
+    - [x] 消息已读
+    - [x] 消息撤回
+    - [x] 群聊创建/更新/解散
+    - [x] 群成员添加/移除
 
 ### 群组
 
@@ -885,7 +890,7 @@ match result {
 | **👥 通讯录**      | 1       | ✅ 100%     | 用户搜索                    |
 | **🏢 组织架构**     | 15      | ✅ 100%     | **v0.12.0 新增** - 完整员工与部门管理 |
 | **🎨 飞书卡片**     | 25      | ✅ 100%     | 完整卡片组件系统                |
-| **💬 消息**       | 4       | ✅ 100%     | 消息发送与接收                 |
+| **💬 消息**       | 8       | ✅ 100%     | 消息发送、接收与完整IM事件监控         |
 | **👥 群组**       | 1       | ✅ 100%     | 群组管理                    |
 | **🔍 搜索**       | 14      | ✅ 100%     | 套件搜索与搜索连接器管理            |
 | **🏢 考勤管理**     | 43      | ✅ 100%     | 完整考勤解决方案                |

examples/README.md

@@ -118,7 +118,7 @@
 ### 🔰 [basic/](./basic/) - 基础入门 (2个)
 **最简单的入门示例，适合初学者**
 - `client_setup.rs` - 客户端基础配置
-- `websocket_client.rs` - WebSocket连接示例
+- `websocket_client.rs` - WebSocket连接与完整IM事件监控示例
 
 ### 📊 [benchmarks/](./benchmarks/) - 性能测试 (2个)
 **性能基准测试和监控示例**
@@ -167,8 +167,8 @@ cargo run --example client_setup
 如需运行其它服务示例，请显式启用对应 feature：
 
 ```bash
-# WebSocket 示例
-cargo run --example websocket_client --features websocket
+# WebSocket 示例 (包含完整IM事件监控)
+cargo run --example websocket_client --features websocket,im
 
 # 招聘（hire）示例
 cargo run --example hire_v1_example --features hire