koishi-plugin-ggcevo 1.0.6 → 1.0.8

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 {
@@ -562,9 +573,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;
@@ -2045,7 +2060,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 +2090,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 +2179,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,6 +2273,16 @@ ${message}
       return `❌ 同步失败: ${e?.message || e}`;
     }
   });
+  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/封禁记录").action(async (argv) => {
     if (!isDocsConfigured()) return "❌ 腾讯文档功能未启用或配置不完整。";
     const session = argv.session;

package/package.json

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

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兑换券/次 |
 | `背包` | — | — | 查看自己的物品背包 |
@@ -79,6 +81,7 @@ npm install koishi-plugin-ggcevo
 | `使用 <name>` | — | — | 使用指定物品（如赎罪券等） |
 | `封禁记录` | — | — | 查询当前绑定句柄在腾讯文档封禁记录表中的全部记录，每页显示 1 条，支持翻页（回复"下一页/上一页/页码/退出"） |
 | `同步封禁记录` | — | 3 | 立即从腾讯文档拉取全量数据并写入数据库（管理员指令） |
+| `同步管理员福利` | — | 3 | 立即从腾讯文档拉取管理员福利表（A列QQ号/B列句柄）全量数据并写入数据库（管理员指令） |
 
 ### 腾讯文档
 
@@ -123,9 +126,37 @@ 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.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
 
 修复封禁记录同步时长文本写入失败的问题。