@qihoo/tuitui-openclaw-channel 1.0.21 → 1.0.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qihoo/tuitui-openclaw-channel",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "maintainers": [
     {
       "name": "huzunjie",

package/src/channel.ts

@@ -8,7 +8,6 @@ import { setAccountEnabledInConfigSection, deleteAccountFromConfigSection } from
 import { CHANNEL_ID, CHANNEL_NAME } from "./const";
 import { handleInboundMessage } from './inbound';
 import {
-  checkAccount,
   sendTextMsg,
   sendPageMsg,
   sendMediaMsg,
@@ -189,7 +188,6 @@ export function createTuiTuiChannelPlugin(apiRuntime: any) {
 
       sendText: async ({ cfg, to, text, accountId, replyToId, threadId }: any) => {
         const account = resolveAccount(cfg, accountId);
-        checkAccount(account);
         
         const chatId = String(to || '').trim();
         const chatType = guessChatType(chatId);
@@ -202,8 +200,6 @@ export function createTuiTuiChannelPlugin(apiRuntime: any) {
 
       sendCustom: async ({ cfg, to, payload, accountId, account, chatType, groupId }: any) => {
         account = account || resolveAccount(cfg, accountId);
-        checkAccount(account, 'send custom message');
-
         // If it's a page message, we need to construct it
         if (payload?.msgtype !== 'page') {
           throw new Error(`[${CHANNEL_ID}] unsupported custom message type: ${payload?.msgtype}`);
@@ -217,7 +213,6 @@ export function createTuiTuiChannelPlugin(apiRuntime: any) {
 
       sendMedia: async ({ cfg, to, mediaUrl, accountId, account }: any) => {
         account = account || resolveAccount(cfg, accountId);
-        checkAccount(account, 'send media');
 
         const chatId = String(to || '').trim();
         // Determine if this is a group message based on 'to' being all digits (group) or not (direct)

package/src/deduplicator.ts

@@ -0,0 +1,121 @@
+export class StringDeduplicator {
+  private items = new Map<string, number>(); // 存储元素和其首次插入时间（秒级时间戳）
+  private readonly maxSize: number;
+  private readonly expireTime: number | null; // 过期时间（秒），null 表示永不过期
+
+  /**
+   * 字符串去重器
+   * @param maxSize - 最大缓存元素数量，默认1000
+   * @param expireTime - 过期时间（秒），默认null（永不过期）。例如：300表示5分钟
+   */
+  constructor(maxSize: number = 1000, expireTime: number | null = null) {
+    if (maxSize <= 0) {
+      throw new Error(`[StringDeduplicator] maxSize must be positive, got ${maxSize}`);
+    }
+    if (expireTime !== null && expireTime <= 0) {
+      throw new Error(`[StringDeduplicator] expireTime must be positive or null, got ${expireTime}`);
+    }
+    this.maxSize = maxSize;
+    this.expireTime = expireTime;
+  }
+
+  /**
+   * 检查并记录字符串
+   * @returns true 表示在有效时间内首次出现（可处理），false 表示重复或已过期
+   */
+  checkAndRecord(item: string): boolean {
+    if (item === undefined || item === null) {
+      throw new Error('[StringDeduplicator] item cannot be null or undefined');
+    }
+
+    const now = Date.now() / 1000; // 转换为秒级时间戳
+
+    // 检查是否已存在
+    const firstSeenTime = this.items.get(item);
+    if (firstSeenTime !== undefined) {
+      // 如果设置了过期时间，检查是否过期
+      if (this.expireTime !== null && now - firstSeenTime >= this.expireTime) {
+        // 已过期，移除旧记录，重新添加
+        this.items.delete(item);
+      } else if (this.expireTime === null || now - firstSeenTime < this.expireTime) {
+        // 未过期（或永不过期模式），重复
+        return false;
+      }
+    }
+
+    // 添加新记录
+    this.items.set(item, now);
+    this.enforceSizeLimit();
+    this.cleanupExpired();
+    return true; // 首次出现或已过期后重新出现
+  }
+
+  /**
+   * 清理过期的条目
+   */
+  private cleanupExpired(): void {
+    if (this.expireTime === null) return;
+
+    const now = Date.now() / 1000;
+    for (const [item, timestamp] of this.items.entries()) {
+      if (now - timestamp >= this.expireTime) {
+        this.items.delete(item);
+      }
+    }
+  }
+
+  /**
+   * 确保不超过最大大小，删除最老的条目
+   */
+  private enforceSizeLimit(): void {
+    if (this.items.size <= this.maxSize) return;
+
+    // 因为每次 checkAndRecord 最多插入1个元素，所以只需删除1个最老的
+    const iterator = this.items.entries();
+    const oldestEntry = iterator.next().value;
+    if (oldestEntry) {
+      const [oldestItem] = oldestEntry;
+      this.items.delete(oldestItem);
+    }
+  }
+
+  // 可选：手动清理
+  clear(): void {
+    this.items.clear();
+  }
+
+  // 可选：检查是否存在（不记录）
+  has(item: string): boolean {
+    const firstSeenTime = this.items.get(item);
+    if (firstSeenTime === undefined) return false;
+    // 如果设置了过期时间，检查是否过期
+    if (this.expireTime !== null) {
+      return (Date.now() / 1000) - firstSeenTime < this.expireTime;
+    }
+    return true;
+  }
+
+  // 可选：获取当前大小
+  size(): number {
+    // 懒清理：每10次size调用执行一次完整清理
+    if (Math.random() < 0.1) {
+      this.cleanupExpired();
+    }
+    return this.items.size;
+  }
+
+  // 可选：删除指定项
+  delete(item: string): boolean {
+    return this.items.delete(item);
+  }
+
+  // 可选：获取过期时间（秒）
+  getExpireTime(): number | null {
+    return this.expireTime;
+  }
+
+  // 可选：获取最大大小
+  getMaxSize(): number {
+    return this.maxSize;
+  }
+}

package/src/inbound.ts

@@ -20,13 +20,15 @@ import {
   sendMediaMsg,
   teamsBuildChatId,
   teamsParseChatId,
+  get_announcement,
 } from "./outbound";
 import { parseChatMessageBody } from './inbound_body_parse';
 import { parseAllowFroms } from './utils';
-import {
-  addUnmentionedHistory,
-  popUnmentionedHistories,
-} from "./histories";
+import { addUnmentionedHistory, popUnmentionedHistories } from "./histories";
+import { StringDeduplicator } from "./deduplicator"
+
+// 会话上下文注入排重
+let _session_ctx_injected = new StringDeduplicator(1000, 3600);
 
 /** 子函数共享的可变上下文，子函数直接修改字段，外层读取结果 */
 interface ChatPayload {
@@ -352,9 +354,17 @@ async function parse_teams_post(payload: ChatPayload, msgData: any, account: Inb
       }
     }
 
-    // 解决机器人不知道自己是谁的问题
-    if(payload.botName) {
-      payload.text += `\n你在当前session中的名字叫: ${payload.botName} \n如果有人@这个名字，就是在命令你`;
+    if(_session_ctx_injected.checkAndRecord(accountId + "_" + payload.chatId)) {
+      // 注入上下文
+      // 解决机器人不知道自己是谁的问题
+      if(payload.botName) {
+        payload.text += `\n[备忘]\n你在当前session中的名字叫: ${payload.botName}\n 如果有人@这个名字，就是在命令你`;
+      }
+      // 公告
+      const annnouncement = await get_announcement(account, channel_id, false);
+      if(annnouncement) {
+        payload.text += `\n[当前公告内容如下--有需要时可参考]\n${annnouncement}`;
+      }
     }
   }  
 
@@ -451,7 +461,11 @@ export async function handleInboundMessage({ json, account, apiRuntime, log }: I
 
   if (account.emojiReaction) {
     // 因为回复较慢，先回复一个表情
-    await tuituiEmojiReaction(account, payload.chatId, payload.chatType, payload.msgId, '收到');
+    try{
+      await tuituiEmojiReaction(account, payload.chatId, payload.chatType, payload.msgId, '收到');
+    } catch (err) {
+      // 出错不影响后续逻辑
+    }
   }
 
   // 路由判断

package/src/outbound.ts

@@ -1,9 +1,8 @@
 import { readFileSync, existsSync, statSync } from 'node:fs';
 import { basename } from 'node:path';
-import { fetchWithSsrFGuard } from 'openclaw/plugin-sdk/tlon';
 import { CHANNEL_ID } from "./const";
-import { TUITUI_SSRF_POLICY, getTuituiApiHost } from "./env"
 import { flattenFileSpaceList, FileSpaceItem } from "./filespace";
+import { tuituiRobotApi, downloadUrl } from "./robot_api"
 
 import type { 
   TuiTuiMessageData,
@@ -33,12 +32,6 @@ export function guessChatType(chatId: string): ChatType {
   return CHAT_TYPE_DIRECT;
 }
 
-export function addTuituiParams2Url(urlStr: string, params: any) {
-  const url = new URL(getTuituiApiHost() + urlStr);
-  for (let k in params) url.searchParams.set(k, params[k]);
-  return url.toString();
-}
-
 const mimeTypes: Record<string, string> = {
   jpg: 'image/jpeg',
   jpeg: 'image/jpeg',
@@ -60,61 +53,10 @@ export function getMimeType(filename: string): string {
   return mimeTypes[ext] || 'application/octet-stream';
 }
 
-function _fetch(opts: any): Promise<any> {
-  return fetchWithSsrFGuard({
-    //url: fileSrc,
-    policy: TUITUI_SSRF_POLICY,
-    //auditCtx: "tuitui.media.download",
-    ...opts,
-  })
-}
-function _fetchJson(url: string, json: any, auditCtx: string): Promise<any> {
-  return _fetch({
-    url,
-    init: {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(json),
-    },
-    auditCtx,
-  });
-}
 export async function postTuituiMsg(account: any, json: any, auditCtx: string): Promise<any> {
-  const { appId: appid, appSecret: secret } = account;
-  const { response, release } = await _fetchJson(
-    addTuituiParams2Url('/message/custom/send', { appid, secret }),
-    json,
-    auditCtx,
-  );
-  try {
-    const bodyText = await response.text();
-    const parsed =  JSON.parse(bodyText);
-
-    console.debug(`[${CHANNEL_ID}] ${auditCtx} postTuituiMsg response status=${response.status} ok=${response.ok} body=${bodyText || '<empty>'}`);
-
-    if (!response.ok) {
-      throw new Error(`postTuituiMsg Failed (response.ok unexpected): ${response.status} ${response.statusText}; body=${bodyText || '<empty>'}`);
-    }
-
-    if (Number(parsed?.errcode) !== 0) {
-      throw new Error(`postTuituiMsg Failed (errcode unexpected): errcode=${parsed.errcode} errmsg=${parsed.errmsg ?? 'Unknown error'}`);
-    }
-  } catch(err) {
-    console.error(`[${CHANNEL_ID}] ${auditCtx} postTuituiMsg error:`, err, `\njson: ${JSON.stringify(json)}`);
-    // 必须抛出错误，否则上层无法知道失败了（channel机器人问答、agent调用tool的场景）
-    throw err;
-  } finally {
-    await release();
-  }
+  await tuituiRobotApi(account, '/message/custom/send', json);
 }
 
-export function checkAccount(account: any, ctxTips: string = 'send text') {
-  if (!account || !account.appId || !account.appSecret) {
-    throw new Error(`[${CHANNEL_ID}] appId and appSecret are required for ${ctxTips}`);
-  }
-}
-
-
 interface tuituiUploadResult {
   fid: string;
   filename: string;
@@ -133,15 +75,15 @@ interface tuituiUploadResult {
  * @returns The media_id from TuiTui
  */
 export async function uploadFileToTuiTui(fileSrc: string, account: any, type: 'image' | 'file'): Promise<tuituiUploadResult> {
-  checkAccount(account, 'uploadFileToTuiTui');
-
-  const { appId: appid, appSecret: secret } = account;
   let fileBuffer: ArrayBuffer;
   let contentType: string;
   let filename: string;
 
+
   // Check if it's a Base64 data URL
   if (/^data\:/.test(fileSrc)) {
+    console.log("uploadFileToTuiTui: Base64 data");
+
     const matches = fileSrc.match(/^data:([^;,]*)(;base64)?,(.*)$/);
     if (!matches) {
       throw new Error(`[${CHANNEL_ID}] Invalid data URL format`);
@@ -168,33 +110,15 @@ export async function uploadFileToTuiTui(fileSrc: string, account: any, type: 'i
   }
   // HTTP/HTTPS URL
   else if (/^https?\:/.test(fileSrc)) {
-    const { response, release } = await _fetch({ url: fileSrc, auditCtx: 'tuitui.media.download' });
-    try {
-      if (!response.ok) {
-        throw new Error(`[${CHANNEL_ID}] Failed to download media from ${fileSrc}: ${response.status}`);
-      }
-
-      fileBuffer = await response.arrayBuffer();
-      contentType = response.headers.get('content-type') || 'application/octet-stream';
-
-      filename = 'media';
-      const urlPath = new URL(fileSrc).pathname;
-      const pathParts = urlPath.split('/');
-      const lastPart = pathParts[pathParts.length - 1];
-      if (lastPart) filename = lastPart;
-      const contentDisposition = response.headers.get('content-disposition');
-      if (contentDisposition) {
-        const match = contentDisposition.match(/filename\*?=(?:UTF-8''|")?([^";\r\n]+)"?/i);
-        if (match) {
-          filename = decodeURIComponent(match[1]);
-        }
-      }
-    } finally {
-      await release();
-    }
+    console.log("uploadFileToTuiTui: url", fileSrc);
+    const { buffer, filename: downloadedFilename, contentType: downloadedContentType } = await downloadUrl(fileSrc);
+    fileBuffer = buffer;
+    filename = downloadedFilename;
+    contentType = downloadedContentType;
   }
   // Check if it's a local file path
   else {
+    console.log("uploadFileToTuiTui: local", fileSrc);
     if (!existsSync(fileSrc)) {
       throw new Error(`[${CHANNEL_ID}] Local file not found: ${fileSrc}`);
     }
@@ -218,27 +142,8 @@ export async function uploadFileToTuiTui(fileSrc: string, account: any, type: 'i
   const body = new FormData();
   body.append('media', new Blob([fileBuffer], { type: contentType }), filename);
 
-  const { response, release } = await _fetch({
-    url: addTuituiParams2Url('/media/upload', { appid, secret, type }),
-    init: { method: "POST", body },
-    auditCtx: "tuitui.media.upload",
-  });
-  try {
-    if (!response.ok) {
-      throw new Error(`[${CHANNEL_ID}] Failed to upload file to TuiTui: HTTP ${response.status}`);
-    }
-
-    const result: TuiTuiMediaUploadResponse = await response.json();
-    if (result.errcode !== 0 || !result.media_id) {
-      throw new Error(`[${CHANNEL_ID}] file upload failed: ${result.errmsg || "Unknown error"}`);
-    }
-
-    return {fid: result.media_id, filename};
-  } catch(err) {
-    throw err;
-  } finally {
-    await release();
-  }
+  const result: TuiTuiMediaUploadResponse = await tuituiRobotApi(account, '/media/upload', body);
+  return {fid: result.media_id||"", filename};
 }
 
 export async function tuituiEmojiReaction(
@@ -260,21 +165,7 @@ export async function tuituiEmojiReaction(
     payload.toteams = [{ ...teamsParseChatId(target), parent_id: '', post_id: msgid }] as TuiTuiTeamsTarget[];
   }
 
-  const { appId: appid, appSecret: secret } = account;
-  const toTarget = (payload.togroups || payload.tousers || payload.toteams)[0];
-  const _logTxt =`[${CHANNEL_ID}] emoji_reaction "${emoji}"`;
-  console.log(`${_logTxt} request`, toTarget);
-  const sendUrl = addTuituiParams2Url('/message/custom/modify', { appid, secret });
-  const { response, release } = await _fetchJson(sendUrl, payload, 'tuitui.emoji_reaction');
-
-  try {
-    const body = JSON.parse(await response.text().catch(() => "{}"));
-    console.log(`${_logTxt} response errcode=${body.errcode} errmsg=${body.errmsg}`, toTarget);
-  } catch (err) {
-    console.error(`${_logTxt} Caught exception:`, err)
-  } finally {
-    await release();
-  }
+  await tuituiRobotApi(account, '/message/custom/modify', payload);
 }
 
 export function teamsBuildChatId(team_id: string, channel_id:string, thread_id:string) : string{
@@ -374,7 +265,6 @@ export async function sendTextMsg(
           delims_right: has_at?"}}":"",
         },
       };
-      console.log(`[${CHANNEL_ID}] sendTeamsPost to ${chatId} ${auditCtx} - `, msg);
       await postTuituiMsg(account, msg, auditCtx);
     } catch(err) {
       if(!has_at)throw err;
@@ -388,7 +278,6 @@ export async function sendTextMsg(
           delims_right: ""
         },
       };
-      console.log(`[${CHANNEL_ID}] retry no @ sendTeamsPost to ${chatId} ${auditCtx} - `, msg);
       await postTuituiMsg(account, msg, auditCtx);
     }
   } else {
@@ -399,7 +288,6 @@ export async function sendTextMsg(
       at: at_from_text,
       text: { content },
     };
-    console.log(`[${CHANNEL_ID}] sendTextMsg to ${chatId} ${auditCtx} - `, msg);
     await postTuituiMsg(account, msg, auditCtx);
   }
 }
@@ -415,7 +303,7 @@ export async function sendPageMsg(
 ): Promise<void> {
   if (!chatId) return console.error(`[${CHANNEL_ID}] sendPageMsg Error ${auditCtx}: Missing "target"`);
   if(chatType == CHAT_TYPE_CHANNEL) {
-    console.log(`[${CHANNEL_ID}] sendPageMsg to teams notNOT supported ${auditCtx} - `, page);
+    console.log(`[${CHANNEL_ID}] sendPageMsg to teams NOT supported ${auditCtx} - `, page);
     return
   }
   const targets = getTargets(chatId, chatType);
@@ -427,7 +315,6 @@ export async function sendPageMsg(
     togroups,
     page: { ...(page || {})}
   };
-  console.log(`[${CHANNEL_ID}] sendPageMsg ${auditCtx} - `, msg);
   await postTuituiMsg(account, msg, auditCtx);
 }
 
@@ -440,7 +327,6 @@ export async function sendMediaMsg(
   atList?: string[],
 ): Promise<void> {
   if (!chatId) return console.error(`[${CHANNEL_ID}] sendMediaMsg Error ${auditCtx}: Missing "target"`);
-  console.log(`[${CHANNEL_ID}] sendMediaMsg ${chatType} ${chatId} ${auditCtx} uploading`);
   // Check if mediaUrl looks like an image
   const isImage = /^data:image\//i.test(mediaUrl) || /\.(jpg|jpeg|png|gif)(?:$|[?#])/i.test(mediaUrl);
   const mediaType = isImage ? 'image' : 'file';
@@ -462,7 +348,6 @@ export async function sendMediaMsg(
       at: atList || [],
       richtext: { markdown: content, delims_left: "{{", delims_right: "}}"},
     }
-    console.log(`[${CHANNEL_ID}] sendMediaMsg ${chatType} ${chatId} ${auditCtx} - `, msg);
     await postTuituiMsg(account, msg, auditCtx);
   } else {
     const msg: TuiTuiOutboundImageMessage | TuiTuiOutboundAttachmentMessage =
@@ -472,7 +357,6 @@ export async function sendMediaMsg(
 
     const realAtList = chatType == CHAT_TYPE_GROUP? atList : [];
     msg.at = realAtList;
-    console.log(`[${CHANNEL_ID}] sendMediaMsg ${chatType} ${chatId} ${auditCtx} - `, msg);
 
     await postTuituiMsg(account, msg, auditCtx);
   }
@@ -545,8 +429,6 @@ export async function getChatRecord(
     return undefined;
   }
 
-  checkAccount(account, 'getChatRecord');
-
   let baseurl = "";
   if (chatType == CHAT_TYPE_DIRECT) {
     baseurl = "/message/single/sync";
@@ -572,52 +454,28 @@ export async function getChatRecord(
   if (options.limit) body.limit = options.limit;
   if (typeof options.orderAsc === 'boolean') body.order_asc = options.orderAsc;
 
-  const { appId: appid, appSecret: secret } = account;
-
-  const url = addTuituiParams2Url(baseurl, { appid, secret });
-
-  console.log(`[${CHANNEL_ID}] getChatRecord request `, body);
-
-  const { response, release } = await _fetchJson(url, body, 'tuitui.chat.record');
-  try {
-    const bodyText = await response.text();
-    //console.log(`[${CHANNEL_ID}] getChatRecord response ${bodyText}`);
-
-    if (!response.ok) {
-      throw new Error(`getChatRecord failed (response.ok unexpected): ${response.status} ${response.statusText}; body=${bodyText}`);
-    }
-
-    const parsed: TuiTuiChatRecordResponse = JSON.parse(bodyText);
-    if (Number(parsed?.errcode) !== 0) {
-      throw new Error(`getChatRecord failed (errcode unexpected): errcode=${parsed.errcode} errmsg=${parsed.errmsg ?? 'Unknown error'}`);
-    }
-
-    const clean: TuiTuiChatRecordResponseClean = {
-      errcode:  parsed.errcode,
-      errmsg:   parsed.errmsg,
-      cursor:   parsed.cursor,
-      has_more: parsed.has_more,
-      current_time: parsed.time,
-      msgs: (parsed.msgs ?? []).map(({ user_account, user_name, timestamp, data }) => {
-        const { at, msgid, group_id, group_name, ...restData } = data;  // 排除一些字段，减少大模型上下文大小
-        return {
-          ...restData,  // 使用排除 at 后的数据
-          user_account,
-          user_name,
-          msg_time: new Date(Number(timestamp) * 1000).toLocaleString('sv-SE', { hour12: false }).replace('T', ' '),
-        };
-      }),
-    };
+  const parsed: TuiTuiChatRecordResponse = await tuituiRobotApi(account, baseurl, body);
+
+  const clean: TuiTuiChatRecordResponseClean = {
+    errcode:  parsed.errcode,
+    errmsg:   parsed.errmsg,
+    cursor:   parsed.cursor,
+    has_more: parsed.has_more,
+    current_time: parsed.time,
+    msgs: (parsed.msgs ?? []).map(({ user_account, user_name, timestamp, data }) => {
+      const { at, msgid, group_id, group_name, ...restData } = data;  // 排除一些字段，减少大模型上下文大小
+      return {
+        ...restData,  // 使用排除 at 后的数据
+        user_account,
+        user_name,
+        msg_time: new Date(Number(timestamp) * 1000).toLocaleString('sv-SE', { hour12: false }).replace('T', ' '),
+      };
+    }),
+  };
 
-    console.log(`[${CHANNEL_ID}] getChatRecord result(cleaned)`, JSON.stringify(clean, null, 2));
+  console.log(`[${CHANNEL_ID}] getChatRecord result(cleaned)`, JSON.stringify(clean, null, 2));
 
-    return clean;
-  } catch (err) {
-    console.error(`[${CHANNEL_ID}] getChatRecord error:`, err);
-    return undefined;
-  } finally {
-    await release();
-  }
+  return clean;
 }
 
 
@@ -644,66 +502,40 @@ export async function getPostChain(
   channelId: string,
   threadId: string,
 ): Promise<TeamsPostChainItem[]> {
-  checkAccount(account, 'getPostChain');
-
-  const { appId: appid, appSecret: secret } = account;
-  const url = addTuituiParams2Url('/teams/post/chain', { appid, secret });
 
   const payload = {
     team_id: teamId,
     channel_id: channelId,
     post_id: threadId,
   };
+  const data = await tuituiRobotApi(account, '/teams/post/chain', payload);
 
-  console.log(`[${CHANNEL_ID}] getPostChain request`, payload);
+  const datas = data.datas ?? {};
+  const topic = datas.topic ?? {};
+  const replyList: any[] = datas.reply_list ?? [];
 
-  const { response, release } = await _fetchJson(url, payload, 'tuitui.teams.post.chain');
-  try {
-    const bodyText = await response.text();
+  const posts: TeamsPostChainItem[] = [];
 
-    if (!response.ok) {
-      throw new Error(`getPostChain failed (response.ok unexpected): ${response.status} ${response.statusText}; body=${bodyText}`);
-    }
-
-    const data = JSON.parse(bodyText);
-    if (Number(data?.errcode) !== 0) {
-      throw new Error(`getPostChain failed (errcode unexpected): errcode=${data.errcode} errmsg=${data.errmsg ?? 'Unknown error'}`);
-    }
-
-    console.log(`[${CHANNEL_ID}] getPostChain `, data);
-
-    const datas = data.datas ?? {};
-    const topic = datas.topic ?? {};
-    const replyList: any[] = datas.reply_list ?? [];
-
-    const posts: TeamsPostChainItem[] = [];
+  posts.push({
+    post_id: topic.post_id ?? '',
+    time: topic.create_time ?? '',
+    name: topic.from_name ?? '',
+    content: topic.content ?? '',
+    properties: topic.properties ?? '',
+  });
 
+  for (const post of [...replyList].reverse()) {
     posts.push({
-      post_id: topic.post_id ?? '',
-      time: topic.create_time ?? '',
-      name: topic.from_name ?? '',
-      content: topic.content ?? '',
-      properties: topic.properties ?? '',
+      post_id: post.post_id ?? '',
+      time: post.create_time ?? '',
+      name: post.from_name ?? '',
+      content: post.content ?? '',
+      properties: post.properties ?? '',
     });
-
-    for (const post of [...replyList].reverse()) {
-      posts.push({
-        post_id: post.post_id ?? '',
-        time: post.create_time ?? '',
-        name: post.from_name ?? '',
-        content: post.content ?? '',
-        properties: post.properties ?? '',
-      });
-    }
-
-    console.log(`[${CHANNEL_ID}] getPostChain result: ${posts.length} posts`, posts);
-    return posts;
-  } catch (err) {
-    console.error(`[${CHANNEL_ID}] getPostChain error:`, err);
-    throw err;
-  } finally {
-    await release();
   }
+
+  console.log(`[${CHANNEL_ID}] getPostChain result: ${posts.length} posts`, posts);
+  return posts;
 }
 
 export async function getPostChainByChatId(
@@ -714,17 +546,11 @@ export async function getPostChainByChatId(
   return await getPostChain(account, team_id, channel_id, parent_id||"");
 }
 
-
 export async function file_space_list(
   account: any,
-  spaceId: string,
+  spaceId: string = "",
   spaceType: string = "2"
 ): Promise<FileSpaceItem[]> {
-  checkAccount(account, 'file_space_list');
-
-  const { appId: appid, appSecret: secret } = account;
-  const url = addTuituiParams2Url('/file_space/node/list', { appid, secret });
-
   const guessType = guessChatType(spaceId);
   let space_final_id = "";
   if(guessType == CHAT_TYPE_CHANNEL){
@@ -739,30 +565,44 @@ export async function file_space_list(
     space_type: spaceType,
   };
 
-  console.log(`[${CHANNEL_ID}] file_space_list request`, payload);
+  const data = await tuituiRobotApi(account, '/file_space/node/list', payload);
 
-  const { response, release } = await _fetchJson(url, payload, 'tuitui.file_space_list');
-  try {
-    const bodyText = await response.text();
+  const list = data?.datas?.list;
+  const flat_list = flattenFileSpaceList(list);
 
-    if (!response.ok) {
-      throw new Error(`file_space_list failed (response.ok unexpected): ${response.status} ${response.statusText}; body=${bodyText}`);
-    }
-
-    const data = JSON.parse(bodyText);
-    if (Number(data?.errcode) !== 0) {
-      throw new Error(`file_space_list failed (errcode unexpected): err=${bodyText}`);
-    }
+  console.log(`[${CHANNEL_ID}] file_space_list `, flat_list);
+  return flat_list
+}
 
-    const list = data?.datas?.list;
-    const flat_list = flattenFileSpaceList(list);
+function parseSessionKey(str: string): string {
+  // 检查是否包含必须的格式 "tuitui:channel:"
+  if (!str.includes('tuitui:channel:')) {
+      return "";
+  }
+  
+  const parts = str.split(':');
+  const channelIndex = parts.findIndex(part => part === 'channel');
+  
+  if (channelIndex !== -1 && parts[channelIndex + 1]) {
+      return parts[channelIndex + 1];
+  }
+  
+  return "";
+}
 
-    console.log(`[${CHANNEL_ID}] file_space_list `, flat_list);
-    return flat_list
-  } catch (err) {
-    console.error(`[${CHANNEL_ID}] file_space_list error:`, err);
-    throw err;
-  } finally {
-    await release();
+// TODO: 支持群公告
+export async function get_announcement(account: any, id: any, id_is_session: boolean = true): Promise<any> {
+  let channel_id = id;
+  if(id_is_session) {
+    channel_id = parseSessionKey(id);
+    if(!channel_id) {
+      return "";
+    }
   }
+  
+  const payload = {channel_id: channel_id};
+  const body = await tuituiRobotApi(account, '/teams/channel/info', payload);
+  //console.log("info", data);
+  const announcement = body?.datas?.info?.announcement;
+  return announcement;
 }

package/src/robot_api.ts

@@ -0,0 +1,123 @@
+import { fetchWithSsrFGuard } from 'openclaw/plugin-sdk/tlon';
+import { CHANNEL_ID } from "./const";
+import { TUITUI_SSRF_POLICY, getTuituiApiHost } from "./env"
+
+function addTuituiParams2Url(urlStr: string, params: any) {
+  const url = new URL(getTuituiApiHost() + urlStr);
+  for (let k in params) url.searchParams.set(k, params[k]);
+  return url.toString();
+}
+
+export function checkAccount(account: any, ctxTips: string = 'send text') {
+  if (!account || !account.appId || !account.appSecret) {
+    throw new Error(`[${CHANNEL_ID}] appId and appSecret are required for ${ctxTips}`);
+  }
+}
+
+export async function tuituiRobotApi(account: any, api: string, payload: any) {
+  checkAccount(account);
+
+  console.log(`[${CHANNEL_ID}] ${api} request`, payload);
+
+  const { appId: appid, appSecret: secret } = account;
+  const url = addTuituiParams2Url(api, { appid, secret });
+
+
+  let fetch_fun = _fetchJson;
+  if (payload instanceof FormData) {
+    fetch_fun = _fetchForm;
+  }
+
+  const { response, release } = await fetch_fun(url, payload);
+  try {
+    const bodyText = await response.text();
+
+    if (!response.ok) {
+      throw new Error(`${api} failed : ${response.status} ${response.statusText}; body=${bodyText}`);
+    }
+
+    const data = JSON.parse(bodyText);
+    if (Number(data?.errcode) !== 0) {
+      throw new Error(`${api} failed : ${bodyText}`);
+    }
+    return data;
+  } catch (err) {
+    // 必须抛出错误，否则上层无法知道失败了
+    console.error(`[${CHANNEL_ID}] ${api} error:`, err);
+    throw err;
+  } finally {
+    await release();
+  }
+}
+
+function _fetch(opts: any): Promise<any> {
+  return fetchWithSsrFGuard({
+    policy: TUITUI_SSRF_POLICY,
+    ...opts,
+  })
+}
+function _fetchJson(url: string, json: any, auditCtx: string = "tuitui.api.call"): Promise<any> {
+  return _fetch({
+    url,
+    init: {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(json),
+    },
+    auditCtx
+  });
+}
+
+function _fetchForm(url: string, form: any, auditCtx: string = "tuitui.api.call"): Promise<any> {
+  return _fetch({
+    url,
+    init: {
+      method: 'POST',
+      body: form,
+    },
+    auditCtx
+  });
+}
+
+/**
+ * Download content from a URL and extract filename and content type
+ * @param url - The URL to download from
+ * @returns Object with buffer, filename and content type
+ */
+export async function downloadUrl(url: string): Promise<{ buffer: ArrayBuffer; filename: string; contentType: string }> {
+  const { response, release } = await _fetch({
+    url,
+    init: { method: 'GET' },
+    auditCtx: "tuitui.download"
+  });
+
+  try {
+    if (!response.ok) {
+      throw new Error(`[${CHANNEL_ID}] Failed to download from ${url}: ${response.status}`);
+    }
+
+    const buffer = await response.arrayBuffer();
+    const contentType = response.headers.get('content-type') || 'application/octet-stream';
+
+    // Extract filename from URL or Content-Disposition header
+    let filename = 'media';
+    try {
+      const urlPath = new URL(url).pathname;
+      const pathParts = urlPath.split('/');
+      const lastPart = pathParts[pathParts.length - 1];
+      if (lastPart) filename = lastPart;
+    } catch (e) {
+      // Ignore URL parsing errors
+    }
+
+    const contentDisposition = response.headers.get('content-disposition');
+    if (contentDisposition) {
+      const match = contentDisposition.match(/filename\*?=(?:UTF-8''|")?([^";\r\n]+)"?/i);
+      if (match) filename = decodeURIComponent(match[1]);
+    }
+
+    return { buffer, filename, contentType };
+  } finally {
+    await release();
+  }
+}

package/src/tools.ts

@@ -3,9 +3,8 @@ import type { OpenClawPluginToolContext } from "openclaw/plugin-sdk/core";
 import { CHANNEL_ID} from "./const";
 import { resolveAccount } from "./accounts"
 import { Type } from "@sinclair/typebox";
-import {DEFAULT_ONLINE} from "./env"
 
-import {CHAT_TYPE_DIRECT,CHAT_TYPE_GROUP,CHAT_TYPE_CHANNEL,guessChatType, getChatRecord, getPostChainByChatId, sendTextMsg, teamsBuildChatId} from "./outbound"
+import {CHAT_TYPE_DIRECT,CHAT_TYPE_GROUP,CHAT_TYPE_CHANNEL,guessChatType, getChatRecord, getPostChainByChatId, sendTextMsg, teamsBuildChatId, get_announcement} from "./outbound"
 import {file_space_list} from "./outbound"
   
 function tool_errmsg(str:string) {
@@ -87,6 +86,27 @@ const tuitui_send_channel_post_factory = (ctx: OpenClawPluginToolContext) => {
 };
 
 
+const tuitui_get_announcement_factory = (ctx: OpenClawPluginToolContext) => {
+  return {
+    name: "tuitui_get_announcement",
+    label: "tuitui_get_announcement",
+    description: "获取推推(tuitui) 当前会话的公告信息\n\n",
+    parameters: Type.Object({
+    }),
+    execute: async (_toolCallId: any, params: any) => {
+      console.log(`tuitui_get_announcement(): agentAccountId: ${ctx.agentAccountId}, sessionKey: ${ctx.sessionKey}`, params);
+      const account = resolveAccount(ctx.config, ctx.agentAccountId);
+      if(!account || !account.enabled || !account.appId || !account.appSecret) {
+        return tool_errmsg(`invalid tuitui account ${ctx.agentAccountId}`);
+      }
+      return await get_announcement(account, ctx.sessionKey);
+    },
+  };
+};
+
+
+
+
 const tuitui_file_space_factory = (ctx: OpenClawPluginToolContext) => {
   return {
     name: "tuitui_file_space_list",
@@ -115,8 +135,7 @@ export function registerTuituiTools(api: OpenClawPluginApi) {
   
   api.registerTool(tuitui_im_get_messages_factory);
   api.registerTool(tuitui_send_channel_post_factory);
-  if(!DEFAULT_ONLINE) {
-    api.registerTool(tuitui_file_space_factory);
-  }
+  api.registerTool(tuitui_get_announcement_factory);
+  api.registerTool(tuitui_file_space_factory);
   api.logger.info?.(`tuitui: Registered tool`);
 }