@m1heng-clawd/feishu 0.1.12 → 0.1.13

package/README.md

@@ -27,14 +27,33 @@ openclaw plugins install @m1heng-clawd/feishu
 > [!IMPORTANT]
 > **Windows Troubleshooting (`spawn npm ENOENT`)**
 >
-> If `openclaw plugins install` fails, install manually:
+> If `openclaw plugins install` fails, install manually with the latest tarball:
 >
 > ```bash
-> # 1. Download the package
-> curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz
+> # Option A (recommended): download latest package tarball
+> npm pack @m1heng-clawd/feishu
+> openclaw plugins install ./m1heng-clawd-feishu-<version>.tgz
+> ```
+>
+> ```bash
+> # Option B (keep curl flow): resolve latest tarball URL, then download/install
+> TARBALL_URL="$(npm view @m1heng-clawd/feishu dist.tarball)"
+> curl -L -o feishu-latest.tgz "$TARBALL_URL"
+> openclaw plugins install ./feishu-latest.tgz
+> ```
 >
-> # 2. Install from local file
-> openclaw plugins install ./feishu-0.1.3.tgz
+> ```powershell
+> # Windows PowerShell (Option B)
+> $tarball = npm view @m1heng-clawd/feishu dist.tarball
+> curl.exe -L $tarball -o feishu-latest.tgz
+> openclaw plugins install .\feishu-latest.tgz
+> ```
+>
+> ```bash
+> # Option C (no npm command): use URL template with latest version from npm Versions tab
+> # https://www.npmjs.com/package/@m1heng-clawd/feishu?activeTab=versions
+> curl -L -o feishu-latest.tgz https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-<version>.tgz
+> openclaw plugins install ./feishu-latest.tgz
 > ```
 
 ### Upgrade
@@ -43,6 +62,12 @@ openclaw plugins install @m1heng-clawd/feishu
 openclaw plugins update feishu
 ```
 
+Check installed version:
+
+```bash
+openclaw plugins list | rg -i feishu
+```
+
 ### Configuration
 
 1. Create a self-built app on [Feishu Open Platform](https://open.feishu.cn)
@@ -478,14 +503,33 @@ openclaw plugins install @m1heng-clawd/feishu
 > [!IMPORTANT]
 > **Windows 排错（`spawn npm ENOENT`）**
 >
-> 如果 `openclaw plugins install` 失败，可以手动安装：
+> 如果 `openclaw plugins install` 失败，可通过最新 tarball 手动安装：
 >
 > ```bash
-> # 1. 下载插件包
-> curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz
+> # 方案 A（推荐）：下载最新插件 tarball
+> npm pack @m1heng-clawd/feishu
+> openclaw plugins install ./m1heng-clawd-feishu-<version>.tgz
+> ```
+>
+> ```bash
+> # 方案 B（保留 curl 路径）：先解析最新 tarball 地址，再下载安装
+> TARBALL_URL="$(npm view @m1heng-clawd/feishu dist.tarball)"
+> curl -L -o feishu-latest.tgz "$TARBALL_URL"
+> openclaw plugins install ./feishu-latest.tgz
+> ```
 >
-> # 2. 从本地安装
-> openclaw plugins install ./feishu-0.1.3.tgz
+> ```powershell
+> # Windows PowerShell（方案 B）
+> $tarball = npm view @m1heng-clawd/feishu dist.tarball
+> curl.exe -L $tarball -o feishu-latest.tgz
+> openclaw plugins install .\feishu-latest.tgz
+> ```
+>
+> ```bash
+> # 方案 C（无 npm 命令）：先在 npm Versions 页查到最新版本号，再套用 URL 模板
+> # https://www.npmjs.com/package/@m1heng-clawd/feishu?activeTab=versions
+> curl -L -o feishu-latest.tgz https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-<version>.tgz
+> openclaw plugins install ./feishu-latest.tgz
 > ```
 
 ### 升级
@@ -494,6 +538,12 @@ openclaw plugins install @m1heng-clawd/feishu
 openclaw plugins update feishu
 ```
 
+查看已安装版本：
+
+```bash
+openclaw plugins list | rg -i feishu
+```
+
 ### 配置
 
 1. 在 [飞书开放平台](https://open.feishu.cn) 创建自建应用

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m1heng-clawd/feishu",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "type": "module",
   "description": "OpenClaw Feishu/Lark channel plugin",
   "scripts": {

package/src/channel.ts

@@ -97,6 +97,7 @@ export const feishuPlugin: ChannelPlugin<ResolvedFeishuAccount> = {
         textChunkLimit: { type: "integer", minimum: 1 },
         chunkMode: { type: "string", enum: ["length", "newline"] },
         mediaMaxMb: { type: "number", minimum: 0 },
+        mediaLocalRoots: { type: "array", items: { type: "string" } },
         renderMode: { type: "string", enum: ["auto", "raw", "card"] },
         accounts: {
           type: "object",
@@ -111,6 +112,7 @@ export const feishuPlugin: ChannelPlugin<ResolvedFeishuAccount> = {
               verificationToken: { type: "string" },
               domain: { type: "string", enum: ["feishu", "lark"] },
               connectionMode: { type: "string", enum: ["websocket", "webhook"] },
+              mediaLocalRoots: { type: "array", items: { type: "string" } },
               groupCommandMentionBypass: { type: "string", enum: ["never", "single_bot", "always"] },
             },
           },

package/src/config-schema.ts

@@ -148,6 +148,7 @@ export const FeishuAccountConfigSchema = z
     chunkMode: z.enum(["length", "newline"]).optional(),
     blockStreamingCoalesce: BlockStreamingCoalesceSchema,
     mediaMaxMb: z.number().positive().optional(),
+    mediaLocalRoots: z.array(z.string()).optional(),
     heartbeat: ChannelHeartbeatVisibilitySchema,
     renderMode: RenderModeSchema,
     streaming: StreamingModeSchema,
@@ -185,6 +186,7 @@ export const FeishuConfigSchema = z
     chunkMode: z.enum(["length", "newline"]).optional(),
     blockStreamingCoalesce: BlockStreamingCoalesceSchema,
     mediaMaxMb: z.number().positive().optional(),
+    mediaLocalRoots: z.array(z.string()).optional(),
     heartbeat: ChannelHeartbeatVisibilitySchema,
     renderMode: RenderModeSchema, // raw = plain text (default), card = interactive card with markdown
     streaming: StreamingModeSchema,

package/src/media.ts

@@ -470,10 +470,30 @@ export async function sendMediaFeishu(params: {
     buffer = mediaBuffer;
     name = fileName ?? "file";
   } else if (mediaUrl) {
-    const loaded = await getFeishuRuntime().media.loadWebMedia(mediaUrl, {
-      maxBytes: mediaMaxBytes,
-      optimizeImages: false,
-    });
+    const mediaLocalRoots = (account.config?.mediaLocalRoots ?? [])
+      .map((root) => root.trim())
+      .filter((root) => root.length > 0);
+    const loaded = await (async () => {
+      try {
+        return await getFeishuRuntime().media.loadWebMedia(mediaUrl, {
+          maxBytes: mediaMaxBytes,
+          optimizeImages: false,
+        });
+      } catch (err) {
+        const shouldRetryWithCustomRoots =
+          mediaLocalRoots.length > 0 &&
+          err instanceof Error &&
+          err.message.includes("Local media path is not under an allowed directory");
+        if (!shouldRetryWithCustomRoots) {
+          throw err;
+        }
+        return await getFeishuRuntime().media.loadWebMedia(mediaUrl, {
+          maxBytes: mediaMaxBytes,
+          optimizeImages: false,
+          localRoots: mediaLocalRoots,
+        });
+      }
+    })();
     buffer = loaded.buffer;
     name = fileName ?? loaded.fileName ?? "file";
   } else {

package/src/reply-dispatcher.ts

@@ -103,7 +103,7 @@ export function createFeishuReplyDispatcher(params: CreateFeishuReplyDispatcherP
         params.runtime.log?.(`feishu[${account.accountId}] ${message}`),
       );
       try {
-        await streaming.start(chatId, resolveReceiveIdType(chatId));
+        await streaming.start(chatId, resolveReceiveIdType(chatId), replyToMessageId);
       } catch (error) {
         params.runtime.error?.(`feishu: streaming start failed: ${String(error)}`);
         streaming = null;

package/src/streaming-card.ts

@@ -72,6 +72,7 @@ export class FeishuStreamingSession {
   async start(
     receiveId: string,
     receiveIdType: "open_id" | "user_id" | "union_id" | "email" | "chat_id" = "chat_id",
+    replyToMessageId?: string,
   ): Promise<void> {
     if (this.state) {
       return;
@@ -108,14 +109,16 @@ export class FeishuStreamingSession {
     }
     const cardId = createData.data.card_id;
 
-    const sendRes = await this.client.im.message.create({
-      params: { receive_id_type: receiveIdType },
-      data: {
-        receive_id: receiveId,
-        msg_type: "interactive",
-        content: JSON.stringify({ type: "card", data: { card_id: cardId } }),
-      },
-    });
+    const cardContent = JSON.stringify({ type: "card", data: { card_id: cardId } });
+    const sendRes = replyToMessageId
+      ? await this.client.im.message.reply({
+          path: { message_id: replyToMessageId },
+          data: { msg_type: "interactive", content: cardContent },
+        })
+      : await this.client.im.message.create({
+          params: { receive_id_type: receiveIdType },
+          data: { receive_id: receiveId, msg_type: "interactive", content: cardContent },
+        });
     if (sendRes.code !== 0 || !sendRes.data?.message_id) {
       throw new Error(`Send card failed: ${sendRes.msg}`);
     }

package/src/task-tools/actions.ts

@@ -553,13 +553,15 @@ export async function uploadTaskAttachment(
   let tempCleanup: (() => Promise<void>) | undefined;
   let filePath: string;
 
-  if ("file_path" in params) {
+  if (params.file_path) {
     filePath = params.file_path;
     await ensureUploadableLocalFile(filePath, maxBytes);
-  } else {
+  } else if (params.file_url) {
     const download = await downloadToTempFile(params.file_url, params.filename, maxBytes);
     filePath = download.tempPath;
     tempCleanup = download.cleanup;
+  } else {
+    throw new Error("Either file_path or file_url is required");
   }
 
   try {

package/src/task-tools/schemas.ts

@@ -156,18 +156,13 @@ export type DeleteTaskCommentParams = {
   comment_id: TaskCommentDeletePayload["path"]["comment_id"];
 };
 
-export type UploadTaskAttachmentParams =
-  | {
-      task_guid: string;
-      file_path: string;
-      user_id_type?: NonNullable<TaskAttachmentUploadPayload["params"]>["user_id_type"];
-    }
-  | {
-      task_guid: string;
-      file_url: string;
-      filename?: string;
-      user_id_type?: NonNullable<TaskAttachmentUploadPayload["params"]>["user_id_type"];
-    };
+export type UploadTaskAttachmentParams = {
+  task_guid: string;
+  file_path?: string;
+  file_url?: string;
+  filename?: string;
+  user_id_type?: NonNullable<TaskAttachmentUploadPayload["params"]>["user_id_type"];
+};
 
 export type ListTaskAttachmentsParams = {
   task_guid: NonNullable<TaskAttachmentListPayload["params"]>["resource_id"];
@@ -300,12 +295,10 @@ export const CreateTaskSchema = Type.Object({
   ),
 });
 
-export const CreateSubtaskSchema = Type.Intersect([
-  Type.Object({
-    task_guid: Type.String({ description: "Parent task GUID" }),
-  }),
-  CreateTaskSchema,
-]);
+export const CreateSubtaskSchema = Type.Object({
+  task_guid: Type.String({ description: "Parent task GUID" }),
+  ...CreateTaskSchema.properties,
+});
 
 export const DeleteTaskSchema = Type.Object({
   task_guid: Type.String({ description: "Task GUID to delete" }),
@@ -521,23 +514,19 @@ export const RemoveTasklistMembersSchema = Type.Object({
   ),
 });
 
-export const UploadTaskAttachmentSchema = Type.Union([
-  Type.Object({
-    task_guid: Type.String({ description: "Task GUID to upload attachment to" }),
-    file_path: Type.String({ description: "Local file path on the OpenClaw host" }),
-    user_id_type: Type.Optional(
-      Type.String({ description: "User ID type for returned uploader" }),
-    ),
-  }),
-  Type.Object({
-    task_guid: Type.String({ description: "Task GUID to upload attachment to" }),
-    file_url: Type.String({ description: "Remote file URL to download and upload" }),
-    filename: Type.Optional(Type.String({ description: "Override filename for uploaded attachment" })),
-    user_id_type: Type.Optional(
-      Type.String({ description: "User ID type for returned uploader" }),
-    ),
-  }),
-]);
+export const UploadTaskAttachmentSchema = Type.Object({
+  task_guid: Type.String({ description: "Task GUID to upload attachment to" }),
+  file_path: Type.Optional(
+    Type.String({ description: "Local file path on the OpenClaw host (provide either file_path or file_url)" }),
+  ),
+  file_url: Type.Optional(
+    Type.String({ description: "Remote file URL to download and upload (provide either file_path or file_url)" }),
+  ),
+  filename: Type.Optional(Type.String({ description: "Override filename for uploaded attachment (only with file_url)" })),
+  user_id_type: Type.Optional(
+    Type.String({ description: "User ID type for returned uploader" }),
+  ),
+});
 
 export const ListTaskAttachmentsSchema = Type.Object({
   task_guid: Type.String({ description: "Task GUID to list attachments for" }),