@qihoo/tuitui-openclaw-channel 1.0.22 → 1.0.24

package/package.json

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

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/filespace.ts

@@ -1,3 +1,5 @@
+import { CHANNEL_ID } from "./const";
+import { tuituiRobotApi, downloadUrl, parseChannelIdBySessionKey, tuituiRobotUpload} from "./robot_api"
 
 export interface FileSpaceItem {
   filename: string;
@@ -42,4 +44,181 @@ export function flattenFileSpaceList(list: any[]): FileSpaceItem[] {
     url: node.file_url,
     filesize: node.file_size,
   }));
-}
+}
+
+
+
+async function getChannelInfoBySessionKey(account: any, sessionKey: string) {
+  const channel_id = parseChannelIdBySessionKey(sessionKey);
+  if(!channel_id) {
+    return null;
+  }
+
+  const payload = {channel_id: channel_id};
+  const body = await tuituiRobotApi(account, '/teams/channel/info', payload);
+  return body?.datas?.info;
+}
+
+export async function file_space_list(
+  account: any,
+  sessionKey: string
+): Promise<FileSpaceItem[]> {
+
+  const channelInfo = await getChannelInfoBySessionKey(account, sessionKey);
+  if(!channelInfo){
+    return [];
+  }
+
+  const payload = {
+    space_id: channelInfo.team_id,
+    space_type: "2",
+  };
+
+  const data = await tuituiRobotApi(account, '/file_space/node/list', payload);
+
+  const list = data?.datas?.list;
+  const flat_list = flattenFileSpaceList(list);
+
+  console.log(`[${CHANNEL_ID}] file_space_list `, flat_list);
+  return flat_list
+}
+
+/**
+ * 确保目录路径存在，自动创建缺失的文件夹，返回最终目录的 parent_id
+ * @param account - TuiTui 账号
+ * @param spaceId - 空间 ID
+ * @param folderPath - 文件夹路径，如 "/projects/2024/q1"
+ * @returns 最终文件夹的 parent_id（用于添加文件）
+ */
+async function ensureFolderPath(
+  account: any,
+  spaceId: string,
+  folderPath: string
+): Promise<string> {
+  // 标准化路径
+  const normalizedPath = folderPath.startsWith('/') ? folderPath : '/' + folderPath;
+
+  // 如果是根目录，返回空字符串
+  if (normalizedPath === '/') {
+    return "";
+  }
+
+  // 分割路径层级
+  const pathParts = normalizedPath.split('/').filter(part => part.trim());
+  if (pathParts.length === 0) {
+    return "";
+  }
+
+  // 一次性获取所有节点
+  const listPayload = {
+    space_id: spaceId,
+    space_type: "2",
+  };
+  const listData = await tuituiRobotApi(account, '/file_space/node/list', listPayload);
+  const allNodes = listData?.datas?.list || [];
+
+  // 构建父目录ID映射，便于查找
+  const parentIdToNodes = new Map<string, any[]>();
+  allNodes.forEach(node => {
+    const parentId = node.parent_id || "";
+    if (!parentIdToNodes.has(parentId)) {
+      parentIdToNodes.set(parentId, []);
+    }
+    parentIdToNodes.get(parentId)!.push(node);
+  });
+
+  // 逐级查找或创建文件夹
+  let currentParentId = ""; // 从根目录开始
+
+  for (const folderName of pathParts) {
+    // 在当前层级查找文件夹
+    const siblings = parentIdToNodes.get(currentParentId) || [];
+    let folderNode = siblings.find(node =>
+      node.node_type === '1' && // 文件夹
+      node.name === folderName
+    );
+
+    // 如果不存在，创建新文件夹
+    if (!folderNode) {
+      const createFolderPayload = {
+        space_id: spaceId,
+        space_type: "2",
+        node_type: "1", // 文件夹
+        name: folderName,
+        parent_id: currentParentId,
+      };
+
+      const createResult = await tuituiRobotApi(account, '/file_space/node/add', createFolderPayload);
+      folderNode = {
+        node_id: createResult?.datas?.node_id || createResult?.node_id,
+        name: folderName,
+        node_type: '1',
+        parent_id: currentParentId,
+      };
+
+      if (!folderNode.node_id) {
+        throw new Error(`[${CHANNEL_ID}] Failed to create folder: ${folderName}`);
+      }
+
+      // 更新缓存，避免后续重复创建
+      if (!parentIdToNodes.has(currentParentId)) {
+        parentIdToNodes.set(currentParentId, []);
+      }
+      parentIdToNodes.get(currentParentId)!.push(folderNode);
+    }
+
+    currentParentId = folderNode.node_id;
+  }
+
+  return currentParentId;
+}
+
+export async function file_space_add(
+  account: any,
+  sessionKey: string,
+  cloud_filepath: string,
+  url_or_localpath: string,
+): Promise<any> {
+  const channelInfo = await getChannelInfoBySessionKey(account, sessionKey);
+  if (!channelInfo) {
+    throw new Error(`私聊、群聊会话不支持共享空间。仅团队频道支持。`);
+  }
+
+  // 1. 解析云路径，分离目录和文件名
+  const normalizedPath = cloud_filepath.startsWith('/')
+    ? cloud_filepath
+    : '/' + cloud_filepath;
+
+  const pathParts = normalizedPath.split('/').filter(part => part);
+  const filename = pathParts.length > 0 ? pathParts[pathParts.length - 1] : 'unnamed';
+  const folderPath = pathParts.length > 0
+    ? '/' + pathParts.slice(0, -1).join('/')
+    : '';
+
+  // 2. 确保目标目录存在，获取 parent_id
+  const parentId = await ensureFolderPath(account, channelInfo.team_id, folderPath);
+
+  // 3. 上传文件获取 fid
+  const isImage = /^data:image\//i.test(url_or_localpath) || /\.(jpg|jpeg|png|gif)(?:$|[?#])/i.test(url_or_localpath);
+  const mediaType = isImage ? 'image' : 'file';
+  const uploadResult = await tuituiRobotUpload(url_or_localpath, account, mediaType);
+  const { fid, filesize } = uploadResult;
+
+  console.log(`[${CHANNEL_ID}] file_space_add: uploading ${normalizedPath}, parentId=${parentId}`);
+
+  // 4. 在指定目录中添加文件
+  const filePayload = {
+    space_id: channelInfo.team_id,
+    space_type: "2",
+    node_type: "2", // 文件
+    name: filename,
+    fid: fid,
+    file_size: filesize?.toString() || "0",
+    parent_id: parentId,
+  };
+
+  const body = await tuituiRobotApi(account, '/file_space/node/add', filePayload);
+  console.log(`[${CHANNEL_ID}] file_space_add: uploaded ${normalizedPath}`);
+
+  return body;
+}

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}`;
+      }
     }
   }  
 

package/src/outbound.ts

@@ -1,12 +1,9 @@
-import { readFileSync, existsSync, statSync } from 'node:fs';
-import { basename } from 'node:path';
+
 import { CHANNEL_ID } from "./const";
-import { flattenFileSpaceList, FileSpaceItem } from "./filespace";
-import { tuituiRobotApi, downloadUrl } from "./robot_api"
+import { tuituiRobotApi, parseChannelIdBySessionKey, tuituiRobotUpload } from "./robot_api"
 
 import type { 
   TuiTuiMessageData,
-  TuiTuiMediaUploadResponse,
   TuiTuiSingleEmojiReactionTarget,
   TuiTuiGroupEmojiReactionTarget,
   TuiTuiOutboundTextMessage,
@@ -32,120 +29,11 @@ export function guessChatType(chatId: string): ChatType {
   return CHAT_TYPE_DIRECT;
 }
 
-const mimeTypes: Record<string, string> = {
-  jpg: 'image/jpeg',
-  jpeg: 'image/jpeg',
-  png: 'image/png',
-  gif: 'image/gif',
-  webp: 'image/webp',
-  bmp: 'image/bmp',
-  svg: 'image/svg+xml',
-  pdf: 'application/pdf',
-  txt: 'text/plain',
-  json: 'application/json',
-  mp3: 'audio/mpeg',
-  mp4: 'video/mp4',
-};
-/** Get MIME type from file extension. */
-export function getMimeType(filename: string): string {
-  const fns = filename.split('.');
-  const ext = fns.length > 1 ? fns[fns.length - 1].toLowerCase() : '';
-  return mimeTypes[ext] || 'application/octet-stream';
-}
 
 export async function postTuituiMsg(account: any, json: any, auditCtx: string): Promise<any> {
   await tuituiRobotApi(account, '/message/custom/send', json);
 }
 
-interface tuituiUploadResult {
-  fid: string;
-  filename: string;
-}
-
-/**
- * Upload file to TuiTui and get media_id.
- * Supports:
- * - HTTP/HTTPS URLs (downloads then uploads)
- * - Local file paths (reads then uploads)
- * - Base64 data URLs (decodes then uploads)
- *
- * @param fileSrc - The URL, file path, or data URL of the media
- * @param account - TuiTui app account id and secret
- * @param type - Media type: 'image' or "file" (auto-detected if not specified)
- * @returns The media_id from TuiTui
- */
-export async function uploadFileToTuiTui(fileSrc: string, account: any, type: 'image' | 'file'): Promise<tuituiUploadResult> {
-  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`);
-    }
-
-    contentType = matches[1] || 'application/octet-stream';
-    const isBase64 = !!matches[2];
-    const data = matches[3];
-
-    if (isBase64) {
-      // Use atob if available; fallback to Buffer for Node environments
-      const binaryStr = typeof atob === 'function' ? atob(data) : Buffer.from(data, 'base64').toString('binary');
-      const bytes = new Uint8Array(binaryStr.length);
-      for (let i = 0; i < binaryStr.length; i++) {
-        bytes[i] = binaryStr.charCodeAt(i);
-      }
-      fileBuffer = bytes.buffer;
-    } else {
-      fileBuffer = new TextEncoder().encode(decodeURIComponent(data)).buffer;
-    }
-
-    const ext = contentType.split("/")[1] || "bin";
-    filename = `media_${Date.now()}.${ext}`;
-  }
-  // HTTP/HTTPS URL
-  else if (/^https?\:/.test(fileSrc)) {
-    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}`);
-    }
-
-    const stats = statSync(fileSrc);
-    const maxSize = 10 * 1024 * 1024;
-    if (stats.size > maxSize) {
-      throw new Error(
-        `[${CHANNEL_ID}] File too large: ${fileSrc} (${(stats.size / 1024 / 1024).toFixed(2)}MB > 10MB limit)`,
-      );
-    }
-
-    const localFileBuffer = readFileSync(fileSrc);
-    const { byteOffset, byteLength } = localFileBuffer;
-    fileBuffer = localFileBuffer.buffer.slice(byteOffset, byteOffset + byteLength);
-
-    filename = basename(fileSrc);
-    contentType = getMimeType(filename);
-  }
-
-  const body = new FormData();
-  body.append('media', new Blob([fileBuffer], { type: contentType }), filename);
-
-  const result: TuiTuiMediaUploadResponse = await tuituiRobotApi(account, '/media/upload', body);
-  return {fid: result.media_id||"", filename};
-}
-
 export async function tuituiEmojiReaction(
   account: any,
   target: string,
@@ -331,7 +219,7 @@ export async function sendMediaMsg(
   const isImage = /^data:image\//i.test(mediaUrl) || /\.(jpg|jpeg|png|gif)(?:$|[?#])/i.test(mediaUrl);
   const mediaType = isImage ? 'image' : 'file';
 
-  const uploadResult = await uploadFileToTuiTui(mediaUrl, account, mediaType);
+  const uploadResult = await tuituiRobotUpload(mediaUrl, account, mediaType);
   const {fid, filename} = uploadResult;
 
   const targets = getTargets(chatId, chatType);
@@ -546,60 +434,20 @@ export async function getPostChainByChatId(
   return await getPostChain(account, team_id, channel_id, parent_id||"");
 }
 
-export async function file_space_list(
-  account: any,
-  spaceId: string = "",
-  spaceType: string = "2"
-): Promise<FileSpaceItem[]> {
-  const guessType = guessChatType(spaceId);
-  let space_final_id = "";
-  if(guessType == CHAT_TYPE_CHANNEL){
-    const { team_id, channel_id, parent_id } = teamsParseChatId(spaceId);
-    space_final_id = team_id;
-  } else {
-    space_final_id = spaceId;
-  }
-
-  const payload = {
-    space_id: space_final_id,
-    space_type: spaceType,
-  };
-
-  const data = await tuituiRobotApi(account, '/file_space/node/list', payload);
-
-  const list = data?.datas?.list;
-  const flat_list = flattenFileSpaceList(list);
-
-  console.log(`[${CHANNEL_ID}] file_space_list `, flat_list);
-  return flat_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 "";
-}
 
 // TODO: 支持群公告
-export async function get_announcement(account: any, sessionKey: string = ""): Promise<any> {
-  const channel_id = parseSessionKey(sessionKey);
-  if(!channel_id) {
-    return {"announcement": ""};
+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 = parseChannelIdBySessionKey(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": announcement};
+  return announcement;
 }

package/src/robot_api.ts

@@ -1,3 +1,5 @@
+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"
@@ -121,3 +123,146 @@ export async function downloadUrl(url: string): Promise<{ buffer: ArrayBuffer; f
     await release();
   }
 }
+
+
+
+const mimeTypes: Record<string, string> = {
+  jpg: 'image/jpeg',
+  jpeg: 'image/jpeg',
+  png: 'image/png',
+  gif: 'image/gif',
+  webp: 'image/webp',
+  bmp: 'image/bmp',
+  svg: 'image/svg+xml',
+  pdf: 'application/pdf',
+  txt: 'text/plain',
+  json: 'application/json',
+  mp3: 'audio/mpeg',
+  mp4: 'video/mp4',
+};
+/** Get MIME type from file extension. */
+export function getMimeType(filename: string): string {
+  const fns = filename.split('.');
+  const ext = fns.length > 1 ? fns[fns.length - 1].toLowerCase() : '';
+  return mimeTypes[ext] || 'application/octet-stream';
+}
+
+interface tuituiUploadResult {
+  fid: string;
+  filename: string;
+  filesize: number;
+}
+
+export interface TuiTuiMediaUploadResponse {
+  errcode: number;
+  errmsg: string;
+  filename?: string;
+  media_id?: string;
+}
+
+
+
+/**
+ * Upload file to TuiTui and get media_id.
+ * Supports:
+ * - HTTP/HTTPS URLs (downloads then uploads)
+ * - Local file paths (reads then uploads)
+ * - Base64 data URLs (decodes then uploads)
+ *
+ * @param fileSrc - The URL, file path, or data URL of the media
+ * @param account - TuiTui app account id and secret
+ * @param type - Media type: 'image' or "file" (auto-detected if not specified)
+ * @returns The media_id from TuiTui
+ */
+export async function tuituiRobotUpload(fileSrc: string, account: any, type: 'image' | 'file'): Promise<tuituiUploadResult> {
+  let fileBuffer: ArrayBuffer;
+  let contentType: string;
+  let filename: string;
+  let filesize = 0;
+
+
+  // Check if it's a Base64 data URL
+  if (/^data\:/.test(fileSrc)) {
+    console.log("tuituiRobotUpload: Base64 data");
+
+    const matches = fileSrc.match(/^data:([^;,]*)(;base64)?,(.*)$/);
+    if (!matches) {
+      throw new Error(`[${CHANNEL_ID}] Invalid data URL format`);
+    }
+
+    contentType = matches[1] || 'application/octet-stream';
+    const isBase64 = !!matches[2];
+    const data = matches[3];
+
+    if (isBase64) {
+      // Use atob if available; fallback to Buffer for Node environments
+      const binaryStr = typeof atob === 'function' ? atob(data) : Buffer.from(data, 'base64').toString('binary');
+      const bytes = new Uint8Array(binaryStr.length);
+      for (let i = 0; i < binaryStr.length; i++) {
+        bytes[i] = binaryStr.charCodeAt(i);
+      }
+      fileBuffer = bytes.buffer;
+    } else {
+      fileBuffer = new TextEncoder().encode(decodeURIComponent(data)).buffer;
+    }
+
+    const ext = contentType.split("/")[1] || "bin";
+    filename = `media_${Date.now()}.${ext}`;
+  }
+  // HTTP/HTTPS URL
+  else if (/^https?\:/.test(fileSrc)) {
+    console.log("tuituiRobotUpload: 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("tuituiRobotUpload: local", fileSrc);
+    if (!existsSync(fileSrc)) {
+      throw new Error(`[${CHANNEL_ID}] Local file not found: ${fileSrc}`);
+    }
+
+    const stats = statSync(fileSrc);
+    const maxSize = 10 * 1024 * 1024;
+    if (stats.size > maxSize) {
+      throw new Error(
+        `[${CHANNEL_ID}] File too large: ${fileSrc} (${(stats.size / 1024 / 1024).toFixed(2)}MB > 10MB limit)`,
+      );
+    }
+
+    const localFileBuffer = readFileSync(fileSrc);
+    const { byteOffset, byteLength } = localFileBuffer;
+    fileBuffer = localFileBuffer.buffer.slice(byteOffset, byteOffset + byteLength);
+
+    filename = basename(fileSrc);
+    contentType = getMimeType(filename);
+  }
+
+  filesize = fileBuffer.byteLength;
+
+  const body = new FormData();
+  body.append('media', new Blob([fileBuffer], { type: contentType }), filename);
+
+  const result: TuiTuiMediaUploadResponse = await tuituiRobotApi(account, '/media/upload', body);
+  return {fid: result.media_id||"", filename, filesize};
+}
+
+
+
+export function parseChannelIdBySessionKey(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 "";
+}

package/src/tools.ts

@@ -5,7 +5,7 @@ import { resolveAccount } from "./accounts"
 import { Type } from "@sinclair/typebox";
 
 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"
+import {file_space_list, file_space_add} from "./filespace"
   
 function tool_errmsg(str:string) {
   const ret = `error: ${str}`
@@ -92,9 +92,11 @@ const tuitui_get_announcement_factory = (ctx: OpenClawPluginToolContext) => {
     label: "tuitui_get_announcement",
     description: "获取推推(tuitui) 当前会话的公告信息\n\n",
     parameters: Type.Object({
+      // 参数不能为空，对模型兼容有问题，即使不用也要传一个
+      reason: Type.String({ description: "调用本工具的原因" }),
     }),
     execute: async (_toolCallId: any, params: any) => {
-      console.log(`tuitui_get_announcement(): agentAccountId: ${ctx.agentAccountId}, sessionKey: ${ctx.sessionKey}`, params);
+      console.log(`tuitui_get_announcement(): agentAccountId: ${ctx.agentAccountId}, sessionKey: ${ctx.sessionKey}`);
       const account = resolveAccount(ctx.config, ctx.agentAccountId);
       if(!account || !account.enabled || !account.appId || !account.appSecret) {
         return tool_errmsg(`invalid tuitui account ${ctx.agentAccountId}`);
@@ -107,21 +109,42 @@ const tuitui_get_announcement_factory = (ctx: OpenClawPluginToolContext) => {
 
 
 
-const tuitui_file_space_factory = (ctx: OpenClawPluginToolContext) => {
+const tuitui_file_space_list_factory = (ctx: OpenClawPluginToolContext) => {
   return {
     name: "tuitui_file_space_list",
     label: "tuitui_file_space_list",
-    description: "推推(tuitui) 团队频道的共享文件（共享空间）的文件列表\n\n",
+    description: "推推(tuitui) 在当前Session的共享文件（共享空间）文件列表\n\n",
     parameters: Type.Object({
-      space_id: Type.String({ description: "空间ID。请传入 GroupChannel 或者 GroupId 中非空的值" }),
+      // 参数不能为空，对模型兼容有问题，即使不用也要传一个
+      reason: Type.String({ description: "调用本工具的原因" }),
     }),
     execute: async (_toolCallId: any, params: any) => {
-      console.log(`tuitui_file_space_list(): agentAccountId: ${ctx.agentAccountId}, sessionKey: ${ctx.sessionKey}`, params);
+      console.log(`tuitui_file_space_list(): agentAccountId: ${ctx.agentAccountId}, sessionKey: ${ctx.sessionKey}`);
       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 file_space_list(account, params?.space_id);
+      return await file_space_list(account, ctx.sessionKey||"");
+    },
+  };
+};
+
+const tuitui_file_space_add_factory = (ctx: OpenClawPluginToolContext) => {
+  return {
+    name: "tuitui_file_space_add",
+    label: "tuitui_file_space_add",
+    description: "推推(tuitui) 团队频道的共享文件（共享空间）添加文件\n\n",
+    parameters: Type.Object({
+      cloud_filepath: Type.String({ description: "云端文件名路径，父目录不存在会自动创建。不含目录代表放根目录示例 1.png ，也支持带目录写法例如 /image/1.png" }),
+      url_or_localpath: Type.String({ description: "支持两种格式：以http开头的文件url；或者本地全路径文件名" }),
+    }),
+    execute: async (_toolCallId: any, params: any) => {
+      console.log(`tuitui_file_space_add(): 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 file_space_add(account, ctx.sessionKey||"", params?.cloud_filepath, params?.url_or_localpath);
     },
   };
 };
@@ -136,6 +159,7 @@ export function registerTuituiTools(api: OpenClawPluginApi) {
   api.registerTool(tuitui_im_get_messages_factory);
   api.registerTool(tuitui_send_channel_post_factory);
   api.registerTool(tuitui_get_announcement_factory);
-  api.registerTool(tuitui_file_space_factory);
+  api.registerTool(tuitui_file_space_list_factory);
+  api.registerTool(tuitui_file_space_add_factory);
   api.logger.info?.(`tuitui: Registered tool`);
 }

package/src/types.ts

@@ -128,15 +128,6 @@ export interface TuiTuiOutboundPageMessage {
   page: TuiTuiOutboundPageMessagePage;
 }
 
-export interface TuiTuiMediaUploadResponse {
-  errcode: number;
-  errmsg: string;
-  filename?: string;
-  media_id?: string;
-}
-
-
-
 export interface TuiTuiSingleEmojiReactionTarget {
   user?: string;
   msgid?: string;