koishi-plugin-ggcevo 1.0.6 → 1.0.9

package/lib/index.d.ts

@@ -12,6 +12,8 @@ export interface Config {
     tencentDocsOpenId: string;
     tencentDocsBanListFileId: string;
     tencentDocsBanListSheetId: string;
+    tencentDocsAdminWelfareFileId: string;
+    tencentDocsAdminWelfareSheetId: string;
 }
 export declare const Config: Schema<Config>;
 export declare const inject: {
@@ -42,6 +44,7 @@ declare module 'koishi' {
         ggcevo_activity_claim_log: ActivityClaimLog;
         ggcevo_docs_token: GgcEvoDocsToken;
         ggcevo_ban_record: GgcEvoBanRecord;
+        ggcevo_admin_welfare: GgcEvoAdminWelfare;
     }
 }
 export interface GgcEvoPlayer {
@@ -86,6 +89,16 @@ export interface GgcEvoBanRecord {
     /** 最近一次同步时间 */
     update_time: Date;
 }
+export interface GgcEvoAdminWelfare {
+    /** 自增ID, 对应文档行号(行号 = id + 1, 跳过表头) */
+    id: number;
+    /** A列: QQ号 */
+    qq: string;
+    /** B列: 游戏句柄 */
+    handle: string;
+    /** 最近一次同步时间 */
+    update_time: Date;
+}
 export interface Backpack {
     id: number;
     user_id: string;

package/lib/index.js

@@ -42,7 +42,9 @@ var Config = import_koishi.Schema.object({
   tencentDocsAccessToken: import_koishi.Schema.string().description("腾讯文档 Access Token(用户级模式必填, 通过扫码授权获取)").role("secret").default(""),
   tencentDocsOpenId: import_koishi.Schema.string().description("腾讯文档 Open ID(用户级模式必填, 与 Access Token 同时获取)").default(""),
   tencentDocsBanListFileId: import_koishi.Schema.string().description("封禁记录在线表格的文件ID(短ID或完整ID)").default("DTVdYZVBDdFhEUkp6"),
-  tencentDocsBanListSheetId: import_koishi.Schema.string().description("封禁记录工作表ID(表格URL中tab参数)").default("BB08J2")
+  tencentDocsBanListSheetId: import_koishi.Schema.string().description("封禁记录工作表ID(表格URL中tab参数)").default("BB08J2"),
+  tencentDocsAdminWelfareFileId: import_koishi.Schema.string().description("管理员福利在线表格的文件ID(短ID或完整ID, A列QQ号/B列句柄)").default("DVGRhUUpXUVRJVVJs"),
+  tencentDocsAdminWelfareSheetId: import_koishi.Schema.string().description("管理员福利工作表ID(表格URL中tab参数)").default("BB08J2")
 });
 var inject = {
   required: ["database"]
@@ -213,6 +215,15 @@ function apply(ctx, config) {
     primary: "id",
     autoInc: true
   });
+  ctx.model.extend("ggcevo_admin_welfare", {
+    id: "unsigned",
+    qq: "string",
+    handle: "string",
+    update_time: "timestamp"
+  }, {
+    primary: "id",
+    autoInc: true
+  });
   if (config.mapMonitorEnabled && config.mapMonitorGroups.length > 0 && config.mapMonitorMapIds.length > 0) {
     ctx.setInterval(async () => {
       try {
@@ -523,7 +534,8 @@ ${message}
     const session = argv.session;
     const handle = await getHandle(session);
     if (!handle) {
-      return "🔒 需要先绑定游戏句柄。\n💡 使用 `绑定句柄` 命令进行绑定。";
+      return `<quote id="${session.messageId}"/>🔒 需要先绑定游戏句柄。
+💡 使用 \`绑定句柄\` 命令进行绑定。`;
     }
     const now = /* @__PURE__ */ new Date();
     const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
@@ -533,7 +545,7 @@ ${message}
       signin_date: { $gte: today }
     });
     if (existingLog) {
-      return "📅 今日已签到，明天再来吧！";
+      return `<quote id="${session.messageId}"/>📅 今日已签到，明天再来吧！`;
     }
     const goldReward = Math.floor(Math.random() * 11) + 10;
     let gugubReward = 3;
@@ -562,9 +574,13 @@ ${message}
       }
       lastAllowanceMonth = summary.last_allowance_month || 0;
     }
-    const memberInfo = session.event?.member?.roles;
-    const isAdmin = !memberInfo?.some((role) => role.name === "member" || role.id === "member");
-    if (isAdmin && lastAllowanceMonth !== currentMonth) {
+    const qq = String(session.userId || "");
+    const normalizedHandle = normalizeHandle(handle);
+    const welfareRecords = await ctx.database.get("ggcevo_admin_welfare", {});
+    const isWelfareMember = welfareRecords.some(
+      (r) => String(r.qq || "").trim() === qq.trim() && r.handle && normalizeHandle(r.handle) === normalizedHandle
+    );
+    if (isWelfareMember && lastAllowanceMonth !== currentMonth) {
       monthlyAllowance = 50;
       gugubReward += monthlyAllowance;
       lastAllowanceMonth = currentMonth;
@@ -628,7 +644,7 @@ ${message}
       message += `
 💰 每月津贴：+${monthlyAllowance} 咕咕币`;
     }
-    return message;
+    return `<quote id="${session.messageId}"/>${message}`;
   });
   ctx.command("ggcevo/兑换 <name:string>").action(async (argv, name2) => {
     const session = argv.session;
@@ -1203,11 +1219,12 @@ ${message}
     const session = argv.session;
     const handle = await getHandle(session);
     if (!handle) {
-      return "🔒 需要先绑定游戏句柄。\n💡 使用 `绑定句柄` 命令进行绑定。";
+      return `<quote id="${session.messageId}"/>🔒 需要先绑定游戏句柄。
+💡 使用 \`绑定句柄\` 命令进行绑定。`;
     }
     const backpackItems = await ctx.database.get("ggcevo_backpack", { user_id: handle });
     if (backpackItems.length === 0) {
-      return "🎒 背包是空的，快去签到或抽奖获得物品吧！";
+      return `<quote id="${session.messageId}"/>🎒 背包是空的，快去签到或抽奖获得物品吧！`;
     }
     let message = `🎒 ${session.username}的背包物品：
 `;
@@ -1217,13 +1234,14 @@ ${message}
       message += `${itemName} x${item.count}
 `;
     }
-    return message;
+    return `<quote id="${session.messageId}"/>${message}`;
   });
   ctx.command("ggcevo/个人信息").action(async (argv) => {
     const session = argv.session;
     const handle = await getHandle(session);
     if (!handle) {
-      return "🔒 需要先绑定游戏句柄。\n💡 使用 `绑定句柄` 命令进行绑定。";
+      return `<quote id="${session.messageId}"/>🔒 需要先绑定游戏句柄。
+💡 使用 \`绑定句柄\` 命令进行绑定。`;
     }
     const username = session.username || "未知用户";
     let message = `👤 个人信息
@@ -1320,7 +1338,7 @@ ${message}
 `;
       }
     }
-    return message;
+    return `<quote id="${session.messageId}"/>${message}`;
   });
   ctx.command("ggcevo/给予 <targetId> <itemId> <count:number>", { authority: 3 }).action(async (argv, targetId, itemId, count) => {
     const session = argv.session;
@@ -1588,13 +1606,9 @@ ${message}
     }
     message += `─────────────
 `;
-    message += `⚠️ 限定物品不可兑换
-`;
-    message += `⚠️ 兑换功能仅限工作日使用（周一至周五）
+    message += `⚠️ 兑换功能仅限工作日使用（周一至周五兑换，周六/周日实装进咕咕虫）
 `;
     message += `⚠️ 兑换完成后请找活动管理员登记
-`;
-    message += `⚠️ 兑换实装进咕咕虫将在休息日完成（周六/周日）
 `;
     return message;
   });
@@ -1676,39 +1690,40 @@ ${message}
     const session = argv.session;
     const handle = await getHandle(session);
     if (!handle) {
-      return "🔒 需要先绑定游戏句柄。\n💡 使用 `绑定句柄` 命令进行绑定。";
+      return `<quote id="${session.messageId}"/>🔒 需要先绑定游戏句柄。
+💡 使用 \`绑定句柄\` 命令进行绑定。`;
     }
     if (activityId === void 0 || activityId === null) {
-      return `❌ 请输入活动ID！
+      return `<quote id="${session.messageId}"/>❌ 请输入活动ID！
 使用 活动列表 查询可领取的活动`;
     }
     const [activity] = await ctx.database.get("ggcevo_activity", { id: activityId });
     if (!activity) {
-      return `❌ 不存在ID为 ${activityId} 的活动！`;
+      return `<quote id="${session.messageId}"/>❌ 不存在ID为 ${activityId} 的活动！`;
     }
     const now = /* @__PURE__ */ new Date();
     const startTime = new Date(activity.start_time);
     const endTime = new Date(activity.end_time);
     if (now < startTime) {
-      return `⏰ 活动尚未开始，开始时间：${startTime.toLocaleString("zh-CN")}`;
+      return `<quote id="${session.messageId}"/>⏰ 活动尚未开始，开始时间：${startTime.toLocaleString("zh-CN")}`;
     }
     if (now > endTime) {
-      return `⏱️ 活动已结束，结束时间：${endTime.toLocaleString("zh-CN")}`;
+      return `<quote id="${session.messageId}"/>⏱️ 活动已结束，结束时间：${endTime.toLocaleString("zh-CN")}`;
     }
     if (activity.required_group && activity.required_group !== "") {
       const currentChannelId = session.channelId || session.event?.channel?.id;
       if (!currentChannelId) {
-        return `❌ 无法获取当前群聊信息！`;
+        return `<quote id="${session.messageId}"/>❌ 无法获取当前群聊信息！`;
       }
       if (currentChannelId !== activity.required_group) {
-        return `❌ 该活动仅限在指定群聊内领取！
+        return `<quote id="${session.messageId}"/>❌ 该活动仅限在指定群聊内领取！
 请前往群聊ID: ${activity.required_group} 领取`;
       }
     }
     if (activity.max_claims > 0) {
       const totalClaims = await ctx.database.get("ggcevo_activity_claim_log", { activity_id: activityId });
       if (totalClaims.length >= activity.max_claims) {
-        return `❌ 该活动领取次数已用尽！`;
+        return `<quote id="${session.messageId}"/>❌ 该活动领取次数已用尽！`;
       }
     }
     const [existingClaim] = await ctx.database.get("ggcevo_activity_claim_log", {
@@ -1716,7 +1731,7 @@ ${message}
       user_id: handle
     });
     if (existingClaim) {
-      return `❌ 您已经领取过该活动了！`;
+      return `<quote id="${session.messageId}"/>❌ 您已经领取过该活动了！`;
     }
     await ctx.database.create("ggcevo_activity_claim_log", {
       activity_id: activityId,
@@ -1742,22 +1757,32 @@ ${message}
       }
     }, "updateBackpackItem");
     await updateBackpackItem(activity.reward_item, activity.reward_amount);
-    return `🎉 领取成功！
+    return `<quote id="${session.messageId}"/>🎉 领取成功！
 ─────────────
 📛 活动：${activity.name}
 🎁 获得：${rewardItemName} x${activity.reward_amount}`;
   });
-  ctx.command("ggcevo/活动列表").action(async () => {
+  ctx.command("ggcevo/活动列表 [showAll]").action(async (argv, showAll) => {
     const activities = await ctx.database.get("ggcevo_activity", {});
     if (activities.length === 0) {
       return `📋 暂无活动`;
     }
     const now = /* @__PURE__ */ new Date();
+    const showExpired = !!showAll;
+    const visibleActivities = activities.filter((activity) => {
+      const endTime = new Date(activity.end_time);
+      if (now > endTime && !showExpired) return false;
+      return true;
+    });
+    if (visibleActivities.length === 0) {
+      return `📋 暂无进行中或未开始的活动
+💡 输入 "活动列表 全部" 可查看包含已过期在内的全部活动`;
+    }
     let message = `📋 活动列表
 `;
     message += `─────────────
 `;
-    for (const activity of activities) {
+    for (const activity of visibleActivities) {
       const startTime = new Date(activity.start_time);
       const endTime = new Date(activity.end_time);
       const rewardItemName = ItemConfig[activity.reward_item] || "未知物品";
@@ -2045,7 +2070,7 @@ ${message}
     if (method === "PUT") return ctx.http.put(url, form, { headers });
     return ctx.http.post(url, form, { headers });
   }, "docsApiRequest");
-  ctx.command("腾讯文档/状态", "查看腾讯文档授权状态").action(async () => {
+  ctx.command("腾讯文档/授权状态", "查看腾讯文档授权状态").action(async () => {
     if (!isDocsConfigured()) return "❌ 腾讯文档功能未启用或配置不完整。";
     const token = await getValidDocsToken();
     if (!token) {
@@ -2075,6 +2100,13 @@ ${message}
     }
     if (v.link) return v.link.text || v.link.url || "";
     if (v.location) return v.location.name || "";
+    if (v.select) {
+      const sel = v.select;
+      const ids = Array.isArray(sel.value) ? sel.value.map(String) : [];
+      const opts = Array.isArray(sel.options) ? sel.options : [];
+      const texts = ids.map((id) => opts.find((o) => String(o.id) === String(id))?.text || "");
+      return texts.filter(Boolean).join("、");
+    }
     return "";
   }, "extractCellText");
   const normalizeHandle = /* @__PURE__ */ __name((raw) => {
@@ -2157,6 +2189,78 @@ ${message}
     );
     return records.length;
   }, "syncBanRecords");
+  const fetchAdminWelfareFromDocs = /* @__PURE__ */ __name(async () => {
+    const fileId = config.tencentDocsAdminWelfareFileId;
+    const sheetId = config.tencentDocsAdminWelfareSheetId;
+    const meta = await docsApiRequest("GET", `/spreadsheet/v3/files/${fileId}`, { concise: 1 });
+    const metaOk = meta?.code === 0 || meta?.ret === 0;
+    if (metaOk === false && meta?.code != null) {
+      throw new Error(`查询工作表信息失败: ${meta.message || "未知错误"}(code=${meta.code})`);
+    }
+    const props = meta?.data?.properties || meta?.properties || [];
+    const sheetInfo = props.find((s) => s.sheetId === sheetId);
+    const rowTotal = Number(sheetInfo?.rowTotal) || 0;
+    if (rowTotal <= 1) return [];
+    const allRows = [];
+    const batchSize = 1e3;
+    for (let start = 2; start <= rowTotal; start += batchSize) {
+      const end = Math.min(start + batchSize - 1, rowTotal);
+      const resp = await docsApiRequest("GET", `/spreadsheet/v3/files/${fileId}/${sheetId}/A${start}:B${end}`);
+      const respOk = resp?.code === 0 || resp?.ret === 0;
+      if (respOk === false && resp?.code != null) {
+        throw new Error(`查询范围 A${start}:B${end} 失败: ${resp.message || "未知错误"}(code=${resp.code})`);
+      }
+      const rows = resp?.data?.gridData?.rows || resp?.gridData?.rows || [];
+      for (const row of rows) {
+        const cells = row.values || [];
+        allRows.push([
+          extractCellText(cells[0]),
+          // A: QQ号
+          extractCellText(cells[1])
+          // B: 游戏句柄
+        ]);
+      }
+    }
+    return allRows;
+  }, "fetchAdminWelfareFromDocs");
+  const syncAdminWelfare = /* @__PURE__ */ __name(async () => {
+    const rows = await fetchAdminWelfareFromDocs();
+    const now = /* @__PURE__ */ new Date();
+    const records = rows.map((r, i) => ({
+      id: i + 1,
+      // 自增 id, 对应文档行号 (id=1 → 文档第2行)
+      qq: r[0] || "",
+      handle: r[1] || "",
+      update_time: now
+    }));
+    const oldRecords = await ctx.database.get("ggcevo_admin_welfare", {}, { fields: ["id"] });
+    const oldCount = oldRecords.length;
+    await ctx.database.remove("ggcevo_admin_welfare", {});
+    if (records.length > 0) {
+      await ctx.database.upsert("ggcevo_admin_welfare", records);
+    }
+    const diff = records.length - oldCount;
+    ctx.logger("ggcevo").info(
+      "管理员福利全量同步完成: 旧 %d 条 → 新 %d 条 (%s%d)",
+      oldCount,
+      records.length,
+      diff >= 0 ? "+" : "",
+      diff
+    );
+    return records.length;
+  }, "syncAdminWelfare");
+  if (isDocsConfigured() && config.tencentDocsAdminWelfareFileId && config.tencentDocsAdminWelfareSheetId) {
+    const syncTask = /* @__PURE__ */ __name(async () => {
+      try {
+        const count = await syncAdminWelfare();
+        ctx.logger("ggcevo").info("管理员福利记录同步完成, 共 %d 条", count);
+      } catch (e) {
+        ctx.logger("ggcevo").warn("管理员福利记录定时同步失败: %o", e);
+      }
+    }, "syncTask");
+    ctx.setTimeout(syncTask, 5e3);
+    ctx.setInterval(syncTask, 60 * 60 * 1e3);
+  }
   if (isDocsConfigured() && config.tencentDocsBanListFileId && config.tencentDocsBanListSheetId) {
     const syncTask = /* @__PURE__ */ __name(async () => {
       try {
@@ -2179,31 +2283,60 @@ ${message}
       return `❌ 同步失败: ${e?.message || e}`;
     }
   });
-  ctx.command("ggcevo/封禁记录").action(async (argv) => {
+  ctx.command("ggcevo/同步管理员福利", { authority: 3 }).action(async () => {
+    if (!isDocsConfigured()) return "❌ 腾讯文档功能未启用或配置不完整。";
+    try {
+      const count = await syncAdminWelfare();
+      return `✅ 管理员福利同步完成, 共 ${count} 条。`;
+    } catch (e) {
+      ctx.logger("ggcevo").warn("手动同步管理员福利失败: %o", e);
+      return `❌ 同步失败: ${e?.message || e}`;
+    }
+  });
+  ctx.command("ggcevo/封禁记录 [user]").usage("不带参数查询自己的封禁记录, 携带 @用户 可查询对方句柄的封禁记录").example("封禁记录, 查询自己的封禁记录\n    封禁记录 @用户, 查询对方句柄的封禁记录").action(async (argv, user) => {
     if (!isDocsConfigured()) return "❌ 腾讯文档功能未启用或配置不完整。";
     const session = argv.session;
-    const handle = await getHandle(session);
-    if (!handle) {
-      return "🔒 需要先绑定游戏句柄。\n💡 使用 `绑定句柄` 命令进行绑定。";
+    let targetHandle;
+    let isOther = false;
+    if (!user) {
+      targetHandle = await getHandle(session);
+    } else {
+      const parsedUser = import_koishi.h.parse(user)[0];
+      if (!parsedUser || parsedUser.type !== "at" || !parsedUser.attrs.id) {
+        return `❌ 参数错误, 请输入"封禁记录 @用户"查询对方的封禁记录。`;
+      }
+      const targetUserId = parsedUser.attrs.id;
+      const [profile] = await ctx.database.get("sc2arcade_player", { userId: targetUserId, isActive: true });
+      if (!profile) {
+        return `❌ 对方暂未绑定游戏句柄。`;
+      }
+      targetHandle = `${profile.regionId}-S2-${profile.realmId}-${profile.profileId}`;
+      isOther = true;
+    }
+    if (!targetHandle) {
+      return `🔒 需要先绑定游戏句柄。
+💡 使用 \`绑定句柄\` 命令进行绑定。`;
     }
+    const handle = targetHandle;
     const [lastSync] = await ctx.database.get("ggcevo_ban_record", {}, { limit: 1 });
     if (!lastSync) {
-      return "⚠️ 封禁记录尚未同步, 请稍后再试或联系管理员。";
+      return `⚠️ 封禁记录尚未同步, 请稍后再试或联系管理员。`;
     }
     const syncTime = lastSync.update_time;
     const allRecords = await ctx.database.get("ggcevo_ban_record", {}, { sort: { id: "asc" } });
     const target = normalizeHandle(handle);
     const records = allRecords.filter((r) => r.handle && normalizeHandle(r.handle) === target);
+    const ownerLabel = isOther ? "对方句柄" : "句柄";
     if (records.length === 0) {
       return [
-        `✅ 句柄 ${handle} 暂无封禁记录。`,
+        `✅ ${ownerLabel} ${handle} 暂无封禁记录。`,
         `📊 数据最近同步: ${toBeijingTime(syncTime.toISOString())}`
       ].join("\n");
     }
     const formatRecord = /* @__PURE__ */ __name((idx) => {
       const r = records[idx];
       return [
-        `📋 封禁记录 (${idx + 1}/${records.length})`,
+        `📋 ${ownerLabel}封禁记录 (${idx + 1}/${records.length})`,
         `文档行号: ${r.id + 1} 行`,
         // id 对应文档行号 (跳过表头)
         `句柄: ${r.handle}`,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-ggcevo",
   "description": "GGCEVO 综合插件：星际争霸2游戏句柄绑定 + 签到/抽奖/兑换/背包/活动系统等虚拟物品玩法",
-  "version": "1.0.6",
+  "version": "1.0.9",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
@@ -30,4 +30,4 @@
   "peerDependencies": {
     "koishi": "^4.18.7"
   }
-}
+}

package/readme.md

@@ -41,6 +41,8 @@ npm install koishi-plugin-ggcevo
 | `tencentDocsOpenId` | `string` | `''` | Open ID（**用户级模式必填**，与 Access Token 同时获取） |
 | `tencentDocsBanListFileId` | `string` | `DTVdYZVBDdFhEUkp6` | 封禁记录在线表格文件ID（短ID或完整ID） |
 | `tencentDocsBanListSheetId` | `string` | `BB08J2` | 封禁记录工作表ID（表格URL中 `tab` 参数） |
+| `tencentDocsAdminWelfareFileId` | `string` | `DVGRhUUpXUVRJVVJs` | 管理员福利在线表格文件ID（短ID或完整ID，A列QQ号/B列句柄） |
+| `tencentDocsAdminWelfareSheetId` | `string` | `BB08J2` | 管理员福利工作表ID（表格URL中 `tab` 参数） |
 
 **授权模式说明：**
 - **用户级模式**（推荐用于无 `Client Secret` 的场景）：填写 `tencentDocsClientId` + `tencentDocsAccessToken` + `tencentDocsOpenId`，三者均通过腾讯文档开放平台扫码授权流程获取。Token 过期后需重新获取并在控制台更新。
@@ -63,7 +65,7 @@ npm install koishi-plugin-ggcevo
 
 | 指令 | 别名 | 权限 | 说明 |
 | --- | --- | --- | --- |
-| `签到` | — | — | 每日签到，获取奖励并发放签到券/补签券等 |
+| `签到` | — | — | 每日签到，获取奖励并发放签到券/补签券等。每月首次签到时，若签到者QQ号与句柄同时匹配管理员福利文档记录，额外发放 50 咕咕币津贴 |
 | `兑换 <name>` | — | — | 使用兑换券兑换指定物品。消耗兑换券数量随物品品质而定（T3皮肤=3、T2=4、T1=5、T3宠物=3、T2=4、T1=5、T0宠物=6、入场特效=5、角色冠名权=10、赎罪券=2） |
 | `抽奖` | — | — | 抽奖。选项：`-p <poolId>` 奖池ID，`-c <count>` 抽奖次数。各池消耗：金币池=100金币/次、普通池=1咕咕币/次、皮肤池/宠物池=3兑换券/次 |
 | `背包` | — | — | 查看自己的物品背包 |
@@ -71,14 +73,15 @@ npm install koishi-plugin-ggcevo
 | `给予 <targetId> <itemId> <count>` | — | 3 | 给予指定用户物品（管理指令） |
 | `抽奖概率` | — | — | 查看各奖池的抽奖概率与保底说明 |
 | `签到奖励` | — | — | 查看签到奖励规则说明 |
-| `兑换列表` | 兑换表 | — | 查看可兑换物品列表（含皮肤、宠物、入场特效、角色冠名权、赎罪券及各自兑换券消耗；限定物品不可兑换） |
+| `兑换列表` | 兑换表 | — | 查看可兑换物品列表（含皮肤、宠物、入场特效、角色冠名权、赎罪券及各自兑换券消耗） |
 | `创建活动` | — | 3 | 创建活动。选项：`-n 名称 -d 描述 -r 奖励物品ID -a 数量 -s 开始时间 -e 结束时间 -m 领取上限 -g 限制群聊ID` |
 | `领取活动 [activityId]` | — | — | 领取指定（或最新）活动奖励 |
-| `活动列表` | — | — | 查看当前所有活动 |
+| `活动列表 [showAll]` | — | — | 查看活动列表。默认只显示进行中与未开始的活动，携带参数（如"全部"）显示含已过期在内的全部活动 |
 | `补签` | — | — | 使用补签券补签漏签的日期 |
 | `使用 <name>` | — | — | 使用指定物品（如赎罪券等） |
-| `封禁记录` | — | — | 查询当前绑定句柄在腾讯文档封禁记录表中的全部记录，每页显示 1 条，支持翻页（回复"下一页/上一页/页码/退出"） |
+| `封禁记录 [user]` | — | — | 查询封禁记录。不带参数查询自己，携带 @用户 查询对方句柄的封禁记录。每页显示 1 条，支持翻页（回复"下一页/上一页/页码/退出"） |
 | `同步封禁记录` | — | 3 | 立即从腾讯文档拉取全量数据并写入数据库（管理员指令） |
+| `同步管理员福利` | — | 3 | 立即从腾讯文档拉取管理员福利表（A列QQ号/B列句柄）全量数据并写入数据库（管理员指令） |
 
 ### 腾讯文档
 
@@ -123,9 +126,46 @@ npm install koishi-plugin-ggcevo
 - `ggcevo_activity_claim_log` — 活动领取记录（主键 `activity_id` + `user_id`）
 - `ggcevo_docs_token` — 腾讯文档令牌缓存（应用级模式使用，主键 `user_id`，应用级账号固定为 `app_account`）
 - `ggcevo_ban_record` — 封禁记录（主键 `id` 自增，对应文档行号 `id+1`，每小时全量同步）
+- `ggcevo_admin_welfare` — 管理员福利（主键 `id` 自增，对应文档行号 `id+1`，每小时全量同步；A列QQ号/B列句柄）
 
 ## 更新日志
 
+### v1.0.9
+
+优化指令交互体验与活动列表过滤。
+
+- **活动列表**：新增可选参数 `[showAll]`，默认（不带参数）只显示进行中与未开始的活动，隐藏已过期活动；输入 `活动列表 全部` 可查看含已过期在内的全部活动
+- **封禁记录**：新增可选参数 `[user]`，支持 `@用户` 查询对方句柄的封禁记录；无参数时查询自己当前使用中的句柄
+- **引用消息**：为 `签到`、`背包`、`个人信息`、`领取活动` 指令的所有返回消息添加引用消息效果
+- **兑换列表**：删除"限定物品不可兑换"提示，合并兑换开放时间与实装时间为一条提示
+
+### v1.0.8
+
+修复腾讯文档单选项下拉框单元格读取为空的问题。
+
+- **修复**：`extractCellText` 新增 `select` 数据类型处理。腾讯文档 V3 API 中，单选/多选下拉框单元格的值不在 `cellValue.text`，而在 `cellValue.select`，其中 `select.value` 存储的是已选项 ID（非文本），需在 `select.options` 中按 `id` 反查才能得到可读文本
+- 影响字段：封禁记录表 C 列「封禁等级」（单选下拉框，选项 A/B/C/D/仅记录）。修复前同步入库为空字符串，修复后可正确读取选项文本
+- 多选下拉框同样兼容，多个已选项以 `、` 连接
+
+### v1.0.7
+
+新增**管理员福利**功能，签到每月津贴改为基于管理员福利文档数据库匹配。
+
+**新增功能：**
+- **管理员福利同步**：每小时自动从腾讯文档在线表格全量拉取管理员福利数据写入数据库（启动后延迟 5 秒首次同步），采用全量替换策略保证 `id` 与文档行号严格对应
+- **手动同步**：`同步管理员福利` 指令（管理员权限 3）立即触发同步
+- **签到每月津贴改写**：原通过 QQ 群管理员身份判断发放 50 咕咕币津贴，现改为从管理员福利数据库读取——签到者 **QQ号与游戏句柄必须同时匹配** 文档记录，且每月首次签到才发放 50 咕咕币津贴
+
+**新增配置项：**
+- `tencentDocsAdminWelfareFileId`（默认 `DVGRhUUpXUVRJVVJs`）
+- `tencentDocsAdminWelfareSheetId`（默认 `BB08J2`）
+
+**新增数据库表：**
+- `ggcevo_admin_welfare` — 管理员福利（主键自增 `id`，对应文档行号 `id+1`；字段：`qq`、`handle`、`update_time`）
+
+**表格结构要求：**
+- A列：QQ号 / B列：游戏句柄
+
 ### v1.0.6
 
 修复封禁记录同步时长文本写入失败的问题。