项目说明与使用方式

项目定位

这是一个基于第三方服务商会话存档页面的聊天消息采集骨架，当前目标是把聊天会话和消息沉淀为结构化数据。

当前目标

• 枚举员工会话
• 拉取消息索引
• 批量调用企业微信开放接口解密消息
• 解析文本、图片、混合消息、撤回消息
• 落库到 SQLite

目录结构

• main.py：命令行入口
• config.py：运行配置
• models.py：数据模型
• storage.py：SQLite 存储
• parser.py：消息解析规则
• sync_service.py：同步编排
• clients/weiban_client.py：第三方服务商接口客户端
• clients/wework_client.py：企业微信开放接口客户端

使用方式

1. 复制 .env.example 为 .env
2. 填入有效 Cookie、SID 和业务参数
3. 执行命令：

python main.py sessions --staff-ext-id DaBai --session-type room
python main.py sessions --staff-ext-id DaBai --session-type other_staff
python main.py sessions --staff-ext-id MiaoDaYe --session-type ext_user
python main.py sessions --staff-ext-id MiaoDaYe --session-type customer
python main.py messages --staff-ext-id DaBai --session-ext-id wrt_xxx --source-session-type room
python main.py messages --staff-ext-id DaBai --session-ext-id taozi --source-session-type other_staff --incremental
python main.py messages --staff-ext-id MiaoDaYe --session-ext-id wmt_xxx --source-session-type ext_user --incremental
python main.py known-messages --staff-ext-id DaBai
python main.py known-messages --staff-ext-id MiaoDaYe --source-session-type ext_user --limit-sessions 50

当前状态

这是第一版工程骨架，已实现：

• 配置加载
• HTTP 客户端封装
• 会话列表拉取
• 消息索引分页
• 消息解密
• 基础消息类型解析
• SQLite 建表与写入

后续可继续补充

• 登录态自动刷新
• 增量调度
• 告警恢复
• 媒体下载
• 更完整的消息类型覆盖