agent-bridge-feishu 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,12 @@
-# Temporary Holding Version
+# 飞书通道插件
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+在管理页面打开飞书通道的设置页，点击「创建飞书机器人」。页面会显示二维码和创建链接，授权完成后自动保存凭据并连接。随后在「关联 Agent」表单选择本地 Agent。
+
+1. `POST /api/plugins/feishu/setup/begin`，响应中的 `url`（兼容字段 `qr_url`）即飞书授权 URL，`qr_image` 为 PNG 二维码 data URL。
+2. 用户打开 URL 完成授权。
+3. 按 `interval` 秒间隔轮询 `POST /api/plugins/feishu/setup/poll`，提交第一步返回的 `device_code`；完成后插件会保存 `app_id/app_secret`。凭据不会出现在响应中。
+4. 重载飞书插件，插件通过长连接接收文本消息，并将消息转发到已启动的本地 Agent 插件。
+
+也可以直接配置飞书开放平台应用的 `app_id` 和 `app_secret`。通过配置中的 `agent_plugin` 或管理界面的绑定功能指定目标 Agent。
+
+飞书应用需要开启机器人能力和接收消息事件权限。插件默认使用飞书中国区 API，可通过 `api_base` 指定其他区域地址。

package/config.schema.json

@@ -0,0 +1,14 @@
+{
+  "type": "object",
+  "properties": {
+    "app_id": { "type": "string" },
+    "app_secret": { "type": "string", "secret": true },
+    "agent_plugin": { "type": "string" },
+    "bindings": { "type": "object", "additionalProperties": { "type": "string" } },
+    "allow_from": { "type": "string" },
+    "allow_chats": { "type": "string" },
+    "ws_url": { "type": "string" },
+    "api_base": { "type": "string" }
+  },
+  "additionalProperties": false
+}

package/dist/src-ts/agent.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentError = void 0;
+class AgentError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "AgentError";
+    }
+}
+exports.AgentError = AgentError;

package/dist/src-ts/channel.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeishuClient = void 0;
+exports.parseFeishuEvent = parseFeishuEvent;
+const defaultTransport = { fetch, WebSocket };
+function parseFeishuEvent(input) {
+    if (!input || typeof input !== "object")
+        return undefined;
+    const root = input;
+    if (root.type === "ping" || root.type === "challenge")
+        return undefined;
+    const event = root.event ?? root.data?.event ?? root;
+    const message = event?.message;
+    const messageId = typeof message?.message_id === "string" ? message.message_id : typeof event?.message_id === "string" ? event.message_id : "";
+    const peerId = typeof event?.sender?.sender_id?.open_id === "string" ? event.sender.sender_id.open_id : typeof event?.sender?.sender_id?.user_id === "string" ? event.sender.sender_id.user_id : "";
+    const chatId = typeof message?.chat_id === "string" ? message.chat_id : undefined;
+    const threadId = typeof message?.thread_id === "string" ? message.thread_id : undefined;
+    if (!messageId || !peerId || typeof message?.message_type !== "undefined" && message.message_type !== "text")
+        return undefined;
+    let text = "";
+    try {
+        const content = typeof message.content === "string" ? JSON.parse(message.content) : message.content;
+        text = typeof content?.text === "string" ? content.text : "";
+    }
+    catch {
+        return undefined;
+    }
+    if (!text.trim())
+        return undefined;
+    return { messageId, peerId, ...(chatId ? { chatId } : {}), ...(threadId ? { threadId } : {}), text: text.trim() };
+}
+class FeishuClient {
+    config;
+    transport;
+    socket;
+    token = "";
+    tokenExpires = 0;
+    constructor(config, transport = defaultTransport) {
+        this.config = config;
+        this.transport = transport;
+    }
+    async start(onMessage, signal) {
+        const url = this.config.ws_url ?? await this.endpoint();
+        const socket = new this.transport.WebSocket(url);
+        this.socket = socket;
+        await new Promise((resolve, reject) => {
+            socket.onopen = () => resolve();
+            socket.onerror = () => reject(new Error("飞书长连接失败"));
+        });
+        socket.onmessage = (event) => { void this.receive(String(event.data), onMessage); };
+        signal?.addEventListener("abort", () => this.close(), { once: true });
+    }
+    close() { this.socket?.close(); this.socket = undefined; }
+    async send(peerId, text, threadId) {
+        const token = await this.accessToken();
+        const body = { receive_id: peerId, msg_type: "text", content: JSON.stringify({ text }) };
+        if (threadId)
+            body.reply_in_thread = true;
+        const response = await this.transport.fetch(`${this.apiBase()}/open-apis/im/v1/messages?receive_id_type=open_id`, { method: "POST", headers: { Authorization: `Bearer ${token}`, "content-type": "application/json" }, body: JSON.stringify(body) });
+        if (!response.ok)
+            throw new Error(`飞书发送消息失败：HTTP ${response.status}`);
+        const result = await response.json();
+        if (result.code && result.code !== 0)
+            throw new Error(`飞书发送消息失败：${result.msg ?? result.code}`);
+    }
+    async receive(raw, onMessage) {
+        let payload;
+        try {
+            payload = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        if (payload.type === "ping") {
+            this.socket?.send(JSON.stringify({ type: "pong" }));
+            return;
+        }
+        if (payload.type === "url_verification" && payload.challenge) {
+            this.socket?.send(JSON.stringify({ challenge: payload.challenge }));
+            return;
+        }
+        const event = parseFeishuEvent(payload);
+        if (event)
+            await onMessage(event);
+    }
+    async endpoint() {
+        const response = await this.transport.fetch(`${this.apiBase()}/open-apis/callback/ws/endpoint?app_id=${encodeURIComponent(this.config.app_id)}&app_secret=${encodeURIComponent(this.config.app_secret)}`);
+        if (!response.ok)
+            throw new Error(`获取飞书长连接地址失败：HTTP ${response.status}`);
+        const result = await response.json();
+        const url = result.data?.URL ?? result.data?.url;
+        if (result.code && result.code !== 0 || !url)
+            throw new Error(`获取飞书长连接地址失败：${result.msg ?? "响应无 URL"}`);
+        return url;
+    }
+    async accessToken() {
+        if (this.token && Date.now() < this.tokenExpires)
+            return this.token;
+        const response = await this.transport.fetch(`${this.apiBase()}/open-apis/auth/v3/tenant_access_token/internal`, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ app_id: this.config.app_id, app_secret: this.config.app_secret }) });
+        if (!response.ok)
+            throw new Error(`获取飞书令牌失败：HTTP ${response.status}`);
+        const result = await response.json();
+        if (result.code && result.code !== 0 || !result.tenant_access_token)
+            throw new Error(`获取飞书令牌失败：${result.msg ?? "响应无令牌"}`);
+        this.token = result.tenant_access_token;
+        this.tokenExpires = Date.now() + Math.max(60, (result.expire ?? 7200) - 60) * 1000;
+        return this.token;
+    }
+    apiBase() { return (this.config.api_base || "https://open.feishu.cn").replace(/\/$/, ""); }
+}
+exports.FeishuClient = FeishuClient;

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

@@ -0,0 +1,209 @@
+"use strict";
+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.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;
+    context;
+    client;
+    ingress;
+    config = {};
+    bindings = {};
+    status = "degraded";
+    message = "尚未配置飞书机器人";
+    unregister = [];
+    seen = new Set();
+    constructor(options = {}) {
+        this.options = options;
+        this.client = options.client;
+        this.ingress = options.ingress;
+    }
+    identity = {
+        list: async () => ({ evolcore: [], muAgentBridge: this.config.app_id ? [String(this.config.app_id)] : [], localMuAgentBridge: [] }),
+        create: async (aid) => { if (!aid.trim())
+            throw new Error("机器人标识不能为空"); return { aid, status: "请通过配置接口提供 app_id 和 app_secret" }; },
+        bind: async (pluginId, aid) => { if (pluginId === "feishu" || pluginId === "abweb")
+            throw new Error("只能关联 Agent 插件"); if (aid && aid !== this.config.app_id)
+            throw new Error("飞书机器人标识不存在"); if (this.context?.pluginStatus(pluginId) !== "ready")
+            throw new Error("目标 Agent 插件未启动"); if (aid)
+            this.bindings[String(aid)] = pluginId;
+        else
+            delete this.bindings[String(this.config.app_id)]; await this.persist(); },
+    };
+    async activate(context) {
+        this.context = context;
+        this.config = { ...context.config };
+        this.ingress ??= context.ingress;
+        if (!this.ingress)
+            throw new Error("运行时未提供通道消息入口");
+        for (const [method, path, handler] of [
+            ["POST", "/api/plugins/feishu/bot", this.configureBot],
+            ["POST", "/api/plugins/feishu/settings", this.configureSettings],
+            ["POST", "/api/plugins/feishu/setup/begin", this.setupBegin],
+            ["POST", "/api/plugins/feishu/setup/poll", this.setupPoll],
+            ["POST", "/api/plugins/feishu/bind", this.bindAgent],
+            ["GET", "/api/plugins/feishu/setup/status", this.setupStatus],
+            ...(["", "/app.js", "/style.css"].map((suffix) => ["GET", `/abweb/channels/feishu${suffix}`, this.servePage])),
+        ]) {
+            const route = context.http.register({ method, path, handler });
+            if (typeof route === "function")
+                this.unregister.push(route);
+        }
+        this.validate();
+        this.bindings = this.config.bindings && typeof this.config.bindings === "object" ? { ...this.config.bindings } : {};
+        if (!this.config.app_id || !this.config.app_secret)
+            return;
+        this.client ??= new client_1.FeishuClient(this.config);
+        try {
+            await this.client.start((event) => this.onMessage(event));
+            this.status = "ready";
+            this.message = "已连接";
+        }
+        catch (error) {
+            this.status = "degraded";
+            this.message = error instanceof Error ? error.message : String(error);
+            context.logger.warn("飞书通道连接失败", { error: this.message });
+        }
+    }
+    async deactivate(_reason) { this.client?.close(); for (const dispose of this.unregister.splice(0))
+        dispose(); this.status = "degraded"; this.context = undefined; }
+    async health() { return { status: this.status, message: this.message, details: { appId: this.config.app_id || undefined, bindings: this.bindings } }; }
+    async handle(_request) { throw new Error("飞书是入站通道插件"); }
+    async onMessage(event) {
+        const allowedFrom = this.csv("allow_from");
+        const allowedChats = this.csv("allow_chats");
+        if (allowedFrom.length && !allowedFrom.includes(event.peerId) || allowedChats.length && (!event.chatId || !allowedChats.includes(event.chatId)))
+            return;
+        if (this.seen.has(event.messageId))
+            return;
+        this.seen.add(event.messageId);
+        if (this.seen.size > 10000)
+            this.seen.delete(this.seen.values().next().value);
+        const channelMessage = { channel: "feishu", peerId: event.peerId, messageId: event.messageId, text: event.text, threadId: event.threadId, agentPlugin: this.bindings[String(this.config.app_id)] ?? this.config.agent_plugin ?? "qwenwork", reply: async (text) => { if (text.trim())
+                await this.client?.send(event.peerId, text, event.threadId); } };
+        try {
+            await this.ingress.publish(channelMessage);
+        }
+        catch (error) {
+            this.context?.logger.warn("飞书消息处理失败", { error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    validate() { for (const key of ["app_id", "app_secret", "agent_plugin", "allow_from", "allow_chats", "ws_url", "api_base"])
+        if (this.config[key] !== undefined && typeof this.config[key] !== "string")
+            throw new Error(`${key} 必须是字符串`); }
+    csv(key) { return String(this.config[key] ?? "").split(",").map((value) => value.trim()).filter(Boolean); }
+    async persist() { await (0, promises_1.mkdir)(this.context.dataDir, { recursive: true }); this.config.bindings = this.bindings; await (0, promises_1.writeFile)((0, node_path_1.join)(this.context.dataDir, "config.json"), `${JSON.stringify(this.config, null, 2)}\n`, { mode: 0o600 }); }
+    setupStatus = async (_request, response) => { this.json(response, 200, { app_id: this.config.app_id || "", configured: Boolean(this.config.app_id && this.config.app_secret), status: this.status, message: this.message, bindings: this.bindings, agent_plugin: this.config.agent_plugin || "", allow_from: this.config.allow_from || "", allow_chats: this.config.allow_chats || "" }); };
+    bindAgent = async (request, response) => {
+        try {
+            const body = await this.readJson(request);
+            const pluginId = typeof body.pluginId === "string" ? body.pluginId.trim() : "";
+            if (!this.config.app_id || !pluginId)
+                return this.json(response, 400, { error: "请先配置机器人并选择 Agent" });
+            await this.identity.bind(pluginId, String(this.config.app_id), 0);
+            this.context?.logger.info("飞书 Agent 已关联", { appId: this.config.app_id, pluginId });
+            this.json(response, 200, { ok: true, app_id: this.config.app_id, pluginId });
+        }
+        catch (error) {
+            this.context?.logger.warn("飞书 Agent 关联失败", { error: error instanceof Error ? error.message : String(error) });
+            this.json(response, 400, { error: error instanceof Error ? error.message : String(error) });
+        }
+    };
+    servePage = async (request, response) => {
+        const path = new URL(request.url ?? "/", "http://localhost").pathname;
+        const file = path.endsWith("/app.js") ? "app.js" : path.endsWith("/style.css") ? "style.css" : "index.html";
+        try {
+            const content = await (0, promises_1.readFile)((0, node_path_1.join)(__dirname, "public", file));
+            response.statusCode = 200;
+            response.setHeader("content-type", file.endsWith(".js") ? "text/javascript; charset=utf-8" : file.endsWith(".css") ? "text/css; charset=utf-8" : "text/html; charset=utf-8");
+            response.setHeader("cache-control", "no-store");
+            response.end(content);
+        }
+        catch {
+            this.json(response, 503, { error: "飞书设置页面资源不可用" });
+        }
+    };
+    configureBot = async (request, response) => { let raw = ""; for await (const chunk of request)
+        raw += Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk); let body; try {
+        body = JSON.parse(raw || "{}");
+    }
+    catch {
+        response.statusCode = 400;
+        response.end(JSON.stringify({ error: "JSON 请求格式无效" }));
+        return;
+    } if (typeof body.app_id !== "string" || typeof body.app_secret !== "string" || !body.app_id.trim() || !body.app_secret.trim()) {
+        response.statusCode = 400;
+        response.end(JSON.stringify({ error: "app_id 和 app_secret 必填" }));
+        return;
+    } this.config = { ...this.config, ...body }; await this.persist(); response.statusCode = 200; response.setHeader("content-type", "application/json; charset=utf-8"); response.end(JSON.stringify({ app_id: body.app_id, status: "已保存，重载插件后连接" })); };
+    configureSettings = async (request, response) => {
+        try {
+            const body = await this.readJson(request);
+            for (const key of ["agent_plugin", "allow_from", "allow_chats"])
+                if (typeof body[key] !== "string")
+                    return this.json(response, 400, { error: `${key} 必须是字符串` });
+            this.config = { ...this.config, agent_plugin: body.agent_plugin, allow_from: body.allow_from, allow_chats: body.allow_chats };
+            await this.persist();
+            this.context?.logger.info("飞书通道配置已保存");
+            this.json(response, 200, { ok: true });
+        }
+        catch (error) {
+            this.context?.logger.warn("飞书通道配置失败", { error: error instanceof Error ? error.message : String(error) });
+            this.json(response, 400, { error: error instanceof Error ? error.message : String(error) });
+        }
+    };
+    setupBegin = async (_request, response) => {
+        try {
+            const init = await this.registration("init");
+            if (init.error)
+                throw new Error(init.error_description ? `${init.error}: ${init.error_description}` : init.error);
+            const result = await this.registration("begin", { archetype: "PersonalAgent", auth_method: "client_secret", request_user_info: "open_id" });
+            if (result.error)
+                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");
+            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) });
+        }
+    };
+    setupPoll = async (request, response) => {
+        try {
+            const body = await this.readJson(request);
+            const deviceCode = typeof body.device_code === "string" ? body.device_code.trim() : "";
+            if (!deviceCode)
+                return this.json(response, 400, { error: "device_code 必填" });
+            const result = await this.registration("poll", { device_code: deviceCode });
+            const user = result.user_info;
+            const appId = typeof result.client_id === "string" ? result.client_id : "";
+            const appSecret = typeof result.client_secret === "string" ? result.client_secret : "";
+            if (appId && appSecret) {
+                this.config = { ...this.config, app_id: appId, app_secret: appSecret };
+                await this.persist();
+                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 = ["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) });
+        }
+    };
+    async registration(action, params = {}) { const form = new URLSearchParams({ action, ...params }); const response = await fetch("https://accounts.feishu.cn/oauth/v1/app/registration", { method: "POST", headers: { "content-type": "application/x-www-form-urlencoded" }, body: form }); if (!response.ok)
+        throw new Error(`飞书授权服务失败：HTTP ${response.status}`); return await response.json(); }
+    async readJson(request) { let raw = ""; for await (const chunk of request)
+        raw += Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk); const body = JSON.parse(raw || "{}"); return body && typeof body === "object" && !Array.isArray(body) ? body : {}; }
+    json(response, status, value) { response.statusCode = status; response.setHeader("content-type", "application/json; charset=utf-8"); response.end(JSON.stringify(value)); }
+}
+exports.FeishuPlugin = FeishuPlugin;
+exports.default = FeishuPlugin;

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

@@ -0,0 +1,86 @@
+(() => {
+  const find = (selector) => document.querySelector(selector);
+  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");
+    const response = await fetch(path, { method, headers: { ...(token ? { authorization: `Bearer ${token}` } : {}), ...(body ? { "content-type": "application/json" } : {}) }, ...(body ? { body: JSON.stringify(body) } : {}) });
+    const result = await response.json();
+    if (!response.ok) throw new Error(result.error || `请求失败：${response.status}`);
+    return result;
+  }
+  function show(message, failed = false) { notice.textContent = message; notice.className = failed ? "error" : ""; }
+  async function load() {
+    try {
+      const [state, plugins] = await Promise.all([request("/api/plugins/feishu/setup/status"), request("/api/plugins")]);
+      const agents = (plugins.plugins || []).filter((plugin) => plugin.type === "agent" && plugin.status === "ready");
+      const options = agents.map((agent) => new Option(agent.displayName || agent.id, agent.id));
+      binding.elements.pluginId.replaceChildren(new Option("选择 Agent", ""), ...options.map((option) => option.cloneNode(true)));
+      settings.elements.agent_plugin.replaceChildren(new Option("默认 Agent", ""), ...options);
+      settings.elements.agent_plugin.value = state.agent_plugin || "";
+      settings.elements.allow_from.value = state.allow_from || "";
+      settings.elements.allow_chats.value = state.allow_chats || "";
+      credentials.elements.app_id.value = state.app_id || "";
+      credentials.elements.app_secret.value = "";
+      find("#connection").textContent = state.message || state.status;
+      find("#app-id").textContent = state.app_id || "未配置";
+      const bound = state.bindings?.[state.app_id] || "";
+      find("#bound-agent").textContent = bound || state.agent_plugin || "未关联";
+      binding.elements.pluginId.value = bound;
+      show(state.configured ? "机器人已配置" : "请授权或手动配置机器人凭据");
+    } catch (error) { show(String(error), true); }
+  }
+  async function reconnect() {
+    await request("/api/plugins/feishu/reload", "POST");
+    await load();
+  }
+  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 (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 = "等待飞书授权";
+      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 () => {
+    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 = "等待飞书授权";
+      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", () => { setup++; clearTimeout(pollTimer); });
+  void load();
+})();

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

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><link rel="stylesheet" href="/abweb/channels/feishu/style.css"><title>飞书通道设置</title></head>
+<body>
+  <main>
+    <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><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>
+  </main>
+  <script src="/abweb/channels/feishu/app.js"></script>
+</body>
+</html>

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

@@ -0,0 +1,25 @@
+:root { font-family: "Segoe UI", "Microsoft YaHei", sans-serif; color: #182027; background: #fff; }
+* { box-sizing: border-box; }
+body { margin: 0; }
+main { padding: 8px 2px 20px; }
+header { display: flex; align-items: center; justify-content: space-between; }
+h1 { font-size: 17px; margin: 0; }
+h2 { font-size: 15px; margin: 0 0 12px; }
+p { min-height: 20px; color: #54665d; font-size: 13px; }
+dl { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 12px; margin: 12px 0 20px; }
+dl div { border-bottom: 1px solid #d9dfdc; padding-bottom: 9px; min-width: 0; }
+dt { color: #566761; font-size: 12px; }
+dd { margin: 4px 0 0; overflow-wrap: anywhere; font-size: 13px; }
+section, form { padding: 18px 0; border-top: 1px solid #d9dfdc; }
+.fields { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; margin-bottom: 12px; }
+label { display: grid; gap: 5px; font-size: 13px; }
+input, select, button { min-height: 34px; padding: 6px 9px; border: 1px solid #bfc9c5; border-radius: 5px; background: white; color: inherit; font: inherit; }
+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,6 +1,12 @@
 {
   "name": "agent-bridge-feishu",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "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

@@ -0,0 +1,12 @@
+{
+  "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"],
+  "managementPage": "/abweb/channels/feishu",
+  "configSchema": "config.schema.json"
+}