@aochuang/client-sdk 1.0.382 → 1.0.401

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (177) hide show
  1. package/components/chat-editor/chat-editor-suggestions/chat-editor-suggestions.vue +4 -40
  2. package/components/chat-editor/chat-editor.vue +5 -75
  3. package/components/index.js +6 -1
  4. package/components/session-select/session-select-item.vue +8 -9
  5. package/components/wechat-chat-control/location/location.vue +3 -3
  6. package/components/wework-chat-control/channel-card/channel-card.vue +144 -0
  7. package/components/wework-chat-control/channel-live/channel-live.vue +7 -2
  8. package/components/wework-chat-control/company-card/company-card.vue +1 -1
  9. package/components/wework-chat-control/custom-expression/custom-expression.vue +2 -1
  10. package/components/wework-chat-control/file-url/file-url.vue +34 -16
  11. package/components/wework-chat-control/image/image.vue +137 -2
  12. package/components/wework-chat-control/index.js +15 -7
  13. package/components/wework-chat-control/location/location.vue +3 -3
  14. package/components/wework-chat-control/merge-message/merge-message-panel.vue +63 -0
  15. package/components/wework-chat-control/merge-message/merge-message.vue +84 -0
  16. package/components/wework-chat-control/merge-message/util.js +59 -0
  17. package/components/wework-chat-control/metting/enterprise-wechat.png +0 -0
  18. package/components/wework-chat-control/metting/meeting-video.svg +4 -0
  19. package/components/wework-chat-control/metting/metting.vue +181 -0
  20. package/components/wework-chat-control/red-envelopes/red-envelopes.vue +3 -2
  21. package/components/wework-chat-control/text/text-default.vue +99 -0
  22. package/components/wework-chat-control/text/text-quote.vue +138 -0
  23. package/components/wework-chat-control/text/text.vue +27 -143
  24. package/components/wework-chat-control/url/url-channel-live.vue +53 -0
  25. package/components/wework-chat-control/url/url-miniprogram.vue +6 -7
  26. package/components/wework-chat-control/url/url.vue +26 -2
  27. package/components/wework-chat-control/util.js +30 -17
  28. package/components/wework-chat-control/video/video.vue +11 -3
  29. package/components/wework-chat-control/voice/voice.vue +14 -3
  30. package/components/wework-chat-control/wework-chat-control-config-item.vue +24 -0
  31. package/components/wework-chat-control/wework-chat-control-config-msg.vue +25 -0
  32. package/{uni-components/chat-control/chat-control-config.vue → components/wework-chat-control/wework-chat-control-config.vue} +16 -13
  33. package/components/wework-chat-panel/chat-panel-chat-status/chat-panel-chat-status.vue +120 -0
  34. package/components/wework-chat-panel/chat-panel-item.vue +70 -39
  35. package/components/wework-chat-panel/chat-panel.vue +96 -13
  36. package/package.json +10 -3
  37. package/services/client-chat/client-chat-wechat/client-chat-account.js +37 -7
  38. package/services/client-chat/client-chat-wechat/client-chat-message.js +175 -18
  39. package/services/client-chat/client-chat-wechat/client-chat-session.js +83 -10
  40. package/services/client-chat/client-chat-wechat/client-chat-socket.js +80 -22
  41. package/services/client-chat/client-chat-wechat/client-chat.js +59 -11
  42. package/services/client-chat/client-chat-wework/client-chat-account.js +93 -1
  43. package/services/client-chat/client-chat-wework/client-chat-concats.js +104 -18
  44. package/services/client-chat/client-chat-wework/client-chat-message.js +268 -11
  45. package/services/client-chat/client-chat-wework/client-chat-session.js +271 -191
  46. package/services/client-chat/client-chat-wework/client-chat-socket.js +18 -2
  47. package/services/client-chat/client-chat-wework/client-chat.js +470 -85
  48. package/services/client-chat/client-chat-wework/docs/README.md +308 -0
  49. package/services/client-chat/client-chat-wework/utils.js +5 -5
  50. package/services/socket/socket.js +56 -7
  51. package/utils/log/constants.js +13 -0
  52. package/utils/log/export.js +88 -0
  53. package/utils/log/findings.md +141 -0
  54. package/utils/log/index.js +331 -0
  55. package/utils/log/indexed-db.js +228 -0
  56. package/utils/log/progress.md +267 -0
  57. package/utils/log/serialize.js +146 -0
  58. package/utils/log/task_plan.md +149 -0
  59. package/utils/log//345/210/206/346/236/220/344/270/216/344/274/230/345/214/226/346/226/271/346/241/210.md +303 -0
  60. package/utils/log//346/212/200/346/234/257/346/226/271/346/241/210/346/226/207/346/241/243.md +201 -0
  61. package/utils/log//346/236/266/346/236/204/346/226/207/346/241/243.md +169 -0
  62. package/utils/log//351/234/200/346/261/202/346/226/207/346/241/243.md +124 -0
  63. package/utils/log.js +2 -626
  64. package/components/wework-chat-panel/chat-panel-controls/company-card/company-card.vue +0 -35
  65. package/components/wework-chat-panel/chat-panel-controls/expression/expression.vue +0 -36
  66. package/components/wework-chat-panel/chat-panel-controls/file-url/file-url.vue +0 -35
  67. package/components/wework-chat-panel/chat-panel-controls/image/image.vue +0 -36
  68. package/components/wework-chat-panel/chat-panel-controls/index.js +0 -35
  69. package/components/wework-chat-panel/chat-panel-controls/jx-sys-text/jx-sys-text.vue +0 -28
  70. package/components/wework-chat-panel/chat-panel-controls/link/link.vue +0 -35
  71. package/components/wework-chat-panel/chat-panel-controls/location/location.vue +0 -35
  72. package/components/wework-chat-panel/chat-panel-controls/text/text.vue +0 -43
  73. package/components/wework-chat-panel/chat-panel-controls/unkonw/unkonw.vue +0 -39
  74. package/components/wework-chat-panel/chat-panel-controls/video/video.vue +0 -37
  75. package/components/wework-chat-panel/chat-panel-controls/voice/voice.vue +0 -35
  76. package/uni-common/account-portray/account-portray.vue +0 -51
  77. package/uni-common/account-select/account-select-item.vue +0 -172
  78. package/uni-common/account-select/account-select.vue +0 -252
  79. package/uni-common/all-friend-avatar/all-friend-avatar.vue +0 -49
  80. package/uni-common/friend-avatar/default.svg +0 -1
  81. package/uni-common/friend-avatar/friend-avatar.vue +0 -27
  82. package/uni-common/friend-avatar/index.js +0 -3
  83. package/uni-common/friend-loader/friend-loader.vue +0 -53
  84. package/uni-common/friend-portray/friend-portray.vue +0 -56
  85. package/uni-common/group-avatar/default.svg +0 -1
  86. package/uni-common/group-avatar/group-avatar.vue +0 -18
  87. package/uni-common/group-avatar/index.js +0 -3
  88. package/uni-common/room-avatar/default.svg +0 -6
  89. package/uni-common/room-avatar/index.js +0 -3
  90. package/uni-common/room-avatar/room-avatar.vue +0 -27
  91. package/uni-common/room-loader/room-loader.vue +0 -53
  92. package/uni-common/room-portray/room-portray.vue +0 -56
  93. package/uni-components/chat-control/calling/calling.vue +0 -91
  94. package/uni-components/chat-control/calling/phone-fill.svg +0 -1
  95. package/uni-components/chat-control/calling/vidicon-fill.svg +0 -1
  96. package/uni-components/chat-control/channel-video/channel-video.vue +0 -89
  97. package/uni-components/chat-control/channel-video-card/channel-video-card.vue +0 -105
  98. package/uni-components/chat-control/channel-video-live/channel-video-live.vue +0 -92
  99. package/uni-components/chat-control/chat-control-config-item/chat-control-config-item.vue +0 -20
  100. package/uni-components/chat-control/chat-control-config-item/index.js +0 -3
  101. package/uni-components/chat-control/chat-control-config-msg/chat-control-config-msg-app.vue +0 -25
  102. package/uni-components/chat-control/chat-control-config-msg/chat-control-config-msg-h5.vue +0 -21
  103. package/uni-components/chat-control/chat-control.vue +0 -218
  104. package/uni-components/chat-control/company-card/company-card.vue +0 -123
  105. package/uni-components/chat-control/const.js +0 -28
  106. package/uni-components/chat-control/expression/expression.vue +0 -41
  107. package/uni-components/chat-control/image/image.vue +0 -68
  108. package/uni-components/chat-control/index.js +0 -89
  109. package/uni-components/chat-control/location/location.vue +0 -110
  110. package/uni-components/chat-control/member-change/member-change.vue +0 -32
  111. package/uni-components/chat-control/quote-message/quote-message.vue +0 -216
  112. package/uni-components/chat-control/real-time-position/real-time-position.vue +0 -62
  113. package/uni-components/chat-control/redpacket/red-envelope.svg +0 -1
  114. package/uni-components/chat-control/redpacket/redpacket.vue +0 -75
  115. package/uni-components/chat-control/share-card/share-card.vue +0 -101
  116. package/uni-components/chat-control/system/system.vue +0 -69
  117. package/uni-components/chat-control/system-batch-message/system-batch-message.vue +0 -30
  118. package/uni-components/chat-control/system-text/system-text.vue +0 -32
  119. package/uni-components/chat-control/text/text.vue +0 -67
  120. package/uni-components/chat-control/text-with-at/text-with-at.vue +0 -51
  121. package/uni-components/chat-control/transfer/red-transfer.svg +0 -1
  122. package/uni-components/chat-control/transfer/transfer.vue +0 -80
  123. package/uni-components/chat-control/unkonw/unkonw.vue +0 -37
  124. package/uni-components/chat-control/url/icons/file-excel-line.svg +0 -1
  125. package/uni-components/chat-control/url/icons/file-info-line.svg +0 -1
  126. package/uni-components/chat-control/url/icons/file-music-line.svg +0 -1
  127. package/uni-components/chat-control/url/icons/file-pdf-line.svg +0 -1
  128. package/uni-components/chat-control/url/icons/file-ppt-line.svg +0 -1
  129. package/uni-components/chat-control/url/icons/file-settings-line.svg +0 -1
  130. package/uni-components/chat-control/url/icons/file-text-line.svg +0 -1
  131. package/uni-components/chat-control/url/icons/file-unknow-line.svg +0 -1
  132. package/uni-components/chat-control/url/icons/file-word-line.svg +0 -1
  133. package/uni-components/chat-control/url/icons/file-zip-line.svg +0 -1
  134. package/uni-components/chat-control/url/icons/index.js +0 -24
  135. package/uni-components/chat-control/url/miniprogram.svg +0 -1
  136. package/uni-components/chat-control/url/url-miniprogram.vue +0 -116
  137. package/uni-components/chat-control/url/url.vue +0 -306
  138. package/uni-components/chat-control/url-new/icons/file-excel-line.svg +0 -1
  139. package/uni-components/chat-control/url-new/icons/file-info-line.svg +0 -1
  140. package/uni-components/chat-control/url-new/icons/file-music-line.svg +0 -1
  141. package/uni-components/chat-control/url-new/icons/file-pdf-line.svg +0 -1
  142. package/uni-components/chat-control/url-new/icons/file-ppt-line.svg +0 -1
  143. package/uni-components/chat-control/url-new/icons/file-settings-line.svg +0 -1
  144. package/uni-components/chat-control/url-new/icons/file-text-line.svg +0 -1
  145. package/uni-components/chat-control/url-new/icons/file-unknow-line.svg +0 -1
  146. package/uni-components/chat-control/url-new/icons/file-word-line.svg +0 -1
  147. package/uni-components/chat-control/url-new/icons/file-zip-line.svg +0 -1
  148. package/uni-components/chat-control/url-new/icons/index.js +0 -24
  149. package/uni-components/chat-control/url-new/url-new.vue +0 -110
  150. package/uni-components/chat-control/utils.js +0 -12
  151. package/uni-components/chat-control/video/video.vue +0 -156
  152. package/uni-components/chat-control/voice/voice.vue +0 -166
  153. package/uni-components/chat-editor/chat-editor-chartlet/chat-editor-chartlet-collect.vue +0 -84
  154. package/uni-components/chat-editor/chat-editor-chartlet/chat-editor-chartlet-system.vue +0 -28
  155. package/uni-components/chat-editor/chat-editor-chartlet/chat-editor-chartlet.vue +0 -85
  156. package/uni-components/chat-editor/chat-editor-func/chat-editor-func.vue +0 -157
  157. package/uni-components/chat-editor/chat-editor-func-at/chat-editor-func-at-panel.vue +0 -158
  158. package/uni-components/chat-editor/chat-editor-func-at/chat-editor-func-at.vue +0 -61
  159. package/uni-components/chat-editor/chat-editor-func-button/chat-editor-func-button.vue +0 -58
  160. package/uni-components/chat-editor/chat-editor-func-file/chat-editor-func-file.vue +0 -54
  161. package/uni-components/chat-editor/chat-editor-func-image/chat-editor-func-image.vue +0 -42
  162. package/uni-components/chat-editor/chat-editor-func-video/chat-editor-func-video.vue +0 -42
  163. package/uni-components/chat-editor/chat-editor-func-voice/chat-editor-func-voice.vue +0 -25
  164. package/uni-components/chat-editor/chat-editor-message-send/chat-editor-message-send.vue +0 -158
  165. package/uni-components/chat-editor/chat-editor-quote/chat-editor-quote.vue +0 -75
  166. package/uni-components/chat-editor/chat-editor.vue +0 -257
  167. package/uni-components/chat-editor/index.js +0 -10
  168. package/uni-components/chat-editor/util.js +0 -65
  169. package/uni-components/chat-panel/chat-panel-chats-box.vue +0 -238
  170. package/uni-components/chat-panel/chat-panel-chats-forward/chat-panel-chats-forward.vue +0 -273
  171. package/uni-components/chat-panel/chat-panel-chats-item.vue +0 -578
  172. package/uni-components/chat-panel/chat-panel-chats-status/chat-panel-chats-status.vue +0 -71
  173. package/uni-components/chat-panel/chat-panel-chats.vue +0 -368
  174. package/uni-components/chat-panel/chat-panel.vue +0 -227
  175. package/uni-components/contacts-group-select/contacts-group-select-item.vue +0 -85
  176. package/uni-components/contacts-group-select/contacts-group-select-panel.vue +0 -119
  177. package/uni-components/contacts-group-select/contacts-group-select.vue +0 -150
@@ -0,0 +1,308 @@
1
+ # 企微客服端 SDK(client-chat-wework)设计文档
2
+
3
+ > 这是一份**活文档**:每次修复或优化 `client-chat-wework` 相关逻辑(包括 360 接入层和后端推送)时,都要同步更新本文档,保证文档描述的就是代码当前的行为。
4
+
5
+ ---
6
+
7
+ ## 0. 维护约定
8
+
9
+ 1. **先改文档里受影响的章节,再提交代码**;同一个提交里包含文档改动。
10
+ 2. 引用代码时**写函数名,不写行号**(行号很快会失效)。例:`ClientChat.handleQwContactAdded`。
11
+ 3. 跨端问题(SDK / 360 / 后端)要写清楚**在哪一端、哪个分支**。
12
+ 4. 发现但暂时不修的问题,记到「9. 已知问题与待办」,修复后改状态,不要删除。
13
+ 5. 每次更新在「10. 变更记录」追加一行。
14
+ 6. 下面这张表记录本文档最后一次核对时用的代码基线,核对后一起更新:
15
+
16
+ | 工程 | 路径 | 分支 / 版本 | 核对基线 |
17
+ | --- | --- | --- | --- |
18
+ | SDK | `fangzhou/client-sdk/services/client-chat/client-chat-wework` | `1.0.379-wework-8` | `a34694c` |
19
+ | 360 客服端 | `workphone-client/360/src/entries/wework` | `java_360-企业微信`,引用 SDK `wework-8` | `03d4a9dd` + 未提交改动(`chat-contacts.vue`) |
20
+ | combine 客服端 | `workphone-admin/combine/src/views/wework` | `master-1480【STD】1.0接入企业微信`,`package.json` 引用 SDK `wework-8`(`package-lock.json` 仍是 `wework-3`) | 未提交改动(`package.json`、`chat-contacts.vue`),见 9#10 |
21
+ | 后端 | `workphone-admin/workphone-java` | `origin/360金融贷-test`(企微代码**不在** `dev` 分支) | `a00658c382` |
22
+
23
+ ---
24
+
25
+ ## 1. 范围与相关工程
26
+
27
+ - **SDK**:负责企微客服端的状态管理,包括企微号、会话、消息、通讯录和 socket 推送处理。不包含 UI,也不直接发 HTTP 请求:所有接口由接入方通过 `xxxMethod` 注入。
28
+ - **360 客服端**:`src/entries/wework/chat/services/client-chat/index.js` 创建 SDK 实例,挂在 `this.$clientChat` 和 `window.$weworkClientChat` 上。
29
+ - **combine 客服端**:`workphone-admin/combine/src/views/wework/chat` 和 360 是同一套接入代码,只在环境相关的地方有差异(比如 `getLoginAccountIdMethod` 取的是 `store.getters.currentUser.id`)。**改 360 的接入层时,要同步评估 combine。**
30
+ - **后端**:企微相关逻辑在 `webservice/.../service/qw/` 下,客服端推送统一走 `ChatClientNotifyService.notifyQw*`。
31
+ - **参考实现**:微信版 SDK `client-chat-wechat`,接入方是 `workphone-client/JavaMain-combine/src/entries/chat`。两者结构相似,但企微版的推送命令和数据结构不同,**不能直接照搬**。
32
+ - **旧文档**:`workphone-admin/combine/docs/企业微信Cmd命令对接文档.md`(TASK#1480)。其中推送结构已经过时,以本文档第 6 节为准。
33
+
34
+ ---
35
+
36
+ ## 2. 整体架构
37
+
38
+ ```
39
+ ┌──────────────────────── ClientChat (client-chat.js) ────────────────────────┐
40
+ 360 接入层 │ │
41
+ (注入 xxxMethod) ──▶│ account session friendMessage / roomMessage contacts │
42
+ │ 企微号/未读 会话列表 联系人消息 / 群消息 通讯录/分组 │
43
+ │ (+ *Filter 用于搜索/定位) │
44
+ │ │
45
+ │ socket (client-chat-socket.js) ── 订阅 onCmdQw* 推送 ──▶ 分发到上面各模块 │
46
+ └──────────────────────────────────────────────────────────────────────────────┘
47
+ ▲
48
+ │ WebSocket 推送 CmdQw*
49
+ 后端 ChatClientNotifyService
50
+ ```
51
+
52
+ | 文件 | 类 | 职责 |
53
+ | --- | --- | --- |
54
+ | `client-chat.js` | `ClientChat` | 组装各模块;处理 socket 推送;维护会话和未读之间的联动 |
55
+ | `client-chat-account.js` | `ClientChatAccount` | 企微号列表、当前企微号、企微号未读数、待处理好友请求数 |
56
+ | `client-chat-session.js` | `ClientChatSession` | 会话列表(按置顶/时间分桶)、会话轮询获取、已读、置顶、删除 |
57
+ | `client-chat-message.js` | `ClientChatMessage` | 消息存储(按 day/毫秒分桶)、发送、发送结果轮询、撤回 |
58
+ | `client-chat-concats.js` | `ClientChatContacts` | 好友/群列表、分组、分组数量缓存、群成员、通讯录修改标记 |
59
+ | `client-chat-socket.js` | `ClientChatSocket` | 包装通用 socket,只订阅企微相关事件 |
60
+ | `utils.js` | — | `createSessionId` 等工具函数 |
61
+
62
+ 所有响应式数据都放在各模块的 `data = Vue.observable({...})` 里;`xxxMap` 这类非响应式的索引只供内部查找使用。
63
+
64
+ ---
65
+
66
+ ## 3. 接入方式(360)
67
+
68
+ ### 3.1 注入方法与接口对应
69
+
70
+ | SDK 配置项 | 360 实现 / 接口 | 说明 |
71
+ | --- | --- | --- |
72
+ | `socket` | `chat/services/socket.js` | 通用 socket 实例 |
73
+ | `getLoginAccountIdMethod` | `store.getters.account.id` | **登录客服 id**,用于计算会话 id |
74
+ | `loadAccountDataMethod` | `loadClientAccountData` | 企微号列表 |
75
+ | `getAccountUnreadMessageNumMethod` | `getAccountUnreadNumber`(`mergeRequest` 合并) | 企微号未读数 |
76
+ | `getAccountGreetingUnreadMsgCountMethod` | `getGreetingUnreadMsgCount` | 待处理好友请求数 |
77
+ | `loadSessionDataMethod` | `loadSessionData`(游标 `lastId`) | 会话分页 |
78
+ | `getSessionMethod` | `POST /chat/qwConversation/{id}` | 单个会话 |
79
+ | `updateSessionReadMethod` / `deleteSessionMethod` | `setSessionRead` / `deleteSession` | |
80
+ | `loadContactsFriendDataMethod` / `loadContactsRoomDataMethod` | `loadClientFriendData` / `loadClientRoomData` | **游标分页**(`lastNickname` + `lastId`),size 默认 50 |
81
+ | `getContactsFriendMethod` / `getContactsRoomMethod` | `getFriendBatch` / `getRoomBatch`(`createThrottleRequest` 合并成批量请求) | 单个联系人/群 |
82
+ | `loadContactsFriendGroupDataMethod` / `loadContactsRoomGroupDataMethod` | 本地写死,只有一个分组 `defaultFriendGroup` / `defaultRoomGroup` | 企微暂无分组 |
83
+ | `getContactsFriendGroupCountMethod` / `getContactsRoomGroupCountMethod` | `Promise.resolve()`(**空实现**) | 分组数量目前不生效 |
84
+ | `loadFriendMessageDataMethod` / `loadRoomMessageDataMethod` | `loadFriendChatData` / `loadRoomChatData` | |
85
+ | `checkMessageSendResultMethod` | `getMessageSendResult` | 发送结果轮询 |
86
+ | `recallMessageMethod` | `recallMessage` | 撤回 |
87
+
88
+ ### 3.2 `withAccountCompany`
89
+
90
+ 360 的每个接口都要带 `qwAccountId` 和 `corpId`。规则如下:
91
+
92
+ - 参数里带了 `qwAccountId`,就用这个企微号的 `corpId`;
93
+ - 没带,就用**当前选中企微号**(`account.currentAccount`)的。
94
+
95
+ `getSessionMethod`、`getContactsFriendMethod`、`getContactsRoomMethod` 都**不带** `qwAccountId`,因此始终用当前企微号的 corpId(见 9. 已知问题 #3)。
96
+
97
+ ### 3.3 初始化顺序(`chat/root.vue`)
98
+
99
+ 1. `ClientChat.connect()`:连接 socket,完成后触发 `ready` 事件。
100
+ 2. `account.loadData()`:加载企微号。如果没有当前企微号,默认选第一个(**360 不存在"全部企微号"模式**)。
101
+ 3. 各界面组件再分别加载会话、通讯录和消息。
102
+
103
+ `ClientChat.disconnect()` 会 reset 所有模块,并停止会话轮询。
104
+
105
+ ---
106
+
107
+ ## 4. 核心标识与数据约定
108
+
109
+ | 标识 | 含义 | 注意 |
110
+ | --- | --- | --- |
111
+ | `qwAccountId` | 企微号**数据库 id** | 不是企微远端 id;手机端协议里的 `remoteId` / `accountId` 是远端 id,两者不能混用 |
112
+ | `contactId` / `roomId` | 联系人 / 群的**数据库 id** | 消息、会话 `targetId`、通讯录 `id` 用的都是它 |
113
+ | 会话 id | `createSessionId(登录客服id, targetId)` = `sha1(accountId + targetId)` | 必须与后端 `QwConversation.conversationId(accountId, targetId)` 一致。**会话是按客服区分的,不是按企微号** |
114
+ | `session.type` | `0` 联系人,`1` 群 | |
115
+ | 会话分组字段 | `qwAccountId` | `session.sessionGroupData[qwAccountId]` |
116
+ | 消息分组字段 | 联系人消息 `contactId`,群消息 `roomId` | 排序字段 `sendTime` |
117
+ | 联系人/群的 `groupId` | 360 统一写成 `defaultFriendGroup` / `defaultRoomGroup` | 可以是逗号分隔的多个分组 |
118
+ | `changeType` | `1` 新增,`2` 更新,`3` 删除 | 后端 `ChangeTypeEnum`,序列化成数字 |
119
+
120
+ ---
121
+
122
+ ## 5. 模块设计
123
+
124
+ ### 5.1 account(企微号)
125
+
126
+ - `accountData` / `accountMap`:企微号列表;`currentAccount` 是当前企微号。
127
+ - `accountUnreadMessageNumData: [{id, num}]`:企微号未读数。
128
+ - 用 `refreshAccountUnreadMessageNum` 从服务端刷新;
129
+ - 用 `updateAccountUnreadMessageNum(id, cb)` 在本地增减。
130
+ - `accountGreetingUnreadMsgCountData: {qwAccountId | 'all': count}`:待处理好友请求数。同一组企微号的请求会合并,后端返回 0 的企微号也要先置为 0。
131
+ - `onAccountAdded`:新企微号加入时,以服务端为准刷新它的未读数。
132
+ - `reloadData()`:取消正在进行的加载并重新加载。新增联系人/群时,如果所属企微号不在列表里,会调用它(`ClientChat.reloadAccountDataIfMissing`)。
133
+
134
+ ### 5.2 session(会话)
135
+
136
+ - 存储:`sessionMap` 用来索引;`data.sessionData` 按 `置顶 → day → milliseconds` 分桶,利用对象数字 key 的天然顺序来排序;`data.sessionGroupData` 再按 `qwAccountId` 分组。
137
+ - 分页:`reload` / `loadData` 使用 `lastSession` 作为游标。
138
+ - **`getSession(sessionId, serializeMethod)`**:
139
+ - 本地已有会话,直接返回本地数据,**不请求服务端**;
140
+ - 本地没有,就用 `createPollRequest` **每 5 秒请求一次,最多 60 秒**,拿到后再 `addSession`;
141
+ - 同一会话的多次调用合并成一个轮询,`serializeMethod` 依次执行,可以修改返回数据,并累加 `context.accountUnreadDelta`;
142
+ - `addSession` 通过 `onAddSession({unreadDelta})` 把这个增量加到企微号未读上。
143
+ - **`refreshSession(sessionId)`**:强制请求一次服务端,不轮询,找不到就 reject。目前没有调用方(新增联系人/群已改用 `getSession`,见 8.2)。
144
+ - `markModify` / `isModify`:按企微号标记"会话列表有变化"。360 的 `chat-session.vue` 据此显示刷新提示。
145
+ - 已读:`setSessionRead` 先请求接口,成功后调用 `markSessionRead`,再触发 `onSessionReadChange`,扣减企微号未读。
146
+
147
+ ### 5.3 message(消息)
148
+
149
+ - 共四个实例:`friendMessage` / `roomMessage` 是主列表;`friendMessageFilter` / `roomMessageFilter` 用于搜索、定位,通过 `setRelatedMessageService` 关联,撤回状态会同步到关联实例。
150
+ - 存储:`messageData[groupField][day][milliseconds] = [message]`。
151
+ - `addMessage(data, fireEvent)`:
152
+ - 用 `id` 去重;
153
+ - `tempMessageMap` 里暂存的是"消息还没到就先收到的更新",消息到达时合并进去;
154
+ - 计算 `isBeforeLastMessage`:收到的消息早于本地最后一条时为 true;
155
+ - `fireEvent !== false` 时调用 `onAddMessageSuccess`,用来联动会话(见 7.2)。
156
+ - 发送:`sendMessage` 发出 `CmdQwSendMessage`,返回的消息对象直接 `addMessage`。
157
+ - **发送结果靠轮询**:消息 `isSend && status === 1` 时加入检查任务,每 3 秒请求一次 `checkMessageSendResultMethod`,超过 5 分钟就置为 `{status: 3, resultMsg: '消息发送超时'}`。后端虽然会推 `CmdQwSendMessageResult`,但 SDK **没有订阅**。
158
+ - 撤回:`recallMessage` 先把消息标记为 `recalling`,10 秒内没收到结果就置为 timeout;最终结果由推送 `CmdQwMessageRecalled` / `CmdQwMessageRecallFailed` 更新。
159
+
160
+ ### 5.4 contacts(通讯录)
161
+
162
+ - `friendData` / `roomData` 是列表;`groupBindFriendMap[groupId]` 和 `accountBindFriendMap[qwAccountId][groupId]` 是给界面用的视图;群也一样。
163
+ - 列表加载:`loadFriendData` / `reloadFriendData`,群对应 `*RoomData`。360 列表是**游标分页**,游标取当前列表**最后一条**的 `nickname` / `id`。
164
+ - `getFriend` / `getRoom`:本地有就直接返回,否则请求服务端,并 `addFriend` / `addRoom`。
165
+ - `refreshFriend` / `refreshRoom`:强制请求服务端并合并。`refreshRoom` 会先 remove 再 add,群会被移到列表末尾。
166
+ - 分组数量:`refreshAllFriendGroupCount({qwAccountId})` 把结果缓存在 `_cacheFriendGroupCountMap[qwAccountId]`。这个缓存**不是响应式的**,用 `clearAllFriendGroupCountCache(qwAccountId)` 清掉该企微号和 `null`(全部)两份缓存。群对应 `*RoomGroupCount*`。
167
+ - `markModify(qwAccountIds)` / `isModify(qwAccountId)` / `unmarkModify`:标记"通讯录有变化"。360 的 `chat-contacts.vue` 会显示"当前通讯录发生改变,点击刷新",点击后执行 `handleRefreshClick`:清分组数量缓存,重新加载分组、分组数量和列表,然后 `unmarkModify`。
168
+
169
+ ### 5.5 socket
170
+
171
+ `ClientChatSocket` 只订阅以下事件,其余推送**一律忽略**:
172
+
173
+ `onCmdQwNewMessage`、`onCmdQwMessageRecalled`、`onCmdQwMessageRecallFailed`、`onCmdQwContactInfoChanged`、`onCmdQwContactRequestChanged`、`onCmdQwAcceptContactRequest`、`onCmdQwRoomInfoChanged`、`onHeartbeatSuccess`、`onHeartbeatCheck`
174
+
175
+ 通用 socket 收到推送后,按 `'on' + cmdType` 触发事件,并自动回复 `CommandResponse`。
176
+
177
+ ---
178
+
179
+ ## 6. 推送命令处理
180
+
181
+ | 推送 | 后端结构(核对于 360 测试分支) | SDK 处理 |
182
+ | --- | --- | --- |
183
+ | `CmdQwNewMessage` | `{contactMessage}` 或 `{roomMessage}`,二选一 | `friendMessage` / `roomMessage` 的 `addMessage`,进而联动会话(7.2) |
184
+ | `CmdQwContactInfoChanged` | `{contacts: [{changeType, contactId, qwAccountId}], qwAccountIds}`。**≥100 条时不给 `contacts`,只给 `qwAccountIds`** | 没有 `contacts`:`markAccountsModified(qwAccountIds)`。有:先 `reloadAccountDataIfMissing`,再按 changeType 分发到 `handleQwContactAdded` / `Updated` / `Removed` |
185
+ | `CmdQwRoomInfoChanged` | `{rooms: [{changeType, roomId, qwAccountId}], qwAccountIds}`,规则同上 | 同上,对应 `handleQwRoom*` |
186
+ | `CmdQwContactRequestChanged` | `{changeType, record}`,新增=1,状态变化=2 | 刷新待处理好友请求数,对外触发 `contactRequestChanged` 事件 |
187
+ | `CmdQwAcceptContactRequest` | 客服端发出的命令的响应 | 刷新待处理好友请求数 |
188
+ | `CmdQwMessageRecalled` / `CmdQwMessageRecallFailed` | `{contactMessageId | roomMessageId, ...}` | 更新撤回状态 |
189
+ | `CmdQwSendMessageResult` | 后端会推 | **未订阅**,发送结果靠轮询 |
190
+ | `CmdQwRoomMemberInfoChanged` | 后端会推 | **未订阅** |
191
+ | `CmdQwAddContactResult` | 后端会推 | **未订阅** |
192
+ | `CmdCmdKickOut` | — | `ClientChat` 里写了 `onCmdCmdKickOut`,但 socket 包装层没绑定,**不会触发** |
193
+
194
+ 后端推送有超时重试(一般 3 次),SDK 处理必须**幂等**:消息按 id 去重,会话和通讯录按 id 覆盖。
195
+
196
+ ### 6.1 各 changeType 的处理
197
+
198
+ | | 联系人 | 群 |
199
+ | --- | --- | --- |
200
+ | 新增(1) | `markModify(qwAccountId)`,清好友分组数量缓存;`getSession` 拉会话,补企微号未读。**不往本地通讯录插入数据** | `markModify(qwAccountId)`,清群分组数量缓存;`getSession` 拉会话,补未读。**不往本地通讯录插入数据** |
201
+ | 更新(2) | `refreshFriend` | `refreshRoom` |
202
+ | 删除(3) | `removeFriend`,清分组数量缓存,删本地会话(是当前会话就先取消选中),扣减企微号未读 | `removeRoom`,触发 `roomRemoved` 事件,清缓存,删会话,扣未读 |
203
+
204
+ ---
205
+
206
+ ## 7. 关键业务流程
207
+
208
+ ### 7.1 连接与初始化
209
+
210
+ 见 3.3。
211
+
212
+ ### 7.2 收到新消息 → 会话联动(`onAddMessageSuccess`)
213
+
214
+ 1. 用 `createSessionId(登录客服id, contactId | roomId)` 算出会话 id。
215
+ 2. 如果 `isBeforeLastMessage`,即收到的是本地最后一条之前的旧消息,**不更新会话**。
216
+ 3. 本地**有**这个会话:
217
+ - 消息比会话的 `lastMsgTime` 新,就更新最后一条消息;
218
+ - 收到的消息(`!isSend`):如果就是当前会话,立刻已读;否则会话未读 +1,企微号未读 +1。
219
+ 4. 本地**没有**这个会话:调用 `getSession` 轮询。拿到后,如果服务端会话还没包含这条消息,本地补上 lastMsg 和未读;企微号未读通过 `accountUnreadDelta` 累加。
220
+
221
+ > 后端对一条新消息的处理顺序是:先**同步**推送 `CmdQwNewMessage`,再通过 `QwContactNewMessageEvent` **异步** upsert 会话。所以客户端收到消息时,服务端会话可能还没建好,这正是 `getSession` 需要轮询的原因。
222
+
223
+ ### 7.3 发送消息
224
+
225
+ `sendMessage` 发出 `CmdQwSendMessage`,后端返回消息对象(`status=1` 表示发送中),SDK `addMessage` 并开始轮询发送结果,直到状态不再是 1,或超过 5 分钟。
226
+
227
+ ### 7.4 通过好友请求(跨端完整链路)
228
+
229
+ ```
230
+ 客服点"通过"
231
+ └─ CmdQwAcceptContactRequest ──▶ 后端 QwContactRequestRecordService.accept
232
+ 记录状态变为"请求中"(1),推 CmdQwContactRequestChanged
233
+ 下发 WEWORK/verifyFriendRequest 到手机
234
+ 手机处理完成
235
+ ├─ (A) SyncA1904Contacts 增量联系人同步 ──▶ QwContactService.process
236
+ │ 新建 QwContact,推 CmdQwContactInfoChanged(ADD);不创建会话
237
+ └─ (B) SyncA1904VerifyFriendRequestResult ──▶ processVerifyResult → markSuccess
238
+ 状态变为"成功"(4),推 CmdQwContactRequestChanged
239
+ QwContactService.createByAccept:
240
+ 联系人不存在或已删除 → 新建/恢复,写系统消息"系统将此联系人从系统分配给XX",
241
+ 同步 upsert 会话,推 CmdQwContactInfoChanged(ADD)
242
+ 联系人已存在且未删除 → 直接 return(⚠ 见 9. 已知问题 #1)
243
+ 客服端收到 ADD
244
+ └─ handleQwContactAdded:通讯录 markModify + getSession 轮询会话
245
+ ```
246
+
247
+ - 后端**不会**为"通过好友"推送 `CmdQwNewMessage`。系统消息只入库,会话由 ADD 推送加 `getSession` 拉取得到。
248
+ - 企微自己生成的打招呼消息,如果设备通过 `SyncA1904Messages` 上报,就会走 7.2 的正常消息流程。
249
+ - 好友请求状态:0 待处理,1 请求中,2 超时,3 失败,4 成功。**"通过成功"是 4,不是 2**。
250
+
251
+ ### 7.5 撤回
252
+
253
+ 见 5.3。
254
+
255
+ ---
256
+
257
+ ## 8. 设计决策(修改前先读)
258
+
259
+ ### 8.1 新增联系人/群不往本地通讯录插入数据,只 `markModify`
260
+
261
+ - 360 通讯录是**游标分页**,游标取本地列表最后一条。`addFriend` / `addRoom` 会 push 到末尾,下一页就会用这条新数据当游标,造成跳页或重复。
262
+ - 新数据的 `groupId` 不一定属于当前打开的分组。
263
+ - 做法与微信版一致:标记修改,清分组数量缓存,由用户点刷新后重新拉取。
264
+ - 代价:新联系人/群要用户点一下"刷新"才会出现在通讯录里;会话列表不受影响,会自动出现。
265
+
266
+ ### 8.2 新增时用 `getSession`,不用 `refreshSession`
267
+
268
+ - 服务端会话可能比 ADD 推送晚创建:比如只走了 7.4 的 (A) 路径,或者会话由异步事件建立。`getSession` 有 5 秒×60 秒的轮询,`refreshSession` 只请求一次。
269
+ - 代价:本地已有这个会话时,`getSession` 不请求服务端,会话的未读数不会重新同步。会话已经显示在列表里,影响不大。
270
+
271
+ ### 8.3 未读数的记账规则
272
+
273
+ - 企微号未读 = 服务端初始值 + 本地增量。增量来源有三个:`onAddSession({unreadDelta})`、`onAddMessageSuccess` 里的 +1、`onSessionReadChange` 里的扣减。
274
+ - 新加载出来的企微号(`reloadAccountDataIfMissing` 返回的 `newAccountMap`)以服务端为准,**不再本地累加**,否则会重复。
275
+ - 删除联系人/群时,按被删会话的 `unreadMsgCount` 扣减。本地没有加载这个会话时没法扣,只能等服务端刷新。
276
+
277
+ ### 8.4 会话 id 按客服计算
278
+
279
+ 会话 id 是 `sha1(登录客服id + targetId)`,而不是按企微号算。同一个联系人被分配给另一个客服后,就是另一个会话。`getLoginAccountIdMethod` 必须返回登录客服的 id(1.0 有帮聊场景,所以这个值由外部传入)。
280
+
281
+ ---
282
+
283
+ ## 9. 已知问题与待办
284
+
285
+ | # | 端 | 问题 | 影响 | 状态 |
286
+ | --- | --- | --- | --- | --- |
287
+ | 1 | 后端 | `QwContactService.createByAccept`:联系人已存在且未删除时直接 return。如果 (A) 联系人同步先于 (B) 验证结果到达,就不会写系统消息、不建会话、不推 ADD | 通过好友后会话列表看不到新联系人;前端轮询 60 秒也拉不到,只有期间来了消息才会出现 | **待修复**。方案:已存在时跳过插入,但继续写系统消息、upsert 会话、推 ADD(系统消息 id 是固定的,需确认重复调用安全) |
288
+ | 2 | SDK | 本地已有会话时,新增事件里的 `getSession` 不会刷新未读 | 未读可能和服务端有偏差 | 已知,可接受 |
289
+ | 3 | 360 | `getSessionMethod` / `getContactsFriendMethod` / `getContactsRoomMethod` 没传 `qwAccountId`,始终用当前企微号的 corpId | 推送里的联系人/群如果属于另一个(不同企业的)企微号,请求可能失败或查不到 | **待确认**后端是否校验 corpId / qwAccountId |
290
+ | 4 | 360 | 分组数量的两个 Method 是空实现 | 分组数量不显示;SDK 的缓存清理和 `handleRefreshClick` 里的数量刷新目前都不起作用(无害) | 等企微做分组时再实现 |
291
+ | 5 | SDK | `ClientChatAccount.removeAccount` 用了未定义的 `data.id`;`onAccountRemoved` 回调拿到的是已经删掉的 `undefined` | 调用就会报 ReferenceError | 待修复(目前没有调用方) |
292
+ | 6 | SDK | `refreshAccountUnreadMessageNum` 的 else 分支写成了 `push(index, 1, {...})` | 企微号不在未读列表里时,会塞进 `-1`、`1` 两个脏数据 | 待修复 |
293
+ | 7 | SDK | `updateAccountUnreadMessageNum` 找不到企微号时,`splice(-1, 1, ...)` 会覆盖最后一个企微号的未读 | 未读数串到别的企微号 | 待修复 |
294
+ | 8 | SDK | socket 没订阅 `CmdQwSendMessageResult`、`CmdQwRoomMemberInfoChanged`、`CmdQwAddContactResult`;`onCmdCmdKickOut` 没绑定 | 发送结果只能靠轮询(最多延迟 3 秒);群成员变化不实时;踢下线不处理 | 待评估 |
295
+ | 10 | combine | 企微接入层和 360 是同一套代码的两个副本(`src/views/wework/chat` ↔ `src/entries/wework/chat`),但 SDK 还停在 `wework-3`,`chat-contacts.vue` 的 `handleRefreshClick` 也没同步 | combine 上没有新好友会话、通讯录刷新提示、撤回等修复 | **进行中**:`package.json` 已改为 `wework-8`,`handleRefreshClick` 已和 360 一致;等 `wework-8` 发布到 npm 后,执行 `npm install` 更新 `package-lock.json` |
296
+ | 9 | 文档 | `combine/docs/企业微信Cmd命令对接文档.md` 里的推送结构已过时 | 容易误导 | 以本文档第 6 节为准 |
297
+
298
+ ---
299
+
300
+ ## 10. 变更记录
301
+
302
+ | 日期 | 端 | 改动 | 相关章节 |
303
+ | --- | --- | --- | --- |
304
+ | 2026-10-28 | SDK | `handleQwContactAdded` / `handleQwRoomAdded` 的会话获取从 `refreshSession` 改为 `getSession`(修复新好友不显示会话) | 8.2、9#1 |
305
+ | 2026-10-28 | SDK | 联系人/群新增改为 `markModify` + 清分组数量缓存,不再 `refreshRoom`;新增 `clearAllFriendGroupCountCache` / `clearAllRoomGroupCountCache`;增删和 `markAccountsModified` 都会清缓存 | 5.4、6.1、8.1 |
306
+ | 2026-10-28 | 360 | `chat-contacts.vue` 的 `handleRefreshClick`:刷新时清缓存,分组重载后再刷新分组数量 | 5.4 |
307
+ | 2026-10-28 | 文档 | 创建本文档 | — |
308
+ | 2026-10-28 | combine | SDK 引用升级到 `wework-8`,同步 `handleRefreshClick` | 9#10 |
@@ -13,11 +13,11 @@ export function isUni () {
13
13
  * @param accountId - 客服id
14
14
  * @param targetId - wechatFriendId | wechatChatroomId
15
15
  */
16
- export function createSessionId (corpId, accountId, targetId) {
17
- if (!corpId || !accountId || !targetId) {
16
+ export function createSessionId (accountId, targetId) {
17
+ if (!accountId || !targetId) {
18
18
  return
19
19
  }
20
- return shajs('sha1').update(`${corpId}${accountId}${targetId}`).digest('hex')
20
+ return shajs('sha1').update(`${accountId}${targetId}`).digest('hex')
21
21
  }
22
22
 
23
23
  /**
@@ -54,7 +54,7 @@ export function createSessionId (corpId, accountId, targetId) {
54
54
  * "msgSvrId": "4319123759514541049",
55
55
  * "msgType": 1,
56
56
  * "origin": "0",
57
- * "sendStatus": 0,
57
+ * "status": 0,
58
58
  * "tenantId": "1761952223049924608",
59
59
  * "wechatAccountId": "ad9d9ae2a8be4f27311312cdd4af3549dc8427ef",
60
60
  * "wechatFriendId": "2089efcc7f8f40b00b7f05fa4c6dfd3bb642774d",
@@ -79,4 +79,4 @@ export function createSessionData (message) {
79
79
  wechatAccountId: message.wechatAccountId
80
80
  }
81
81
  return nextSession
82
- }
82
+ }
@@ -25,6 +25,8 @@ export default class Socket {
25
25
 
26
26
  maxReconnectInterval = 60000
27
27
 
28
+ connectionGeneration = 0
29
+
28
30
  data = Vue.observable({
29
31
  connectIpChange: false, // 连接设备是否变化,如果变化需要提示用户退出重新登录
30
32
  connectMessage: null,
@@ -47,6 +49,7 @@ export default class Socket {
47
49
  url: null,
48
50
  client: null,
49
51
  logEnable: false,
52
+ log: null,
50
53
  logName: 'socket',
51
54
  logMaxSize: 3 * 1024 * 1024, // 非网页版本最多记3M日志
52
55
  socketAdapter: null, // 支持从外面传一个socket构造函数,但是要实现socket标准的使用方式
@@ -73,7 +76,7 @@ export default class Socket {
73
76
  this.logEnable = !!options.logEnable
74
77
  this.url = options.url
75
78
  this.event = new Event()
76
- this.log = new Log({
79
+ this.log = options.log || new Log({
77
80
  maxSize: options.logMaxSize, // 非网页版本日志大小限制
78
81
  name: options.logName || 'socket'
79
82
  })
@@ -105,6 +108,17 @@ export default class Socket {
105
108
  return !!socket && socket === this._ws
106
109
  }
107
110
 
111
+ _addSocketStateLog (event, data = {}) {
112
+ this.logEnable && this.log.addLog({
113
+ group: 'diagnostic:socket_state',
114
+ content: Object.assign({
115
+ event,
116
+ connectionGeneration: this.connectionGeneration,
117
+ connectStatus: this.connectStatus
118
+ }, data)
119
+ })
120
+ }
121
+
108
122
  _handleReconnectLimitExceeded () {
109
123
  const err = new Error('socket重连次数已超过上限')
110
124
  clearTimeout(this._reconnectTimer)
@@ -141,14 +155,20 @@ export default class Socket {
141
155
  this.readyPromise = createPromise()
142
156
  this.data.connectUrl = this.url + `?client=${this.client}&accountId=${this.accountId}&accessToken=${this.token}`
143
157
  let socket = null
158
+ this.connectionGeneration++
144
159
  this.data.connectStatus = CONNECT_STATUS.Connecting
145
160
  this.logEnable && this.log.addLog({
146
161
  group: 'socket:connect',
147
162
  content: {
148
163
  title: '开始连接',
149
- socketUrl: this.data.connectUrl
164
+ client: this.client,
165
+ accountId: this.accountId,
166
+ connectionGeneration: this.connectionGeneration
150
167
  }
151
168
  })
169
+ this._addSocketStateLog('connect_start', {
170
+ to: CONNECT_STATUS.Connecting
171
+ })
152
172
  this._ws = null
153
173
  if (this.socketAdapter) {
154
174
  socket = new this.socketAdapter(this.data.connectUrl)
@@ -275,6 +295,9 @@ export default class Socket {
275
295
  title: 'socket连接中'
276
296
  }
277
297
  })
298
+ this._addSocketStateLog('native_open', {
299
+ to: CONNECT_STATUS.Success
300
+ })
278
301
  this.sendMessage(params).then(() => {
279
302
  if (socket && !this._isCurrentSocket(socket)) {
280
303
  return
@@ -286,6 +309,9 @@ export default class Socket {
286
309
  }
287
310
  })
288
311
  this._startHeartbeat() // 注释掉,因为现在心跳的命令改了,用账号在线状态控制,减少命令发送频率
312
+ this._addSocketStateLog('signin_success', {
313
+ result: 'success'
314
+ })
289
315
  successFn && successFn()
290
316
  this.event.emit('onOpen')
291
317
  }, (err) => {
@@ -293,6 +319,13 @@ export default class Socket {
293
319
  return
294
320
  }
295
321
  errorFn && errorFn(err)
322
+ this.data.connectStatus = CONNECT_STATUS.Error
323
+ this._addSocketStateLog('signin_failed', {
324
+ result: 'failed',
325
+ errorType: err && (err.name || err.code) || typeof err,
326
+ willReconnect: true
327
+ })
328
+ this.reconnect().catch(() => {})
296
329
  })
297
330
  }
298
331
 
@@ -324,11 +357,15 @@ export default class Socket {
324
357
  reason: evt.reason,
325
358
  }
326
359
  })
360
+ this._addSocketStateLog('socket_close', {
361
+ from: prevConnectStatus,
362
+ to: CONNECT_STATUS.Close,
363
+ closeCode: evt.code,
364
+ reason: evt.reason,
365
+ willReconnect: !evt.reason || evt.reason.indexOf('(手动关闭)') < 0
366
+ })
327
367
  if (!evt.reason || evt.reason.indexOf('(手动关闭)') < 0) {
328
- if (prevConnectStatus === CONNECT_STATUS.Connecting) {
329
- return
330
- }
331
- this.reconnect()
368
+ this.reconnect().catch(() => {})
332
369
  }
333
370
  this.event.emit('onClose', {
334
371
  code: evt.code,
@@ -355,7 +392,11 @@ export default class Socket {
355
392
  if (this.readyPromise && typeof this.readyPromise.reject === 'function') {
356
393
  this.readyPromise.reject(new Error('socket连接错误'))
357
394
  }
358
- this.reconnect()
395
+ this._addSocketStateLog('socket_error', {
396
+ to: CONNECT_STATUS.Error,
397
+ willReconnect: true
398
+ })
399
+ this.reconnect().catch(() => {})
359
400
  }
360
401
 
361
402
  mockSocketMessage (evt) {
@@ -445,6 +486,10 @@ export default class Socket {
445
486
  // 指数退避 + 随机抖动
446
487
  const jitter = Math.random() * 500 * 2 - 500
447
488
  const actualInterval = Math.min(this.reconnectInterval + jitter, this.maxReconnectInterval)
489
+ this._addSocketStateLog('reconnect_scheduled', {
490
+ retryCount: this.reconnectCount,
491
+ delayMs: Math.max(0, Math.round(actualInterval))
492
+ })
448
493
  // 先翻倍再等待,避免定时器被取消导致倍数丢失
449
494
  this.reconnectInterval = Math.min(this.reconnectInterval * 2, this.maxReconnectInterval)
450
495
  clearTimeout(this._reconnectTimer)
@@ -801,6 +846,10 @@ export default class Socket {
801
846
  return this.log.exportLogData()
802
847
  }
803
848
 
849
+ exportLogFiles () {
850
+ return this.log.exportLogFiles()
851
+ }
852
+
804
853
  checkAndSync () {
805
854
  return this.log.checkAndSync()
806
855
  }
@@ -0,0 +1,13 @@
1
+ export const INDEXED_DB_VERSION = 2
2
+ export const INDEXED_DB_STORE_NAME = 'logs'
3
+ export const INDEXED_DB_META_STORE_NAME = 'meta'
4
+ export const INDEXED_DB_ORDER_INDEX_NAME = 'order'
5
+ export const INDEXED_DB_STATS_KEY = 'stats'
6
+
7
+ export const DEFAULT_INDEXED_DB_MAX_SIZE = 200 * 1024 * 1024
8
+ export const DEFAULT_FLUSH_INTERVAL = 300
9
+ export const DEFAULT_FLUSH_THRESHOLD = 50
10
+ export const DEFAULT_FLUSH_BATCH_SIZE = 500
11
+ export const DEFAULT_MAX_PENDING_COUNT = 2000
12
+ export const DEFAULT_MAX_PENDING_BYTES = 2 * 1024 * 1024
13
+
@@ -0,0 +1,88 @@
1
+ import { safeStringify, getByteSize } from './serialize'
2
+
3
+ export const ERROR_LOG_GROUPS = [
4
+ 'diagnostic:runtime_error',
5
+ 'diagnostic:runtime_error_suppressed'
6
+ ]
7
+
8
+ export function recordPayload (record) {
9
+ if (record && typeof record.payload === 'string') {
10
+ return record.payload
11
+ }
12
+ return safeStringify(record && record.log) || '{}'
13
+ }
14
+
15
+ export function recordDay (record, payload) {
16
+ if (record && record.day) {
17
+ return record.day
18
+ }
19
+ try {
20
+ const log = record && record.log ? record.log : JSON.parse(payload)
21
+ const value = log && (log.timestamp || log.createTime)
22
+ if (typeof value === 'number') {
23
+ const date = new Date(value)
24
+ return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`
25
+ }
26
+ if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}/.test(value)) {
27
+ return value.slice(0, 10)
28
+ }
29
+ } catch (error) {}
30
+ return 'unknown-date'
31
+ }
32
+
33
+ function isErrorLogRecord (record, payload) {
34
+ const group = record && (
35
+ record.group ||
36
+ (record.log && record.log.group)
37
+ )
38
+ if (ERROR_LOG_GROUPS.indexOf(group) >= 0) {
39
+ return true
40
+ }
41
+ if (typeof payload !== 'string') {
42
+ return false
43
+ }
44
+ return ERROR_LOG_GROUPS.some(errorGroup => (
45
+ payload.indexOf(`"group":"${errorGroup}"`) >= 0
46
+ ))
47
+ }
48
+
49
+ export function createExportFiles (records, options = {}) {
50
+ const separateErrorLogs = !!options.separateErrorLogs
51
+ const groups = Object.create(null)
52
+ ;(records || []).forEach(record => {
53
+ const payload = recordPayload(record)
54
+ const day = recordDay(record, payload)
55
+ const type = separateErrorLogs && isErrorLogRecord(record, payload) ? 'error' : 'operation'
56
+ const key = `${type}:${day}`
57
+ if (!groups[key]) {
58
+ groups[key] = { day, type, payloads: [] }
59
+ }
60
+ groups[key].payloads.push(payload)
61
+ })
62
+ return Object.keys(groups).sort((left, right) => {
63
+ const leftGroup = groups[left]
64
+ const rightGroup = groups[right]
65
+ return leftGroup.day.localeCompare(rightGroup.day) || leftGroup.type.localeCompare(rightGroup.type)
66
+ }).map(key => {
67
+ const group = groups[key]
68
+ const payloads = group.payloads
69
+ const parts = ['[']
70
+ payloads.forEach((payload, index) => {
71
+ if (index) {
72
+ parts.push(',')
73
+ }
74
+ parts.push(payload)
75
+ })
76
+ parts.push(']')
77
+ const content = typeof Blob !== 'undefined'
78
+ ? new Blob(parts, { type: 'application/json' })
79
+ : parts.join('')
80
+ return {
81
+ day: group.day,
82
+ type: group.type,
83
+ count: payloads.length,
84
+ size: typeof content === 'string' ? getByteSize(content) : content.size,
85
+ content
86
+ }
87
+ })
88
+ }