koishi-plugin-cs2-update-log 2.2.2 → 2.3.0

package/README.md

@@ -6,15 +6,16 @@ Koishi QQ 机器人插件，用于轮询 CS2 官方 Steam 公告流，按 `gid`
 
 ## 功能
 
-- 使用 Steam Store RSS `https://store.steampowered.com/feeds/news/app/730/` 拉取 AppID `730` 的官方公告流。
-- 默认每 30 秒轮询一次。
+- 使用 Valve Fastly RSS、Steam Web API 与 Store RSS 拉取 AppID `730` 的官方公告流。
+- 默认每 15 秒轮询一次。
 - 首次启动默认只记录历史 `gid`，不推送历史内容。
 - 自动分类：
   - 标题包含 `Counter-Strike 2 Update` / `Release Notes`
   - 或正文包含 `[MAPS]`、`[GAMEPLAY]`、`[MISC]`、`[AUDIO]`、`[ITEMS]`、`[WORKSHOP]`、`[PREMIER]` 等更新分区
 - 支持纯文本推送或 Puppeteer 深色长图卡片推送。
 - 支持 OpenAI-compatible Chat Completions API 翻译。
-- 内置短时运行时缓存：RSS 列表缓存 15 秒，新闻内容、AI 翻译结果、长图 PNG 和卡片静态资源每 5 分钟清理一次，减少连续测试/重复推送的开销。
+- 优先并发请求 Valve Fastly RSS 与 Steam Web API，并在两者都不可用时回退到 Store RSS；Fastly RSS 使用 30 秒缓存时间桶，兼顾新公告发现速度和源站压力。
+- 内置短时运行时缓存：RSS 列表缓存 3 秒，新闻内容、AI 翻译结果、长图 PNG 和卡片静态资源每 5 分钟清理一次，减少连续测试/重复推送的开销。
 - 提供 `cs2log.check`、`cs2log.push` 与 `cs2log.test` 命令。
 
 ## 配置要点

package/lib/index.js

@@ -17,9 +17,13 @@ exports.inject = {
     optional: ['puppeteer'],
 };
 const APP_ID = 730;
-const STEAM_RSS_URL = `https://store.steampowered.com/feeds/news/app/${APP_ID}/`;
+const STEAM_FASTLY_RSS_URL = `https://store.fastly.steamstatic.com/feeds/news/app/${APP_ID}/`;
+const STEAM_STORE_RSS_URL = `https://store.steampowered.com/feeds/news/app/${APP_ID}/`;
+const STEAM_NEWS_API_URL = 'https://api.steampowered.com/ISteamNews/GetNewsForApp/v2/';
 const STATE_LIMIT = 1000;
-const RSS_LIST_CACHE_TTL_MS = 15 * 1000;
+const RSS_LIST_CACHE_TTL_MS = 3 * 1000;
+const RSS_CACHE_BUCKET_MS = 30 * 1000;
+const STEAM_REQUEST_TIMEOUT_MS = 8 * 1000;
 const RUNTIME_CACHE_CLEAR_INTERVAL_MS = 5 * 60 * 1000;
 const TRANSLATE_TIMEOUT_MS = 90 * 1000;
 const ASSET_DIR = node_path_1.default.resolve(__dirname, '..', 'assets');
@@ -27,7 +31,7 @@ const BRAND_LOGO_PATH = node_path_1.default.join(ASSET_DIR, 'brand-logo.png');
 const GITHUB_QRCODE_PATH = node_path_1.default.join(ASSET_DIR, 'github-qrcode.png');
 const loggerName = 'cs2-update-log';
 exports.Config = koishi_1.Schema.object({
-    interval: koishi_1.Schema.number().min(5).step(1).default(30).description('轮询间隔，单位：秒。'),
+    interval: koishi_1.Schema.number().min(5).step(1).default(15).description('轮询间隔，单位：秒。'),
     count: koishi_1.Schema.number().min(1).max(100).step(1).default(20).description('每次从 Steam 拉取的新闻数量。'),
     stateFile: koishi_1.Schema.string().default('.koishi-cs2-update-log.json').description('本地 gid 判重文件路径。相对路径会基于 Koishi 启动目录解析。'),
     pushOnFirstRun: koishi_1.Schema.boolean().default(false).description('首次启动时是否推送历史内容。默认关闭，避免刷屏。'),
@@ -37,8 +41,8 @@ exports.Config = koishi_1.Schema.object({
         channelId: koishi_1.Schema.string().required().description('目标频道或 QQ 群号。'),
         guildId: koishi_1.Schema.string().description('可选群组 ID。标准 bot.sendMessage 只使用 channelId，此字段用于记录配置语义。'),
     })).default([]).description('推送目标列表。'),
-    brandName: koishi_1.Schema.string().default('FKBUFF').description('图片顶部品牌名。'),
-    siteName: koishi_1.Schema.string().default('CS2 官方公告').description('图片底部站点名。'),
+    brandName: koishi_1.Schema.string().default('CS2 update').description('图片顶部品牌名。'),
+    siteName: koishi_1.Schema.string().default('Github仓库').description('图片底部站点名。'),
     picture: koishi_1.Schema.boolean().default(true).description('是否以 Puppeteer 截图长图形式推送。关闭后推送纯文本。'),
     appendLink: koishi_1.Schema.boolean().default(true).description('图片或文本后是否附带 Steam 原文链接。'),
     trans: koishi_1.Schema.boolean().default(false).description('是否启用 AI 翻译。关闭时推送 Steam 返回的原文。'),
@@ -130,13 +134,48 @@ function apply(ctx, config) {
                 logger.debug('使用 RSS 短时缓存：items=%d', cache.rssItems.length);
                 return cache.rssItems.slice(0, config.count);
             }
-            const xml = await ctx.http.get(STEAM_RSS_URL, {
+            const cacheBucket = Math.floor(Date.now() / RSS_CACHE_BUCKET_MS);
+            const fastlyUrl = `${STEAM_FASTLY_RSS_URL}?l=english&_=${cacheBucket}`;
+            const apiUrl = `${STEAM_NEWS_API_URL}?appid=${APP_ID}&count=${config.count}&maxlength=0&format=json`;
+            let items;
+            try {
+                items = await Promise.any([
+                    fetchRssSource('Fastly RSS', fastlyUrl),
+                    fetchApiSource('Steam Web API', apiUrl),
+                ]);
+            }
+            catch (primaryError) {
+                const storeUrl = `${STEAM_STORE_RSS_URL}?l=english&_=${cacheBucket}`;
+                logger.warn('Fastly RSS 与 Steam Web API 均不可用，回退到 Store RSS：%s', formatAggregateError(primaryError));
+                items = await fetchRssSource('Store RSS', storeUrl);
+            }
+            const cachedItems = items.map((item) => {
+                const cached = cache.newsByGid.get(item.gid);
+                if (cached && cached.title === item.title && cached.content === item.content && cached.url === item.url && cached.date === item.date) {
+                    return cached;
+                }
+                cache.newsByGid.set(item.gid, item);
+                return item;
+            });
+            cache.rssFetchedAt = Date.now();
+            cache.rssItems = cachedItems;
+            return cachedItems.slice(0, config.count);
+        }
+        catch (error) {
+            logger.error('拉取 Steam CS2 官方新闻失败：\n%s', formatError(error));
+            return [];
+        }
+    }
+    async function fetchRssSource(source, url) {
+        const startedAt = Date.now();
+        try {
+            const xml = await ctx.http.get(url, {
                 headers: {
                     Accept: 'application/rss+xml, application/xml, text/xml;q=0.9, */*;q=0.8',
-                    'User-Agent': 'koishi-plugin-cs2-update-log/2.1',
+                    'User-Agent': 'koishi-plugin-cs2-update-log/2.2',
                 },
                 responseType: 'text',
-                timeout: 30000,
+                timeout: STEAM_REQUEST_TIMEOUT_MS,
             });
             const parsed = rssParser.parse(xml);
             const rawItems = parsed.rss?.channel?.item;
@@ -144,21 +183,37 @@ function apply(ctx, config) {
             const parsedItems = items
                 .map(parseRssItem)
                 .filter((item) => !!item?.gid && !!item.title);
-            const cachedItems = parsedItems.map((item) => {
-                const cached = cache.newsByGid.get(item.gid);
-                if (cached && cached.title === item.title && cached.content === item.content && cached.url === item.url && cached.date === item.date) {
-                    return cached;
-                }
-                cache.newsByGid.set(item.gid, item);
-                return item;
+            if (!parsedItems.length)
+                throw new Error('返回内容中没有有效新闻');
+            logger.debug('%s 拉取成功：items=%d duration=%dms', source, parsedItems.length, Date.now() - startedAt);
+            return parsedItems;
+        }
+        catch (error) {
+            logger.debug('%s 拉取失败：duration=%dms url=%s\n%s', source, Date.now() - startedAt, url, formatError(error));
+            throw new Error(`${source} 拉取失败：${formatError(error)}`);
+        }
+    }
+    async function fetchApiSource(source, url) {
+        const startedAt = Date.now();
+        try {
+            const response = await ctx.http.get(url, {
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': 'koishi-plugin-cs2-update-log/2.2',
+                },
+                timeout: STEAM_REQUEST_TIMEOUT_MS,
             });
-            cache.rssFetchedAt = Date.now();
-            cache.rssItems = cachedItems;
-            return cachedItems.slice(0, config.count);
+            const parsedItems = (response.appnews?.newsitems || [])
+                .map(parseSteamApiItem)
+                .filter((item) => !!item?.gid && !!item.title);
+            if (!parsedItems.length)
+                throw new Error('返回内容中没有有效新闻');
+            logger.debug('%s 拉取成功：items=%d duration=%dms', source, parsedItems.length, Date.now() - startedAt);
+            return parsedItems;
         }
         catch (error) {
-            logger.error('拉取 Steam CS2 RSS 失败：url=%s\n%s', STEAM_RSS_URL, formatError(error));
-            return [];
+            logger.debug('%s 拉取失败：duration=%dms url=%s\n%s', source, Date.now() - startedAt, url, formatError(error));
+            throw new Error(`${source} 拉取失败：${formatError(error)}`);
         }
     }
     async function pollAndPush(source) {
@@ -211,24 +266,24 @@ function apply(ctx, config) {
             : buildTextMessage(news, displayTitle, displayMarkdown, link);
     }
     async function pushNews(news) {
-        const content = await buildNewsContent(news);
         if (!config.targets.length) {
             logger.warn('未配置推送目标，已跳过：%s', news.item.title);
             return;
         }
-        for (const target of config.targets) {
+        const content = await buildNewsContent(news);
+        await Promise.all(config.targets.map(async (target) => {
             try {
                 const bot = findTargetBot(ctx, target);
                 if (!bot) {
                     logger.warn('找不到推送机器人 platform=%s selfId=%s', target.platform, target.selfId || '*');
-                    continue;
+                    return;
                 }
                 await bot.sendMessage(target.channelId, content);
             }
             catch (error) {
                 logger.error('推送到 channelId=%s 失败：%s', target.channelId, formatError(error));
             }
-        }
+        }));
     }
     async function renderOrFallbackText(news, title, bodyMarkdown, link) {
         const puppeteer = ctx.puppeteer;
@@ -267,7 +322,7 @@ function apply(ctx, config) {
                 });
             }
             await page.setContent(html, {
-                waitUntil: 'networkidle0',
+                waitUntil: 'load',
             });
             const card = await page.$('#card');
             if (!card)
@@ -440,11 +495,25 @@ function parseRssItem(item) {
         gid,
         title,
         url,
-        author: 'Valve',
+        author: 'BestBcz',
         content: readXmlText(item.description),
         date: Number.isFinite(dateValue) ? Math.floor(dateValue / 1000) : 0,
     };
 }
+function parseSteamApiItem(item) {
+    const gid = String(item.gid || '').trim();
+    const title = decodeHtmlEntities(String(item.title || '').trim());
+    if (!gid || !title)
+        return null;
+    return {
+        gid,
+        title,
+        url: String(item.url || '').trim(),
+        author: String(item.author || 'Valve').trim(),
+        content: String(item.contents || ''),
+        date: Number.isFinite(item.date) ? Number(item.date) : 0,
+    };
+}
 function readXmlText(value) {
     if (value == null)
         return '';
@@ -762,13 +831,13 @@ body {
   font-size: 14px;
 }
 .qr-code {
-  width: 62px;
-  height: 62px;
+  display: block;
+  width: 64px;
+  height: 64px;
   flex: 0 0 auto;
-  padding: 5px;
-  border-radius: 8px;
-  background: rgba(255, 255, 255, 0.94);
-  border: 1px solid rgba(255, 255, 255, 0.22);
+  border-radius: 5px;
+  background: #ffffff;
+  object-fit: cover;
 }
 </style>
 </head>
@@ -917,6 +986,12 @@ function formatError(error) {
     appendErrorDetails(lines, error);
     return lines.join('\n');
 }
+function formatAggregateError(error) {
+    if (error instanceof AggregateError) {
+        return error.errors.map((item) => formatError(item)).join(' | ');
+    }
+    return formatError(error);
+}
 function appendErrorDetails(lines, error, label = 'error', depth = 0, seen = new Set()) {
     if (error == null || typeof error !== 'object') {
         lines.push(`${label}: ${String(error)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-cs2-update-log",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "description": "Koishi plugin for monitoring CS2 official Steam announcements and update logs.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -50,8 +50,8 @@
   },
   "koishi": {
     "description": {
-      "zh": "监控 CS2 官方 Steam 公告和更新日志，并推送到指定 QQ 群。",
-      "en": "Monitor official CS2 Steam announcements and update logs."
+      "zh": "✨监控CS2更新日志和官方公告，并自动推送到指定QQ群⭐",
+      "en": "Monitor official CS2 announcements and update logs."
     },
     "service": {
       "required": [