chatccc 0.2.231 → 0.2.232

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 (127) hide show
  1. package/.agents/skills/create-chatccc-feishu-app/SKILL.md +85 -85
  2. package/.claude/skills/create-chatccc-feishu-app/SKILL.md +85 -85
  3. package/.cursor/skills/create-chatccc-feishu-app/SKILL.md +85 -85
  4. package/README.md +90 -90
  5. package/agent-prompts/claude_specific.md +45 -45
  6. package/agent-prompts/codex_specific.md +2 -2
  7. package/agent-prompts/cursor_specific.md +13 -13
  8. package/bin/cccagent.mjs +17 -17
  9. package/im-skills/feishu-skill/receive-send-file.md +63 -63
  10. package/im-skills/feishu-skill/receive-send-image.md +24 -24
  11. package/im-skills/feishu-skill/skill.md +3 -3
  12. package/im-skills/wechat-file-skill/receive-send-file.md +38 -38
  13. package/im-skills/wechat-file-skill/send-file.mjs +83 -83
  14. package/im-skills/wechat-file-skill/skill.md +10 -10
  15. package/im-skills/wechat-image-skill/skill.md +10 -10
  16. package/im-skills/wechat-video-skill/receive-send-video.md +38 -38
  17. package/im-skills/wechat-video-skill/send-video.mjs +79 -79
  18. package/im-skills/wechat-video-skill/skill.md +10 -10
  19. package/package.json +1 -1
  20. package/scripts/postinstall-sharp-check.mjs +58 -58
  21. package/src/__tests__/agent-activity.test.ts +86 -86
  22. package/src/__tests__/agent-delegate-task-rpc.test.ts +165 -165
  23. package/src/__tests__/agent-reload-config-rpc.test.ts +99 -99
  24. package/src/__tests__/builtin-chat-session.test.ts +449 -393
  25. package/src/__tests__/builtin-cli-json.test.ts +39 -39
  26. package/src/__tests__/builtin-config.test.ts +26 -26
  27. package/src/__tests__/builtin-context.test.ts +319 -202
  28. package/src/__tests__/builtin-file-tools.test.ts +240 -240
  29. package/src/__tests__/builtin-permissions.test.ts +211 -211
  30. package/src/__tests__/builtin-session-search.test.ts +228 -0
  31. package/src/__tests__/builtin-session-select.test.ts +116 -116
  32. package/src/__tests__/builtin-sigint.test.ts +56 -56
  33. package/src/__tests__/builtin-skills.test.ts +284 -284
  34. package/src/__tests__/builtin-web-tools.test.ts +220 -220
  35. package/src/__tests__/card-action-routing.test.ts +18 -18
  36. package/src/__tests__/cardkit.test.ts +60 -60
  37. package/src/__tests__/ccc-adapter.test.ts +170 -170
  38. package/src/__tests__/chatgpt-subscription-rpc.test.ts +89 -89
  39. package/src/__tests__/chatgpt-subscription.test.ts +135 -135
  40. package/src/__tests__/chrome-devtools-guard.test.ts +165 -165
  41. package/src/__tests__/claude-adapter.test.ts +614 -614
  42. package/src/__tests__/claude-raw-stream-log.test.ts +87 -87
  43. package/src/__tests__/codex-adapter.test.ts +58 -58
  44. package/src/__tests__/codex-raw-stream-log.test.ts +170 -170
  45. package/src/__tests__/codex-reset-actions.test.ts +146 -146
  46. package/src/__tests__/cursor-adapter.test.ts +268 -268
  47. package/src/__tests__/feishu-api.test.ts +60 -60
  48. package/src/__tests__/feishu-avatar.test.ts +164 -164
  49. package/src/__tests__/feishu-message-ingress.test.ts +138 -138
  50. package/src/__tests__/feishu-platform.test.ts +22 -22
  51. package/src/__tests__/format-message.test.ts +47 -47
  52. package/src/__tests__/jsonl-stream.test.ts +79 -79
  53. package/src/__tests__/package-files.test.ts +24 -24
  54. package/src/__tests__/privacy.test.ts +198 -198
  55. package/src/__tests__/progress-reducer.test.ts +121 -121
  56. package/src/__tests__/raw-stream-log.test.ts +106 -106
  57. package/src/__tests__/response-stall.test.ts +49 -49
  58. package/src/__tests__/restart.test.ts +132 -132
  59. package/src/__tests__/session.test.ts +199 -199
  60. package/src/__tests__/shared-prefix.test.ts +36 -36
  61. package/src/__tests__/sim-platform.test.ts +16 -16
  62. package/src/__tests__/startup-lifecycle.test.ts +231 -231
  63. package/src/__tests__/stop-session.test.ts +34 -34
  64. package/src/__tests__/stream-state.test.ts +42 -42
  65. package/src/__tests__/terminal-error.test.ts +54 -54
  66. package/src/__tests__/terminal-renderer.test.ts +247 -247
  67. package/src/__tests__/update-command-guard.test.ts +144 -144
  68. package/src/__tests__/web-ui.test.ts +326 -326
  69. package/src/adapters/adapter-interface.ts +33 -33
  70. package/src/adapters/ccc-adapter.ts +141 -141
  71. package/src/adapters/claude-adapter.ts +620 -620
  72. package/src/adapters/claude-session-meta-store.ts +120 -120
  73. package/src/adapters/codex-adapter.ts +426 -426
  74. package/src/adapters/cursor-adapter.ts +681 -681
  75. package/src/adapters/jsonl-stream.ts +157 -157
  76. package/src/adapters/raw-stream-log.ts +124 -124
  77. package/src/adapters/resource-monitor.ts +140 -140
  78. package/src/agent-activity.ts +175 -175
  79. package/src/agent-delegate-task-rpc.ts +153 -153
  80. package/src/agent-delegate-task.ts +91 -91
  81. package/src/agent-reload-config-rpc.ts +34 -34
  82. package/src/agent-stop-stuck.ts +129 -129
  83. package/src/builtin/cli.ts +6 -0
  84. package/src/builtin/config.ts +84 -84
  85. package/src/builtin/context.ts +465 -391
  86. package/src/builtin/file-log.ts +38 -38
  87. package/src/builtin/file-tools.ts +34 -0
  88. package/src/builtin/index.ts +24 -23
  89. package/src/builtin/proc-tree-kill.ts +61 -61
  90. package/src/builtin/progress/cards-helpers.ts +76 -76
  91. package/src/builtin/progress/reducer.ts +113 -113
  92. package/src/builtin/progress/terminal-renderer.ts +294 -294
  93. package/src/builtin/progress/view.ts +77 -77
  94. package/src/builtin/raw-stream-log.ts +124 -124
  95. package/src/builtin/session-search.ts +363 -0
  96. package/src/builtin/session-select.ts +48 -48
  97. package/src/builtin/sigint.ts +50 -50
  98. package/src/builtin/skills.ts +205 -205
  99. package/src/builtin/web-tools.ts +313 -313
  100. package/src/card-action-routing.ts +14 -14
  101. package/src/chatgpt-subscription-rpc.ts +27 -27
  102. package/src/chatgpt-subscription.ts +299 -299
  103. package/src/chrome-devtools-guard.ts +318 -318
  104. package/src/codex-reset-actions.ts +184 -184
  105. package/src/feishu-api.ts +193 -193
  106. package/src/feishu-message-ingress.ts +195 -195
  107. package/src/feishu-platform.ts +20 -20
  108. package/src/format-message.ts +293 -293
  109. package/src/litellm-proxy.ts +374 -374
  110. package/src/orchestrator.ts +2494 -2494
  111. package/src/platform-adapter.ts +6 -6
  112. package/src/privacy.ts +118 -118
  113. package/src/progress/reducer.ts +113 -113
  114. package/src/progress/terminal-renderer.ts +294 -294
  115. package/src/progress/view.ts +77 -77
  116. package/src/response-stall.ts +28 -28
  117. package/src/runtime-reload.ts +34 -34
  118. package/src/session-chat-binding.ts +82 -82
  119. package/src/session-name.ts +8 -8
  120. package/src/session.ts +201 -201
  121. package/src/shared-prefix.ts +29 -29
  122. package/src/sim-platform.ts +20 -20
  123. package/src/startup-lifecycle.ts +250 -250
  124. package/src/stream-state.ts +21 -21
  125. package/src/terminal-error.ts +129 -129
  126. package/src/turn-cards.ts +117 -117
  127. package/src/update-command-guard.ts +165 -165
@@ -1,293 +1,293 @@
1
- /**
2
- * format-message.ts — 飞书消息内容格式化
3
- *
4
- * 从 index.ts 中提取,独立模块便于测试。
5
- */
6
-
7
- import { cardJsonToPlainText } from "./card-plain-text.ts";
8
- import { ts } from "./config.ts";
9
- import {
10
- getTenantAccessToken,
11
- getOrDownloadImage,
12
- getMergeForwardMessages,
13
- } from "./feishu-platform.ts";
14
-
15
- /**
16
- * 根据消息类型格式化消息内容为可读文本。
17
- */
18
- export async function formatMessageContent(message: {
19
- message_id?: string;
20
- message_type?: string;
21
- content?: string;
22
- }): Promise<string> {
23
- const contentStr = message.content ?? "{}";
24
- let content: Record<string, unknown>;
25
- try { content = JSON.parse(contentStr); } catch {
26
- // merge_forward 消息的 content 可能为空字符串,但可通过 message_id 调 API 获取子消息
27
- if (message.message_type === "merge_forward") {
28
- content = {};
29
- } else {
30
- return "";
31
- }
32
- }
33
-
34
- if (message.message_type === "text") {
35
- let text = (content.text ?? "") as string;
36
- text = text.replace(/<\/?p[^>]*>/gi, "");
37
- text = text.replace(/<br\s*\/?>/gi, "\n");
38
- text = text.replace(/&nbsp;/gi, " ");
39
- return text.trim();
40
- }
41
-
42
- if (message.message_type === "post") {
43
- return formatPostContentWithImages(content, message.message_id);
44
- }
45
-
46
- if (message.message_type === "image") {
47
- const imageKey = content.image_key as string | undefined;
48
- const messageId = message.message_id;
49
- if (!imageKey || !messageId) return contentStr;
50
- try {
51
- const token = await getTenantAccessToken();
52
- const localPath = await getOrDownloadImage(token, messageId, imageKey);
53
- return `[图片] ${localPath}`;
54
- } catch (err) {
55
- console.error(
56
- `[${ts()}] [IMAGE] download failed for ${imageKey}: ${(err as Error).message}`,
57
- );
58
- return `[图片: ${imageKey}]`;
59
- }
60
- }
61
-
62
- if (message.message_type === "media") {
63
- const fileKey = content.file_key as string | undefined;
64
- const fileName = (content.file_name as string) || "video.mp4";
65
- const messageId = message.message_id;
66
- if (!fileKey || !messageId) return contentStr;
67
- return `[视频] message_id=${messageId} file_key=${fileKey} file_name=${fileName}`;
68
- }
69
-
70
- if (message.message_type === "file") {
71
- const fileKey = content.file_key as string | undefined;
72
- const fileName = (content.file_name as string) || "download.bin";
73
- const messageId = message.message_id;
74
- if (!fileKey || !messageId) return contentStr;
75
- return `[文件] message_id=${messageId} file_key=${fileKey} file_name=${fileName}`;
76
- }
77
-
78
- if (message.message_type === "interactive") {
79
- const raw = JSON.stringify(content);
80
- const text = cardJsonToPlainText(raw);
81
- if (text) return `[卡片] ${text}`;
82
- return contentStr;
83
- }
84
-
85
- if (message.message_type === "merge_forward") {
86
- return formatMergeForward(message.message_id ?? "", content);
87
- }
88
-
89
- // 其他类型(audio, sticker 等)直接给原始 JSON
90
- return contentStr;
91
- }
92
-
93
- export function formatPostContent(content: Record<string, unknown>): string {
94
- const paragraphs = getPostParagraphs(content);
95
- if (!Array.isArray(paragraphs)) return "";
96
-
97
- const parts: string[] = [];
98
- for (const line of paragraphs) {
99
- if (!Array.isArray(line)) continue;
100
- for (const elem of line) {
101
- const el = elem as Record<string, unknown>;
102
- if (!el || typeof el !== "object") continue;
103
- const text = formatPostTextElement(el);
104
- if (text) parts.push(text);
105
- }
106
- }
107
- return parts.join("\n").trim();
108
- }
109
-
110
- function getPostParagraphs(content: Record<string, unknown>): unknown[][] {
111
- const direct = content.content;
112
- if (Array.isArray(direct)) return direct as unknown[][];
113
-
114
- for (const locale of ["zh_cn", "en_us", "ja_jp"]) {
115
- const localized = content[locale] as Record<string, unknown> | undefined;
116
- if (localized && Array.isArray(localized.content)) {
117
- return localized.content as unknown[][];
118
- }
119
- }
120
-
121
- return [];
122
- }
123
-
124
- function formatPostTextElement(el: Record<string, unknown>): string {
125
- const t = typeof el.text === "string" ? el.text : "";
126
-
127
- if (el.tag === "code_block") {
128
- const lang = typeof el.language === "string" ? el.language : "";
129
- return "```" + lang + "\n" + t + "\n```";
130
- }
131
-
132
- if (el.tag === "p" || el.tag === "text") {
133
- return t;
134
- }
135
-
136
- return "";
137
- }
138
-
139
- function getPostImageKey(el: Record<string, unknown>): string | undefined {
140
- const imageKey = el.image_key;
141
- if (typeof imageKey === "string" && imageKey.trim()) return imageKey;
142
-
143
- if (el.tag === "img") {
144
- const fileKey = el.file_key;
145
- if (typeof fileKey === "string" && fileKey.trim()) return fileKey;
146
- }
147
-
148
- return undefined;
149
- }
150
-
151
- async function formatPostContentWithImages(
152
- content: Record<string, unknown>,
153
- messageId?: string,
154
- ): Promise<string> {
155
- const paragraphs = getPostParagraphs(content);
156
- if (!Array.isArray(paragraphs)) return "";
157
-
158
- const parts: string[] = [];
159
- for (const line of paragraphs) {
160
- if (!Array.isArray(line)) continue;
161
- for (const elem of line) {
162
- const el = elem as Record<string, unknown>;
163
- if (!el || typeof el !== "object") continue;
164
-
165
- const text = formatPostTextElement(el);
166
- if (text) parts.push(text);
167
-
168
- const imageKey = getPostImageKey(el);
169
- if (imageKey) {
170
- parts.push(await formatPostImageElement(messageId, imageKey));
171
- }
172
- }
173
- }
174
- return parts.join("\n").trim();
175
- }
176
-
177
- async function formatPostImageElement(
178
- messageId: string | undefined,
179
- imageKey: string,
180
- ): Promise<string> {
181
- if (!messageId) return `[图片: ${imageKey}]`;
182
-
183
- try {
184
- const token = await getTenantAccessToken();
185
- const localPath = await getOrDownloadImage(token, messageId, imageKey);
186
- return `[图片] ${localPath}`;
187
- } catch (err) {
188
- console.error(
189
- `[${ts()}] [IMAGE] download failed for post image ${imageKey}: ${(err as Error).message}`,
190
- );
191
- return `[图片: ${imageKey}]`;
192
- }
193
- }
194
-
195
- // ---------------------------------------------------------------------------
196
- // 合并转发消息格式化
197
- // ---------------------------------------------------------------------------
198
-
199
- /**
200
- * 格式化合并转发消息。
201
- *
202
- * 三阶段降级策略:
203
- * 1. 调用 GET /im/v1/messages/{messageId} 获取完整子消息列表
204
- * 2. API 失败时降级使用 content.preview 字段
205
- * 3. preview 也为空时返回原始 JSON
206
- *
207
- * 递归深度限制 MAX_DEPTH=3,避免嵌套合并转发 API 爆炸。
208
- */
209
- export async function formatMergeForward(
210
- messageId: string,
211
- content: Record<string, unknown>,
212
- depth: number = 0,
213
- ): Promise<string> {
214
- const MAX_DEPTH = 3;
215
- if (depth >= MAX_DEPTH) {
216
- return `[合并转发: 超出最大嵌套深度 ${MAX_DEPTH}]`;
217
- }
218
-
219
- const title = (content.title as string) || "聊天记录";
220
- const chatName = (content.chat_name as string) || "";
221
- const header = `[合并转发: ${title}${chatName ? ` (${chatName})` : ""}]`;
222
-
223
- // 从 preview 构建 sender ID → name 映射表
224
- const senderNameMap = new Map<string, string>();
225
- const preview = content.preview;
226
- if (Array.isArray(preview)) {
227
- for (const entry of preview) {
228
- const e = entry as Record<string, unknown>;
229
- const s = e.sender as Record<string, unknown> | undefined;
230
- if (s && typeof s.id === "string" && typeof s.name === "string") {
231
- senderNameMap.set(s.id, s.name);
232
- }
233
- }
234
- }
235
-
236
- const lines: string[] = [];
237
- let usedApi = false;
238
-
239
- // Phase 1: 尝试通过 API 获取完整子消息列表
240
- try {
241
- const token = await getTenantAccessToken();
242
- const items = await getMergeForwardMessages(token, messageId);
243
-
244
- // 跳过第一个 item(合并转发消息自身,无 upper_message_id)
245
- const subItems = items.filter((item) => item.upper_message_id);
246
-
247
- if (subItems.length > 0) {
248
- for (const item of subItems) {
249
- const senderId = item.sender?.id ?? "unknown";
250
- const senderName = senderNameMap.get(senderId) ?? senderId;
251
-
252
- const subMsgType = item.msg_type ?? "";
253
- const subContent = item.body?.content ?? "{}";
254
-
255
- try {
256
- const formatted = await formatMessageContent({
257
- message_id: item.message_id,
258
- message_type: subMsgType,
259
- content: subContent,
260
- });
261
- lines.push(`${senderName}: ${formatted}`);
262
- } catch {
263
- lines.push(`${senderName}: ${subContent}`);
264
- }
265
- }
266
- usedApi = true;
267
- }
268
- } catch (err) {
269
- console.error(
270
- `[${ts()}] [MERGE_FORWARD] API 获取子消息失败 (${messageId}), 降级使用 preview: ${(err as Error).message}`,
271
- );
272
- }
273
-
274
- // Phase 2: API 失败或返回空时降级使用 preview
275
- if (!usedApi) {
276
- if (Array.isArray(preview) && preview.length > 0) {
277
- for (const entry of preview) {
278
- const e = entry as Record<string, unknown>;
279
- const s = e.sender as Record<string, unknown> | undefined;
280
- const senderName = (s?.name as string) ?? "未知用户";
281
- const text = (e.content as string) ?? "";
282
- lines.push(`${senderName}: ${text}`);
283
- }
284
- }
285
- }
286
-
287
- // Phase 3: 没有任何内容时返回原始 JSON
288
- if (lines.length === 0) {
289
- return JSON.stringify(content);
290
- }
291
-
292
- return header + "\n" + lines.join("\n");
293
- }
1
+ /**
2
+ * format-message.ts — 飞书消息内容格式化
3
+ *
4
+ * 从 index.ts 中提取,独立模块便于测试。
5
+ */
6
+
7
+ import { cardJsonToPlainText } from "./card-plain-text.ts";
8
+ import { ts } from "./config.ts";
9
+ import {
10
+ getTenantAccessToken,
11
+ getOrDownloadImage,
12
+ getMergeForwardMessages,
13
+ } from "./feishu-platform.ts";
14
+
15
+ /**
16
+ * 根据消息类型格式化消息内容为可读文本。
17
+ */
18
+ export async function formatMessageContent(message: {
19
+ message_id?: string;
20
+ message_type?: string;
21
+ content?: string;
22
+ }): Promise<string> {
23
+ const contentStr = message.content ?? "{}";
24
+ let content: Record<string, unknown>;
25
+ try { content = JSON.parse(contentStr); } catch {
26
+ // merge_forward 消息的 content 可能为空字符串,但可通过 message_id 调 API 获取子消息
27
+ if (message.message_type === "merge_forward") {
28
+ content = {};
29
+ } else {
30
+ return "";
31
+ }
32
+ }
33
+
34
+ if (message.message_type === "text") {
35
+ let text = (content.text ?? "") as string;
36
+ text = text.replace(/<\/?p[^>]*>/gi, "");
37
+ text = text.replace(/<br\s*\/?>/gi, "\n");
38
+ text = text.replace(/&nbsp;/gi, " ");
39
+ return text.trim();
40
+ }
41
+
42
+ if (message.message_type === "post") {
43
+ return formatPostContentWithImages(content, message.message_id);
44
+ }
45
+
46
+ if (message.message_type === "image") {
47
+ const imageKey = content.image_key as string | undefined;
48
+ const messageId = message.message_id;
49
+ if (!imageKey || !messageId) return contentStr;
50
+ try {
51
+ const token = await getTenantAccessToken();
52
+ const localPath = await getOrDownloadImage(token, messageId, imageKey);
53
+ return `[图片] ${localPath}`;
54
+ } catch (err) {
55
+ console.error(
56
+ `[${ts()}] [IMAGE] download failed for ${imageKey}: ${(err as Error).message}`,
57
+ );
58
+ return `[图片: ${imageKey}]`;
59
+ }
60
+ }
61
+
62
+ if (message.message_type === "media") {
63
+ const fileKey = content.file_key as string | undefined;
64
+ const fileName = (content.file_name as string) || "video.mp4";
65
+ const messageId = message.message_id;
66
+ if (!fileKey || !messageId) return contentStr;
67
+ return `[视频] message_id=${messageId} file_key=${fileKey} file_name=${fileName}`;
68
+ }
69
+
70
+ if (message.message_type === "file") {
71
+ const fileKey = content.file_key as string | undefined;
72
+ const fileName = (content.file_name as string) || "download.bin";
73
+ const messageId = message.message_id;
74
+ if (!fileKey || !messageId) return contentStr;
75
+ return `[文件] message_id=${messageId} file_key=${fileKey} file_name=${fileName}`;
76
+ }
77
+
78
+ if (message.message_type === "interactive") {
79
+ const raw = JSON.stringify(content);
80
+ const text = cardJsonToPlainText(raw);
81
+ if (text) return `[卡片] ${text}`;
82
+ return contentStr;
83
+ }
84
+
85
+ if (message.message_type === "merge_forward") {
86
+ return formatMergeForward(message.message_id ?? "", content);
87
+ }
88
+
89
+ // 其他类型(audio, sticker 等)直接给原始 JSON
90
+ return contentStr;
91
+ }
92
+
93
+ export function formatPostContent(content: Record<string, unknown>): string {
94
+ const paragraphs = getPostParagraphs(content);
95
+ if (!Array.isArray(paragraphs)) return "";
96
+
97
+ const parts: string[] = [];
98
+ for (const line of paragraphs) {
99
+ if (!Array.isArray(line)) continue;
100
+ for (const elem of line) {
101
+ const el = elem as Record<string, unknown>;
102
+ if (!el || typeof el !== "object") continue;
103
+ const text = formatPostTextElement(el);
104
+ if (text) parts.push(text);
105
+ }
106
+ }
107
+ return parts.join("\n").trim();
108
+ }
109
+
110
+ function getPostParagraphs(content: Record<string, unknown>): unknown[][] {
111
+ const direct = content.content;
112
+ if (Array.isArray(direct)) return direct as unknown[][];
113
+
114
+ for (const locale of ["zh_cn", "en_us", "ja_jp"]) {
115
+ const localized = content[locale] as Record<string, unknown> | undefined;
116
+ if (localized && Array.isArray(localized.content)) {
117
+ return localized.content as unknown[][];
118
+ }
119
+ }
120
+
121
+ return [];
122
+ }
123
+
124
+ function formatPostTextElement(el: Record<string, unknown>): string {
125
+ const t = typeof el.text === "string" ? el.text : "";
126
+
127
+ if (el.tag === "code_block") {
128
+ const lang = typeof el.language === "string" ? el.language : "";
129
+ return "```" + lang + "\n" + t + "\n```";
130
+ }
131
+
132
+ if (el.tag === "p" || el.tag === "text") {
133
+ return t;
134
+ }
135
+
136
+ return "";
137
+ }
138
+
139
+ function getPostImageKey(el: Record<string, unknown>): string | undefined {
140
+ const imageKey = el.image_key;
141
+ if (typeof imageKey === "string" && imageKey.trim()) return imageKey;
142
+
143
+ if (el.tag === "img") {
144
+ const fileKey = el.file_key;
145
+ if (typeof fileKey === "string" && fileKey.trim()) return fileKey;
146
+ }
147
+
148
+ return undefined;
149
+ }
150
+
151
+ async function formatPostContentWithImages(
152
+ content: Record<string, unknown>,
153
+ messageId?: string,
154
+ ): Promise<string> {
155
+ const paragraphs = getPostParagraphs(content);
156
+ if (!Array.isArray(paragraphs)) return "";
157
+
158
+ const parts: string[] = [];
159
+ for (const line of paragraphs) {
160
+ if (!Array.isArray(line)) continue;
161
+ for (const elem of line) {
162
+ const el = elem as Record<string, unknown>;
163
+ if (!el || typeof el !== "object") continue;
164
+
165
+ const text = formatPostTextElement(el);
166
+ if (text) parts.push(text);
167
+
168
+ const imageKey = getPostImageKey(el);
169
+ if (imageKey) {
170
+ parts.push(await formatPostImageElement(messageId, imageKey));
171
+ }
172
+ }
173
+ }
174
+ return parts.join("\n").trim();
175
+ }
176
+
177
+ async function formatPostImageElement(
178
+ messageId: string | undefined,
179
+ imageKey: string,
180
+ ): Promise<string> {
181
+ if (!messageId) return `[图片: ${imageKey}]`;
182
+
183
+ try {
184
+ const token = await getTenantAccessToken();
185
+ const localPath = await getOrDownloadImage(token, messageId, imageKey);
186
+ return `[图片] ${localPath}`;
187
+ } catch (err) {
188
+ console.error(
189
+ `[${ts()}] [IMAGE] download failed for post image ${imageKey}: ${(err as Error).message}`,
190
+ );
191
+ return `[图片: ${imageKey}]`;
192
+ }
193
+ }
194
+
195
+ // ---------------------------------------------------------------------------
196
+ // 合并转发消息格式化
197
+ // ---------------------------------------------------------------------------
198
+
199
+ /**
200
+ * 格式化合并转发消息。
201
+ *
202
+ * 三阶段降级策略:
203
+ * 1. 调用 GET /im/v1/messages/{messageId} 获取完整子消息列表
204
+ * 2. API 失败时降级使用 content.preview 字段
205
+ * 3. preview 也为空时返回原始 JSON
206
+ *
207
+ * 递归深度限制 MAX_DEPTH=3,避免嵌套合并转发 API 爆炸。
208
+ */
209
+ export async function formatMergeForward(
210
+ messageId: string,
211
+ content: Record<string, unknown>,
212
+ depth: number = 0,
213
+ ): Promise<string> {
214
+ const MAX_DEPTH = 3;
215
+ if (depth >= MAX_DEPTH) {
216
+ return `[合并转发: 超出最大嵌套深度 ${MAX_DEPTH}]`;
217
+ }
218
+
219
+ const title = (content.title as string) || "聊天记录";
220
+ const chatName = (content.chat_name as string) || "";
221
+ const header = `[合并转发: ${title}${chatName ? ` (${chatName})` : ""}]`;
222
+
223
+ // 从 preview 构建 sender ID → name 映射表
224
+ const senderNameMap = new Map<string, string>();
225
+ const preview = content.preview;
226
+ if (Array.isArray(preview)) {
227
+ for (const entry of preview) {
228
+ const e = entry as Record<string, unknown>;
229
+ const s = e.sender as Record<string, unknown> | undefined;
230
+ if (s && typeof s.id === "string" && typeof s.name === "string") {
231
+ senderNameMap.set(s.id, s.name);
232
+ }
233
+ }
234
+ }
235
+
236
+ const lines: string[] = [];
237
+ let usedApi = false;
238
+
239
+ // Phase 1: 尝试通过 API 获取完整子消息列表
240
+ try {
241
+ const token = await getTenantAccessToken();
242
+ const items = await getMergeForwardMessages(token, messageId);
243
+
244
+ // 跳过第一个 item(合并转发消息自身,无 upper_message_id)
245
+ const subItems = items.filter((item) => item.upper_message_id);
246
+
247
+ if (subItems.length > 0) {
248
+ for (const item of subItems) {
249
+ const senderId = item.sender?.id ?? "unknown";
250
+ const senderName = senderNameMap.get(senderId) ?? senderId;
251
+
252
+ const subMsgType = item.msg_type ?? "";
253
+ const subContent = item.body?.content ?? "{}";
254
+
255
+ try {
256
+ const formatted = await formatMessageContent({
257
+ message_id: item.message_id,
258
+ message_type: subMsgType,
259
+ content: subContent,
260
+ });
261
+ lines.push(`${senderName}: ${formatted}`);
262
+ } catch {
263
+ lines.push(`${senderName}: ${subContent}`);
264
+ }
265
+ }
266
+ usedApi = true;
267
+ }
268
+ } catch (err) {
269
+ console.error(
270
+ `[${ts()}] [MERGE_FORWARD] API 获取子消息失败 (${messageId}), 降级使用 preview: ${(err as Error).message}`,
271
+ );
272
+ }
273
+
274
+ // Phase 2: API 失败或返回空时降级使用 preview
275
+ if (!usedApi) {
276
+ if (Array.isArray(preview) && preview.length > 0) {
277
+ for (const entry of preview) {
278
+ const e = entry as Record<string, unknown>;
279
+ const s = e.sender as Record<string, unknown> | undefined;
280
+ const senderName = (s?.name as string) ?? "未知用户";
281
+ const text = (e.content as string) ?? "";
282
+ lines.push(`${senderName}: ${text}`);
283
+ }
284
+ }
285
+ }
286
+
287
+ // Phase 3: 没有任何内容时返回原始 JSON
288
+ if (lines.length === 0) {
289
+ return JSON.stringify(content);
290
+ }
291
+
292
+ return header + "\n" + lines.join("\n");
293
+ }