dsh-remote-web 0.7.12-beta.1 → 0.7.12-beta.3

package/lib/client.js

@@ -675,6 +675,11 @@ window.__ModuleLoader__.load({
       ".dru-ia-tier-link:hover{text-decoration:underline}",
       ".dru-ia-badge{display:inline-flex;align-items:center;padding:1px 6px;border-radius:999px;font-size:11px;font-weight:600;line-height:1.4;color:var(--dru-accent-fg);background:var(--dru-accent-tint);border:1px solid var(--dru-accent-tint-border);cursor:help}",
       "select.dru-ia-input[disabled]{opacity:.6;cursor:not-allowed;background:var(--dru-surface-3)}",
+      // 能力行置灰（缺 Robot Code 时不可用，但仍可读 + 有提示）
+      ".dru-ia-state.is-disabled{opacity:.6;background:var(--dru-surface-3);cursor:not-allowed}",
+      // 飞书 8 步向导：编号列表紧凑可读（一屏内可滚，不撑破弹层）
+      ".dru-ia-steps{margin:6px 0 8px;padding-left:20px;font-size:12px;line-height:1.7;color:var(--dsw-alias-label-secondary,var(--dru-fg-muted))}",
+      ".dru-ia-steps li{margin:2px 0}",
       // A3/A6（2026-11-07 业主逐条 UI 修正）：状态头右侧按钮组 / 后台服务横向紧凑布局 / 卸载反馈单选行
       ".dru-ia-head-actions{display:flex;align-items:center;gap:8px;flex-wrap:wrap;justify-content:flex-end}",
       ".dru-bridge-keep{display:flex;align-items:center;gap:6px;margin:8px 0 10px;padding:7px 10px;border-radius:8px;font-size:12px;line-height:1.5;color:var(--dru-warn-fg);background:var(--dru-warn-soft);border:1px solid var(--dru-warn-border)}",
@@ -3584,6 +3589,24 @@ window.__ModuleLoader__.load({
       // 未登录守卫：为什么弹登录（A4/A5）+ 登录后自动回到哪个流程（"手机访问"登录完继续生成访问码）。
       var iaLoginWhyArr = useState(""); var iaLoginWhy = iaLoginWhyArr[0]; var setIaLoginWhy = iaLoginWhyArr[1];
       var iaAfterLoginArr = useState(""); var iaAfterLogin = iaAfterLoginArr[0]; var setIaAfterLogin = iaAfterLoginArr[1];
+      // ── 钉钉 / 飞书（2026-11-08）：与 wecom 并列的两条通道 ──
+      var imDingIdArr = useState(""); var imDingId = imDingIdArr[0]; var setImDingId = imDingIdArr[1];
+      var imDingSecretArr = useState(""); var imDingSecret = imDingSecretArr[0]; var setImDingSecret = imDingSecretArr[1];
+      var imDingRobotArr = useState(""); var imDingRobot = imDingRobotArr[0]; var setImDingRobot = imDingRobotArr[1];
+      // 钉钉扫码一键创建（2026-11-08）：authId/授权链接/等待态；手动配置默认折叠
+      var imDingAuthArr = useState(null); var imDingAuth = imDingAuthArr[0]; var setImDingAuth = imDingAuthArr[1];
+      var imDingManualArr = useState(false); var imDingManual = imDingManualArr[0]; var setImDingManual = imDingManualArr[1];
+      var imFeishuAppIdArr = useState(""); var imFeishuAppId = imFeishuAppIdArr[0]; var setImFeishuAppId = imFeishuAppIdArr[1];
+      var imFeishuSecretArr = useState(""); var imFeishuSecret = imFeishuSecretArr[0]; var setImFeishuSecret = imFeishuSecretArr[1];
+      var imFeishuRecvArr = useState(""); var imFeishuRecv = imFeishuRecvArr[0]; var setImFeishuRecv = imFeishuRecvArr[1];
+      var imFeishuTypeArr = useState("open_id"); var imFeishuType = imFeishuTypeArr[0]; var setImFeishuType = imFeishuTypeArr[1];
+      // 平台级消息/错误/忙碌（与 wecom 的 imBotsMsg 分开：切平台时不会串台）
+      var imPlatMsgArr = useState(null); var imPlatMsg = imPlatMsgArr[0]; var setImPlatMsg = imPlatMsgArr[1];   // {kind,text}
+      var imPlatErrArr = useState({}); var imPlatErr = imPlatErrArr[0]; var setImPlatErr = imPlatErrArr[1];     // {field: msg}
+      var imPlatBusyArr = useState(""); var imPlatBusy = imPlatBusyArr[0]; var setImPlatBusy = imPlatBusyArr[1]; // ""|"save"|"test"|"deps"
+      // 飞书 SDK 依赖（按需下载）：installed/version/phase/lastError
+      var imDepsArr = useState(null); var imDeps = imDepsArr[0]; var setImDeps = imDepsArr[1];
+      var imFeishuWizardArr = useState(false); var imFeishuWizard = imFeishuWizardArr[0]; var setImFeishuWizard = imFeishuWizardArr[1];
 
       /** 读通道配置（GET 只回脱敏视图：botId/hasSecret/url/targetChatId + 桥写的状态）。 */
       function loadImBots() {
@@ -5989,6 +6012,21 @@ window.__ModuleLoader__.load({
             setImBotsSessionTitle(String(w.sessionTitle || ""));
             setImBotsWhyOpen(false);
             setImBotsUrl(String(w.url || ""));
+            var d = (b && b.dingtalk) || {};
+            setImDingId(String(d.clientId || ""));
+            setImDingSecret("");
+            setImDingRobot(String(d.robotCode || ""));
+            var f = (b && b.feishu) || {};
+            setImFeishuAppId(String(f.appId || ""));
+            setImFeishuSecret("");
+            setImFeishuRecv(String(f.receiveId || ""));
+            setImFeishuType(String(f.receiveIdType || "open_id"));
+            setImFeishuWizard(false);
+            setImPlatMsg(null);
+            setImPlatErr({});
+            var deps = b && b.status && b.status.deps && b.status.deps.feishu;
+            if (deps) setImDeps(deps);
+            loadImDeps();
           });
         }
         // 数据加载交给下面的 effect（按"弹层是否打开"触发）：
@@ -6554,6 +6592,446 @@ window.__ModuleLoader__.load({
                 }, "去登录"))] }));
       }
 
+      // ══════════════════════════════════════════════════════════════════════════════════
+      // 钉钉 / 飞书（2026-11-08）：与 wecom 并列的两条通道；飞书 SDK 走「按需下载」。
+      // ══════════════════════════════════════════════════════════════════════════════════
+
+      /** 飞书官方文档（配置页顶部固定展示；外链一律 target=_blank + rel=noopener）。 */
+      var FEISHU_DOCS = {
+        // 业主给的两个官方入口（必须出现在配置流程里）
+        createApp: "https://open.feishu.cn/app?lang=zh-CN",
+        cardBot: "https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/quick-start/develop-a-card-interactive-bot"
+      };
+      /** 主路径只有 3 件事（业主：接收人参数用户根本不知道怎么获取，别让用户配）。 */
+      var FEISHU_MAIN_STEPS = [
+        "创建企业自建应用（打开上面的「创建应用」链接）",
+        "复制应用凭证里的 App ID / App Secret",
+        "填到下面两个框，点「保存并连接」——接收群/私聊会自动发现，不用你配"
+      ];
+      /** 细步骤（折叠）：开机器人能力 / 权限 / 事件与回调切长连接 / 发布。 */
+      var FEISHU_DETAIL_STEPS = [
+        "开通机器人能力：应用功能 → 机器人 → 启用",
+        "申请权限：收 p2p / 群@消息，发 im:message:send_as_bot",
+        "事件配置：订阅方式选「长连接」，添加「接收消息 v2.0」",
+        "回调配置：订阅方式选「长连接」，添加 card.action.trigger",
+        "发布版本：版本管理与发布 → 创建版本 → 申请发布（管理员审核）"
+      ];
+
+      /** GET /dsh-remote/im-deps：飞书 SDK 是否已装 + phase（下载进度轮询用）。 */
+      function loadImDeps() {
+        return api("/dsh-remote/im-deps").then(function (b) {
+          var f = b && b.feishu;
+          if (f) setImDeps(f);
+          return f || null;
+        }).catch(function () { return null; });
+      }
+
+      /** 触发飞书 SDK 下载（后台 npm install；进度靠轮询 im-deps 的 phase）。 */
+      function startFeishuDownload() {
+        if (imPlatBusy) return;
+        setImPlatBusy("deps");
+        setImPlatMsg({ kind: "ok", text: "正在下载依赖（约 41MB，仅装一次）…" });
+        post("/dsh-remote/im-deps/feishu", {}).then(function (b) {
+          if (b && b.deps && b.deps.feishu) setImDeps(b.deps.feishu);
+          loadImDeps();
+        }).catch(function (e) {
+          setImPlatMsg({ kind: "err", text: "下载失败：" + ((e && e.message) || e) + "（可重试）" });
+        }).finally(function () { setImPlatBusy(""); });
+      }
+
+      /** 依赖下载中：每 ~900ms 轮询一次 phase；失败/完成后自动停。 */
+      useEffect(function () {
+        if (iaModal !== "channel" || iaChStep !== "feishu") return undefined;
+        var phase = imDeps && imDeps.phase;
+        if (phase !== "downloading" && phase !== "installing") return undefined;
+        var t = null;
+        try {
+          t = setTimeout(function () { loadImDeps(); }, 900);
+        } catch (e) { /* 忽略 */ }
+        return function () { try { if (t) clearTimeout(t); } catch (e) { /* 忽略 */ } };
+      }, [iaModal, iaChStep, imDeps]);
+
+      /** 钉钉表单提交体（空 secret = 不修改，与 wecom 一致）。 */
+      function imDingPayload() {
+        return {
+          clientId: String(imDingId || "").trim(),
+          clientSecret: String(imDingSecret || ""),
+          robotCode: String(imDingRobot || "").trim()
+        };
+      }
+      /** 飞书表单提交体。 */
+      function imFeishuPayload() {
+        // 只提交两个凭据：接收群/私聊由桥侧自动发现（业主：不让用户填不知道怎么获取的 ID）。
+        return {
+          appId: String(imFeishuAppId || "").trim(),
+          appSecret: String(imFeishuSecret || "")
+        };
+      }
+      function imPlatFieldErrOf(code) {
+        var map = {
+          missing_client_id: "clientId", missing_client_secret: "clientSecret", missing_robot_code: "robotCode",
+          missing_app_id: "appId", missing_app_secret: "appSecret", missing_receive_id: "receiveId",
+          invalid_receive_id_type: "receiveIdType"
+        };
+        return map[String(code || "")] || "";
+      }
+      var IM_PLAT_FIELD_NAMES = {
+        clientId: "Client ID", clientSecret: "Client Secret", robotCode: "Robot Code",
+        appId: "App ID", appSecret: "App Secret", receiveId: "接收人", receiveIdType: "接收对象类型"
+      };
+
+      /**
+       * 保存 / 测试（钉钉·飞书共用）。
+       * @param {"dingtalk"|"feishu"} platform
+       * @param {"save"|"test"} mode  save=只保存；test=先保存再连接测试（「保存并连接」）
+       */
+      function saveImPlatform(platform, mode) {
+        if (imPlatBusy) return;
+        var cfg = platform === "dingtalk" ? imDingPayload() : imFeishuPayload();
+        setImPlatBusy(mode === "test" ? "test" : "save");
+        setImPlatMsg(null);
+        setImPlatErr({});
+        // ⚠️ 必须是 PUT：/dsh-remote/im-bots 在节点半按 method 分发（GET/PUT），POST 会被 405。
+        api("/dsh-remote/im-bots", {
+          method: "PUT", headers: { "content-type": "application/json" },
+          body: JSON.stringify({ platform: platform, config: cfg })
+        }, 15000).then(function () {
+          if (mode !== "test") {
+            setImPlatMsg({ kind: "ok", text: "已保存（配置只在本机，Secret 不会回显）" });
+            return loadImBots();
+          }
+          return post("/dsh-remote/im-bots/test", { platform: platform, config: cfg }, 15000).then(function (r) {
+            if (r && r.connected) setImPlatMsg({ kind: "ok", text: "已连接，消息可以正常收发了" });
+            else setImPlatMsg({ kind: "warn", text: "已保存，但连接还没成功" + (r && r.lastError ? "：" + r.lastError : "（稍后自动重试）") });
+            return loadImBots();
+          });
+        }).catch(function (e) {
+          var body = (e && e.body) || {};
+          var code = String(body.error || "");
+          var field = imPlatFieldErrOf(code);
+          if (field) {
+            var errs = {}; errs[field] = String(body.message || "请填写完整");
+            setImPlatErr(errs);
+            setImPlatMsg({ kind: "err", text: "请补全：" + IM_PLAT_FIELD_NAMES[field] });
+          } else {
+            setImPlatMsg({ kind: "err", text: "保存失败：" + (body.message || (e && e.message) || "未知错误") });
+          }
+          return null;
+        }).finally(function () { setImPlatBusy(""); });
+      }
+
+      /** 平台状态行（连接中 / 已连接 / 失败；文案面向非技术用户）。 */
+      function imPlatStateLine(st) {
+        if (imPlatBusy === "test") return h("div", { className: "dru-ia-state", role: "status" }, h("span", { className: "dru-spin" }), "正在连接…（最多 10 秒）");
+        if (imPlatMsg) return h("div", { className: "dru-ia-state " + (imPlatMsg.kind === "ok" ? "is-ok" : imPlatMsg.kind === "warn" ? "is-warn" : "is-err"), role: "status" }, imPlatMsg.text);
+        if (st && st.connected) return h("div", { className: "dru-ia-state is-ok", role: "status" }, druIcon("check"), "已连接");
+        if (st && st.lastError) return h("div", { className: "dru-ia-state is-err", role: "status" }, "上次连接失败：" + st.lastError);
+        return null;
+      }
+
+      /** 钉钉扫码授权：开始（POST begin）→ 拿授权链接；deviceCode 只在服务端，不落浏览器。 */
+      function startDingAuth() {
+        if (imPlatBusy) return;
+        setImPlatBusy("auth");
+        setImPlatMsg(null);
+        setImPlatErr({});
+        post("/dsh-remote/im-dingtalk-auth/begin", {}).then(function (b) {
+          if (!b || b.ok !== true || !b.url) {
+            setImDingAuth(null);
+            setImPlatMsg({ kind: "err", text: "发起授权失败：" + ((b && b.message) || "请稍后重试") });
+            return;
+          }
+          setImDingAuth({
+            authId: String(b.authId || ""),
+            url: String(b.url || ""),
+            interval: Math.max(1, Math.min(10, Number(b.interval) || 2)),
+            expiresAt: Date.now() + Math.max(10, Math.min(600, Number(b.expiresIn) || 120)) * 1000,
+            phase: "waiting",
+            error: ""
+          });
+        }).catch(function (e) {
+          setImDingAuth(null);
+          var body = (e && e.body) || {};
+          setImPlatMsg({ kind: "err", text: "发起授权失败：" + (body.message || (e && e.message) || "网络错误") });
+        }).finally(function () { setImPlatBusy(""); });
+      }
+      /** 查询一次授权状态；成功后凭据已由服务端写盘 → 刷新面板即"已连接"。 */
+      function pollDingAuth() {
+        var a = imDingAuth;
+        if (!a || !a.authId || a.phase !== "waiting") return;
+        api("/dsh-remote/im-dingtalk-auth/status?id=" + encodeURIComponent(a.authId)).then(function (b) {
+          if (b && b.status === "success") {
+            setImDingAuth(null);
+            setImPlatMsg({ kind: "ok", text: "已创建机器人并建立连接" + (b.clientIdTail ? "（Client ID 尾号 " + b.clientIdTail + "）" : "") + "，去钉钉里发条消息试试" });
+            loadImBots();
+            return;
+          }
+          if (b && (b.status === "failed" || b.status === "expired")) {
+            setImDingAuth({ authId: a.authId, url: a.url, interval: a.interval, expiresAt: a.expiresAt, phase: "failed", error: String(b.message || "授权失败，请重试") });
+            return;
+          }
+          if (Date.now() > a.expiresAt) {
+            setImDingAuth({ authId: a.authId, url: a.url, interval: a.interval, expiresAt: a.expiresAt, phase: "failed", error: "授权已超时（2 分钟内未确认），请重新发起" });
+            return;
+          }
+          // waiting：**换一个新对象** → 轮询 effect 依赖变化 → 继续排下一次（否则只会轮询一次）。
+          setImDingAuth({ authId: a.authId, url: a.url, interval: a.interval, expiresAt: a.expiresAt, phase: "waiting", error: "", polledAt: Date.now() });
+        }).catch(function () { /* 网络抖动：下一轮再试（轮询期内不打断用户） */ });
+      }
+      /** 等待确认中：每 ~2s 轮询一次 status（最长到 expiresAt）。 */
+      useEffect(function () {
+        if (iaModal !== "channel" || iaChStep !== "dingtalk") return undefined;
+        if (!imDingAuth || imDingAuth.phase !== "waiting") return undefined;
+        var t = null;
+        try { t = setTimeout(pollDingAuth, Math.max(1000, (imDingAuth.interval || 2) * 1000)); } catch (e) { /* 忽略 */ }
+        return function () { try { if (t) clearTimeout(t); } catch (e) { /* 忽略 */ } };
+      }, [iaModal, iaChStep, imDingAuth]);
+
+      /** 钉钉手动创建 7 步（2026-11-08 业主给的官方链接；每步一句 + 链接）。 */
+      var DINGTALK_STEPS = [
+        { t: "用钉钉账号登录开发者后台", url: "https://open-dev.dingtalk.com/" },
+        { t: "「应用开发 → 企业内部应用 → 钉钉应用 → 创建应用」，起个名字保存", url: "https://open.dingtalk.com/document/orgapp/create-an-application" },
+        { t: "「基础信息 → 凭证与基础信息」复制 Client ID / Client Secret（Secret 只显示一次，丢了要重置）", url: "" },
+        { t: "「应用能力 → 机器人」开启机器人配置（名称/图标/简介/预览图）", url: "https://open.dingtalk.com/document/orgapp/add-application-capabilities" },
+        { t: "「消息接收模式」必须选 Stream 模式（不要选 HTTP、不要填地址），保存并发布机器人", url: "https://open.dingtalk.com/document/orgapp/configure-the-robot-application" },
+        { t: "同一页找到 Robot Code（一般与 Client ID 相同）一起填", url: "https://open.dingtalk.com/document/orgapp/faq-robot" },
+        { t: "「应用发布 → 版本管理与发布 → 创建新版本 → 发布」，回来点「测试连接」", url: "https://open.dingtalk.com/document/orgapp/robot-receive-message" }
+      ];
+      /** 三个高频坑（折叠底部，警示样式）。 */
+      var DINGTALK_PITFALLS = [
+        "建错机器人：群设置里加的「自定义机器人」只有 webhook 地址，没有 Client ID/Secret，也不可能长连接",
+        "只保存没发布：机器人发布 + 应用版本发布是两步，漏任一步会 400 或群里搜不到机器人",
+        "模式选错/凭证脏：消息接收模式留 HTTP、Secret 复制带空格、开了 IP 白名单 → 都会「连不上但报错含糊」；建议「连接成功才放行」"
+      ];
+
+      /** 钉钉能力行：缺 Robot Code 时置灰并提示（业主：补 Robot Code 可开启）。 */
+      function dingCapabilityRow(label, enabled, hint) {
+        return h("div", {
+          className: "dru-ia-state" + (enabled ? "" : " is-disabled"),
+          "aria-disabled": enabled ? "false" : "true",
+          title: enabled ? "" : hint
+        },
+          druIcon(enabled ? "check" : "alert"),
+          label,
+          enabled ? null : h("span", { className: "dru-ia-badge" }, hint));
+      }
+
+      /** 钉钉配置页：主路径 = 扫码一键创建；手动创建 7 步 + 三个坑折叠在「高级」。 */
+      function renderDingtalkStep(close) {
+        var d = (imBots && imBots.dingtalk) || {};
+        var st = (imBots && imBots.status && imBots.status.dingtalk) || {};
+        var err = imPlatErr || {};
+        var auth = imDingAuth;
+        var sourceText = (st.credentialSource || d.credentialSource) === "scan" ? "扫码创建"
+          : (st.credentialSource || d.credentialSource) === "manual" ? "手动填写" : "";
+        var clientTail = String(d.clientId || "").length > 4 ? String(d.clientId).slice(-4) : String(d.clientId || "");
+        // Robot Code 是否已配置：优先用桥状态；旧桥没这个字段时退回配置里的 robotCode。
+        var robotCodeOk = st.robotCodeConfigured === true || !!String(d.robotCode || "").trim();
+        var caps = st.capabilities || null;
+        return iaDialog(Object.assign({}, {
+          title: "钉钉机器人",
+          sub: "不用去开发者后台创建应用：扫码点一下就会自动创建机器人",
+          onClose: close,
+          foot: [
+            h("button", {
+              type: "button", className: "dru-ia-btn is-primary", disabled: imPlatBusy !== "",
+              onClick: function () { if (!auth || auth.phase !== "waiting") startDingAuth(); }
+            }, imPlatBusy === "auth" ? "正在生成授权链接…" : (auth && auth.phase === "waiting" ? "重新发起扫码" : "用钉钉扫码，一键创建机器人")),
+            h("button", { type: "button", className: "dru-ia-btn is-ghost", onClick: function () { close(); } }, "关闭")
+          ]
+        }, { children: [
+          // 判断口诀（醒目）：帮用户尽早排除"群 webhook 机器人"这个错误方向
+          h("div", { className: "dru-ia-state is-warn", role: "note" },
+            "要你填「消息接收地址」的，就是群 webhook 机器人——那种不能长连接，请退出重来"),
+          h("div", { className: "dru-ia-hint" },
+            "官方入口：",
+            h("a", { className: "dru-ia-tier-link", href: "https://open.dingtalk.com/", target: "_blank", rel: "noopener" }, "钉钉开放平台"),
+            " · ",
+            h("a", { className: "dru-ia-tier-link", href: "https://open-dev.dingtalk.com/", target: "_blank", rel: "noopener" }, "开发者后台")),
+          // 已连接状态：clientId 尾号 + 来源
+          (st.connected || d.hasSecret)
+            ? h("div", { className: "dru-ia-state is-ok" }, druIcon("check"),
+                (st.connected ? "已连接" : "已保存凭据") + (clientTail ? "（Client ID 尾号 " + clientTail + "）" : "")
+                + (sourceText ? " · 来源：" + sourceText : ""))
+            : h("div", { className: "dru-ia-state" }, druIcon("chat"), "还没有连接：点下方按钮扫码创建机器人"),
+          // 扫码授权中：链接 + 提示 + 复制/打开（无 QR 库 → 降级，明确告知用手机钉钉扫码）
+          (auth && auth.phase === "waiting")
+            ? h("div", { className: "dru-ia-field" },
+                h("div", { className: "dru-ia-state", role: "status" }, h("span", { className: "dru-spin" }),
+                  "等待你在钉钉里确认…（用手机钉钉扫下方链接，或复制到手机打开）"),
+                h("div", { className: "dru-copy-row" },
+                  h("div", { className: "dru-copy-box" },
+                    h("span", { className: "dru-link-val" }, auth.url),
+                    h("button", {
+                      type: "button", className: "dru-copy-btn", "aria-label": "复制授权链接",
+                      onClick: function () {
+                        copyText(auth.url).then(function (ok) { if (!ok) setImPlatMsg({ kind: "err", text: "复制失败：请手动选中链接复制" }); });
+                      }
+                    }, "复制授权链接")),
+                  h("div", { className: "dru-actions", style: { marginTop: 8 } },
+                    h("a", { className: "dru-ia-btn is-primary", href: auth.url, target: "_blank", rel: "noopener" }, "在浏览器打开授权页"),
+                    h("button", { type: "button", className: "dru-ia-btn", onClick: function () { setImDingAuth(null); setImPlatMsg({ kind: "ok", text: "已取消本次扫码授权" }); } }, "取消授权"))))
+            : null,
+          (auth && auth.phase === "failed")
+            ? h("div", { className: "dru-ia-field" },
+                h("div", { className: "dru-ia-state is-err", role: "alert" }, auth.error || "授权失败"),
+                h("button", { type: "button", className: "dru-ia-btn", onClick: function () { startDingAuth(); } }, "重试扫码授权"))
+            : null,
+          // 能力：主动推送 / 卡片（缺 Robot Code 时置灰，提示补 Robot Code）
+          h("div", { className: "dru-ia-field" },
+            h("div", { className: "dru-ia-label" }, "机器人能力"),
+            dingCapabilityRow("主动推送（任务完成/出错通知）", robotCodeOk && (!caps || caps.openapi !== false), "补 Robot Code 可开启"),
+            dingCapabilityRow("卡片交互（审批卡片，点按钮放行/拒绝）", robotCodeOk && (!caps || caps.card !== false), "补 Robot Code 可开启")),
+          // 高级：手动创建（7 步 + 三个坑 + 手动填凭据；默认折叠）
+          h("div", { className: "dru-ia-field" },
+            h("button", {
+              type: "button", className: "dru-ia-disclose", "aria-expanded": imDingManual ? "true" : "false",
+              onClick: function () { setImDingManual(!imDingManual); }
+            }, "高级：去开发者后台手动创建（或手动填凭据）", druIcon(imDingManual ? "left" : "right")),
+            imDingManual
+              ? h("div", null,
+                  h("ol", { className: "dru-ia-steps" }, DINGTALK_STEPS.map(function (stp, i) {
+                    return h("li", { key: "dt" + i }, stp.t,
+                      stp.url
+                        ? h("a", { className: "dru-ia-tier-link", href: stp.url, target: "_blank", rel: "noopener", style: { marginLeft: 6 } }, "官方文档")
+                        : null);
+                  })),
+                  // 三个高频坑（警示）
+                  h("div", { className: "dru-ia-state is-warn", role: "alert" },
+                    h("div", null, "三个高频坑："),
+                    h("ol", { className: "dru-ia-steps" }, DINGTALK_PITFALLS.map(function (t, i) {
+                      return h("li", { key: "pf" + i }, t);
+                    }))),
+                  // 手动填三层字段（已有应用的兜底）
+                  h("div", { className: "dru-ia-hint" }, "已有钉钉应用的话可以手填：Client ID/Secret 就是 AppKey/AppSecret；Robot Code 在机器人页复制。"),
+                  iaField("Client ID（= AppKey）", "dru-ding-client", h("input", {
+                    id: "dru-ding-client", className: "dru-ia-input", type: "text", value: imDingId, autoComplete: "off", spellCheck: false,
+                    placeholder: "钉钉应用 AppKey", "aria-invalid": err.clientId ? "true" : "false",
+                    onChange: function (e) { setImDingId(e.target.value); }
+                  }), err.clientId || ""),
+                  iaField("Client Secret（= AppSecret）", "dru-ding-secret", h("input", {
+                    id: "dru-ding-secret", className: "dru-ia-input", type: "password", value: imDingSecret, autoComplete: "new-password", spellCheck: false,
+                    placeholder: d.hasSecret ? "已保存（留空表示不修改）" : "钉钉应用 AppSecret", "aria-invalid": err.clientSecret ? "true" : "false",
+                    onChange: function (e) { setImDingSecret(e.target.value); }
+                  }), err.clientSecret || "", "只保存在本机；已保存的 Secret 永远不回显。"),
+                  iaField("Robot Code", "dru-ding-robot", h("input", {
+                    id: "dru-ding-robot", className: "dru-ia-input", type: "text", value: imDingRobot, autoComplete: "off", spellCheck: false,
+                    placeholder: "机器人编码（开放平台 → 机器人页复制）", "aria-invalid": err.robotCode ? "true" : "false",
+                    onChange: function (e) { setImDingRobot(e.target.value); }
+                  }), err.robotCode || "", "三个字段都要填。"),
+                  h("div", { className: "dru-actions", style: { marginTop: 8 } },
+                    h("button", { type: "button", className: "dru-ia-btn is-primary", disabled: imPlatBusy !== "", onClick: function () { saveImPlatform("dingtalk", "test"); } },
+                      imPlatBusy === "test" ? "连接中…" : "保存并连接"),
+                    h("button", { type: "button", className: "dru-ia-btn", disabled: imPlatBusy !== "", onClick: function () { saveImPlatform("dingtalk", "save"); } },
+                      imPlatBusy === "save" ? "保存中…" : "仅保存")))
+              : null),
+          imPlatStateLine(st)
+        ] }));
+      }
+
+      /** 飞书 SDK 依赖未安装时的那一屏（按需下载，不装也能用其它通道）。 */
+      function renderFeishuDepsGate(close) {
+        var deps = imDeps || {};
+        var running = deps.phase === "downloading" || deps.phase === "installing";
+        return iaDialog(Object.assign({}, {
+          title: "飞书机器人",
+          sub: "首次使用需要先下载依赖（约 41MB，仅装一次）",
+          onClose: close,
+          foot: [
+            h("button", { type: "button", className: "dru-ia-btn is-primary", disabled: imPlatBusy !== "" || running, onClick: startFeishuDownload },
+              running ? "下载中…" : (deps.phase === "failed" ? "重试下载" : "下载依赖")),
+            h("button", { type: "button", className: "dru-ia-btn", onClick: function () { setIaChStep("list"); } }, "返回平台列表")
+          ]
+        }, { children: [
+          h("div", { className: "dru-ia-state" }, druIcon("bell"),
+            running ? "正在下载并安装（约 41MB，仅装一次）…" : (deps.phase === "failed" ? "上次下载失败" : "还没有安装飞书依赖")),
+          deps.lastError ? h("div", { className: "dru-ia-state is-err", role: "alert" }, deps.lastError) : null,
+          h("div", { className: "dru-ia-hint" }, "下载的是飞书官方 Node SDK，仅装在这个插件自己的目录里，不影响其它插件和系统环境。"),
+          h("div", { className: "dru-ia-hint" }, "不下载也能用其它通道：企业微信、钉钉都可正常配置；飞书随时回来装即可，不会影响已有通知。")
+        ] }));
+      }
+
+      /** 飞书配置页（依赖已装）：官方文档 + 3 步主路径（细步骤折叠）+ 只有 App ID / App Secret。 */
+      function renderFeishuStep(close) {
+        var deps = imDeps || {};
+        if (deps.installed !== true) return renderFeishuDepsGate(close);
+        var f = (imBots && imBots.feishu) || {};
+        var st = (imBots && imBots.status && imBots.status.feishu) || {};
+        var err = imPlatErr || {};
+        // 自动绑定状态（业主：接收人不需要用户填，由插件自动发现）
+        var bindLine = (function () {
+          var bound = String(st.boundChatId || "").trim();
+          if (!bound) return h("div", { className: "dru-ia-state" }, druIcon("chat"),
+            "连接后会自动绑定你的机器人所在群/你与机器人的私聊（不需要操作）");
+          var type = String(st.boundChatType || "").toLowerCase();
+          var src = String(st.receiveIdSource || "").toLowerCase();
+          var isP2p = type === "p2p" || src === "p2p" || src === "private";
+          var name = isP2p ? "私聊" : (/^oc_/.test(bound) || /^ou_/.test(bound) ? ("群 " + iaShortId(bound)) : bound);
+          return h("div", { className: "dru-ia-state is-ok" }, druIcon("check"),
+            "已自动绑定：" + name,
+            src ? h("span", { className: "dru-ia-hint", style: { marginLeft: 6 } }, "（自动发现，无需配置）") : null);
+        })();
+        return iaDialog(Object.assign({}, {
+          title: "飞书机器人",
+          sub: "依赖已就绪（v" + (deps.version || f.sdkVersion || "?") + "）；只需填 App ID 与 App Secret",
+          onClose: close,
+          foot: [
+            h("button", { type: "button", className: "dru-ia-btn is-primary", disabled: imPlatBusy !== "", onClick: function () { saveImPlatform("feishu", "test"); } },
+              imPlatBusy === "test" ? "连接中…" : "保存并连接"),
+            h("button", { type: "button", className: "dru-ia-btn", disabled: imPlatBusy !== "", onClick: function () { saveImPlatform("feishu", "save"); } },
+              imPlatBusy === "save" ? "保存中…" : "仅保存"),
+            h("button", { type: "button", className: "dru-ia-btn is-ghost", disabled: imPlatBusy !== "", onClick: function () {
+              if (imPlatBusy) return;
+              setImPlatBusy("test"); setImPlatMsg(null);
+              post("/dsh-remote/im-bots/test", { platform: "feishu" }, 15000).then(function (r) {
+                setImPlatMsg({ kind: r && r.connected ? "ok" : "warn", text: r && r.connected ? "已连接" : ("连接失败" + (r && r.lastError ? "：" + r.lastError : "（稍后自动重试）")) });
+              }).catch(function (e) { setImPlatMsg({ kind: "err", text: "测试失败：" + ((e && e.message) || e) }); })
+                .finally(function () { setImPlatBusy(""); });
+            } }, "测试")
+          ]
+        }, { children: [
+          // 官方入口固定顶部（业主给的两个链接）
+          h("div", { className: "dru-ia-hint" },
+            "官方入口：",
+            h("a", { className: "dru-ia-tier-link", href: FEISHU_DOCS.createApp, target: "_blank", rel: "noopener" }, "创建企业自建应用"),
+            " · ",
+            h("a", { className: "dru-ia-tier-link", href: FEISHU_DOCS.cardBot, target: "_blank", rel: "noopener" }, "卡片交互机器人文档")),
+          // 主路径只有 3 件事；细步骤折叠（业主：别让用户读 8 步才敢动手）
+          h("div", { className: "dru-ia-field" },
+            h("div", { className: "dru-ia-hint" }, "三步就能用："),
+            h("ol", { className: "dru-ia-steps" }, FEISHU_MAIN_STEPS.map(function (t, i) {
+              return h("li", { key: "m" + i }, t);
+            })),
+            h("button", {
+              type: "button", className: "dru-ia-disclose", "aria-expanded": imFeishuWizard ? "true" : "false",
+              onClick: function () { setImFeishuWizard(!imFeishuWizard); }
+            }, "细步骤（机器人能力 / 权限 / 长连接 / 发布）", druIcon(imFeishuWizard ? "left" : "right")),
+            imFeishuWizard
+              ? h("div", null,
+                  h("ol", { className: "dru-ia-steps" }, FEISHU_DETAIL_STEPS.map(function (t, i) {
+                    return h("li", { key: "d" + i }, t);
+                  })),
+                  h("div", { className: "dru-ia-state is-warn", role: "note" },
+                    "顺序很重要：保存事件/回调配置时飞书的「长连接必须已在线」——",
+                    "请**先在上面填凭据点「保存并连接」让插件连上**，再回飞书后台保存事件配置；顺序反了会保存失败。"))
+              : null),
+          // 自动绑定状态行（不再让用户填接收人）
+          bindLine,
+          iaField("App ID", "dru-fs-appid", h("input", {
+            id: "dru-fs-appid", className: "dru-ia-input", type: "text", value: imFeishuAppId, autoComplete: "off", spellCheck: false,
+            placeholder: "cli_xxxxxxxx", "aria-invalid": err.appId ? "true" : "false",
+            onChange: function (e) { setImFeishuAppId(e.target.value); }
+          }), err.appId || ""),
+          iaField("App Secret", "dru-fs-secret", h("input", {
+            id: "dru-fs-secret", className: "dru-ia-input", type: "password", value: imFeishuSecret, autoComplete: "new-password", spellCheck: false,
+            placeholder: f.hasSecret ? "已保存（留空表示不修改）" : "从应用详情 → 凭证与基础信息复制",
+            "aria-invalid": err.appSecret ? "true" : "false",
+            onChange: function (e) { setImFeishuSecret(e.target.value); }
+          }), err.appSecret || "", "只保存在本机；已保存的 Secret 永远不回显。"),
+          imPlatStateLine(st)
+        ] }));
+      }
+
       /** 还没支持的平台：只给**诚实**的空状态（说明 + 反馈入口），绝不放假表单/假入口。 */
       function renderComingSoonStep(close, kind) {
         var meta = {
@@ -6600,12 +7078,30 @@ window.__ModuleLoader__.load({
         if (iaModal !== "channel") return null;
         if (iaChStep === "wecom") return renderWecomStep(closeIAModal);
         if (iaChStep === "wechat") return renderWechatStep(closeIAModal);
-        if (iaChStep === "feishu" || iaChStep === "dingtalk" || iaChStep === "webhook") return renderComingSoonStep(closeIAModal, iaChStep);
+        if (iaChStep === "dingtalk") return renderDingtalkStep(closeIAModal);
+        if (iaChStep === "feishu") return renderFeishuStep(closeIAModal);
+        if (iaChStep === "webhook") return renderComingSoonStep(closeIAModal, "webhook");
         var w = (imBots && imBots.wecom) || {};
         var ws = (imBots && imBots.status) || {};
         var wecomSub = ws.connected
           ? "已连接 · 推送消息到企业微信"
           : (w.enabled || w.hasSecret ? "已配置，等待连接" : "未配置 · 填 Bot ID 与 Secret 即可");
+        var d = (imBots && imBots.dingtalk) || {};
+        var f = (imBots && imBots.feishu) || {};
+        var dst = (imBots && imBots.status && imBots.status.dingtalk) || {};
+        var fst = (imBots && imBots.status && imBots.status.feishu) || {};
+        var dingSub = dst.connected
+          ? "已连接 · 推送消息到钉钉"
+          : (d.enabled || d.hasSecret ? "已配置，等待连接" : "未配置 · 填 Client ID / Secret / Robot Code");
+        var feishuSub = !(imDeps && imDeps.installed)
+          ? "需要先下载依赖（约 41MB，仅装一次）"
+          : (fst.connected ? "已连接 · 推送消息到飞书" : (f.enabled || f.hasSecret ? "已配置，等待连接" : "依赖已就绪 · 填 App ID / Secret / 接收人"));
+        var resetPlatStep = function (step) {
+          setIaChStep(step);
+          setImPlatMsg(null);
+          setImPlatErr({});
+          if (step === "feishu") loadImDeps();
+        };
         return iaDialog(Object.assign({}, {
           title: "通知与消息通道",
           sub: "选一个平台，让电脑端在任务完成、出错或需要拍板时主动通知你",
@@ -6613,10 +7109,10 @@ window.__ModuleLoader__.load({
           foot: h("button", { type: "button", className: "dru-ia-btn", onClick: closeIAModal }, "关闭")
         }, { children: [h("div", { className: "dru-ia-list" },
             iaChannelRow("chat", "企业微信智能机器人", wecomSub, function () { setIaChStep("wecom"); setImBotsMsg(null); setImBotsFieldErr({}); }, "配置"),
+            iaChannelRow("send", "钉钉机器人", dingSub, function () { resetPlatStep("dingtalk"); }, "配置"),
+            iaChannelRow("send", "飞书机器人", feishuSub, function () { resetPlatStep("feishu"); }, imDeps && imDeps.installed ? "配置" : "下载依赖"),
             iaChannelRow("chat", "微信机器人（扫码绑定）", "扫码绑定 · 在微信里收通知 / 回数字拍板", function () { setIaChStep("wechat"); }, "打开"),
-            iaChannelRow("send", "飞书机器人", "即将支持 · 需要企业管理员配置应用", function () { setIaChStep("feishu"); }, "查看"),
-            iaChannelRow("send", "钉钉机器人", "即将支持 · 需要企业管理员创建应用", function () { setIaChStep("dingtalk"); }, "查看"),
-            iaChannelRow("code", "高级 · Webhook", "高级用法 · 自备公网端点", function () { setIaChStep("webhook"); }, "查看")
+            iaChannelRow("code", "高级 · Webhook", "免费 · 高级用法：自备公网端点", function () { setIaChStep("webhook"); }, "查看")
           )] }));
       }