fix(feishu): omit command guidance when URL overrides fallback command text

xialonglee · xialonglee · commit 4bcf0a59a6eb · 2026-06-21T16:04:54.000+08:00
diff --git a/extensions/feishu/src/outbound.test.ts b/extensions/feishu/src/outbound.test.ts
@@ -834,6 +834,37 @@ describe("feishuOutbound.sendPayload native cards", () => {
     );
     expectFeishuResult(result, "reply_msg");
   });
+
+  it("omits command guidance when all command buttons have URLs overriding the fallback text", async () => {
+    const result = await feishuOutbound.sendPayload?.({
+      cfg: emptyConfig,
+      to: "comment:docx:doxcn123:7623358762119646411",
+      text: "Review this",
+      accountId: "main",
+      payload: {
+        text: "Review this",
+        interactive: {
+          blocks: [
+            {
+              type: "buttons",
+              buttons: [
+                {
+                  label: "Open URL",
+                  url: "https://example.com/action",
+                  action: { type: "command", command: "/approve req_1" },
+                },
+              ],
+            },
+          ],
+        },
+      },
+    });
+
+    expect(commentThreadParams()?.content).toBe(
+      "Review this\n\n- Open URL: https://example.com/action",
+    );
+    expectFeishuResult(result, "reply_msg");
+  });
 });
 
 describe("feishuOutbound comment-thread routing", () => {
diff --git a/extensions/feishu/src/outbound.ts b/extensions/feishu/src/outbound.ts
@@ -518,13 +518,19 @@ export const feishuOutbound: ChannelOutboundAdapter = {
         text: ctx.payload.text,
         presentation: normalizedPresentation,
       });
-      const hasCommandAction =
+      const hasRenderedCommandAction =
         normalizedPresentation?.blocks.some(
           (block) =>
             block.type === "buttons" &&
-            block.buttons.some((button) => button.action?.type === "command"),
+            block.buttons.some(
+              (button) =>
+                button.action?.type === "command" &&
+                !button.url &&
+                !button.webApp?.url &&
+                !button.web_app?.url,
+            ),
         ) ?? false;
-      const text = hasCommandAction
+      const text = hasRenderedCommandAction
         ? `${presentationFallbackText}\n\n> Interactive buttons are unavailable in Feishu document comments. You can type the command shown above manually.`
         : presentationFallbackText;
 
