新增864 provider并打通server_key配置

- 新增 server_864 独立 provider 目录,接入登录、消息轮询、联系人、群资料、用户资料与朋友圈基础能力

- 扩展 gateway、robot 与配置归一化逻辑,支持 server_864/864 别名和 WECHAT_SERVER_KEY

- 更新配置示例与多版本适配路线图,明确 864 第一版接入范围和后续待补项
This commit is contained in:
liuwei
2026-05-07 11:24:33 +08:00
parent 86f8d57874
commit ff33edb0d1
18 changed files with 1174 additions and 7 deletions

View File

@@ -26,19 +26,24 @@
- 已补上 `Legacy855WechatClient` 的显式初始化入口,避免 provider 多继承构造链不稳定
- 已删除历史 `wechat_ipad/client/` 目录,避免后续误回退到旧实现
- 已为 855 登录流程补充 Dashboard 首页二维码引导态,支持未登录时自动弹窗、倒计时与最近二维码记录展示
- 已新增 `providers/server_864/` 独立目录,用于承接 864 风格 server
- 已为 864 接入补充 `wechat_ipad.server_key` 统一配置项,支持通过 `.env``WECHAT_SERVER_KEY` 注入
- 已在 [wechat_ipad/gateway.py](/d:/learn/abot/wechat_ipad/gateway.py:1) 中注册 `server_864 / 864` 别名
- 已实现 864 第一版登录、初始化等待、HTTP 消息轮询、联系人、群信息、资料与朋友圈基础接口
当前尚未完成的关键项:
- 855 provider 仍需完成一轮“当前项目实际依赖接口”的可上线回归验证
- 855 provider 仍需继续梳理“项目真实使用到的接口覆盖面”,确认是否还有遗漏能力未纳入 provider 目录
- 864 provider 尚未开始接入,当前统一接口仍主要围绕 855 第一阶段目标进行验证
- 864 provider 仍需完成真机联调,尤其是消息字段归一化、视频发送、名片发送等增强能力
因此,当前状态可以定义为:
- “接入入口已收口”
- “855 运行时主链路已迁入 provider”
- “未登录场景已有 Dashboard 可视化登录引导”
-尚未达到 855 可直接替换现网上线的最终状态
-864 第一版 provider 已落地,但还需要真实 server 回归验证
- “尚未达到 855 / 864 都可直接无差异替换现网上线的最终状态”
## 2. 当前问题概览
@@ -70,8 +75,8 @@
- 更偏向 `key + body` 的请求风格
- 登录接口命名和流程明显不同
- 消息同步接口不再与 855 完全一致
- 在线状态、保活和消息同步的职责边界可能由 server 侧承担更多
- 消息同步同时支持 WS 与 HTTP 轮询
- 在线状态、保活和消息同步的职责边界更多由 server 侧承担
结论:
@@ -425,6 +430,20 @@ wechat_ipad/
- 864 可以先跑主链路
- 高级能力后续再补
当前已完成的第一版范围:
- 已接入固定 `server_key` 配置
- 已实现二维码登录轮询与初始化等待
- 已实现 HTTP 轮询消息同步
- 已实现联系人、群资料、当前账号资料、朋友圈基础接口
- 已保留与 855 尽量一致的对外方法名,便于 `Robot` 无感切换
当前仍待补强的范围:
- 真实 864 server 环境下的字段回包核对
- 视频发送、名片发送等低频接口
- 如后续需要更低延迟,可再补 WS 同步消息 runtime
### 阶段三:扩展 864 与后续 provider 的高级能力
后续再逐步统一: