官网友情链接： wechatapi.net
个人微信二次开发系统运行几个月以后，数据不一致几乎不可避免。
联系人事件可能漏。
群成员变化可能没处理。
账号异常期间任务失败。
CRM同步中断。
如果系统只依赖实时事件，差异会不断积累。
所以长期运行的个人微信API系统需要定期对账。
WechatApi 可以作为个人微信API接入层，把账号、好友、微信群、消息和文件持续送入业务系统。本地数据平台则通过周期任务重新获取当前状态，与本地数据比较并生成差异。
一、实时同步和对账是互补
实时：
追求快。
对账：
追求最终正确。
不能因为有实时事件就不要对账。
也不能只靠全量每天覆盖。
二、一个具体例子
联系人A已经删除账号。
删除事件因为服务重启漏掉。
本地仍然：
active。
第二天联系人对账发现：
远端不存在。
生成差异。
系统补：
关系inactive；
end_time；
source = reconciliation。
数据恢复正确。
三、对账对象可以有哪些
账号状态；
联系人；
微信群；
群成员；
文件任务；
CRM同步结果。
不同对象不同频率。
四、WechatApi 的位置
WechatApi提供：
当前真实微信侧数据。
本地对账层负责：
比较；
Diff；
修复。
五、对账不能无脑覆盖
本地CRM客户阶段和微信联系人字段不同语义。
只能修复微信主责字段。
字段主责必须明确。
六、差异类型
remote_only；
local_only；
status_mismatch；
field_mismatch；
relation_mismatch。
不同类型不同处理。
七、普通差异自动修复
例如昵称变化。
可以自动。
高风险：
客户主体冲突。
人工确认。
八、群成员差异
本地在群。
远端不在。
补退出历史。
不要直接删除。
九、任务结果对账
本地任务显示处理中。
但已经超过最大执行时间。
可以检查执行记录。
修正为失败或异常。
十、账号状态对账
后台显示在线。
但实际接口不可用。
健康检查纠正。
这也是一种运行态对账。
十一、对账任务分片
多账号、大量联系人。
按账号分页。
断点续跑。
不要一条大任务。
十二、优先级
对账属于后台批任务。
不能堵住实时微信消息。
白天低速，夜间加速。
十三、对账差异快照
每次任务记录：
远端数量；
本地数量；
差异；
自动修复；
人工。
可以分析系统长期稳定性。
十四、连续差异
同一对象每天都被修复。
说明实时链路有持续Bug。
应该进入异常，而不是每天默默修。
十五、数据修复工单
复杂差异创建内部工单。
负责人确认。
修复后重新对账。
形成闭环。
十六、权限
普通业务人员查看自己账号差异。
数据管理员处理全局修复。
强制覆盖高权限。
十七、日志
每一次修复记录：
原值；
远端值；
修复来源；
任务。
历史可追踪。
十八、总结
微信二次开发系统长期运行以后，最重要的数据能力之一不是“永远不出错”，而是出现差异以后能够重新发现并修正。
WechatApi 可以负责个人微信账号、好友、群聊和消息的持续接入。
本地对账系统则定期重新确认真实状态，找出遗漏和不一致，再通过自动补偿或人工修复恢复正确数据。
实时事件保证体验，对账保证长期可信。
只有两者同时存在，多账号微信机器人、CRM和客户管理系统运行几年以后，数据才不会悄悄偏离真实微信状态。
