chatccc 0.2.231 → 0.2.233

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 (130) 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__/crash-logging.test.ts +95 -1
  47. package/src/__tests__/cursor-adapter.test.ts +268 -268
  48. package/src/__tests__/feishu-api.test.ts +60 -60
  49. package/src/__tests__/feishu-avatar.test.ts +164 -164
  50. package/src/__tests__/feishu-message-ingress.test.ts +138 -138
  51. package/src/__tests__/feishu-platform.test.ts +22 -22
  52. package/src/__tests__/format-message.test.ts +47 -47
  53. package/src/__tests__/jsonl-stream.test.ts +79 -79
  54. package/src/__tests__/package-files.test.ts +24 -24
  55. package/src/__tests__/privacy.test.ts +198 -198
  56. package/src/__tests__/progress-reducer.test.ts +121 -121
  57. package/src/__tests__/raw-stream-log.test.ts +106 -106
  58. package/src/__tests__/response-stall.test.ts +49 -49
  59. package/src/__tests__/restart.test.ts +55 -10
  60. package/src/__tests__/session.test.ts +199 -199
  61. package/src/__tests__/shared-prefix.test.ts +36 -36
  62. package/src/__tests__/sim-platform.test.ts +16 -16
  63. package/src/__tests__/startup-lifecycle.test.ts +231 -231
  64. package/src/__tests__/stop-session.test.ts +34 -34
  65. package/src/__tests__/stream-state.test.ts +42 -42
  66. package/src/__tests__/terminal-error.test.ts +54 -54
  67. package/src/__tests__/terminal-renderer.test.ts +247 -247
  68. package/src/__tests__/update-command-guard.test.ts +144 -144
  69. package/src/__tests__/web-ui.test.ts +326 -326
  70. package/src/adapters/adapter-interface.ts +33 -33
  71. package/src/adapters/ccc-adapter.ts +141 -141
  72. package/src/adapters/claude-adapter.ts +620 -620
  73. package/src/adapters/claude-session-meta-store.ts +120 -120
  74. package/src/adapters/codex-adapter.ts +426 -426
  75. package/src/adapters/cursor-adapter.ts +681 -681
  76. package/src/adapters/jsonl-stream.ts +157 -157
  77. package/src/adapters/raw-stream-log.ts +124 -124
  78. package/src/adapters/resource-monitor.ts +140 -140
  79. package/src/agent-activity.ts +175 -175
  80. package/src/agent-delegate-task-rpc.ts +153 -153
  81. package/src/agent-delegate-task.ts +91 -91
  82. package/src/agent-reload-config-rpc.ts +34 -34
  83. package/src/agent-stop-stuck.ts +129 -129
  84. package/src/builtin/cli.ts +6 -0
  85. package/src/builtin/config.ts +84 -84
  86. package/src/builtin/context.ts +465 -391
  87. package/src/builtin/file-log.ts +38 -38
  88. package/src/builtin/file-tools.ts +34 -0
  89. package/src/builtin/index.ts +24 -23
  90. package/src/builtin/proc-tree-kill.ts +61 -61
  91. package/src/builtin/progress/cards-helpers.ts +76 -76
  92. package/src/builtin/progress/reducer.ts +113 -113
  93. package/src/builtin/progress/terminal-renderer.ts +294 -294
  94. package/src/builtin/progress/view.ts +77 -77
  95. package/src/builtin/raw-stream-log.ts +124 -124
  96. package/src/builtin/session-search.ts +363 -0
  97. package/src/builtin/session-select.ts +48 -48
  98. package/src/builtin/sigint.ts +50 -50
  99. package/src/builtin/skills.ts +205 -205
  100. package/src/builtin/web-tools.ts +313 -313
  101. package/src/card-action-routing.ts +14 -14
  102. package/src/chatgpt-subscription-rpc.ts +27 -27
  103. package/src/chatgpt-subscription.ts +299 -299
  104. package/src/chrome-devtools-guard.ts +318 -318
  105. package/src/codex-reset-actions.ts +184 -184
  106. package/src/feishu-api.ts +193 -193
  107. package/src/feishu-message-ingress.ts +195 -195
  108. package/src/feishu-platform.ts +20 -20
  109. package/src/format-message.ts +293 -293
  110. package/src/index.ts +6 -1
  111. package/src/litellm-proxy.ts +374 -374
  112. package/src/orchestrator.ts +36 -13
  113. package/src/platform-adapter.ts +6 -6
  114. package/src/privacy.ts +118 -118
  115. package/src/progress/reducer.ts +113 -113
  116. package/src/progress/terminal-renderer.ts +294 -294
  117. package/src/progress/view.ts +77 -77
  118. package/src/response-stall.ts +28 -28
  119. package/src/runtime-reload.ts +34 -34
  120. package/src/session-chat-binding.ts +82 -82
  121. package/src/session-name.ts +8 -8
  122. package/src/session.ts +201 -201
  123. package/src/shared-prefix.ts +29 -29
  124. package/src/shared.ts +44 -0
  125. package/src/sim-platform.ts +20 -20
  126. package/src/startup-lifecycle.ts +250 -250
  127. package/src/stream-state.ts +21 -21
  128. package/src/terminal-error.ts +129 -129
  129. package/src/turn-cards.ts +117 -117
  130. 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
+ }
package/src/index.ts CHANGED
@@ -27,7 +27,7 @@ import { createServer, type IncomingMessage, type Server, type ServerResponse }
27
27
  import { WSClient, EventDispatcher, Domain } from "@larksuiteoapi/node-sdk";
28
28
  import WebSocket from "ws";
29
29
 
30
- import { appendStartupTrace, attachRelayWebSocket, ensureSingleInstance, freeRelayListenPort, installCrashLogging, waitForPortFree } from "./shared.ts";
30
+ import { appendStartupTrace, attachRelayWebSocket, ensureSingleInstance, freeRelayListenPort, installCrashLogging, installEpipeGuard, waitForPortFree } from "./shared.ts";
31
31
  import { createUiRouter, setExtraApiHandler, setReloadConfigHook, startSetupMode } from "./web-ui.ts";
32
32
  import {
33
33
  buildWebUiUrl,
@@ -804,6 +804,11 @@ async function main(): Promise<void> {
804
804
  onBeforeExit: (code) => serviceLifecycle.handleBeforeExit(code),
805
805
  });
806
806
 
807
+ // stdout/stderr 管道读端消失(如 /restart 旧进程退出后)时,第三方 SDK 写
808
+ // stderr 会 EPIPE;无监听会抛 uncaughtException 杀死整个服务。挂守卫把这类
809
+ // IO 错误降级为一条非致命 trace。
810
+ installEpipeGuard();
811
+
807
812
  // 模拟模式:独立端口 18079,不与 SDK 实例冲突,不走飞书凭证/权限/WSClient
808
813
  if (USE_SIMULATE) {
809
814
  const SIM_PORT = 18079;