agent-bridge-feishu 1.0.0 → 1.0.1

package/README.md

@@ -1,10 +1,10 @@
 # 飞书通道插件
 
-可通过管理接口创建飞书机器人：
+在管理页面打开飞书通道的设置页，点击「创建飞书机器人」。页面会显示二维码和创建链接，授权完成后自动保存凭据并连接。随后在「关联 Agent」表单选择本地 Agent。
 
-1. `POST /api/plugins/feishu/setup/begin`，响应中的 `url` 即飞书授权 URL。
+1. `POST /api/plugins/feishu/setup/begin`，响应中的 `url`（兼容字段 `qr_url`）即飞书授权 URL，`qr_image` 为 PNG 二维码 data URL。
 2. 用户打开 URL 完成授权。
-3. 轮询 `POST /api/plugins/feishu/setup/poll`，提交第一步返回的 `device_code`；完成后插件会保存 `app_id/app_secret`。
+3. 按 `interval` 秒间隔轮询 `POST /api/plugins/feishu/setup/poll`，提交第一步返回的 `device_code`；完成后插件会保存 `app_id/app_secret`。凭据不会出现在响应中。
 4. 重载飞书插件，插件通过长连接接收文本消息，并将消息转发到已启动的本地 Agent 插件。
 
 也可以直接配置飞书开放平台应用的 `app_id` 和 `app_secret`。通过配置中的 `agent_plugin` 或管理界面的绑定功能指定目标 Agent。

package/dist/src-ts/plugins/feishu/index.js

@@ -3,8 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FeishuPlugin = void 0;
 const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
+const qrcode_1 = require("qrcode");
 const client_1 = require("./client");
-const manifest = { id: "feishu", version: "1.0.0", type: "channel", displayName: "飞书通道", entry: "dist/src-ts/plugins/feishu/index.js", apiVersion: "1", process: "in-process", capabilities: ["channel", "channel.bot.setup", "channel.receive", "channel.send", "health"], configSchema: "config.schema.json", managementPage: "/abweb/channels/feishu" };
+const manifest = { id: "feishu", version: "1.0.1", type: "channel", displayName: "飞书通道", entry: "dist/src-ts/plugins/feishu/index.js", apiVersion: "1", process: "in-process", capabilities: ["channel", "channel.bot.setup", "channel.receive", "channel.send", "health"], configSchema: "config.schema.json", managementPage: "/abweb/channels/feishu" };
 class FeishuPlugin {
     options;
     manifest = manifest;
@@ -166,7 +167,10 @@ class FeishuPlugin {
                 throw new Error(result.error_description ? `${result.error}: ${result.error_description}` : result.error);
             if (typeof result.device_code !== "string" || typeof result.verification_uri_complete !== "string")
                 throw new Error("飞书授权响应缺少设备码或授权 URL");
-            this.json(response, 200, { device_code: result.device_code, url: result.verification_uri_complete, interval: Number(result.interval ?? 5), expires_in: Number(result.expire_in ?? 600) });
+            const url = new URL(result.verification_uri_complete);
+            if (url.protocol !== "https:")
+                throw new Error("飞书授权 URL 必须使用 HTTPS");
+            this.json(response, 200, { device_code: result.device_code, url: url.href, qr_url: url.href, qr_image: await (0, qrcode_1.toDataURL)(url.href, { width: 256, margin: 4 }), interval: Number(result.interval ?? 5), expires_in: Number(result.expire_in ?? 600) });
         }
         catch (error) {
             this.json(response, 502, { error: error instanceof Error ? error.message : String(error) });
@@ -188,8 +192,8 @@ class FeishuPlugin {
                 return this.json(response, 200, { status: "completed", app_id: appId, owner_open_id: user?.open_id });
             }
             const errorCode = typeof result.error === "string" ? result.error : "";
-            const status = errorCode === "authorization_pending" ? "pending" : errorCode === "access_denied" ? "denied" : errorCode === "expired_token" ? "expired" : "error";
-            return this.json(response, 200, { status, ...(status === "error" ? { error: result.error_description || errorCode || "飞书授权响应无效" } : {}) });
+            const status = ["authorization_pending", "slow_down"].includes(errorCode) ? "pending" : errorCode === "access_denied" ? "denied" : errorCode === "expired_token" ? "expired" : "error";
+            return this.json(response, 200, { status, ...(status === "error" ? { error: result.error_description || errorCode || "飞书授权响应无效" } : {}), ...(errorCode === "slow_down" ? { slow_down: true } : {}) });
         }
         catch (error) {
             this.json(response, 502, { error: error instanceof Error ? error.message : String(error) });

package/dist/src-ts/plugins/feishu/public/app.js

@@ -3,10 +3,14 @@
   const notice = find("#notice");
   const authState = find("#authorization-state");
   const authLink = find("#authorization-link");
+  const authDetails = find("#authorization-details");
+  const authQr = find("#authorization-qr");
+  const authUrl = find("#authorization-url");
   const credentials = find("#credentials");
   const binding = find("#binding");
   const settings = find("#settings");
   let pollTimer;
+  let setup = 0;
 
   async function request(path, method = "GET", body) {
     const token = localStorage.getItem("mab-login-token");
@@ -40,33 +44,43 @@
     await request("/api/plugins/feishu/reload", "POST");
     await load();
   }
-  async function poll(deviceCode, interval, deadline) {
-    if (Date.now() >= deadline) { authState.textContent = "授权已过期，请重新开始"; return; }
+  async function poll(deviceCode, interval, deadline, currentSetup) {
+    if (currentSetup !== setup) return;
+    if (Date.now() >= deadline) { authState.textContent = "授权已过期，请重新开始"; find("#begin").disabled = false; return; }
     try {
       const result = await request("/api/plugins/feishu/setup/poll", "POST", { device_code: deviceCode });
-      if (result.status === "completed") { authState.textContent = "授权完成，正在连接"; await reconnect(); authState.textContent = "授权完成"; return; }
-      if (result.status === "denied") { authState.textContent = "授权已拒绝"; return; }
-      if (result.status === "expired") { authState.textContent = "授权已过期，请重新开始"; return; }
-      if (result.status === "error") { authState.textContent = `授权失败：${result.error || "未知错误"}`; return; }
+      if (currentSetup !== setup) return;
+      if (result.status === "completed") { authState.textContent = "授权完成，正在连接"; await reconnect(); if (currentSetup === setup) { authState.textContent = "授权完成"; find("#begin").disabled = false; } return; }
+      if (result.status === "denied") { authState.textContent = "授权已拒绝"; find("#begin").disabled = false; return; }
+      if (result.status === "expired") { authState.textContent = "授权已过期，请重新开始"; find("#begin").disabled = false; return; }
+      if (result.status === "error") { authState.textContent = `授权失败：${result.error || "未知错误"}`; find("#begin").disabled = false; return; }
       authState.textContent = "等待飞书授权";
-      pollTimer = setTimeout(() => void poll(deviceCode, interval, deadline), interval);
-    } catch (error) { authState.textContent = `授权检查失败：${String(error)}`; }
+      const nextInterval = interval + (result.slow_down ? 5000 : 0);
+      pollTimer = setTimeout(() => void poll(deviceCode, nextInterval, deadline, currentSetup), nextInterval);
+    } catch (error) { if (currentSetup === setup) { authState.textContent = `授权检查失败：${String(error)}`; find("#begin").disabled = false; } }
   }
   find("#begin").onclick = async () => {
-    clearTimeout(pollTimer); authLink.hidden = true; authState.textContent = "正在申请设备授权";
+    const currentSetup = ++setup;
+    find("#begin").disabled = true;
+    clearTimeout(pollTimer); authLink.hidden = true; authDetails.hidden = true; authState.textContent = "正在申请设备授权";
     try {
       const result = await request("/api/plugins/feishu/setup/begin", "POST");
+      if (currentSetup !== setup) return;
       const url = new URL(result.url);
       if (url.protocol !== "https:") throw new Error("飞书授权地址无效");
       authLink.href = url.href; authLink.hidden = false;
+      authQr.src = result.qr_image;
+      authUrl.textContent = url.href;
+      authDetails.hidden = false;
       authState.textContent = "等待飞书授权";
-      pollTimer = setTimeout(() => void poll(result.device_code, Math.max(1, Number(result.interval) || 5) * 1000, Date.now() + (Number(result.expires_in) || 600) * 1000), 1000);
-    } catch (error) { authState.textContent = `启动授权失败：${String(error)}`; }
+      const interval = Math.max(1, Number(result.interval) || 5) * 1000;
+      pollTimer = setTimeout(() => void poll(result.device_code, interval, Date.now() + (Number(result.expires_in) || 600) * 1000, currentSetup), interval);
+    } catch (error) { if (currentSetup === setup) { authState.textContent = `启动授权失败：${String(error)}`; find("#begin").disabled = false; } }
   };
   credentials.onsubmit = (event) => { event.preventDefault(); void request("/api/plugins/feishu/bot", "POST", { app_id: credentials.elements.app_id.value.trim(), app_secret: credentials.elements.app_secret.value }).then(reconnect).then(() => show("凭据已保存，正在连接")).catch((error) => show(String(error), true)); };
   binding.onsubmit = (event) => { event.preventDefault(); void request("/api/plugins/feishu/bind", "POST", { pluginId: binding.elements.pluginId.value }).then(load).then(() => show("Agent 已关联")).catch((error) => show(String(error), true)); };
   settings.onsubmit = (event) => { event.preventDefault(); void request("/api/plugins/feishu/settings", "POST", { agent_plugin: settings.elements.agent_plugin.value, allow_from: settings.elements.allow_from.value, allow_chats: settings.elements.allow_chats.value }).then(load).then(() => show("配置已保存")).catch((error) => show(String(error), true)); };
   find("#refresh").onclick = () => void load();
-  window.addEventListener("pagehide", () => clearTimeout(pollTimer));
+  window.addEventListener("pagehide", () => { setup++; clearTimeout(pollTimer); });
   void load();
 })();

package/dist/src-ts/plugins/feishu/public/index.html

@@ -6,7 +6,7 @@
     <header><h1>飞书机器人</h1><button id="refresh" type="button">刷新</button></header>
     <p id="notice" role="status"></p>
     <dl><div><dt>连接状态</dt><dd id="connection">未配置</dd></div><div><dt>App ID</dt><dd id="app-id">未配置</dd></div><div><dt>关联 Agent</dt><dd id="bound-agent">未关联</dd></div></dl>
-    <section><h2>设备授权</h2><div class="actions"><button id="begin" type="button">开始授权</button><a id="authorization-link" target="_blank" rel="noopener noreferrer" hidden>打开飞书授权页面</a></div><p id="authorization-state" role="status"></p></section>
+    <section><h2>创建设备授权</h2><div class="actions"><button id="begin" type="button">创建飞书机器人</button><a id="authorization-link" target="_blank" rel="noopener noreferrer" hidden>打开飞书创建链接</a></div><div id="authorization-details" hidden><img id="authorization-qr" width="256" height="256" alt="飞书机器人创建授权二维码"><p id="authorization-url"></p></div><p id="authorization-state" role="status"></p></section>
     <form id="credentials"><h2>手动配置凭据</h2><div class="fields"><label>App ID<input name="app_id" required autocomplete="off"></label><label>App Secret<input name="app_secret" type="password" required autocomplete="new-password"></label></div><button type="submit">保存并连接</button></form>
     <form id="binding"><h2>关联 Agent</h2><div class="fields"><label>Agent<select name="pluginId" required></select></label></div><button type="submit">关联</button></form>
     <form id="settings"><h2>通道配置</h2><div class="fields"><label>默认 Agent<select name="agent_plugin"></select></label><label>允许的 open_id<input name="allow_from"></label><label>允许的 chat_id<input name="allow_chats"></label></div><button type="submit">保存配置</button></form>

package/dist/src-ts/plugins/feishu/public/style.css

@@ -17,6 +17,9 @@ input, select, button { min-height: 34px; padding: 6px 9px; border: 1px solid #b
 button { cursor: pointer; }
 button:hover { background: #e5f2ea; }
 .actions { display: flex; align-items: center; gap: 14px; flex-wrap: wrap; }
+#authorization-details { margin-top: 12px; }
+#authorization-qr { display: block; width: min(256px, 100%); height: auto; aspect-ratio: 1; }
+#authorization-url { overflow-wrap: anywhere; }
 a { color: #176848; }
 .error { color: #a83427; }
 @media (max-width: 620px) { .fields, dl { grid-template-columns: 1fr; } }

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "agent-bridge-feishu",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "agent-bridge 的飞书通道插件。",
   "keywords": ["mu-agent-bridge-plugin", "mu-agent-bridge-channel"],
   "main": "dist/src-ts/plugins/feishu/index.js",
   "files": ["dist/", "plugin.json", "config.schema.json", "README.md"],
   "agentBridge": { "plugin": "./plugin.json", "type": "channel" },
   "engines": { "node": ">=22" },
+  "dependencies": { "qrcode": "^1.5.4" },
   "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" }
 }

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "feishu",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "channel",
   "displayName": "飞书通道",
   "entry": "dist/src-ts/plugins/feishu/index.js",