koishi-plugin-ggcevo 1.3.0 → 1.3.2

package/lib/index.d.ts

@@ -21,11 +21,14 @@ export interface Config {
     handleInactiveUnbindDays: number;
     /** 活动兑换管理员名字, 填写后兑换成功及兑换列表会提示向该管理员登记; 不填则不提醒 */
     exchangeAdminName: string;
+    /** 咕咕之战菜单渲染方式: text=文字菜单(默认, 无需额外服务), image=图片菜单(需启用 puppeteer 服务) */
+    menuStyle: 'text' | 'image';
     debugEnabled: boolean;
 }
 export declare const Config: Schema<Config>;
 export declare const inject: {
     required: string[];
+    optional: string[];
 };
 export declare const ItemConfig: Record<number, string>;
 export declare const LotteryPoolConfig: Record<number, string>;

package/lib/index.js

@@ -1,6 +1,8 @@
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -30,6 +40,10 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 var import_koishi = require("koishi");
+var import_node_fs = __toESM(require("node:fs"));
+var import_node_path = __toESM(require("node:path"));
+var import_node_crypto = require("node:crypto");
+var import_promises = require("node:fs/promises");
 var name = "ggcevo";
 var Config = import_koishi.Schema.intersect([
   import_koishi.Schema.object({
@@ -61,12 +75,19 @@ var Config = import_koishi.Schema.intersect([
     handleInactiveUnbindEnabled: import_koishi.Schema.boolean().description("是否启用句柄长时间未使用自动解绑").default(false),
     handleInactiveUnbindDays: import_koishi.Schema.number().description("句柄超过该天数未使用将自动解绑(仅对非当前使用的句柄生效)").default(90).min(1)
   }).description("句柄自动解绑"),
+  import_koishi.Schema.object({
+    menuStyle: import_koishi.Schema.union([
+      import_koishi.Schema.const("text").description("文字菜单(默认, 无需额外服务)"),
+      import_koishi.Schema.const("image").description("图片菜单(需安装并启用 koishi-plugin-puppeteer 或 @shangxueink/puppeteer-without-canvas)")
+    ]).description("咕咕之战菜单渲染方式").default("text")
+  }).description("菜单设置"),
   import_koishi.Schema.object({
     debugEnabled: import_koishi.Schema.boolean().description("是否启用调试模式(启用后, ggcevo 所有指令的触发/参数/执行结果/错误信息会输出到 Koishi 日志)").default(false)
   }).description("调试模式")
 ]);
 var inject = {
-  required: ["database"]
+  required: ["database"],
+  optional: ["puppeteer"]
 };
 var ItemConfig = {
   1: "金币",
@@ -2416,10 +2437,10 @@ ${rewardLines.join("\n")}` : "";
       return record || null;
     }
   }, "getValidDocsToken");
-  const docsApiRequest = /* @__PURE__ */ __name(async (method, path, data) => {
+  const docsApiRequest = /* @__PURE__ */ __name(async (method, path2, data) => {
     const token = await getValidDocsToken();
     if (!token) throw new Error("腾讯文档应用级账号不可用, 请检查插件配置(Client ID / Client Secret)");
-    const url = `https://docs.qq.com/openapi${path}`;
+    const url = `https://docs.qq.com/openapi${path2}`;
     const headers = {
       "Access-Token": token.access_token,
       "Client-Id": config.tencentDocsClientId,
@@ -2812,186 +2833,181 @@ ${rewardLines.join("\n")}` : "";
     }
     return "已退出封禁记录查询。";
   });
-  const MENU_PREFIX = "ggg:";
   const menuCategories = [
     {
       key: "daily",
-      label: "📅 每日玩法",
+      label: "每日玩法",
+      emoji: "📅",
       desc: "签到 / 挖矿 / 探索 / 补签",
       items: [
-        { key: "sign", label: "签到", desc: "每日签到, 获取金币与咕咕币", cmd: "签到" },
-        { key: "mine", label: "挖矿", desc: "领取挂机挖矿收益(每半小时4金币)", cmd: "挖矿" },
-        { key: "explore", label: "探索", desc: "选择星系进行12小时探索", cmd: "探索" },
-        { key: "makeup", label: "补签", desc: "使用补签券补签漏签日期", cmd: "补签" }
+        { key: "sign", icon: "签", label: "签到", desc: "每日签到, 获取金币与咕咕币" },
+        { key: "mine", icon: "挖", label: "挖矿", desc: "领取挂机挖矿收益(每半小时4金币)" },
+        { key: "explore", icon: "探", label: "探索", desc: "选择星系进行12小时探索" },
+        { key: "makeup", icon: "补", label: "补签", desc: "使用补签券补签漏签日期" }
       ]
     },
     {
       key: "bag",
-      label: "🎒 物品背包",
+      label: "物品背包",
+      emoji: "🎒",
       desc: "背包 / 个人信息 / 使用",
       items: [
-        { key: "inv", label: "背包", desc: "查看自己的物品背包", cmd: "背包" },
-        { key: "profile", label: "个人信息", desc: "查看签到统计与个人信息", cmd: "个人信息" },
-        { key: "use", label: "使用 <名称>", desc: "使用指定物品(如赎罪券等)", cmd: "使用", input: "请输入要使用的物品名称" }
+        { key: "inv", icon: "包", label: "背包", desc: "查看自己的物品背包" },
+        { key: "profile", icon: "信", label: "个人信息", desc: "查看签到统计与个人信息" },
+        { key: "use", icon: "用", label: "使用 <名称>", desc: "使用指定物品(如赎罪券等)" }
       ]
     },
     {
       key: "lottery",
-      label: "🎲 抽奖兑换",
+      label: "抽奖兑换",
+      emoji: "🎲",
       desc: "抽奖 / 抽奖概率 / 兑换 / 兑换列表",
       items: [
-        { key: "lottery", label: "抽奖", desc: "抽奖, 可加选项 -p 奖池ID -c 次数", cmd: "抽奖" },
-        { key: "odds", label: "抽奖概率", desc: "查看各奖池抽奖概率与保底说明", cmd: "抽奖概率" },
-        { key: "exchange", label: "兑换 <名称>", desc: "使用兑换券兑换物品", cmd: "兑换", input: "请输入要兑换的物品名称" },
-        { key: "exchangeList", label: "兑换列表", desc: "查看可兑换物品列表", cmd: "兑换列表" }
+        { key: "lottery", icon: "抽", label: "抽奖", desc: "抽奖, 可加选项 -p 奖池ID -c 次数" },
+        { key: "odds", icon: "率", label: "抽奖概率", desc: "查看各奖池抽奖概率与保底说明" },
+        { key: "exchange", icon: "兑", label: "兑换 <名称>", desc: "使用兑换券兑换物品" },
+        { key: "exchangeList", icon: "表", label: "兑换列表", desc: "查看可兑换物品列表" }
       ]
     },
     {
       key: "activity",
-      label: "🎉 活动",
+      label: "活动",
+      emoji: "🎉",
       desc: "活动列表 / 领取活动",
       items: [
-        { key: "actList", label: "活动列表", desc: '查看进行中的活动(参数"全部"查看全部)', cmd: "活动列表" },
-        { key: "actClaim", label: "领取活动", desc: "领取指定(或最新)活动奖励", cmd: "领取活动" }
+        { key: "actList", icon: "活", label: "活动列表", desc: '查看进行中的活动(参数"全部"查看全部)' },
+        { key: "actClaim", icon: "领", label: "领取活动", desc: "领取指定(或最新)活动奖励" }
       ]
     },
     {
       key: "handle",
-      label: "🔗 句柄绑定",
+      label: "句柄绑定",
+      emoji: "🔗",
       desc: "绑定 / 句柄 / 切换 / 查询 / 解绑 / 迁移",
       items: [
-        { key: "bind", label: "绑定 <句柄>", desc: "绑定星际争霸2游戏句柄", cmd: "绑定", input: "请输入游戏句柄(格式: 区域-S2-服务器-档案, 如 5-S2-1-1234567)" },
-        { key: "list", label: "句柄", desc: "查询已绑定的游戏句柄", cmd: "句柄" },
-        { key: "switch", label: "切换", desc: "切换正在使用的游戏句柄", cmd: "切换" },
-        { key: "check", label: "查询", desc: "查询某句柄是否已被绑定", cmd: "查询" },
-        { key: "unbind", label: "解绑", desc: "解除绑定某个游戏句柄", cmd: "解绑" },
-        { key: "migrate", label: "迁移 <QQ>", desc: "将指定QQ号绑定的句柄迁移到当前账号", cmd: "迁移", input: "请输入要迁移的QQ号" }
+        { key: "bind", icon: "绑", label: "绑定 <句柄>", desc: "绑定星际争霸2游戏句柄" },
+        { key: "list", icon: "句", label: "句柄", desc: "查询已绑定的游戏句柄" },
+        { key: "switch", icon: "切", label: "切换", desc: "切换正在使用的游戏句柄" },
+        { key: "check", icon: "查", label: "查询", desc: "查询某句柄是否已被绑定" },
+        { key: "unbind", icon: "解", label: "解绑", desc: "解除绑定某个游戏句柄" },
+        { key: "migrate", icon: "迁", label: "迁移 <QQ>", desc: "将指定QQ号绑定的句柄迁移到当前账号" }
       ]
     },
     {
       key: "query",
-      label: "📊 查询信息",
+      label: "查询信息",
+      emoji: "📊",
       desc: "地图检测 / 封禁记录 / 签到奖励",
       items: [
-        { key: "map", label: "地图检测", desc: "查询已配置地图的检测状态", cmd: "地图检测" },
-        { key: "ban", label: "封禁记录", desc: "查询句柄的封禁记录", cmd: "封禁记录" },
-        { key: "reward", label: "签到奖励", desc: "查看签到奖励规则说明", cmd: "签到奖励" }
+        { key: "map", icon: "图", label: "地图检测", desc: "查询已配置地图的检测状态" },
+        { key: "ban", icon: "封", label: "封禁记录", desc: "查询句柄的封禁记录" },
+        { key: "reward", icon: "奖", label: "签到奖励", desc: "查看签到奖励规则说明" }
       ]
     }
   ];
-  const buildPlainMenu = /* @__PURE__ */ __name((category) => {
-    if (category) {
-      return [`🐤 咕咕之战 · ${category.label}`, ...category.items.map((i) => `${i.label}：${i.desc}`)].join("\n");
-    }
-    return [
-      "🐤 咕咕之战菜单",
-      ...menuCategories.map((c) => `${c.label}
-  ${c.items.map((i) => i.label).join(" / ")}`),
-      "",
-      "提示: 当前平台不支持按钮菜单, 请直接输入对应指令使用。"
-    ].join("\n\n");
-  }, "buildPlainMenu");
-  const sendMenu = /* @__PURE__ */ __name(async (session, category) => {
-    if (session.platform !== "qq") {
-      await session.send(buildPlainMenu(category));
-      return;
-    }
-    let title;
-    let lines;
-    let rows;
-    if (category) {
-      title = `🐤 咕咕之战 · ${category.label}`;
-      lines = [
-        ...category.items.map((item, idx) => `${idx + 1}. **${item.label}**：${item.desc}`),
-        "",
-        "点击下方按钮即可使用对应功能, 点「⬅️ 返回」回到主菜单。"
-      ];
-      rows = [
-        category.items.map((item) => ({
-          id: `${MENU_PREFIX}run:${category.key}:${item.key}`,
-          label: item.label,
-          input: item.input,
-          primary: item.key === "sign"
-        })),
-        [{ id: `${MENU_PREFIX}back`, label: "⬅️ 返回" }]
-      ];
-    } else {
-      title = "🐤 咕咕之战菜单";
-      lines = [
-        ...menuCategories.map((cat, idx) => `${idx + 1}. ${cat.label}：${cat.desc}`),
-        "",
-        "点击下方分类按钮进入对应功能菜单。"
-      ];
-      rows = [
-        [
-          { id: `${MENU_PREFIX}cat:daily`, label: "📅 每日玩法", primary: true },
-          { id: `${MENU_PREFIX}cat:bag`, label: "🎒 物品背包" }
-        ],
-        [
-          { id: `${MENU_PREFIX}cat:lottery`, label: "🎲 抽奖兑换" },
-          { id: `${MENU_PREFIX}cat:activity`, label: "🎉 活动" }
-        ],
-        [
-          { id: `${MENU_PREFIX}cat:handle`, label: "🔗 句柄绑定" },
-          { id: `${MENU_PREFIX}cat:query`, label: "📊 查询信息" }
-        ]
-      ];
-    }
-    const elements = [
-      (0, import_koishi.h)("qq:markdown", `**${title}**
-
-${lines.join("\n")}`),
-      ...rows.map((row) => (0, import_koishi.h)("button-group", row.map((btn) => (0, import_koishi.h)("button", {
-        id: btn.id,
-        class: btn.primary ? "primary" : void 0,
-        type: btn.input ? "input" : void 0,
-        text: btn.input
-      }, btn.label))))
-    ];
-    try {
-      await session.send(elements);
-    } catch (e) {
-      ctx.logger("ggcevo").warn("咕咕之战菜单 Markdown 发送失败, 回退为纯文本: %o", e);
-      await session.send(buildPlainMenu(category));
-    }
-  }, "sendMenu");
-  const runMenuCommand = /* @__PURE__ */ __name(async (session, name2, args = []) => {
-    session.messageId = "";
-    await session.execute({ name: name2, args, options: {} });
-  }, "runMenuCommand");
-  ctx.command("咕咕之战").alias("菜单").usage("生成咕咕之战内容分类菜单(QQ 官方机器人支持按钮点击使用)").action(async (argv) => {
-    await sendMenu(argv.session, void 0);
-  });
-  ctx.on("interaction/button", async (session) => {
-    const button = session.event?.button;
-    if (!button || typeof button.id !== "string" || !button.id.startsWith(MENU_PREFIX)) return;
-    const parts = button.id.split(":");
+  const buildTextMenu = /* @__PURE__ */ __name(() => [
+    "🐤 咕咕之战菜单",
+    "",
+    ...menuCategories.map((cat) => `${cat.emoji} ${cat.label}（${cat.desc}）
+  ${cat.items.map((item) => item.label).join(" / ")}`),
+    "",
+    "提示: 直接输入上方指令名即可使用对应功能。"
+  ].join("\n"), "buildTextMenu");
+  const buildMenuHtml = /* @__PURE__ */ __name((title, subtitle) => {
+    const palette = ["#4a7dff", "#9b59b6", "#e67e22", "#27ae60", "#e74c3c", "#16a085", "#f39c12", "#8e44ad", "#2980b9", "#d35400", "#2ecc71", "#c0392b"];
+    const groupHtml = menuCategories.map((group) => {
+      const itemRows = group.items.map((item, i) => {
+        const color = palette[i % palette.length];
+        return `
+        <div class="item">
+          <div class="icon" style="background: ${color}">${item.icon}</div>
+          <div class="info">
+            <div class="name">${item.label}</div>
+            <div class="desc">${item.desc}</div>
+          </div>
+        </div>`;
+      }).join("");
+      return `
+      <div class="group">
+        <div class="group-title">${group.label}</div>
+        <div class="list">${itemRows}</div>
+      </div>`;
+    }).join("");
+    return `<!DOCTYPE html>
+<html lang="zh">
+<head>
+<meta charset="UTF-8">
+<style>
+  body { margin: 0; padding: 24px 28px; background:
+    repeating-linear-gradient(45deg, rgba(255,255,255,0.02) 0 1px, transparent 1px 2px),
+    linear-gradient(135deg, #1b2a4a 0%, #0f1a33 100%);
+    font-family: "Microsoft YaHei", "PingFang SC", sans-serif; color: #e8eefc; }
+  .header { text-align: center; padding-bottom: 18px; border-bottom: 2px solid rgba(120,160,255,0.35); }
+  .title { font-size: 32px; font-weight: bold; letter-spacing: 6px; color: #8fc0ff; text-shadow: 0 0 18px rgba(90,140,255,0.45); }
+  .subtitle { margin-top: 8px; font-size: 14px; color: #93a6c8; }
+  .group { margin-top: 22px; }
+  .group-title { font-size: 15px; font-weight: bold; color: #ffd98a; letter-spacing: 3px; margin-bottom: 10px; padding-left: 10px; border-left: 3px solid #ffd98a; }
+  .list { display: flex; flex-direction: column; gap: 12px; }
+  .item { display: flex; align-items: center; gap: 14px; background: rgba(255,255,255,0.07); border: 1px solid rgba(140,170,255,0.22); border-radius: 12px; padding: 12px 16px; }
+  .icon { width: 40px; height: 40px; border-radius: 10px; display: flex; align-items: center; justify-content: center; font-size: 19px; font-weight: bold; color: #fff; flex-shrink: 0; }
+  .info { flex: 1; }
+  .name { font-size: 20px; font-weight: bold; color: #ffffff; }
+  .desc { margin-top: 4px; font-size: 13px; color: #9db1d8; line-height: 1.5; }
+  .footer { margin-top: 24px; text-align: center; font-size: 12px; color: #6b7ea6; }
+</style>
+</head>
+<body>
+  <div class="header">
+    <div class="title">${title}</div>
+    <div class="subtitle">${subtitle}</div>
+  </div>
+  ${groupHtml}
+  <div class="footer">输入上方指令名即可使用对应功能</div>
+</body>
+</html>`;
+  }, "buildMenuHtml");
+  const menuCacheDir = import_node_path.default.resolve(ctx.baseDir, "data/ggcevo/menu");
+  const renderMenuImage = /* @__PURE__ */ __name(async (html) => {
+    const logger = ctx.logger("ggcevo");
+    const hash = (0, import_node_crypto.createHash)("sha256").update(html).digest("hex");
+    const cachePath = import_node_path.default.resolve(menuCacheDir, `${hash}.jpg`);
+    if (import_node_fs.default.existsSync(cachePath)) {
+      const cached = await (0, import_promises.readFile)(cachePath);
+      return import_koishi.h.image(`data:image/jpeg;base64,${cached.toString("base64")}`);
+    }
+    if (!ctx.puppeteer) {
+      logger.warn("[menu-render] 未启用 puppeteer 服务");
+      return "⚠️ 未启用 puppeteer 服务，无法渲染图片菜单。请安装并启用 `koishi-plugin-puppeteer` 或 `@shangxueink/puppeteer-without-canvas`。";
+    }
+    const page = await ctx.puppeteer.page();
     try {
-      if (parts[1] === "back") {
-        await sendMenu(session, void 0);
-      } else if (parts[1] === "cat") {
-        const category = menuCategories.find((c) => c.key === parts[2]);
-        if (category) await sendMenu(session, category);
-      } else if (parts[1] === "run") {
-        const category = menuCategories.find((c) => c.key === parts[2]);
-        const item = category?.items.find((i) => i.key === parts[3]);
-        if (!category || !item || !item.cmd) return;
-        if (item.input) {
-          const value = String(button.data ?? "").trim();
-          if (!value) {
-            await session.send(`请输入${item.label}后重试。`);
-            return;
-          }
-          await runMenuCommand(session, item.cmd, [value]);
-        } else {
-          await runMenuCommand(session, item.cmd);
-        }
+      await page.setViewport({ width: 1280, height: 100, deviceScaleFactor: 1 });
+      await page.setContent(html);
+      await page.waitForNetworkIdle();
+      const img = await page.screenshot({ type: "jpeg", quality: 85, fullPage: true, encoding: "binary" });
+      logger.info("[menu-render] 菜单图渲染完成, 体积 %s KB", (img.length / 1024).toFixed(1));
+      try {
+        await (0, import_promises.mkdir)(menuCacheDir, { recursive: true });
+        const files = await (0, import_promises.readdir)(menuCacheDir);
+        for (const file of files) await (0, import_promises.unlink)(import_node_path.default.resolve(menuCacheDir, file));
+        await (0, import_promises.writeFile)(cachePath, img);
+      } catch (e) {
+        logger.error("[menu-render] 写入菜单图缓存失败: %o", e);
       }
+      return import_koishi.h.image(`data:image/jpeg;base64,${img.toString("base64")}`);
     } catch (e) {
-      ctx.logger("ggcevo").warn("咕咕之战按钮回调处理失败: %o", e);
-      await session.send("⚠️ 操作失败, 请重试或直接输入指令使用。").catch(() => {
-      });
-    }
+      logger.warn("[menu-render] 渲染菜单图片失败: %o", e);
+      return "⚠️ 菜单图片渲染失败，请查看日志后重试。";
+    } finally {
+      await page.close();
+    }
+  }, "renderMenuImage");
+  ctx.command("咕咕之战", "查看咕咕之战内容分类菜单").alias("菜单").action(async ({ session }) => {
+    if (config.menuStyle === "image") {
+      const result = await renderMenuImage(buildMenuHtml("咕咕之战", "内容分类菜单 · 输入指令名即可使用"));
+      return typeof result === "string" ? result : (0, import_koishi.h)("quote", { id: session.messageId }, result);
+    }
+    return buildTextMenu();
   });
 }
 __name(apply, "apply");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-ggcevo",
   "description": "GGCEVO 综合插件：星际争霸2游戏句柄绑定 + 签到/抽奖/兑换/背包/活动系统等虚拟物品玩法",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
@@ -28,6 +28,16 @@
     }
   },
   "peerDependencies": {
-    "koishi": "^4.18.7"
+    "koishi": "^4.18.7",
+    "koishi-plugin-puppeteer": "^3.9.0",
+    "@shangxueink/puppeteer-without-canvas": "^3.0.7"
+  },
+  "peerDependenciesMeta": {
+    "koishi-plugin-puppeteer": {
+      "optional": true
+    },
+    "@shangxueink/puppeteer-without-canvas": {
+      "optional": true
+    }
   }
 }

package/readme.md

@@ -78,6 +78,12 @@ npm install koishi-plugin-ggcevo
 - 功能上线前已绑定的旧句柄无时间记录，首次检查时以当前时间作为绑定时间补齐。
 - 定时任务每天检查一次（启动后延迟 5 秒首次检查），删除超过阈值天数未使用且非当前使用的句柄。
 
+### 菜单设置
+
+| 配置项 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `menuStyle` | `'text' \| 'image'` | `'text'` | 咕咕之战菜单渲染方式。`text`=文字菜单（默认，无需额外服务）；`image`=图片菜单（需安装并启用 `koishi-plugin-puppeteer` 或 `@shangxueink/puppeteer-without-canvas` 其一，未启用时自动降级为文字菜单并提示） |
+
 ### 活动兑换
 
 | 配置项 | 类型 | 默认值 | 说明 |
@@ -102,7 +108,7 @@ npm install koishi-plugin-ggcevo
 
 | 指令 | 别名 | 权限 | 说明 |
 | --- | --- | --- | --- |
-| `咕咕之战` | 菜单 | — | 生成咕咕之战内容分类菜单（「每日玩法」「物品背包」「抽奖兑换」「活动」「句柄绑定」「查询信息」六类，仅收录普通用户可用指令）。QQ 官方机器人下使用 Markdown+按钮渲染，点击分类按钮进入子菜单、点击指令按钮直接执行（兑换/使用/绑定/迁移等需参数的指令支持输入框按钮）；其余平台自动回退为纯文本菜单 |
+| `咕咕之战` | 菜单 | — | 生成咕咕之战内容分类菜单（「每日玩法」「物品背包」「抽奖兑换」「活动」「句柄绑定」「查询信息」六类，仅收录普通用户可用指令）。根据配置项 `menuStyle` 选择渲染方式：`text`（默认）输出文字分类菜单，`image` 使用 puppeteer 渲染分类图片菜单（需启用 puppeteer 服务，未启用时自动降级为文字菜单） |
 | `签到` | — | — | 每日签到，获取奖励并发放签到券/补签券等。每月首次签到时，若签到者的游戏句柄匹配管理员福利文档记录，额外发放 50 咕咕币津贴（仅校验句柄） |
 | `挖矿` | — | — | 领取挂机挖矿收益（咕咕之战玩法）。每半小时收益 4 金币，单次存储上限 24 小时，领取后立即进入下一轮挖矿。累计挖矿总时长与累计收益金币数会被记录统计。受宵禁影响：17:00-24:00 禁止领取 |
 | `探索` | — | — | 选择星系进行 12 小时探索，结束后领取收益（咕咕之战玩法）。星系：天枢（成功率100%，成功80金币）、赤潮（成功率60%，成功120金币/失败60金币）、千帆（成功率80%，成功50金币/失败25金币，成功时独立概率获得补签券×1（10%）、咕咕币1-3枚（50%），失败无道具）。金币/道具发放到背包，按星系累计统计探索次数/成功次数/累计金币。受宵禁影响：17:00-24:00 禁止 |
@@ -173,6 +179,23 @@ npm install koishi-plugin-ggcevo
 
 ## 更新日志
 
+### v1.3.2
+
+图片菜单渲染对齐 preview-help 方案，新增磁盘缓存。
+
+- **新增图片菜单磁盘缓存**：`咕咕之战` 图片菜单按 HTML 内容 hash 缓存到 `data/ggcevo/menu/`，命中缓存直接读回图片（免去重复渲染、无需 puppeteer 也可返回缓存图），渲染成功后会清理旧缓存文件
+- **渲染参数对齐 preview-help**：viewport 由 900×DPR2 调整为 1280×DPR1，`setContent` 后改用 `waitForNetworkIdle()` 等待页面网络空闲
+
+### v1.3.1
+
+取消 Markdown 按钮菜单，改为可配置的文字/图片菜单。
+
+- **取消 Markdown 按钮**：移除 `咕咕之战`（别名 `菜单`）的 QQ 官方机器人 Markdown + 按钮渲染及按钮回调处理，改为输出分类菜单（「每日玩法」「物品背包」「抽奖兑换」「活动」「句柄绑定」「查询信息」六类）
+- **新增配置项 `menuStyle`**（默认 `text`）：选择菜单渲染方式
+  - `text`：文字分类菜单，无需任何额外服务（默认）
+  - `image`：图片菜单，使用 puppeteer 将 HTML 渲染为图片后以 base64 data URL 发送（与 preview-help 插件同方案）
+- **可选依赖 puppeteer 服务**：声明 `koishi-plugin-puppeteer`（^3.9.0）与 `@shangxueink/puppeteer-without-canvas`（^3.0.7）为可选 peer 依赖，任选其一安装启用即可渲染图片菜单；`image` 模式未启用 puppeteer 服务时自动降级为文字菜单并提示
+
 ### v1.3.0
 
 咕咕之战菜单改为 QQ 官方机器人 Markdown 按钮菜单（取代 v1.2.0 移除的图片渲染方案，不再依赖 puppeteer）。