koishi-plugin-ggcevo 1.0.8 → 1.0.10

package/lib/index.d.ts

@@ -5,6 +5,7 @@ export interface Config {
     mapMonitorGroups: string[];
     mapMonitorMapIds: number[];
     mapMonitorApiUrl: string;
+    mapMonitorRecommendMapName: string;
     tencentDocsEnabled: boolean;
     tencentDocsClientId: string;
     tencentDocsClientSecret: string;

package/lib/index.js

@@ -36,15 +36,16 @@ var Config = import_koishi.Schema.object({
   mapMonitorGroups: import_koishi.Schema.array(import_koishi.Schema.string()).description("地图检测广播的群组ID列表").default([]),
   mapMonitorMapIds: import_koishi.Schema.array(import_koishi.Schema.number()).description("需要检测的地图ID列表").default([]),
   mapMonitorApiUrl: import_koishi.Schema.string().description("地图检测API地址").default("https://server.dreamprotocol.info:13085/mapmonitor/maps"),
+  mapMonitorRecommendMapName: import_koishi.Schema.string().description("当所有配置地图均离线时, 推荐玩家游玩的地图名称").default(""),
   tencentDocsEnabled: import_koishi.Schema.boolean().description("是否启用腾讯文档功能").default(false),
   tencentDocsClientId: import_koishi.Schema.string().description("腾讯文档开放平台应用 Client ID(应用ID)").default(""),
   tencentDocsClientSecret: import_koishi.Schema.string().description("腾讯文档应用 Client Secret(应用级账号模式需要, 用户级模式留空)").role("secret").default(""),
   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"),
-  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")
+  tencentDocsBanListFileId: import_koishi.Schema.string().description("封禁记录在线表格的文件ID(短ID或完整ID)").default(""),
+  tencentDocsBanListSheetId: import_koishi.Schema.string().description("封禁记录工作表ID(表格URL中tab参数)").default(""),
+  tencentDocsAdminWelfareFileId: import_koishi.Schema.string().description("管理员福利在线表格的文件ID(短ID或完整ID, A列QQ号/B列句柄)").default(""),
+  tencentDocsAdminWelfareSheetId: import_koishi.Schema.string().description("管理员福利工作表ID(表格URL中tab参数)").default("")
 });
 var inject = {
   required: ["database"]
@@ -524,6 +525,11 @@ ${message}
         }
         return lines.join("\n");
       });
+      const allOffline = targetMaps.length > 0 && targetMaps.every((m) => !m.isOnline);
+      if (allOffline && config.mapMonitorRecommendMapName) {
+        messages.push(`━━━━━━━━━━━━━━━━
+💡 当前所有地图均处于离线状态，推荐游玩「${config.mapMonitorRecommendMapName}」`);
+      }
       return `<quote id="${argv.session.messageId}"/>${messages.join("\n")}`;
     } catch (error) {
       console.error("查询地图检测信息失败:", error);
@@ -534,7 +540,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());
@@ -544,7 +551,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;
@@ -643,7 +650,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;
@@ -1218,11 +1225,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}的背包物品：
 `;
@@ -1232,13 +1240,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 = `👤 个人信息
@@ -1335,7 +1344,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;
@@ -1603,13 +1612,9 @@ ${message}
     }
     message += `─────────────
 `;
-    message += `⚠️ 限定物品不可兑换
-`;
-    message += `⚠️ 兑换功能仅限工作日使用（周一至周五）
+    message += `⚠️ 兑换功能仅限工作日使用（周一至周五兑换，周六/周日实装进咕咕虫）
 `;
     message += `⚠️ 兑换完成后请找活动管理员登记
-`;
-    message += `⚠️ 兑换实装进咕咕虫将在休息日完成（周六/周日）
 `;
     return message;
   });
@@ -1691,39 +1696,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", {
@@ -1731,7 +1737,7 @@ ${message}
       user_id: handle
     });
     if (existingClaim) {
-      return `❌ 您已经领取过该活动了！`;
+      return `<quote id="${session.messageId}"/>❌ 您已经领取过该活动了！`;
     }
     await ctx.database.create("ggcevo_activity_claim_log", {
       activity_id: activityId,
@@ -1757,22 +1763,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] || "未知物品";
@@ -2283,31 +2299,50 @@ ${message}
       return `❌ 同步失败: ${e?.message || e}`;
     }
   });
-  ctx.command("ggcevo/封禁记录").action(async (argv) => {
+  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.8",
+  "version": "1.0.10",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
@@ -30,4 +30,4 @@
   "peerDependencies": {
     "koishi": "^4.18.7"
   }
-}
+}

package/readme.md

@@ -27,6 +27,7 @@ npm install koishi-plugin-ggcevo
 | `mapMonitorGroups` | `string[]` | `[]` | 地图检测广播的群组 ID 列表 |
 | `mapMonitorMapIds` | `number[]` | `[]` | 需要检测的地图 ID 列表 |
 | `mapMonitorApiUrl` | `string` | `https://server.dreamprotocol.info:13085/mapmonitor/maps` | 地图检测 API 地址 |
+| `mapMonitorRecommendMapName` | `string` | `''` | 当所有配置地图均离线时，推荐玩家游玩的地图名称 |
 
 ### 腾讯文档（封禁记录查询）
 
@@ -39,10 +40,10 @@ npm install koishi-plugin-ggcevo
 | `tencentDocsClientSecret` | `string` | `''` | 应用 Client Secret（**应用级模式必填**，用户级模式留空） |
 | `tencentDocsAccessToken` | `string` | `''` | Access Token（**用户级模式必填**，通过扫码授权获取） |
 | `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` 参数） |
+| `tencentDocsBanListFileId` | `string` | `''` | 封禁记录在线表格文件ID（短ID或完整ID） |
+| `tencentDocsBanListSheetId` | `string` | `''` | 封禁记录工作表ID（表格URL中 `tab` 参数） |
+| `tencentDocsAdminWelfareFileId` | `string` | `''` | 管理员福利在线表格文件ID（短ID或完整ID，A列QQ号/B列句柄） |
+| `tencentDocsAdminWelfareSheetId` | `string` | `''` | 管理员福利工作表ID（表格URL中 `tab` 参数） |
 
 **授权模式说明：**
 - **用户级模式**（推荐用于无 `Client Secret` 的场景）：填写 `tencentDocsClientId` + `tencentDocsAccessToken` + `tencentDocsOpenId`，三者均通过腾讯文档开放平台扫码授权流程获取。Token 过期后需重新获取并在控制台更新。
@@ -59,7 +60,7 @@ npm install koishi-plugin-ggcevo
 | `切换 [index]` | — | 切换正在使用的游戏句柄 |
 | `查询 [handle]` | — | 查询某游戏句柄是否已被绑定 |
 | `解绑 [index]` | 解绑句柄 | 解除绑定某个游戏句柄 |
-| `地图检测` | — | 查询已配置地图（`mapMonitorMapIds`）的检测状态：在线状态、最后状态变更时间、24h/30d离线次数、近期事件。需开启 `mapMonitorEnabled` 且配置地图ID |
+| `地图检测` | — | 查询已配置地图（`mapMonitorMapIds`）的检测状态：在线状态、最后状态变更时间、24h/30d离线次数、近期事件。当所有配置地图均离线时，底部额外提示推荐游玩的地图（需配置 `mapMonitorRecommendMapName`）。需开启 `mapMonitorEnabled` 且配置地图ID |
 
 ### 签到与虚拟物品（ggcevo）
 
@@ -73,13 +74,13 @@ 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列句柄）全量数据并写入数据库（管理员指令） |
 
@@ -130,6 +131,22 @@ npm install koishi-plugin-ggcevo
 
 ## 更新日志
 
+### v1.0.10
+
+地图检测新增推荐地图提示，腾讯文档配置项默认值调整。
+
+- **新增配置项** `mapMonitorRecommendMapName`：当所有配置地图均离线时，在「地图检测」指令返回消息底部额外提示推荐游玩的地图名称
+- **配置项默认值调整**：取消 `tencentDocsBanListFileId`、`tencentDocsBanListSheetId`、`tencentDocsAdminWelfareFileId`、`tencentDocsAdminWelfareSheetId` 的默认填充值，改为空字符串，需手动在控制台填写
+
+### v1.0.9
+
+优化指令交互体验与活动列表过滤。
+
+- **活动列表**：新增可选参数 `[showAll]`，默认（不带参数）只显示进行中与未开始的活动，隐藏已过期活动；输入 `活动列表 全部` 可查看含已过期在内的全部活动
+- **封禁记录**：新增可选参数 `[user]`，支持 `@用户` 查询对方句柄的封禁记录；无参数时查询自己当前使用中的句柄
+- **引用消息**：为 `签到`、`背包`、`个人信息`、`领取活动` 指令的所有返回消息添加引用消息效果
+- **兑换列表**：删除"限定物品不可兑换"提示，合并兑换开放时间与实装时间为一条提示
+
 ### v1.0.8
 
 修复腾讯文档单选项下拉框单元格读取为空的问题。