@sfmc-bds/qq-bridge 0.1.1-beta.4 → 0.2.0-beta.4

package/dist/commands/handlers.js

@@ -0,0 +1,660 @@
+import {
+  getGroupBotState,
+  getGroupInfo,
+  sendGroupMessage
+} from "@sfmc-bds/sdk/node/qq-official";
+import {
+  fetchBindMe,
+  fetchJoinPending,
+  fetchJoinSettings,
+  fetchSfmcStatus,
+  postAdminKick,
+  postBindRequest,
+  postBindUnbind,
+  postJoinDecide,
+  postJoinRequest,
+  postJoinSettings
+} from "./db-api.js";
+import { buildJoinSettingsPanel, settingsFromResponse } from "./join-settings-ui.js";
+import { formatCommandMenu } from "./menu-format.js";
+function formatUptime(startedAt) {
+  const ms = Math.max(0, Date.now() - startedAt);
+  const s = Math.floor(ms / 1e3);
+  const m = Math.floor(s / 60);
+  const h = Math.floor(m / 60);
+  if (h > 0) return `${h}h ${m % 60}m`;
+  if (m > 0) return `${m}m ${s % 60}s`;
+  return `${s}s`;
+}
+function dbEp(ctx) {
+  const host = ctx.runtimeInfo.dbHost;
+  const port = ctx.runtimeInfo.dbPort;
+  if (!host || !port) return null;
+  return { host, port };
+}
+function isAdmin(ctx) {
+  const admins = ctx.runtimeInfo.adminOpenids ?? [];
+  if (admins.length > 0 && admins.includes(ctx.inbound.userId)) return true;
+  return ctx.inbound.isGroupAdmin === true;
+}
+function asGroupAdminField(ctx) {
+  return ctx.inbound.isGroupAdmin === true;
+}
+async function fetchQqGroupLines(ctx) {
+  const creds = ctx.runtimeInfo.officialCreds;
+  const gid = ctx.runtimeInfo.groupOpenid || ctx.inbound.groupId;
+  if (!creds || !gid || ctx.inbound.backend !== "official") return [];
+  const lines = [];
+  try {
+    const [infoRes, stateRes] = await Promise.all([
+      getGroupInfo(creds, gid),
+      getGroupBotState(creds, gid)
+    ]);
+    if (infoRes.ok && infoRes.json && typeof infoRes.json === "object") {
+      const j = infoRes.json;
+      lines.push(`QQ\u7FA4\uFF1A${j.group_name ?? "\u2014"} \xB7 \u6210\u5458 ${j.group_member_num ?? "\u2014"}`);
+    } else if (!infoRes.ok) {
+      const hint = /11253/.test(infoRes.error || infoRes.body || "") ? "\u7FA4\u4FE1\u606F\u63A5\u53E3\u672A\u5F00\u901A\u767D\u540D\u5355(11253)" : `\u7FA4\u4FE1\u606F\u5931\u8D25\uFF1A${(infoRes.error || "").slice(0, 60)}`;
+      lines.push(hint);
+    }
+    if (stateRes.ok && stateRes.json && typeof stateRes.json === "object") {
+      const j = stateRes.json;
+      lines.push(
+        `\u673A\u5668\u4EBA\uFF1A\u89D2\u8272=${j.member_role ?? "\u2014"} \xB7 \u4E3B\u52A8\u63A8\u9001=${j.allow_proactive_msg === true ? "\u5F00" : "\u5173"} \xB7 \u6536\u6D88\u606F=${j.recv_msg_setting ?? "\u2014"}`
+      );
+    }
+  } catch (e) {
+    lines.push(`\u7FA4\u4FE1\u606F\u5F02\u5E38\uFF1A${e.message}`);
+  }
+  return lines;
+}
+function createMenuHandler(registry) {
+  return () => {
+    const cmds = registry.userMenu().filter((c) => c.name !== "menu");
+    return formatCommandMenu({
+      title: "SFMC \u6307\u4EE4",
+      subtitle: "\u70B9\u6309\u94AE\u6216\u53D1\u540D\u79F0/\u7F16\u53F7\uFF1B\u7BA1\u7406\u5458\u53D1\u300C\u7BA1\u7406\u300D\u6253\u5F00\u7BA1\u7406\u83DC\u5355\u3002",
+      cmds,
+      idPrefix: "cmd",
+      footerMd: "_\u5B98\u65B9\u4EC5 @\u673A\u5668\u4EBA \u89E6\u53D1\uFF1B\u6E38\u620F\u804A\u5929\u9700\u914D\u7F6E `bridge_channel_id`\u3002_",
+      footerText: "\u5B98\u65B9\u4EC5 @\u673A\u5668\u4EBA \u89E6\u53D1\uFF1B\u6E38\u620F\u804A\u5929\u9700\u914D\u7F6E bridge_channel_id\u3002"
+    });
+  };
+}
+function createAdminMenuHandler(registry) {
+  return (ctx) => {
+    if (!isAdmin(ctx)) {
+      return { text: "\u4EC5\u7BA1\u7406\u5458\u53EF\u6253\u5F00\u7BA1\u7406\u83DC\u5355\uFF08\u9700\u5728 qq_admin_openids\uFF0C\u6216\u5F00\u542F\u7FA4\u7BA1\u89C6\u4F5C\u7BA1\u7406\u5458\uFF09" };
+    }
+    const cmds = registry.adminMenu();
+    if (cmds.length === 0) {
+      return { text: "\u6682\u65E0\u7BA1\u7406\u6307\u4EE4" };
+    }
+    return formatCommandMenu({
+      title: "SFMC \u7BA1\u7406",
+      subtitle: "\u4EE5\u4E0B\u4E3A\u7BA1\u7406\u6307\u4EE4\uFF1B\u4E5F\u53EF\u76F4\u63A5\u53D1\u300C\u8E22\u4EBA\u300D\u300C\u5F85\u5BA1\u300D\u7B49\u89E6\u53D1\u8BCD\u3002",
+      cmds,
+      idPrefix: "adm",
+      footerMd: "_\u654F\u611F\u64CD\u4F5C\u8BF7\u786E\u8BA4\u5BF9\u8C61\u6B63\u786E\u3002_",
+      footerText: "\u654F\u611F\u64CD\u4F5C\u8BF7\u786E\u8BA4\u5BF9\u8C61\u6B63\u786E\u3002"
+    });
+  };
+}
+const pingHandler = (ctx) => {
+  const { runtimeInfo, startedAt, inbound } = ctx;
+  const parts = ["pong", `backend=${inbound.backend}`, `uptime=${formatUptime(startedAt)}`];
+  if (inbound.backend === "official") {
+    parts.push(`sandbox=${runtimeInfo.sandbox ? "true" : "false"}`);
+    if (runtimeInfo.appIdHint) parts.push(`app=${runtimeInfo.appIdHint}`);
+  }
+  return { text: parts.join(" \xB7 ") };
+};
+const whoamiHandler = async (ctx) => {
+  const { inbound } = ctx;
+  const lines = [`\u4F60\u662F ${inbound.userName}`, `id=${inbound.userId}`, `group=${inbound.groupId}`];
+  const ep = dbEp(ctx);
+  if (ep) {
+    try {
+      const me = await fetchBindMe(ep, inbound.userId);
+      if (me.bound && me.binding) {
+        lines.push(`\u5DF2\u7ED1\u5B9A MC\uFF1A${me.binding.player_name || "?"} (${me.binding.player_xuid || "?"})`);
+      } else {
+        lines.push("\u672A\u7ED1\u5B9A MC\uFF08\u53D1\u9001\u300C\u7ED1\u5B9A\u300D\u83B7\u53D6\u9A8C\u8BC1\u7801\uFF09");
+      }
+    } catch {
+      lines.push("\u7ED1\u5B9A\u67E5\u8BE2\u5931\u8D25\uFF08db-server \u4E0D\u53EF\u8FBE\uFF09");
+    }
+  }
+  return { text: lines.join("\n") };
+};
+const statusHandler = async (ctx) => {
+  const ep = dbEp(ctx);
+  if (!ep) return { text: "status\uFF1A\u672A\u914D\u7F6E db_host/db_port" };
+  try {
+    const st = await fetchSfmcStatus(ep);
+    const n = Array.isArray(st.online) ? st.online.length : 0;
+    const day = st.world?.day != null ? String(st.world.day) : "\u2014";
+    const diff = st.world?.difficulty ? String(st.world.difficulty) : "\u2014";
+    const age = typeof st.updatedAt === "number" ? `${Math.max(0, Math.floor((Date.now() - st.updatedAt) / 1e3))}s\u524D` : "\u2014";
+    const host = st.host;
+    const bds = st.processes?.bds;
+    const db = st.processes?.db;
+    const hostUp = host?.uptimeText || "\u2014";
+    const bdsLine = bds?.state === "running" ? `\u8FD0\u884C\u4E2D \xB7 ${bds.uptimeText || "\u2014"}${bds.pid ? ` (PID ${bds.pid})` : ""}` : "\u672A\u8FD0\u884C";
+    const mem = host?.memory != null ? `${host.memory.usedMb ?? "\u2014"}/${host.memory.totalMb ?? "\u2014"} MB (${host.memory.usedPercent ?? "\u2014"}%)` : "\u2014";
+    const cpu = host?.cpu != null ? `${host.cpu.cores ?? "\u2014"} \u6838 \xB7 ${host.cpu.model || "\u2014"}` : "\u2014";
+    const machine = host ? `${host.hostname || "\u2014"} \xB7 ${host.platform || "\u2014"}/${host.arch || "\u2014"} ${host.release || ""}`.trim() : "\u2014";
+    const note = st.note ? `
+${st.note}` : n === 0 ? "\n\u6682\u65E0\u5728\u7EBF\u73A9\u5BB6\u6570\u636E" : "";
+    const qqLines = await fetchQqGroupLines(ctx);
+    const text = [
+      "\u670D\u52A1\u5668\u72B6\u6001",
+      `\u5728\u7EBF\uFF1A${n} \u4EBA`,
+      `\u4E16\u754C\u65E5\uFF1A${day}`,
+      `\u96BE\u5EA6\uFF1A${diff}`,
+      `\u4E3B\u673A\uFF1A${machine}`,
+      `\u4E3B\u673A\u8FD0\u884C\uFF1A${hostUp}`,
+      `BDS\uFF1A${bdsLine}`,
+      `\u5185\u5B58\uFF1A${mem}`,
+      `CPU\uFF1A${cpu}`,
+      `db-server\uFF1A${db?.uptimeText || "\u2014"}${db?.pid ? ` (PID ${db.pid})` : ""}`,
+      ...qqLines,
+      `\u6570\u636E\uFF1A${age}${note}`
+    ].join("\n");
+    const markdown = [
+      "## \u670D\u52A1\u5668\u72B6\u6001",
+      "",
+      `- **\u5728\u7EBF**\uFF1A${n} \u4EBA`,
+      `- **\u4E16\u754C\u65E5**\uFF1A${day}`,
+      `- **\u96BE\u5EA6**\uFF1A${diff}`,
+      `- **\u4E3B\u673A**\uFF1A${machine}`,
+      `- **\u4E3B\u673A\u8FD0\u884C**\uFF1A${hostUp}`,
+      `- **BDS**\uFF1A${bdsLine}`,
+      `- **\u5185\u5B58**\uFF1A${mem}`,
+      `- **CPU**\uFF1A${cpu}`,
+      `- **db-server**\uFF1A${db?.uptimeText || "\u2014"}${db?.pid ? ` (PID ${db.pid})` : ""}`,
+      ...qqLines.map((l) => `- ${l}`),
+      `- **\u6570\u636E**\uFF1A${age}`,
+      note ? `
+_${(st.note || "\u6682\u65E0\u5728\u7EBF\u73A9\u5BB6\u6570\u636E").trim()}_` : ""
+    ].filter((line) => line !== "").join("\n");
+    return { text, markdown };
+  } catch (e) {
+    return { text: `status \u5931\u8D25\uFF1A${e.message}` };
+  }
+};
+const ONLINE_CAP = 30;
+const onlineHandler = async (ctx) => {
+  const ep = dbEp(ctx);
+  if (!ep) return { text: "online\uFF1A\u672A\u914D\u7F6E db_host/db_port" };
+  try {
+    const st = await fetchSfmcStatus(ep);
+    const list = Array.isArray(st.online) ? st.online : [];
+    if (list.length === 0) {
+      return { text: st.note || "\u6682\u65E0\u5728\u7EBF\u73A9\u5BB6" };
+    }
+    const shown = list.slice(0, ONLINE_CAP);
+    const names = shown.map((p, i) => `${i + 1}. ${p.name || p.id || "?"}`).join("\n");
+    const more = list.length > ONLINE_CAP ? `
+\u2026\u53E6\u6709 ${list.length - ONLINE_CAP} \u4EBA\u672A\u5217\u51FA` : "";
+    return { text: `\u5728\u7EBF ${list.length} \u4EBA
+${names}${more}` };
+  } catch (e) {
+    return { text: `online \u5931\u8D25\uFF1A${e.message}` };
+  }
+};
+const bindHandler = async (ctx) => {
+  const ep = dbEp(ctx);
+  if (!ep) return { text: "\u7ED1\u5B9A\uFF1A\u672A\u914D\u7F6E db_host/db_port" };
+  try {
+    const { status, data } = await postBindRequest(ep, {
+      openid: ctx.inbound.userId,
+      qq_backend: ctx.inbound.backend
+    });
+    if (status === 409 || data.error === "already_bound") {
+      return {
+        text: `\u4F60\u5DF2\u7ED1\u5B9A MC \u73A9\u5BB6\u300C${data.player_name || "?"}\u300D\u3002\u5982\u9700\u6362\u7ED1\u8BF7\u5148\u53D1\u9001\u300C\u89E3\u7ED1\u300D\u3002`
+      };
+    }
+    if (!data.success || !data.code) {
+      return { text: `\u7533\u8BF7\u7ED1\u5B9A\u5931\u8D25\uFF1A${data.error || `HTTP ${status}`}` };
+    }
+    return {
+      text: `\u7ED1\u5B9A\u7801\uFF1A${data.code}
+\u8BF7\u5728\u6E38\u620F\u5185\u8F93\u5165 !bind\uFF0C\u7136\u540E\u5728 60 \u79D2\u5185\u53D1\u9001\u6B64\u6570\u5B57\u7801\uFF08\u4E0D\u8981\u5E26 !\uFF09\u3002`,
+      markdown: `## \u7ED1\u5B9A\u7801 \`${data.code}\`
+
+1. \u6E38\u620F\u5185\u6267\u884C **!bind**
+2. \u5728 **60 \u79D2\u5185**\u53D1\u9001\u672C\u6570\u5B57\u7801\uFF08\u4E0D\u8981\u5E26 \`!\`\uFF09
+
+_\u8D85\u65F6\u8BF7\u91CD\u65B0\u7533\u8BF7_`
+    };
+  } catch (e) {
+    return { text: `\u7ED1\u5B9A\u5931\u8D25\uFF1A${e.message}` };
+  }
+};
+const unbindHandler = async (ctx) => {
+  const ep = dbEp(ctx);
+  if (!ep) return { text: "\u89E3\u7ED1\uFF1A\u672A\u914D\u7F6E db_host/db_port" };
+  try {
+    const { data } = await postBindUnbind(ep, { openid: ctx.inbound.userId });
+    if (data.unbound) return { text: "\u5DF2\u89E3\u9664 QQ\u2194MC \u7ED1\u5B9A\u3002" };
+    return { text: "\u5F53\u524D\u6CA1\u6709\u7ED1\u5B9A\u8BB0\u5F55\u3002" };
+  } catch (e) {
+    return { text: `\u89E3\u7ED1\u5931\u8D25\uFF1A${e.message}` };
+  }
+};
+const groupInfoHandler = async (ctx) => {
+  const lines = await fetchQqGroupLines(ctx);
+  if (lines.length === 0) {
+    return { text: "\u7FA4\u4FE1\u606F\u4EC5\u5B98\u65B9\u540E\u7AEF\u53EF\u7528\uFF0C\u4E14\u9700\u914D\u7F6E qq_group_openid / \u51ED\u8BC1\u3002" };
+  }
+  return { text: ["QQ \u7FA4\u4FE1\u606F", ...lines].join("\n") };
+};
+const joinHandler = async (ctx) => {
+  const ep = dbEp(ctx);
+  if (!ep) return { text: "\u7533\u8BF7\u5165\u670D\uFF1A\u672A\u914D\u7F6E db_host/db_port" };
+  let playerName = ctx.inbound.text.replace(/^\/?(申请入服|join)\s*/i, "").trim();
+  if (!playerName) {
+    try {
+      const me = await fetchBindMe(ep, ctx.inbound.userId);
+      if (me.bound && me.binding?.player_name) playerName = String(me.binding.player_name);
+    } catch {
+    }
+  }
+  if (!playerName) {
+    return { text: "\u7528\u6CD5\uFF1A\u7533\u8BF7\u5165\u670D <\u73A9\u5BB6\u540D>\n\uFF08\u5DF2\u7ED1\u5B9A\u53EF\u7701\u7565\u540D\u5B57\uFF09" };
+  }
+  try {
+    const { data } = await postJoinRequest(ep, {
+      openid: ctx.inbound.userId,
+      player_name: playerName,
+      qq_backend: ctx.inbound.backend
+    });
+    if (!data.success || !data.id) {
+      if (data.error === "join_allowlist_disabled") {
+        return { text: "\u5165\u670D\u767D\u540D\u5355\u5DF2\u5173\u95ED\uFF08\u7BA1\u7406\u5458\u53EF\u53D1\u300C\u914D\u7F6E \u767D\u540D\u5355 \u5F00\u300D\uFF09" };
+      }
+      return { text: `\u7533\u8BF7\u5931\u8D25\uFF1A${data.error || "unknown"}` };
+    }
+    if (data.auto_approved || data.status === "approved") {
+      return {
+        text: data.note ? `\u300C${playerName}\u300D${data.note}` : `\u5DF2\u81EA\u52A8\u901A\u8FC7\u300C${playerName}\u300D\u5165\u670D\uFF0C\u7B49\u5F85 BDS \u5199\u5165\u767D\u540D\u5355`
+      };
+    }
+    const admins = ctx.runtimeInfo.adminOpenids ?? [];
+    const creds = ctx.runtimeInfo.officialCreds;
+    const gid = ctx.runtimeInfo.groupOpenid || ctx.inbound.groupId;
+    if (creds && gid && admins.length > 0 && ctx.inbound.backend === "official") {
+      void sendGroupMessage(creds, {
+        groupOpenid: gid,
+        msgType: 2,
+        markdown: `## \u5165\u670D\u7533\u8BF7
+
+\u73A9\u5BB6 **${playerName}**
+\u7533\u8BF7\u4EBA \`${ctx.inbound.userId.slice(0, 8)}\u2026\`
+\u8BF7\u6C42 id=\`${data.id}\``,
+        keyboardButtons: [
+          {
+            id: `ap_${data.id}`,
+            label: "\u901A\u8FC7",
+            data: `join:approve:${data.id}`,
+            actionType: 1,
+            style: 1,
+            permission: { type: 0, specify_user_ids: admins }
+          },
+          {
+            id: `rj_${data.id}`,
+            label: "\u62D2\u7EDD",
+            data: `join:reject:${data.id}`,
+            actionType: 1,
+            style: 0,
+            permission: { type: 0, specify_user_ids: admins }
+          }
+        ]
+      }).catch(() => void 0);
+    }
+    const note = data.note ? `
+${data.note}` : admins.length === 0 ? "\n\u672A\u914D\u7F6E qq_admin_openids\uFF0C\u7BA1\u7406\u5458\u6536\u4E0D\u5230\u901A\u77E5" : "";
+    return {
+      text: `\u5DF2\u63D0\u4EA4\u5165\u670D\u7533\u8BF7\u300C${playerName}\u300D${note}`,
+      buttons: ctx.inbound.backend === "llbot" && admins.length > 0 ? [
+        { id: "a", label: `\u901A\u8FC7 ${playerName}`, command: `/approve ${data.id}` },
+        { id: "r", label: `\u62D2\u7EDD ${playerName}`, command: `/reject ${data.id}` }
+      ] : void 0
+    };
+  } catch (e) {
+    return { text: `\u7533\u8BF7\u5931\u8D25\uFF1A${e.message}` };
+  }
+};
+function parseOnOff(raw) {
+  const s = raw.trim().toLowerCase();
+  if (["\u5F00", "\u5F00\u542F", "on", "true", "1", "yes"].includes(s)) return true;
+  if (["\u5173", "\u5173\u95ED", "off", "false", "0", "no"].includes(s)) return false;
+  return null;
+}
+const joinConfigHandler = async (ctx) => {
+  if (!isAdmin(ctx)) return { text: "\u4EC5\u7BA1\u7406\u5458\u53EF\u914D\u7F6E\u5165\u670D\u5F00\u5173\uFF08qq_admin_openids / \u7FA4\u7BA1\u89C6\u4F5C\u7BA1\u7406\u5458\uFF09" };
+  const ep = dbEp(ctx);
+  if (!ep) return { text: "\u914D\u7F6E\uFF1A\u672A\u8FDE\u63A5 db" };
+  const admins = ctx.runtimeInfo.adminOpenids ?? [];
+  const rest = ctx.inbound.text.replace(/^\/?(配置|config|入服配置)\s*/i, "").trim();
+  if (!rest) {
+    try {
+      const data = await fetchJoinSettings(ep);
+      if (data.success === false) return { text: `\u8BFB\u53D6\u5931\u8D25\uFF1A${data.error || "unknown"}` };
+      return buildJoinSettingsPanel({
+        settings: settingsFromResponse(data),
+        backend: ctx.inbound.backend,
+        adminOpenids: admins
+      });
+    } catch (e) {
+      return { text: `\u8BFB\u53D6\u5931\u8D25\uFF1A${e.message}` };
+    }
+  }
+  if (/^(群管|群管理员|treat|group.?admin)/i.test(rest)) {
+    return {
+      text: "\u300C\u7FA4\u7BA1\u89C6\u4F5C\u7BA1\u7406\u5458\u300D\u53EA\u80FD\u6539 configs/qq_link.json \u7684 treat_group_admins_as_admins\uFF0C\u7FA4\u804A\u4E0D\u53EF\u6539\u3002\u53D1\u300C\u914D\u7F6E\u300D\u53EF\u67E5\u770B\u5F53\u524D\u503C\u3002"
+    };
+  }
+  const m = /^(白名单|allowlist|审批|approval)\s+(\S+)/i.exec(rest);
+  if (!m) {
+    return { text: "\u7528\u6CD5\uFF1A\u914D\u7F6E\n\u3000\u3000\u3000\u6216\u70B9\u9762\u677F\u6309\u94AE\u5207\u6362\u767D\u540D\u5355/\u5BA1\u6279" };
+  }
+  const which = m[1].toLowerCase();
+  const onOff = parseOnOff(m[2]);
+  if (onOff === null) return { text: "\u8BF7\u4F7F\u7528 \u5F00/\u5173\uFF08\u6216 on/off\uFF09" };
+  const body = {
+    openid: ctx.inbound.userId,
+    as_group_admin: asGroupAdminField(ctx)
+  };
+  if (which === "\u767D\u540D\u5355" || which === "allowlist") body.allowlist_enabled = onOff;
+  else body.require_approval = onOff;
+  try {
+    const { data } = await postJoinSettings(ep, body);
+    if (data.success === false) {
+      if (data.error === "not_admin") {
+        return { text: "\u65E0\u6743\u9650\uFF08\u7FA4\u7BA1\u9700 configs/qq_link.json \u4E2D treat_group_admins_as_admins=true\uFF09" };
+      }
+      if (data.error === "immutable_field") {
+        return { text: data.note || "\u8BE5\u5B57\u6BB5\u4E0D\u53EF\u7ECF\u7FA4\u804A\u4FEE\u6539" };
+      }
+      return { text: `\u4FDD\u5B58\u5931\u8D25\uFF1A${data.error || "unknown"}` };
+    }
+    return buildJoinSettingsPanel({
+      settings: settingsFromResponse(data),
+      backend: ctx.inbound.backend,
+      adminOpenids: admins,
+      prefix: "\u5DF2\u4FDD\u5B58"
+    });
+  } catch (e) {
+    return { text: `\u4FDD\u5B58\u5931\u8D25\uFF1A${e.message}` };
+  }
+};
+const pendingHandler = async (ctx) => {
+  if (!isAdmin(ctx)) return { text: "\u4EC5\u7BA1\u7406\u5458\u53EF\u67E5\u770B\u5F85\u5BA1\u5217\u8868\uFF08\u914D\u7F6E qq_admin_openids\uFF09" };
+  const ep = dbEp(ctx);
+  if (!ep) return { text: "\u5F85\u5BA1\uFF1A\u672A\u914D\u7F6E db" };
+  try {
+    const data = await fetchJoinPending(ep, ctx.inbound.userId, asGroupAdminField(ctx));
+    if (data.error) {
+      if (data.error === "not_admin") {
+        return { text: "\u65E0\u6743\u9650\uFF08\u7FA4\u7BA1\u9700 treat_group_admins_as_admins=true\uFF09" };
+      }
+      return { text: `\u5F85\u5BA1\u5931\u8D25\uFF1A${data.error}` };
+    }
+    const list = data.pending ?? [];
+    if (list.length === 0) return { text: "\u6682\u65E0\u5F85\u5BA1\u5165\u670D\u7533\u8BF7" };
+    const lines = list.map((r, i) => `${i + 1}. ${r.player_name || "?"} (${r.id})`);
+    return { text: `\u5F85\u5BA1 ${list.length} \u6761
+${lines.join("\n")}` };
+  } catch (e) {
+    return { text: `\u5F85\u5BA1\u5931\u8D25\uFF1A${e.message}` };
+  }
+};
+const approveHandler = async (ctx) => {
+  if (!isAdmin(ctx)) return { text: "\u4EC5\u7BA1\u7406\u5458\u53EF\u5BA1\u6279" };
+  const ep = dbEp(ctx);
+  if (!ep) return { text: "\u672A\u914D\u7F6E db" };
+  const id = ctx.inbound.text.replace(/^\/?(approve|通过)\s*/i, "").trim();
+  if (!id) return { text: "\u7528\u6CD5\uFF1A\u901A\u8FC7 <\u7533\u8BF7id>" };
+  try {
+    const { data } = await postJoinDecide(ep, {
+      id,
+      decision: "approve",
+      decided_by: ctx.inbound.userId,
+      as_group_admin: asGroupAdminField(ctx)
+    });
+    if (data.success === false && data.error === "not_admin") {
+      return { text: "\u65E0\u6743\u9650\uFF08\u7FA4\u7BA1\u9700 treat_group_admins_as_admins=true\uFF09" };
+    }
+    return { text: data.success === false ? `\u5931\u8D25\uFF1A${data.error}` : `\u5DF2\u901A\u8FC7\u300C${data.player_name || id}\u300D` };
+  } catch (e) {
+    return { text: `\u5931\u8D25\uFF1A${e.message}` };
+  }
+};
+const rejectHandler = async (ctx) => {
+  if (!isAdmin(ctx)) return { text: "\u4EC5\u7BA1\u7406\u5458\u53EF\u5BA1\u6279" };
+  const ep = dbEp(ctx);
+  if (!ep) return { text: "\u672A\u914D\u7F6E db" };
+  const id = ctx.inbound.text.replace(/^\/?(reject|拒绝)\s*/i, "").trim();
+  if (!id) return { text: "\u7528\u6CD5\uFF1A\u62D2\u7EDD <\u7533\u8BF7id>" };
+  try {
+    const { data } = await postJoinDecide(ep, {
+      id,
+      decision: "reject",
+      decided_by: ctx.inbound.userId,
+      as_group_admin: asGroupAdminField(ctx)
+    });
+    if (data.success === false && data.error === "not_admin") {
+      return { text: "\u65E0\u6743\u9650\uFF08\u7FA4\u7BA1\u9700 treat_group_admins_as_admins=true\uFF09" };
+    }
+    return { text: data.success === false ? `\u5931\u8D25\uFF1A${data.error}` : `\u5DF2\u62D2\u7EDD\u300C${data.player_name || id}\u300D` };
+  } catch (e) {
+    return { text: `\u5931\u8D25\uFF1A${e.message}` };
+  }
+};
+const channelHandler = async (ctx) => {
+  const id = String(ctx.runtimeInfo.bridgeChannelId ?? "").trim();
+  const lines = [
+    "\u3010\u804A\u5929\u4E92\u901A\u3011",
+    id ? `\u9891\u9053\uFF1A${id}` : "\u9891\u9053\uFF1A\u672A\u914D\u7F6E\uFF08\u8BF7\u8BBE qq_config.json \u2192 bridge_channel_id \u5E76\u91CD\u542F db/qq/BDS\uFF09",
+    `\u540E\u7AEF\uFF1A${ctx.inbound.backend}${ctx.runtimeInfo.sandbox ? " \xB7 sandbox" : ""}`
+  ];
+  const ep = dbEp(ctx);
+  if (!ep) {
+    lines.push("db\uFF1A\u672A\u914D\u7F6E db_host/db_port");
+  } else {
+    try {
+      const st = await fetchSfmcStatus(ep);
+      const bds = st.processes?.bds;
+      const db = st.processes?.db;
+      lines.push(`db-server\uFF1A${db?.state === "stopped" || db?.running === false ? "\u672A\u8FD0\u884C" : db?.uptimeText || "\u53EF\u8FBE"}${db?.pid ? ` (PID ${db.pid})` : ""}`);
+      lines.push(
+        `BDS\uFF1A${bds?.state === "running" || bds?.running === true ? `\u8FD0\u884C\u4E2D \xB7 ${bds.uptimeText || "\u2014"}` : "\u672A\u8FD0\u884C"}`
+      );
+    } catch (e) {
+      lines.push(`db\uFF1A\u4E0D\u53EF\u8FBE\uFF08${e.message}\uFF09`);
+    }
+  }
+  lines.push("\u63D0\u793A\uFF1A\u5B98\u65B9\u4EC5 @\u673A\u5668\u4EBA \u7684\u975E\u6307\u4EE4\u6D88\u606F\u8FDB\u6E38\u620F\uFF1B\u6E38\u620F\u804A\u5929\u63A8\u7FA4\u8D70 MC\u2192QQ\u3002");
+  const text = lines.join("\n");
+  return {
+    text,
+    markdown: text.split("\n").map((l, i) => i === 0 ? `## ${l.replace(/【|】/g, "")}` : `- ${l}`).join("\n")
+  };
+};
+const doctorHandler = async (ctx) => {
+  if (!isAdmin(ctx)) return { text: "\u4EC5\u7BA1\u7406\u5458\u53EF\u6267\u884C\u81EA\u68C0" };
+  const base = await channelHandler(ctx);
+  const extra = ["", "\u3010\u7BA1\u7406\u81EA\u68C0\u3011"];
+  const admins = ctx.runtimeInfo.adminOpenids ?? [];
+  extra.push(`\u7BA1\u7406\u5458 openid \u6570\uFF1A${admins.length}${admins.length === 0 ? "\uFF08\u7A7A\u5219\u65E0\u6CD5\u5BA1\u6279/\u8E22\u4EBA\uFF09" : ""}`);
+  extra.push(`\u7FA4 openid\uFF1A${ctx.runtimeInfo.groupOpenid ? "\u5DF2\u914D\u7F6E" : "\u672A\u914D\u7F6E"}`);
+  if (ctx.inbound.backend === "official") {
+    extra.push(`\u51ED\u8BC1\uFF1A${ctx.runtimeInfo.officialCreds ? "\u5DF2\u6CE8\u5165" : "\u7F3A\u5931"}`);
+  }
+  const text = `${base.text}
+${extra.join("\n")}`;
+  return { text, markdown: `${base.markdown ?? base.text}
+
+### \u7BA1\u7406\u81EA\u68C0
+
+${extra.filter(Boolean).map((l) => `- ${l}`).join("\n")}` };
+};
+const kickHandler = async (ctx) => {
+  if (!isAdmin(ctx)) return { text: "\u4EC5\u7BA1\u7406\u5458\u53EF\u8E22\u4EBA\uFF08\u914D\u7F6E qq_admin_openids\uFF09" };
+  const ep = dbEp(ctx);
+  if (!ep) return { text: "\u8E22\u4EBA\uFF1A\u672A\u914D\u7F6E db" };
+  const target = ctx.inbound.text.replace(/^\/?(踢人|kick)\s*/i, "").trim();
+  if (!target) return { text: "\u7528\u6CD5\uFF1A\u8E22\u4EBA <\u73A9\u5BB6\u540D>" };
+  try {
+    const { data } = await postAdminKick(ep, {
+      openid: ctx.inbound.userId,
+      target_name: target,
+      reason: "QQ \u7BA1\u7406\u5458\u8E22\u51FA",
+      as_group_admin: asGroupAdminField(ctx)
+    });
+    if (!data.success) {
+      if (data.error === "not_admin") {
+        return { text: "\u65E0\u6743\u9650\uFF08\u7FA4\u7BA1\u9700 treat_group_admins_as_admins=true\uFF09" };
+      }
+      return { text: `\u8E22\u4EBA\u5165\u961F\u5931\u8D25\uFF1A${data.error || "unknown"}` };
+    }
+    return { text: `\u5DF2\u5C06\u300C${target}\u300D\u8E22\u4EBA\u8BF7\u6C42\u5165\u961F\uFF0C\u7B49\u5F85 BDS \u6267\u884C\u3002` };
+  } catch (e) {
+    return { text: `\u8E22\u4EBA\u5931\u8D25\uFF1A${e.message}` };
+  }
+};
+function registerBuiltinCommands(registry) {
+  registry.register({
+    name: "menu",
+    aliases: ["\u83DC\u5355", "help", "\u5E2E\u52A9", "/help", "/\u83DC\u5355", "/menu"],
+    description: "\u663E\u793A\u6307\u4EE4\u83DC\u5355",
+    handler: createMenuHandler(registry)
+  });
+  registry.register({
+    name: "ping",
+    aliases: ["/ping"],
+    description: "\u8FDE\u901A\u6027\u63A2\u6D4B",
+    handler: pingHandler
+  });
+  registry.register({
+    name: "whoami",
+    aliases: ["/whoami", "\u6211\u7684\u7ED1\u5B9A"],
+    description: "\u67E5\u770B QQ id \u4E0E MC \u7ED1\u5B9A",
+    handler: whoamiHandler
+  });
+  registry.register({
+    name: "status",
+    aliases: ["\u72B6\u6001", "/status", "/\u72B6\u6001"],
+    description: "\u670D\u52A1\u5668\u72B6\u6001\u6458\u8981",
+    handler: statusHandler
+  });
+  registry.register({
+    name: "online",
+    aliases: ["\u5728\u7EBF", "/online", "/\u5728\u7EBF"],
+    description: "\u5728\u7EBF\u73A9\u5BB6\u540D\u5355",
+    handler: onlineHandler
+  });
+  registry.register({
+    name: "bind",
+    aliases: ["\u7ED1\u5B9A", "/bind", "/\u7ED1\u5B9A"],
+    description: "\u7533\u8BF7 QQ\u2194MC \u7ED1\u5B9A\u7801",
+    handler: bindHandler
+  });
+  registry.register({
+    name: "unbind",
+    aliases: ["\u89E3\u7ED1", "/unbind", "/\u89E3\u7ED1"],
+    description: "\u89E3\u9664 QQ\u2194MC \u7ED1\u5B9A",
+    handler: unbindHandler
+  });
+  registry.register({
+    name: "join",
+    aliases: ["\u7533\u8BF7\u5165\u670D", "/join", "/\u7533\u8BF7\u5165\u670D"],
+    description: "\u7533\u8BF7\u52A0\u5165\u670D\u52A1\u5668\u767D\u540D\u5355",
+    handler: joinHandler
+  });
+  registry.register({
+    name: "channel",
+    aliases: ["\u9891\u9053", "/channel", "/\u9891\u9053"],
+    description: "\u804A\u5929\u4E92\u901A\u9891\u9053\u4E0E\u8FDE\u901A\u81EA\u68C0",
+    handler: channelHandler
+  });
+  registry.register({
+    name: "admin",
+    aliases: ["\u7BA1\u7406", "/admin", "/\u7BA1\u7406"],
+    description: "\u7BA1\u7406\u5B50\u83DC\u5355\uFF08\u7BA1\u7406\u5458\uFF09",
+    handler: createAdminMenuHandler(registry)
+  });
+  registry.register({
+    name: "doctor",
+    aliases: ["\u81EA\u68C0", "/doctor", "/\u81EA\u68C0"],
+    description: "\u7BA1\u7406\u4FA7\u8FDE\u901A/\u914D\u7F6E\u81EA\u68C0",
+    handler: doctorHandler,
+    adminMenu: true
+  });
+  registry.register({
+    name: "group",
+    aliases: ["\u7FA4\u4FE1\u606F", "/group", "/\u7FA4\u4FE1\u606F"],
+    description: "QQ \u7FA4 OpenAPI \u6458\u8981",
+    handler: groupInfoHandler,
+    adminMenu: true
+  });
+  registry.register({
+    name: "config",
+    aliases: ["\u914D\u7F6E", "\u5165\u670D\u914D\u7F6E", "/config", "/\u914D\u7F6E"],
+    description: "\u5165\u670D\u767D\u540D\u5355/\u5BA1\u6279\u5F00\u5173\uFF08\u7BA1\u7406\u5458\uFF09",
+    handler: joinConfigHandler,
+    adminMenu: true
+  });
+  registry.register({
+    name: "pending",
+    aliases: ["\u5F85\u5BA1", "/pending", "/\u5F85\u5BA1"],
+    description: "\u5F85\u5BA1\u5165\u670D\u5217\u8868\uFF08\u7BA1\u7406\u5458\uFF09",
+    handler: pendingHandler,
+    adminMenu: true
+  });
+  registry.register({
+    name: "approve",
+    aliases: ["\u901A\u8FC7", "/approve", "/\u901A\u8FC7"],
+    description: "\u901A\u8FC7\u5165\u670D\u7533\u8BF7\uFF08\u7BA1\u7406\u5458\uFF09",
+    handler: approveHandler,
+    adminMenu: true
+  });
+  registry.register({
+    name: "reject",
+    aliases: ["\u62D2\u7EDD", "/reject", "/\u62D2\u7EDD"],
+    description: "\u62D2\u7EDD\u5165\u670D\u7533\u8BF7\uFF08\u7BA1\u7406\u5458\uFF09",
+    handler: rejectHandler,
+    adminMenu: true
+  });
+  registry.register({
+    name: "kick",
+    aliases: ["\u8E22\u4EBA", "/kick", "/\u8E22\u4EBA"],
+    description: "\u8E22\u51FA\u6E38\u620F\u5185\u73A9\u5BB6\uFF08\u7BA1\u7406\u5458\uFF09",
+    handler: kickHandler,
+    adminMenu: true
+  });
+}
+export {
+  approveHandler,
+  bindHandler,
+  channelHandler,
+  createAdminMenuHandler,
+  createMenuHandler,
+  doctorHandler,
+  groupInfoHandler,
+  joinConfigHandler,
+  joinHandler,
+  kickHandler,
+  onlineHandler,
+  pendingHandler,
+  pingHandler,
+  registerBuiltinCommands,
+  rejectHandler,
+  statusHandler,
+  unbindHandler,
+  whoamiHandler
+};
+//# sourceMappingURL=handlers.js.map