@xmanrui/dsh-im 1.2.0 → 1.4.0

package/src/channels/feishu/bridge.mjs

@@ -12,6 +12,10 @@ import {
   imagePromptUserMessage,
   promptContentForMessage,
 } from '../shared/image-prompt.mjs';
+import {
+  hasInboundFiles,
+  inboundFileUserMessage,
+} from '../shared/inbound-file.mjs';
 import {
   harnessAnswerForQuestion,
   harnessQuestionText,
@@ -91,7 +95,7 @@ const REPAIR_URL_HOSTS = new Set([
 const HELP_TEXT = [
   '北汇星河 AIOS 已连接 DeepSeek Harness。',
   '',
-  '直接发送文字或图片即可继续当前会话。',
+  '直接发送文字、图片或文件即可继续当前会话。',
   '/new  开启一个全新会话',
   '/compact  压缩当前会话的较早上下文',
   '/workspace 工作区绝对路径  切换工作区',
@@ -431,7 +435,7 @@ export class FeishuHarnessBridge {
     const processingReaction = this.#addReaction(messageId, 'OnIt');
     const commandMessage = extractInboundMessage(event, this.#client);
     const commandText = nonEmptyString(commandMessage.content) ?? '';
-    const commandRunner = isControlCommand(commandText)
+    const commandRunner = hasInboundFiles(commandMessage) ? null : isControlCommand(commandText)
       ? runControlCommand
       : (isModelCommand(commandText)
           ? runModelCommand
@@ -610,7 +614,8 @@ export class FeishuHarnessBridge {
     await this.#finishReaction(messageId, processingReaction, 'ERROR');
     await this.#send(
       event.message.chat_id,
-      imagePromptUserMessage(error)
+      inboundFileUserMessage(error)
+        ?? imagePromptUserMessage(error)
         ?? '处理失败，请稍后重试。如果问题持续，请在 DeepSeek Harness 的飞书插件页面检查连接状态。',
     ).catch(() => undefined);
   }
@@ -641,6 +646,7 @@ export class FeishuHarnessBridge {
       {
         signal: this.#signal,
         hasImages: hasInboundImages(message),
+        hasFiles: hasInboundFiles(message),
         pendingInteraction: this.#pendingInteractions.has(key)
           || this.#approvals.hasPending(key),
         control: { owner: this, key },
@@ -671,9 +677,10 @@ export class FeishuHarnessBridge {
     const message = extractInboundMessage(event, this.#client);
     const text = message.content;
     const hasImages = hasInboundImages(message);
-    const commandText = event.message.message_type === 'text' && !hasImages ? text : null;
-    if (!text && !hasImages) {
-      await this.#send(event.message.chat_id, '目前支持文字和图片消息。');
+    const hasFiles = hasInboundFiles(message);
+    const commandText = event.message.message_type === 'text' && !hasImages && !hasFiles ? text : null;
+    if (!text && !hasImages && !hasFiles) {
+      await this.#send(event.message.chat_id, '目前支持文字、图片和文件消息。');
       return;
     }
 
@@ -1603,7 +1610,7 @@ export class FeishuHarnessBridge {
     }
   }
 
-  #interactionAskOptions(event, key) {
+  #interactionAskOptions(event, key, files) {
     return {
       timeoutMs: this.#replyTimeoutMs,
       signal: this.#signal,
@@ -1615,6 +1622,7 @@ export class FeishuHarnessBridge {
         requiresMention: event.message.chat_type !== 'p2p',
       }),
       onInteractionResolved: (resolution) => this.#handleInteractionResolved(resolution),
+      files,
     };
   }
 
@@ -1709,7 +1717,7 @@ export class FeishuHarnessBridge {
         content,
         createOptions: { signal: this.#signal },
         existsOptions: { signal: this.#signal },
-        askOptions: this.#interactionAskOptions(event, key),
+        askOptions: this.#interactionAskOptions(event, key, message.files),
       });
       let textReceipt;
       let textSendError = null;
@@ -1749,7 +1757,7 @@ export class FeishuHarnessBridge {
         markdown: async (controller) => {
           promptStarted = true;
           const askOptions = {
-            ...this.#interactionAskOptions(event, key),
+            ...this.#interactionAskOptions(event, key, message.files),
             onUpdate: async (update) => {
               await controller.setContent(this.#progressText(update));
               this.#status.streamUpdates = (this.#status.streamUpdates ?? 0) + 1;
@@ -1821,7 +1829,7 @@ export class FeishuHarnessBridge {
         content,
         createOptions: { signal: this.#signal },
         existsOptions: { signal: this.#signal },
-        askOptions: this.#interactionAskOptions(event, key),
+        askOptions: this.#interactionAskOptions(event, key, message.files),
       });
       let textReceipt;
       let textSendError = null;

package/src/channels/feishu/message-utils.mjs

@@ -125,6 +125,31 @@ async function readBoundedStream(stream, { signal, maxBytes }) {
   }
 }
 
+async function readStream(stream, { signal }) {
+  if (!stream || typeof stream[Symbol.asyncIterator] !== 'function') {
+    throw new Error('Feishu file download returned no readable stream');
+  }
+  signal?.throwIfAborted();
+  const abort = () => stream.destroy?.(
+    signal.reason ?? new DOMException('Feishu file download aborted', 'AbortError'),
+  );
+  signal?.addEventListener('abort', abort, { once: true });
+  const chunks = [];
+  let size = 0;
+  try {
+    for await (const chunk of stream) {
+      signal?.throwIfAborted();
+      const data = Buffer.from(chunk);
+      size += data.length;
+      chunks.push(data);
+    }
+    signal?.throwIfAborted();
+    return Buffer.concat(chunks, size);
+  } finally {
+    signal?.removeEventListener('abort', abort);
+  }
+}
+
 function providerCode(value) {
   if (!value || typeof value !== 'object') return null;
   const code = value.code ?? value.error?.code;
@@ -232,6 +257,26 @@ function feishuImageSource(event, client, key) {
   };
 }
 
+function feishuFileSource(event, client, file) {
+  const key = nonEmptyString(file?.file_key);
+  if (!key) return null;
+  return {
+    name: nonEmptyString(file?.file_name) ?? 'file',
+    async load({ signal } = {}) {
+      signal?.throwIfAborted();
+      const resource = await client?.im?.v1?.messageResource?.get?.({
+        path: {
+          message_id: event.message.message_id,
+          file_key: key,
+        },
+        params: { type: 'file' },
+      });
+      signal?.throwIfAborted();
+      return readStream(resource?.getReadableStream?.(), { signal });
+    },
+  };
+}
+
 export function extractInboundMessage(event, client) {
   const messageType = event?.message?.message_type;
   const parsed = parsedMessageContent(event);
@@ -240,9 +285,11 @@ export function extractInboundMessage(event, client) {
     ? nonEmptyString(parsed?.image_key)
     : null;
   const imageKeys = standaloneImageKey ? [standaloneImageKey] : post?.imageKeys ?? [];
+  const file = messageType === 'file' ? feishuFileSource(event, client, parsed) : null;
   return {
     content: messageType === 'text' ? extractText(event) ?? '' : post?.text ?? '',
     images: imageKeys.map((key) => feishuImageSource(event, client, key)),
+    files: file ? [file] : [],
   };
 }
 

package/src/channels/qq/markdown-reply.mjs

@@ -0,0 +1,176 @@
+// QQ markdown 回复投递：长文尽量按结构边界切分，以 msg_type=2 发送，
+// 平台拒绝 markdown 时逐条回退纯文本。
+
+const DEFAULT_CHUNK_LIMIT = 4_500;
+const CODE_FENCE_OPEN = /^```/;
+const GFM_TABLE_LINE = /^\|.+\|$/;
+const PASSIVE_REPLY_LIMIT = Object.freeze({ c2c: 4, group: 5 });
+const PARTIAL_REPLY_NOTICE = '回答较长，后续内容未能通过 QQ 完整发送，请回复“继续”。';
+
+function safeSliceIndex(value, limit) {
+  let index = Math.min(limit, value.length);
+  const before = value.charCodeAt(index - 1);
+  const after = value.charCodeAt(index);
+  if (before >= 0xD800 && before <= 0xDBFF && after >= 0xDC00 && after <= 0xDFFF) {
+    index -= 1;
+  }
+  return Math.max(1, index);
+}
+
+/**
+ * 按换行边界切分 Markdown 文本：
+ * - 不在代码块中间断开；
+ * - 不在 GFM 表格中间断开；
+ * - 超长行在 limit 处硬切，避免单行超限无法投递。
+ */
+export function chunkMarkdownText(text, limit = DEFAULT_CHUNK_LIMIT) {
+  const value = typeof text === 'string' ? text : '';
+  const bound = Number.isInteger(limit) && limit > 0 ? limit : DEFAULT_CHUNK_LIMIT;
+  if (value.length <= bound) return value ? [value] : [];
+
+  const lines = value.split('\n');
+  const chunks = [];
+  let current = '';
+  let inCodeBlock = false;
+  let tableBuffer = [];
+
+  const appendBlock = (block) => {
+    if (block.length <= bound) {
+      if (!current) {
+        current = block;
+        return;
+      }
+      const candidate = `${current}\n${block}`;
+      if (candidate.length > bound) {
+        chunks.push(current);
+        current = block;
+      } else {
+        current = candidate;
+      }
+      return;
+    }
+    // 超大块：收束当前块后按 bound 硬切，保证每块可投递。
+    if (current) {
+      chunks.push(current);
+      current = '';
+    }
+    let remaining = block;
+    while (remaining.length > bound) {
+      const index = safeSliceIndex(remaining, bound);
+      chunks.push(remaining.slice(0, index));
+      remaining = remaining.slice(index);
+    }
+    current = remaining;
+  };
+
+  const flushTable = () => {
+    if (tableBuffer.length === 0) return;
+    const block = tableBuffer.join('\n');
+    tableBuffer = [];
+    appendBlock(block);
+  };
+
+  const appendLine = (line) => {
+    let remaining = line;
+    // 超长行先硬切，保证每块不超过 bound。
+    while (remaining.length > bound) {
+      if (current) {
+        chunks.push(current);
+        current = '';
+      }
+      const index = safeSliceIndex(remaining, bound);
+      chunks.push(remaining.slice(0, index));
+      remaining = remaining.slice(index);
+    }
+    appendBlock(remaining);
+  };
+
+  for (const line of lines) {
+    if (CODE_FENCE_OPEN.test(line)) {
+      flushTable();
+      if (!inCodeBlock && current) {
+        // 代码块开启：先收束当前块，让整个代码块从新块开始。
+        chunks.push(current);
+        current = '';
+      }
+      inCodeBlock = !inCodeBlock;
+      appendLine(line);
+      continue;
+    }
+    if (inCodeBlock) {
+      appendLine(line);
+      continue;
+    }
+    if (GFM_TABLE_LINE.test(line)) {
+      tableBuffer.push(line);
+      continue;
+    }
+    flushTable();
+    appendLine(line);
+  }
+
+  flushTable();
+  if (current) chunks.push(current);
+  return chunks;
+}
+
+function nextMsgSeq() {
+  // 与 SDK getNextMsgSeq 相同的随机策略：被动回复同 msg_id 的多条消息
+  // 各自带不同 msg_seq，避免平台去重（错误码 40054005）。
+  const timePart = Date.now() % 100_000_000;
+  const random = Math.floor(Math.random() * 65_536);
+  return (timePart ^ random) % 65_536;
+}
+
+/**
+ * 以 markdown（msg_type=2）发送回复；单条被平台拒绝时回退纯文本（msg_type=0）。
+ * 返回每条消息的平台响应，供调用方提取 provider message ids。
+ */
+export async function sendMarkdownReply(bot, target, text, { logger } = {}) {
+  const chunks = chunkMarkdownText(text);
+  const results = [];
+  const passiveLimit = target?.msgId ? PASSIVE_REPLY_LIMIT[target.scope] : null;
+  const overflow = passiveLimit !== null && chunks.length > passiveLimit;
+  const passiveContentCount = overflow ? passiveLimit - 1 : chunks.length;
+  const proactiveTarget = target?.msgId
+    ? { scope: target.scope, targetId: target.targetId }
+    : target;
+  let partialNoticeSent = false;
+
+  const sendPartialNotice = async () => {
+    if (partialNoticeSent || !target?.msgId) return;
+    partialNoticeSent = true;
+    try {
+      results.push(await bot.sendText(target, PARTIAL_REPLY_NOTICE));
+    } catch (error) {
+      logger?.warn?.('[dsh-im:qq] unable to send partial reply notice:', error);
+    }
+  };
+
+  for (const [index, chunk] of chunks.entries()) {
+    const deliveryTarget = overflow && index >= passiveContentCount
+      ? proactiveTarget
+      : target;
+    if (typeof bot?.send === 'function') {
+      try {
+        results.push(await bot.send({
+          target: deliveryTarget,
+          msgType: 2,
+          markdown: { content: chunk },
+          extra: { msg_seq: nextMsgSeq() },
+        }));
+        continue;
+      } catch (error) {
+        logger?.warn?.('[dsh-im:qq] markdown delivery failed; retrying as plain text:', error);
+      }
+    }
+    try {
+      results.push(await bot.sendText(deliveryTarget, chunk));
+    } catch (error) {
+      if (results.length === 0) throw error;
+      await sendPartialNotice();
+      break;
+    }
+  }
+  return results;
+}