@sfmc-bds/qq-bridge 0.2.0-beta.12 → 0.2.0-beta.13

package/dist/commands/handlers.js

@@ -1,22 +1,17 @@
-import {
-  getGroupBotState,
-  getGroupInfo,
-  sendGroupMessage
-} from "@sfmc-bds/sdk/node/qq-official";
+import { getGroupBotState, getGroupInfo } from "@sfmc-bds/sdk/node/qq-official";
+import { log } from "../log.js";
 import {
   fetchBindMe,
-  fetchJoinPending,
-  fetchJoinSettings,
+  fetchContent,
+  fetchQqEventSettings,
   fetchSfmcStatus,
-  postAdminKick,
   postBindRequest,
   postBindUnbind,
-  postJoinDecide,
-  postJoinRequest,
-  postJoinSettings
+  postQqEventSettings
 } from "./db-api.js";
-import { buildJoinSettingsPanel, settingsFromResponse } from "./join-settings-ui.js";
-import { formatCommandMenu } from "./menu-format.js";
+import { formatAccountCard } from "./account-format.js";
+import { formatModuleLines, formatPackLines, formatPackMarkdown } from "./content-format.js";
+import { formatCard, formatCommandMenu } from "./menu-format.js";
 function formatUptime(startedAt) {
   const ms = Math.max(0, Date.now() - startedAt);
   const s = Math.floor(ms / 1e3);
@@ -33,26 +28,25 @@ function dbEp(ctx) {
   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;
+  return ctx.adminAuthorized === true;
+}
+function failure(error) {
+  log.warn(`QQ \u64CD\u4F5C\u5931\u8D25: ${String(error)}`);
+  return { text: "\u64CD\u4F5C\u6682\u65F6\u672A\u5B8C\u6210\uFF0C\u8BF7\u7A0D\u540E\u67E5\u8BE2\u72B6\u6001\u6216\u8054\u7CFB\u7BA1\u7406\u5458\uFF1B\u8BF7\u52FF\u8FDE\u7EED\u91CD\u590D\u63D0\u4EA4\u4FEE\u6539\u3002" };
 }
 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;
+  const gid = ctx.runtimeInfo.groupOpenid || (ctx.inbound.scene !== "c2c" ? 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)
-    ]);
+    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"}`);
+      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);
@@ -60,7 +54,7 @@ async function fetchQqGroupLines(ctx) {
     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"}`
+        `\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) {
@@ -69,143 +63,158 @@ async function fetchQqGroupLines(ctx) {
   return lines;
 }
 function createMenuHandler(registry) {
-  return () => {
-    const cmds = registry.userMenu().filter((c) => c.name !== "menu");
+  return (ctx) => formatCommandMenu({
+    title: "\u4E1C\u65B9\u72AC\u660E\u6E56",
+    home: true,
+    subtitle: "\u6B22\u8FCE\u56DE\u6765\uFF0C\u4ECA\u5929\u4E5F\u4E00\u8D77\u73A9\u5427 (\u2267\u2207\u2266)\uFF89\n\n\u67E5\u8BE2\u670D\u52A1\u5668\u4FE1\u606F\uFF0C\u6216\u7BA1\u7406\u4F60\u7684\u6E38\u620F\u8D26\u53F7\u3002",
+    cmds: registry.all().filter((c) => c.group === "home" && c.name !== "menu" && (c.permission !== "admin" || isAdmin(ctx))),
+    idPrefix: "home",
+    footerMd: "",
+    footerText: ""
+  });
+}
+function createAdminMenuHandler(registry) {
+  return (ctx) => {
+    if (!isAdmin(ctx)) return { text: "\u5F53\u524D\u6CA1\u6709\u7BA1\u7406\u6743\u9650\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002" };
     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"
+      title: "\u670D\u52A1\u5668\u7BA1\u7406",
+      subtitle: "\u7BA1\u7406\u670D\u52A1\u5668\u4E0E\u7FA4\u63A8\u9001\u3002",
+      cmds: registry.adminMenu(),
+      idPrefix: "admin",
+      footerMd: "",
+      footerText: ""
     });
   };
 }
-function createAdminMenuHandler(registry) {
+function sectionHandler(registry, group, title) {
+  return () => formatCommandMenu({
+    title,
+    subtitle: "\u67E5\u770B\u8FD0\u884C\u72B6\u6001\u3001\u5728\u7EBF\u73A9\u5BB6\u548C\u8FDE\u63A5\u65B9\u5F0F\u3002",
+    cmds: registry.all().filter((c) => c.group === group),
+    idPrefix: group,
+    footerMd: "",
+    footerText: ""
+  });
+}
+function helpHandler(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" };
+    const trigger = ctx.inbound.backend === "official" ? "\u7FA4\u5185\u5F00\u542F\u300C\u63A5\u6536\u6240\u6709\u6D88\u606F\u300D\u540E\u53EF\u76F4\u63A5\u53D1\u9001\u6307\u4EE4\uFF1B\u5426\u5219\u8BF7 @\u673A\u5668\u4EBA\u3002\u5355\u804A\u76F4\u63A5\u53D1\u9001\u3002" : "\u76F4\u63A5\u53D1\u9001\u547D\u4EE4\uFF0C\u6216\u5728\u83DC\u5355\u6253\u5F00\u540E 60 \u79D2\u5185\u56DE\u590D\u7F16\u53F7\u3002";
+    const sections = [
+      ["server", "\u670D\u52A1\u5668"],
+      ["account", "\u6211\u7684\u8D26\u53F7"],
+      ["admin", "\u7BA1\u7406"]
+    ];
+    const lines = [trigger];
+    for (const [group, title] of sections) {
+      const commands = registry.all().filter((c) => c.group === group && (c.permission !== "admin" || isAdmin(ctx)));
+      if (!commands.length) continue;
+      lines.push(
+        "",
+        `\u3010${title}\u3011`,
+        ...commands.map((c) => `${c.name === "ip" ? "ip" : c.aliases[0] || c.name}\uFF1A${c.description}`)
+      );
     }
-    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"
-    });
+    lines.push("", "\u53D1\u9001 \u83DC\u5355 \u8FD4\u56DE\u9996\u9875\uFF0C\u53D1\u9001 \u53D6\u6D88 \u53D6\u6D88\u5F85\u786E\u8BA4\u64CD\u4F5C\u3002", "\u539F\u6709\u82F1\u6587\u547D\u4EE4\u53CA /\u547D\u4EE4 \u65B9\u5F0F\u4ECD\u53EF\u4F7F\u7528\u3002");
+    return formatCard("\u4F7F\u7528\u5E2E\u52A9", lines);
   };
 }
-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 serverVersionHandler = async (ctx) => {
   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");
+      const status = await fetchSfmcStatus(ep);
+      const bds = status.processes?.bds;
+      if (bds?.state === "running" && bds.version)
+        return formatCard("\u7248\u672C", ["\u6E38\u620F\u7C7B\u578B\uFF1A\u57FA\u5CA9\u7248", `\u5F53\u524D BDS \u7248\u672C\uFF1A${bds.version}`]);
+    } catch (error) {
+      log.warn(`BDS \u7248\u672C\u67E5\u8BE2\u5931\u8D25: ${String(error)}`);
     }
   }
-  return { text: lines.join("\n") };
+  return {
+    text: ctx.runtimeInfo.publicServer?.version ? `\u6682\u65F6\u65E0\u6CD5\u786E\u8BA4\u5B9E\u9645 BDS \u7248\u672C\u3002
+\u7BA1\u7406\u5458\u63D0\u4F9B\u7684\u5165\u670D\u8BF4\u660E\uFF1A${ctx.runtimeInfo.publicServer.version}` : "\u6682\u65F6\u65E0\u6CD5\u786E\u8BA4\u5B9E\u9645 BDS \u7248\u672C\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u786E\u8BA4\u5165\u670D\u7248\u672C\u3002"
+  };
+};
+const serverAddressHandler = (ctx) => {
+  const info = ctx.runtimeInfo.publicServer;
+  return formatCard(
+    "\u8FDE\u63A5\u5730\u5740",
+    info?.address ? [
+      "\u6E38\u620F\u7C7B\u578B\uFF1A\u57FA\u5CA9\u7248",
+      `\u670D\u52A1\u5668\u5730\u5740\uFF1A${info.address}`,
+      `\u7AEF\u53E3\uFF1A${info.port ?? 19132}`,
+      "",
+      "\u5728\u6E38\u620F\u5185\u9009\u62E9\u300C\u6DFB\u52A0\u670D\u52A1\u5668\u300D\uFF0C\u586B\u5199\u4EE5\u4E0A\u4FE1\u606F\u3002"
+    ] : ["\u6682\u672A\u516C\u5E03\u670D\u52A1\u5668\u5730\u5740\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u83B7\u53D6\u3002"]
+  );
+};
+const pingHandler = (ctx) => ({
+  text: `\u673A\u5668\u4EBA\u8FDE\u63A5\u6B63\u5E38\uFF0C\u5DF2\u8FD0\u884C ${formatUptime(ctx.startedAt)}`
+});
+const whoamiHandler = async (ctx) => {
+  const ep = dbEp(ctx);
+  if (!ep) return failure("db \u672A\u914D\u7F6E");
+  const me = await fetchBindMe(ep, ctx.inbound.userId);
+  if (me.success === false) return failure("\u7ED1\u5B9A\u67E5\u8BE2\u5931\u8D25");
+  return {
+    ...formatAccountCard({
+      bound: !!me.bound,
+      ...me.binding?.player_name ? { playerName: me.binding.player_name } : {},
+      ...me.profile ? { profile: me.profile } : {}
+    }),
+    buttons: me.bound ? [{ id: "unbind", label: "\u89E3\u7ED1", command: "/unbind" }] : [{ id: "bind", label: "\u7ED1\u5B9A", command: "/bind" }]
+  };
 };
 const statusHandler = async (ctx) => {
   const ep = dbEp(ctx);
-  if (!ep) return { text: "status\uFF1A\u672A\u914D\u7F6E db_host/db_port" };
+  if (!ep) return failure("db \u672A\u914D\u7F6E");
+  let st;
   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}` };
+    st = await fetchSfmcStatus(ep);
+  } catch (error) {
+    log.warn(`\u67E5\u670D\u72B6\u6001\u63A5\u53E3\u4E0D\u53EF\u7528: ${String(error)}`);
+    return formatCard("\u670D\u52A1\u5668\u72B6\u6001", ["\u6682\u65F6\u65E0\u6CD5\u8FDE\u63A5\u72B6\u6001\u670D\u52A1\uFF0C\u65E0\u6CD5\u786E\u8BA4\u6E38\u620F\u670D\u52A1\u5668\u662F\u5426\u8FD0\u884C\u3002", "\u8BF7\u7A0D\u540E\u91CD\u8BD5\u6216\u8054\u7CFB\u7BA1\u7406\u5458\u3002"]);
   }
+  const state = st.processes?.bds;
+  const running = state?.state === "running" || state?.running === true;
+  const stopped = state?.state === "stopped" || state?.running === false;
+  const onlineText = stopped ? "0 \u4EBA" : st.note || !Array.isArray(st.online) ? "\u6570\u636E\u6682\u4E0D\u53EF\u786E\u8BA4" : `${st.online.length} \u4EBA`;
+  const age = typeof st.updatedAt === "number" ? `${Math.max(0, Math.floor((Date.now() - st.updatedAt) / 1e3))} \u79D2\u524D` : "\u672A\u77E5";
+  return {
+    ...formatCard("\u670D\u52A1\u5668\u72B6\u6001", [
+      `\u8FD0\u884C\u72B6\u6001\uFF1A${running ? "\u8FD0\u884C\u4E2D" : stopped ? "\u672A\u8FD0\u884C" : "\u6682\u65F6\u65E0\u6CD5\u786E\u8BA4"}`,
+      `\u5728\u7EBF\u73A9\u5BB6\uFF1A${onlineText}`,
+      `\u4E16\u754C\u65E5\uFF1A${st.world?.day ?? "\u672A\u77E5"}`,
+      `\u96BE\u5EA6\uFF1A${st.world?.difficulty ?? "\u672A\u77E5"}`,
+      `\u6570\u636E\u66F4\u65B0\uFF1A${age}`,
+      ...st.note && running ? ["\u5728\u7EBF\u6570\u636E\u6682\u4E0D\u53EF\u786E\u8BA4\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002"] : []
+    ]),
+    buttons: [
+      { id: "online", label: "\u5728\u7EBF\u73A9\u5BB6", command: "/online" },
+      { id: "version", label: "\u7248\u672C", command: "/version" },
+      { id: "ip", label: "\u8FDE\u63A5\u5730\u5740", command: "/ip" },
+      { id: "refresh_status", label: "\u5237\u65B0\u72B6\u6001", command: "/status" }
+    ]
+  };
 };
-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}` };
-  }
+  if (!ep) return failure("db \u672A\u914D\u7F6E");
+  const st = await fetchSfmcStatus(ep);
+  if (st.processes?.bds?.state === "stopped") return formatCard("\u5728\u7EBF\u73A9\u5BB6", ["\u670D\u52A1\u5668\u672A\u8FD0\u884C\uFF0C\u5F53\u524D\u6CA1\u6709\u5728\u7EBF\u73A9\u5BB6\u3002"]);
+  if (!Array.isArray(st.online) || st.note) return { text: "\u5728\u7EBF\u6570\u636E\u6682\u4E0D\u53EF\u786E\u8BA4\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002" };
+  if (!st.online.length) return formatCard("\u5728\u7EBF\u73A9\u5BB6", ["\u5F53\u524D\u6CA1\u6709\u5728\u7EBF\u73A9\u5BB6\u3002"]);
+  return {
+    ...formatCard("\u5728\u7EBF\u73A9\u5BB6", [
+      `\u5F53\u524D\u5728\u7EBF ${st.online.length} \u4EBA`,
+      "",
+      ...st.online.map((p, i) => `${i + 1}. ${p.name || "\u672A\u547D\u540D\u73A9\u5BB6"}`)
+    ])
+  };
 };
 const bindHandler = async (ctx) => {
   const ep = dbEp(ctx);
-  if (!ep) return { text: "\u7ED1\u5B9A\uFF1A\u672A\u914D\u7F6E db_host/db_port" };
+  if (!ep) return failure("db \u672A\u914D\u7F6E");
   try {
     const { status, data } = await postBindRequest(ep, {
       openid: ctx.inbound.userId,
@@ -217,442 +226,301 @@ const bindHandler = async (ctx) => {
       };
     }
     if (!data.success || !data.code) {
-      return { text: `\u7533\u8BF7\u7ED1\u5B9A\u5931\u8D25\uFF1A${data.error || `HTTP ${status}`}` };
+      return failure(data.error);
     }
-    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_`
-    };
+    return formatCard("\u7ED1\u5B9A\u8D26\u53F7", [
+      `\u7ED1\u5B9A\u7801\uFF1A${data.code}`,
+      "",
+      "\u8FDB\u5165\u670D\u52A1\u5668\u540E\u5B8C\u6210\u4E0B\u9762\u4E24\u6B65\uFF1A",
+      "1. \u5728\u6E38\u620F\u5185\u6267\u884C /c:bind",
+      "2. \u5728 60 \u79D2\u5185\u628A\u4EE5\u4E0A\u7EAF\u6570\u5B57\u9A8C\u8BC1\u7801\u53D1\u5230\u6E38\u620F\u804A\u5929",
+      "",
+      "\u7ED1\u5B9A\u6210\u529F\u540E\u5373\u53EF\u81EA\u7531\u6D3B\u52A8\u3002",
+      "\u8D85\u65F6\u8BF7\u91CD\u65B0\u53D1\u9001\u300C\u7ED1\u5B9A\u300D\u83B7\u53D6\u9A8C\u8BC1\u7801\u3002"
+    ]);
   } catch (e) {
-    return { text: `\u7ED1\u5B9A\u5931\u8D25\uFF1A${e.message}` };
+    return failure(e);
   }
 };
 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}` };
-  }
+  if (!ep) return failure("db \u672A\u914D\u7F6E");
+  const me = await fetchBindMe(ep, ctx.inbound.userId);
+  if (me.success === false) return failure("\u7ED1\u5B9A\u67E5\u8BE2\u5931\u8D25");
+  if (!me.bound || !me.binding) return { text: "\u5F53\u524D\u6CA1\u6709\u7ED1\u5B9A\u8BB0\u5F55\u3002" };
+  const original = me.binding;
+  return {
+    text: "\u786E\u8BA4\u89E3\u7ED1",
+    confirmation: {
+      summary: `\u5373\u5C06\u89E3\u9664\u4F60\u4E0E\u300C${original.player_name || "\u672A\u547D\u540D\u89D2\u8272"}\u300D\u7684\u7ED1\u5B9A\u3002\u4E4B\u540E\u9700\u8981\u91CD\u65B0\u7533\u8BF7\u9A8C\u8BC1\u7801\u624D\u80FD\u7ED1\u5B9A\u3002`,
+      execute: async (confirmed) => {
+        const current = await fetchBindMe(ep, confirmed.inbound.userId);
+        if (current.success === false) return failure("\u7ED1\u5B9A\u6838\u9A8C\u5931\u8D25");
+        if (!current.bound || current.binding?.player_xuid !== original.player_xuid || current.binding?.bound_at !== original.bound_at) {
+          return { text: "\u7ED1\u5B9A\u72B6\u6001\u5DF2\u53D8\u5316\uFF0C\u8BF7\u91CD\u65B0\u67E5\u8BE2\u300C\u6211\u7684\u8D26\u53F7\u300D\u540E\u518D\u64CD\u4F5C\u3002" };
+        }
+        const { data } = await postBindUnbind(ep, { openid: confirmed.inbound.userId });
+        if (data.success === false) return failure(data.error);
+        return { text: data.unbound ? "\u5DF2\u89E3\u9664 QQ \u4E0E\u6E38\u620F\u89D2\u8272\u7684\u7ED1\u5B9A\u3002" : "\u5F53\u524D\u6CA1\u6709\u7ED1\u5B9A\u8BB0\u5F55\u3002" };
+      }
+    }
+  };
 };
 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: "\u7FA4\u4FE1\u606F\u4EC5\u5B98\u65B9\u540E\u7AEF\u53EF\u7528\uFF0C\u4E14\u9700\u914D\u7F6E official.group_openid / \u51ED\u8BC1\u3002" };
   }
   return { text: ["QQ \u7FA4\u4FE1\u606F", ...lines].join("\n") };
 };
-const joinHandler = async (ctx) => {
+const entryGuideHandler = () => formatCard("\u8FDB\u670D\u8BF4\u660E", [
+  "\u76F4\u63A5\u8FDB\u5165\u670D\u52A1\u5668\u5373\u53EF\u3002",
+  "",
+  "\u672A\u7ED1\u5B9A\u7684\u89D2\u8272\u53EF\u4EE5\u8FDB\u670D\uFF0C\u4F46\u65E0\u6CD5\u79FB\u52A8\uFF0C\u6743\u9650\u4E3A\u8BBF\u5BA2\u3002",
+  "\u804A\u5929\u680F\u4F1A\u63D0\u793A\u7ED1\u5B9A\u6B65\u9AA4\u3002",
+  "\u5728 QQ \u53D1\u9001\u300C\u7ED1\u5B9A\u300D\u83B7\u53D6\u9A8C\u8BC1\u7801\uFF0C\u8FDB\u670D\u540E\u6267\u884C /c:bind\uFF0C\u518D\u628A\u9A8C\u8BC1\u7801\u53D1\u5230\u6E38\u620F\u804A\u5929\u3002",
+  "\u7ED1\u5B9A\u6210\u529F\u540E\u5373\u53EF\u6B63\u5E38\u6E38\u73A9\u3002"
+]);
+const retiredJoinFlowHandler = () => ({
+  text: "\u5165\u670D\u7533\u8BF7\u5DF2\u5173\u95ED\u3002\u76F4\u63A5\u8FDB\u5165\u670D\u52A1\u5668\uFF0C\u5728\u6E38\u620F\u5185\u6309\u804A\u5929\u63D0\u793A\u5B8C\u6210\u7ED1\u5B9A\u540E\u5373\u53EF\u6E38\u73A9\u3002\u7ED1\u5B9A\u6210\u529F\u4F1A\u5199\u5165\u767D\u540D\u5355\u5E76\u89E3\u9664\u8BBF\u5BA2\u9650\u5236\u3002"
+});
+const EVENT_SWITCHES = [
+  ["enabled", "\u603B\u5F00\u5173"],
+  ["start", "\u542F\u52A8"],
+  ["stop", "\u505C\u670D"],
+  ["crash", "\u5F02\u5E38\u9000\u51FA"],
+  ["join", "\u4E0A\u7EBF"],
+  ["leave", "\u4E0B\u7EBF"],
+  ["death", "\u6B7B\u4EA1"]
+];
+function eventSettingsPanel(settings, prefix = "") {
+  const rows = [
+    ...EVENT_SWITCHES.map(([field, label]) => [label, settings[field] ? "\u5F00" : "\u5173"]),
+    ["\u805A\u5408\u95F4\u9694", `${settings.window_sec} \u79D2`]
+  ];
+  const textRows = rows.map(([label, value]) => `\u2502 ${label}${"\u3000".repeat(4 - label.length)} \u2502 ${value} \u2502`);
+  const buttons = EVENT_SWITCHES.map(([field, label]) => ({
+    id: `events_${field}`,
+    label: `${label} ${settings[field] ? "\u5173" : "\u5F00"}`,
+    command: `/events ${label} ${settings[field] ? "\u5173" : "\u5F00"}`
+  }));
+  buttons.push({ id: "events_window", label: "\u805A\u5408\u95F4\u9694", command: "/events \u95F4\u9694" });
+  return {
+    text: [
+      "\u63A8\u9001\u8BBE\u7F6E",
+      ...prefix ? [prefix] : [],
+      "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+      "\u2502 \u9879\u76EE\u3000\u3000 \u2502 \u72B6\u6001\u3000 \u2502",
+      "\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524",
+      ...textRows,
+      "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518",
+      `\u73A9\u5BB6\u4E8B\u4EF6\u7EA6 ${settings.window_sec} \u79D2\u5408\u5E76\u53D1\u9001\uFF1B\u542F\u505C\u4E0E\u5F02\u5E38\u9000\u51FA\u5373\u65F6\u53D1\u9001\u3002`
+    ].join("\n"),
+    markdown: [
+      "## \u63A8\u9001\u8BBE\u7F6E",
+      ...prefix ? ["", prefix] : [],
+      "",
+      "| \u9879\u76EE | \u72B6\u6001 |",
+      "| --- | --- |",
+      ...rows.map(([label, value]) => `| ${label} | **${value}** |`),
+      "",
+      `_\u73A9\u5BB6\u4E8B\u4EF6\u7EA6 ${settings.window_sec} \u79D2\u5408\u5E76\u53D1\u9001\uFF1B\u542F\u505C\u4E0E\u5F02\u5E38\u9000\u51FA\u5373\u65F6\u53D1\u9001_`
+    ].join("\n"),
+    buttons
+  };
+}
+const eventSettingsHandler = async (ctx) => {
+  if (!isAdmin(ctx)) return { text: "\u5F53\u524D\u6CA1\u6709\u7BA1\u7406\u6743\u9650\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002" };
   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" };
-  }
+  if (!ep) return failure("db \u672A\u914D\u7F6E");
+  const rest = ctx.inbound.text.replace(/^\/?(?:events|事件推送|事件配置)\s*/i, "").trim();
   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 (!rest) {
+      const data = await fetchQqEventSettings(ep);
+      return data.success && data.settings ? eventSettingsPanel(data.settings) : failure(data.error);
     }
-    if (data.auto_approved || data.status === "approved") {
+    if (rest === "\u95F4\u9694") {
+      const data = await fetchQqEventSettings(ep);
+      if (!data.success || !data.settings) return failure(data.error);
       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`
+        ...formatCard("\u805A\u5408\u95F4\u9694", [
+          `\u5F53\u524D\uFF1A${data.settings.window_sec} \u79D2`,
+          "\u73A9\u5BB6\u8FDB\u51FA\u53CA\u6B7B\u4EA1\u901A\u77E5\u4F1A\u5728\u8FD9\u6BB5\u65F6\u95F4\u5185\u5408\u5E76\u3002",
+          "\u4E5F\u53EF\u53D1\u9001\u300C\u4E8B\u4EF6\u63A8\u9001 \u95F4\u9694 \u79D2\u6570\u300D\uFF0C\u8303\u56F4 5\u2013600 \u79D2\u3002"
+        ]),
+        buttons: [30, 60, 120].map((seconds) => ({
+          id: `events_window_${seconds}`,
+          label: `${seconds} \u79D2`,
+          command: `/events \u95F4\u9694 ${seconds}`
+        }))
       };
     }
-    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
+    const interval = /^间隔\s+(\d+)$/.exec(rest);
+    if (interval) {
+      const seconds = Number(interval[1]);
+      if (!Number.isInteger(seconds) || seconds < 5 || seconds > 600) return { text: "\u805A\u5408\u95F4\u9694\u9700\u4E3A 5\u2013600 \u79D2\u7684\u6574\u6570\u3002" };
+      const data = await postQqEventSettings(ep, {
+        openid: ctx.inbound.userId,
+        as_group_admin: asGroupAdminField(ctx),
+        field: "window_sec",
+        value: seconds
       });
-    } 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 data.success && data.settings ? eventSettingsPanel(data.settings, "\u5DF2\u4FDD\u5B58") : failure(data.error);
     }
-    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" };
+    const match = /^(总开关|启动|停服|异常退出|上线|下线|死亡)\s+(开|关)$/.exec(rest);
+    if (!match) return { text: "\u53D1\u9001\u300C\u4E8B\u4EF6\u63A8\u9001\u300D\u6253\u5F00\u5F00\u5173\u9762\u677F\uFF0C\u6216\u9009\u62E9\u9762\u677F\u4E2D\u7684\u64CD\u4F5C\u3002" };
+    const item = EVENT_SWITCHES.find(([, label]) => label === match[1]);
+    if (!item) return { text: "\u6CA1\u6709\u8FD9\u4E2A\u4E8B\u4EF6\u5F00\u5173\u3002" };
+    const [field] = item;
+    const value = match[2] === "\u5F00";
+    const execute = async (confirmed) => {
+      try {
+        const data = await postQqEventSettings(ep, {
+          openid: confirmed.inbound.userId,
+          as_group_admin: asGroupAdminField(confirmed),
+          field,
+          value
+        });
+        return data.success && data.settings ? eventSettingsPanel(data.settings, "\u5DF2\u4FDD\u5B58") : failure(data.error);
+      } catch (error) {
+        return failure(error);
       }
-      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" };
+    };
+    if (field === "enabled" && !value) {
+      return {
+        text: "\u786E\u8BA4\u5173\u95ED\u4E8B\u4EF6\u63A8\u9001",
+        confirmation: { summary: "\u5373\u5C06\u5173\u95ED\u5168\u90E8\u670D\u52A1\u5668\u4E8B\u4EF6\u7FA4\u63A8\u9001\u3002", execute }
+      };
     }
-    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}` };
+    return execute(ctx);
+  } catch (error) {
+    return failure(error);
   }
 };
-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 channelHandler = () => ({
+  text: "QQ\u7FA4\u6D88\u606F\u8FDB\u5165\u6E38\u620F\u5185\u53EA\u8BFB\u7684 QQ \u9891\u9053\u3002\u6E38\u620F\u5185\u5404\u9891\u9053\u53EF\u5206\u522B\u8BBE\u7F6E\u662F\u5426\u8F6C\u53D1\u5230 QQ\u3002"
+});
+const doctorHandler = async (ctx) => {
+  if (!isAdmin(ctx)) return { text: "\u5F53\u524D\u6CA1\u6709\u7BA1\u7406\u6743\u9650\u3002" };
   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");
+  if (!ep) return failure("db \u672A\u914D\u7F6E");
+  const st = await fetchSfmcStatus(ep);
+  const qq = await fetchQqGroupLines(ctx);
   return {
-    text,
-    markdown: text.split("\n").map((l, i) => i === 0 ? `## ${l.replace(/【|】/g, "")}` : `- ${l}`).join("\n")
+    text: [
+      "\u7BA1\u7406\u81EA\u68C0",
+      `\u540E\u7AEF\uFF1A${ctx.inbound.backend}`,
+      `QQ \u5165\u7AD9\u9891\u9053\uFF1A${ctx.runtimeInfo.bridgeChannelId || "qq"}`,
+      `\u4E3B\u673A\uFF1A${st.host?.hostname || "\u672A\u77E5"} \xB7 ${st.host?.platform || "\u672A\u77E5"}`,
+      `CPU\uFF1A${st.host?.cpu?.model || "\u672A\u77E5"} \xB7 ${st.host?.cpu?.cores ?? "\u672A\u77E5"} \u6838`,
+      `\u5185\u5B58\uFF1A${st.host?.memory?.usedMb ?? "\u672A\u77E5"}/${st.host?.memory?.totalMb ?? "\u672A\u77E5"} MB`,
+      `\u4E3B\u673A\u8FD0\u884C\uFF1A${st.host?.uptimeText || "\u672A\u77E5"}`,
+      `BDS\uFF1A${st.processes?.bds?.state || "\u672A\u77E5"} \xB7 PID ${st.processes?.bds?.pid ?? "\u672A\u77E5"} \xB7 ${st.processes?.bds?.uptimeText || "\u672A\u77E5"}`,
+      `\u6570\u636E\u5E93\uFF1APID ${st.processes?.db?.pid ?? "\u672A\u77E5"} \xB7 ${st.processes?.db?.uptimeText || "\u672A\u77E5"}`,
+      ...qq
+    ].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 modulesHandler = async (ctx) => {
+  const ep = dbEp(ctx);
+  if (!ep) return failure("db \u672A\u914D\u7F6E");
+  const keyword = ctx.inbound.text.replace(/^\/?(模块|modules)\s*/i, "").trim();
+  try {
+    const data = await fetchContent(ep);
+    if (data.success === false) return failure(data.error);
+    return formatCard("\u6A21\u5757", formatModuleLines(data.modules ?? [], keyword));
+  } catch (error) {
+    return failure(error);
   }
-  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 packsHandler = async (ctx) => {
   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>" };
+  if (!ep) return failure("db \u672A\u914D\u7F6E");
   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}` };
+    const data = await fetchContent(ep);
+    if (data.success === false) return failure(data.error);
+    const packs = data.packs ?? (data.resource_packs ?? []).map((pack) => ({
+      kind: "resource",
+      enabled: true,
+      ...pack.name ? { name: pack.name } : {},
+      ...pack.pack_id ? { pack_id: pack.pack_id } : {},
+      ...pack.version ? { version: pack.version } : {}
+    }));
+    return {
+      text: ["\u4E16\u754C\u5305", "", ...formatPackLines(packs, data.note)].join("\n"),
+      markdown: formatPackMarkdown(packs, data.note)
+    };
+  } catch (error) {
+    return failure(error);
   }
 };
 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
+  const add = (name, aliases, description, handler, group, admin = false) => registry.register({
+    name,
+    aliases,
+    description,
+    handler,
+    group,
+    permission: admin ? "admin" : "player",
+    adminMenu: group === "admin"
   });
+  add("menu", ["\u83DC\u5355"], "\u8FD4\u56DE\u9996\u9875", createMenuHandler(registry), "home");
+  add(
+    "server",
+    ["\u670D\u52A1\u5668"],
+    "\u67E5\u770B\u8FD0\u884C\u72B6\u6001\u3001\u5728\u7EBF\u73A9\u5BB6\u548C\u8FDE\u63A5\u65B9\u5F0F",
+    sectionHandler(registry, "server", "\u670D\u52A1\u5668\u4FE1\u606F"),
+    "home"
+  );
+  add("account", ["\u6211\u7684\u8D26\u53F7"], "\u67E5\u770B\u4E0E\u7BA1\u7406\u6E38\u620F\u89D2\u8272\u7ED1\u5B9A", whoamiHandler, "home");
+  add(
+    "entry",
+    ["\u5165\u670D"],
+    "\u76F4\u63A5\u8FDB\u670D\uFF0C\u6E38\u620F\u5185\u7ED1\u5B9A\u540E\u5373\u53EF\u6E38\u73A9",
+    entryGuideHandler,
+    "home"
+  );
+  add("help", ["\u5E2E\u52A9"], "\u67E5\u770B\u4F7F\u7528\u8BF4\u660E\u548C\u5E38\u7528\u547D\u4EE4", helpHandler(registry), "home");
+  add("admin", ["\u7BA1\u7406"], "\u7BA1\u7406\u83DC\u5355", createAdminMenuHandler(registry), "home", true);
+  add("status", ["\u67E5\u670D", "\u72B6\u6001"], "\u670D\u52A1\u5668\u8FD0\u884C\u72B6\u6001", statusHandler, "server");
+  add("online", ["\u5728\u7EBF"], "\u5B8C\u6574\u5728\u7EBF\u540D\u5355", onlineHandler, "server");
+  add("version", ["\u7248\u672C"], "\u57FA\u5CA9\u7248\u5165\u670D\u7248\u672C", serverVersionHandler, "server");
+  add("ip", ["\u5730\u5740"], "\u516C\u5F00\u670D\u52A1\u5668\u5730\u5740\u4E0E\u7AEF\u53E3", serverAddressHandler, "server");
+  add("modules", ["\u6A21\u5757"], "\u67E5\u770B\u5DF2\u5B89\u88C5\u6A21\u5757", modulesHandler, "server");
+  add("packs", ["\u8D44\u6E90\u5305", "\u884C\u4E3A\u5305", "\u4E16\u754C\u5305"], "\u67E5\u770B\u4E16\u754C\u884C\u4E3A\u5305\u548C\u8D44\u6E90\u5305", packsHandler, "server");
+  add("channel", ["\u9891\u9053"], "\u804A\u5929\u4E92\u901A\u72B6\u6001", channelHandler, "server");
+  add("ping", [], "\u673A\u5668\u4EBA\u8FDE\u901A\u6027", pingHandler, "server");
+  add("whoami", ["\u6211\u7684\u7ED1\u5B9A"], "\u67E5\u770B\u7ED1\u5B9A\u89D2\u8272", whoamiHandler, "account");
+  add("bind", ["\u7ED1\u5B9A"], "\u7533\u8BF7\u7ED1\u5B9A\u9A8C\u8BC1\u7801", bindHandler, "account");
+  add("unbind", ["\u89E3\u7ED1"], "\u786E\u8BA4\u89E3\u9664\u7ED1\u5B9A", unbindHandler, "account");
+  add(
+    "join",
+    ["\u7533\u8BF7\u5165\u670D", "\u901A\u8FC7", "\u62D2\u7EDD", "\u5F85\u5BA1", "approve", "reject", "pending", "\u914D\u7F6E", "\u5165\u670D\u914D\u7F6E", "config"],
+    "\u5165\u670D\u7533\u8BF7\u5DF2\u5173\u95ED\uFF0C\u8BF7\u76F4\u63A5\u8FDB\u670D\u5E76\u7ED1\u5B9A",
+    retiredJoinFlowHandler,
+    "help"
+  );
+  add("doctor", ["\u81EA\u68C0"], "\u8FDE\u901A\u4E0E\u8FD0\u884C\u8BCA\u65AD", doctorHandler, "admin", true);
+  add("group", ["\u7FA4\u4FE1\u606F"], "\u5B98\u65B9 QQ \u7FA4\u4FE1\u606F", groupInfoHandler, "admin", true);
+  add("events", ["\u4E8B\u4EF6\u63A8\u9001", "\u4E8B\u4EF6\u914D\u7F6E"], "\u670D\u52A1\u5668\u4E8B\u4EF6\u63A8\u9001\u5F00\u5173", eventSettingsHandler, "admin", true);
 }
 export {
-  approveHandler,
   bindHandler,
   channelHandler,
   createAdminMenuHandler,
   createMenuHandler,
   doctorHandler,
+  entryGuideHandler,
+  eventSettingsHandler,
   groupInfoHandler,
-  joinConfigHandler,
-  joinHandler,
-  kickHandler,
+  modulesHandler,
   onlineHandler,
-  pendingHandler,
+  packsHandler,
   pingHandler,
   registerBuiltinCommands,
-  rejectHandler,
+  retiredJoinFlowHandler,
+  serverAddressHandler,
+  serverVersionHandler,
   statusHandler,
   unbindHandler,
   whoamiHandler