koishi-plugin-cs2-update-log 2.1.1 → 2.2.0

package/README.md

@@ -14,13 +14,14 @@ Koishi QQ 机器人插件，用于轮询 CS2 官方 Steam 公告流，按 `gid`
   - 或正文包含 `[MAPS]`、`[GAMEPLAY]`、`[MISC]`、`[AUDIO]`、`[ITEMS]`、`[WORKSHOP]`、`[PREMIER]` 等更新分区
 - 支持纯文本推送或 Puppeteer 深色长图卡片推送。
 - 支持 OpenAI-compatible Chat Completions API 翻译。
+- 内置短时运行时缓存：RSS 列表缓存 15 秒，新闻内容、AI 翻译结果、长图 PNG 和卡片静态资源每 5 分钟清理一次，减少连续测试/重复推送的开销。
 - 提供 `cs2log.check`、`cs2log.push` 与 `cs2log.test` 命令。
 
 ## 配置要点
 
 - `targets` 必须配置目标 QQ 群，其中 `channelId` 一般填写群号。
 - `picture` 开启后需要安装并启用 Puppeteer 服务插件，例如 `@koishijs/plugin-puppeteer`。
-- `trans` 开启后需要填写 `translateApiKey`；默认接口是 OpenAI Chat Completions 格式，可按你的服务商修改 `translateApiEndpoint` 和 `translateModel`。
+- `trans` 开启后需要填写 `translateApiKey`；默认接口是 OpenAI Chat Completions 格式，可按你的服务商修改 `translateApiEndpoint` 和 `translateModel`。AI 翻译请求超时时间为 90 秒。
 
 ## 命令
 

package/lib/index.js

@@ -8,6 +8,7 @@ exports.apply = apply;
 const koishi_1 = require("koishi");
 const markdown_it_1 = __importDefault(require("markdown-it"));
 const fast_xml_parser_1 = require("fast-xml-parser");
+const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
 exports.name = 'cs2-update-log';
@@ -18,6 +19,12 @@ exports.inject = {
 const APP_ID = 730;
 const STEAM_RSS_URL = `https://store.steampowered.com/feeds/news/app/${APP_ID}/`;
 const STATE_LIMIT = 1000;
+const RSS_LIST_CACHE_TTL_MS = 15 * 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');
+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('轮询间隔，单位：秒。'),
@@ -59,8 +66,25 @@ function apply(ctx, config) {
     const logger = ctx.logger(loggerName);
     const statePath = resolveStatePath(ctx, config.stateFile);
     const knownGids = new Set();
+    const cache = {
+        rssFetchedAt: 0,
+        rssItems: [],
+        newsByGid: new Map(),
+        translations: new Map(),
+        cardImages: new Map(),
+        assetDataUris: new Map(),
+    };
     let stateInitialized = false;
     let polling = false;
+    function clearRuntimeCache(reason) {
+        cache.rssFetchedAt = 0;
+        cache.rssItems = [];
+        cache.newsByGid.clear();
+        cache.translations.clear();
+        cache.cardImages.clear();
+        cache.assetDataUris.clear();
+        logger.info('已清理运行时缓存：%s', reason);
+    }
     async function loadState() {
         try {
             const raw = await node_fs_1.promises.readFile(statePath, 'utf8');
@@ -102,19 +126,38 @@ function apply(ctx, config) {
     }
     async function fetchNews() {
         try {
+            if (cache.rssItems.length && Date.now() - cache.rssFetchedAt < RSS_LIST_CACHE_TTL_MS) {
+                logger.debug('使用 RSS 短时缓存：items=%d', cache.rssItems.length);
+                return cache.rssItems.slice(0, config.count);
+            }
             const xml = await ctx.http.get(STEAM_RSS_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',
+                },
                 responseType: 'text',
+                timeout: 30000,
             });
             const parsed = rssParser.parse(xml);
             const rawItems = parsed.rss?.channel?.item;
             const items = Array.isArray(rawItems) ? rawItems : rawItems ? [rawItems] : [];
-            return items
+            const parsedItems = items
                 .map(parseRssItem)
-                .filter((item) => !!item?.gid && !!item.title)
-                .slice(0, config.count);
+                .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;
+            });
+            cache.rssFetchedAt = Date.now();
+            cache.rssItems = cachedItems;
+            return cachedItems.slice(0, config.count);
         }
         catch (error) {
-            logger.error('拉取 Steam CS2 RSS 失败：%s', formatError(error));
+            logger.error('拉取 Steam CS2 RSS 失败：url=%s\n%s', STEAM_RSS_URL, formatError(error));
             return [];
         }
     }
@@ -194,7 +237,15 @@ function apply(ctx, config) {
             return buildTextMessage(news, title, bodyMarkdown, link);
         }
         try {
-            const png = await renderCard(puppeteer, news, title, bodyMarkdown);
+            const cacheKey = hashCacheKey('card-image', news.item.gid, news.category, config.brandName, config.siteName, title, bodyMarkdown);
+            let png = cache.cardImages.get(cacheKey);
+            if (!png) {
+                png = await renderCard(puppeteer, news, title, bodyMarkdown);
+                cache.cardImages.set(cacheKey, png);
+            }
+            else {
+                logger.debug('使用长图缓存：gid=%s title=%s', news.item.gid, news.item.title);
+            }
             const image = koishi_1.h.image(png, 'image/png');
             return config.appendLink ? [image, '\n', link] : image;
         }
@@ -204,7 +255,8 @@ function apply(ctx, config) {
         }
     }
     async function renderCard(puppeteer, news, title, bodyMarkdown) {
-        const html = buildCardHtml(news, title, bodyMarkdown, config);
+        const assets = await loadCardAssets();
+        const html = buildCardHtml(news, title, bodyMarkdown, config, assets);
         const page = await puppeteer.page();
         try {
             if (page.setViewport) {
@@ -237,6 +289,12 @@ function apply(ctx, config) {
             logger.warn('已开启 AI 翻译但未填写 translateApiKey，将推送原文。');
             return { title, markdown: bodyMarkdown };
         }
+        const cacheKey = hashCacheKey('translation', config.translateApiEndpoint, config.translateModel, config.translatePrompt, title, bodyMarkdown);
+        const cached = cache.translations.get(cacheKey);
+        if (cached) {
+            logger.debug('使用 AI 翻译缓存：title=%s', title);
+            return cached;
+        }
         try {
             const response = await ctx.http.post(config.translateApiEndpoint, {
                 model: config.translateModel,
@@ -265,22 +323,49 @@ function apply(ctx, config) {
                     Authorization: `Bearer ${config.translateApiKey}`,
                     'Content-Type': 'application/json',
                 },
-                timeout: 60000,
+                timeout: TRANSLATE_TIMEOUT_MS,
             });
             const content = response?.choices?.[0]?.message?.content?.trim();
             if (!content)
                 throw new Error('empty translation response');
             const parsed = parseJsonObject(content);
-            return {
+            const translated = {
                 title: parsed.title || title,
                 markdown: parsed.markdown || bodyMarkdown,
             };
+            cache.translations.set(cacheKey, translated);
+            return translated;
         }
         catch (error) {
             logger.error('AI 翻译失败，将推送原文：%s', formatError(error));
             return { title, markdown: bodyMarkdown };
         }
     }
+    async function loadCardAssets() {
+        const [brandLogoDataUri, githubQrDataUri] = await Promise.all([
+            loadAssetDataUri('brand-logo', BRAND_LOGO_PATH, 'image/png'),
+            loadAssetDataUri('github-qrcode', GITHUB_QRCODE_PATH, 'image/png'),
+        ]);
+        return {
+            brandLogoDataUri,
+            githubQrDataUri,
+        };
+    }
+    async function loadAssetDataUri(cacheKey, filePath, mimeType) {
+        const cached = cache.assetDataUris.get(cacheKey);
+        if (cached)
+            return cached;
+        try {
+            const buffer = await node_fs_1.promises.readFile(filePath);
+            const dataUri = `data:${mimeType};base64,${buffer.toString('base64')}`;
+            cache.assetDataUris.set(cacheKey, dataUri);
+            return dataUri;
+        }
+        catch (error) {
+            logger.error('读取卡片资源失败：path=%s\n%s', filePath, formatError(error));
+            return '';
+        }
+    }
     ctx.command('cs2log.check', '查看最近 5 条 CS2 官方公告分类结果')
         .action(async () => {
         const items = await fetchNews();
@@ -327,6 +412,9 @@ function apply(ctx, config) {
     ctx.setInterval(() => {
         void pollAndPush('timer');
     }, Math.max(5, config.interval) * 1000);
+    ctx.setInterval(() => {
+        clearRuntimeCache('short cache interval');
+    }, RUNTIME_CACHE_CLEAR_INTERVAL_MS);
 }
 function classifyNews(item) {
     const body = decodeHtmlEntities(item.content || '');
@@ -417,6 +505,14 @@ function steamContentToMarkdown(input) {
         .replace(/\n{3,}/g, '\n\n')
         .trim();
 }
+function hashCacheKey(...parts) {
+    const hash = (0, node_crypto_1.createHash)('sha256');
+    for (const part of parts) {
+        hash.update(part);
+        hash.update('\0');
+    }
+    return hash.digest('hex');
+}
 function buildTextMessage(news, title, bodyMarkdown, link) {
     const categoryName = news.category === 'update' ? 'CS2 官方更新日志' : 'CS2 官方公告';
     const parts = [
@@ -433,7 +529,7 @@ function buildTextMessage(news, title, bodyMarkdown, link) {
         parts.push(`原文：${link}`);
     return parts.join('\n');
 }
-function buildCardHtml(news, title, bodyMarkdown, config) {
+function buildCardHtml(news, title, bodyMarkdown, config, assets) {
     const categoryName = news.category === 'update' ? 'CS2 官方更新日志' : 'CS2 官方公告';
     const categoryTag = news.category === 'update' ? 'UPDATE LOG' : 'ANNOUNCEMENT';
     const rendered = markdown.render(bodyMarkdown);
@@ -497,6 +593,13 @@ body {
   border: 1px solid rgba(255, 255, 255, 0.14);
   box-shadow: inset 0 0 0 5px rgba(255, 255, 255, 0.03);
   font-size: 26px;
+  overflow: hidden;
+}
+.avatar img {
+  display: block;
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
 }
 .brand-title {
   font-size: 21px;
@@ -637,6 +740,13 @@ body {
   font-weight: 900;
   color: #ffffff;
 }
+.site-wrap {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 14px;
+  min-width: 230px;
+}
 .site {
   text-align: right;
   min-width: 160px;
@@ -651,13 +761,22 @@ body {
   color: #78b7ff;
   font-size: 14px;
 }
+.qr-code {
+  width: 62px;
+  height: 62px;
+  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);
+}
 </style>
 </head>
 <body>
   <article id="card">
     <header class="topbar">
       <div class="brand">
-        <div class="avatar">CS</div>
+        <div class="avatar">${assets.brandLogoDataUri ? `<img src="${assets.brandLogoDataUri}" alt="">` : 'CS'}</div>
         <div>
           <div class="brand-title">${escapeHtml(config.brandName)}</div>
           <div class="brand-subtitle">CS2 更新日志工具</div>
@@ -678,9 +797,12 @@ body {
         <div class="published-label">PUBLISHED AT</div>
         <div class="published-time">${escapeHtml(publishedAt)}</div>
       </div>
-      <div class="site">
-        <div class="site-name">${escapeHtml(config.siteName)}</div>
-        <div class="author">${escapeHtml(author)}</div>
+      <div class="site-wrap">
+        <div class="site">
+          <div class="site-name">${escapeHtml(config.siteName)}</div>
+          <div class="author">${escapeHtml(author)}</div>
+        </div>
+        ${assets.githubQrDataUri ? `<img class="qr-code" src="${assets.githubQrDataUri}" alt="">` : ''}
       </div>
     </footer>
   </article>
@@ -791,7 +913,77 @@ function isNodeError(error) {
     return !!error && typeof error === 'object' && 'code' in error;
 }
 function formatError(error) {
-    if (error instanceof Error)
-        return error.stack || error.message;
-    return String(error);
+    const lines = [];
+    appendErrorDetails(lines, error);
+    return lines.join('\n');
+}
+function appendErrorDetails(lines, error, label = 'error', depth = 0, seen = new Set()) {
+    if (error == null || typeof error !== 'object') {
+        lines.push(`${label}: ${String(error)}`);
+        return;
+    }
+    if (seen.has(error)) {
+        lines.push(`${label}: [Circular]`);
+        return;
+    }
+    seen.add(error);
+    const record = error;
+    const name = typeof record.name === 'string' ? record.name : error instanceof Error ? error.name : 'Error';
+    const message = typeof record.message === 'string' ? record.message : String(error);
+    lines.push(`${label}: ${name}: ${message}`);
+    const details = collectErrorDetails(record);
+    if (details.length)
+        lines.push(`${label} details: ${details.join(', ')}`);
+    const stack = typeof record.stack === 'string' ? record.stack : '';
+    const stackLines = stack.split(/\r?\n/).slice(1, 7).map((line) => line.trim()).filter(Boolean);
+    if (stackLines.length)
+        lines.push(`${label} stack:\n  ${stackLines.join('\n  ')}`);
+    appendNestedObjectDetails(lines, record, 'request', label);
+    appendNestedObjectDetails(lines, record, 'response', label);
+    const cause = record.cause;
+    if (cause !== undefined && depth < 5) {
+        appendErrorDetails(lines, cause, `${label}.cause`, depth + 1, seen);
+    }
+}
+function collectErrorDetails(record) {
+    const keys = [
+        'code',
+        'errno',
+        'type',
+        'syscall',
+        'hostname',
+        'host',
+        'address',
+        'port',
+        'method',
+        'url',
+        'status',
+        'statusCode',
+        'statusText',
+    ];
+    const details = [];
+    for (const key of keys) {
+        const value = record[key];
+        if (value == null)
+            continue;
+        const rendered = renderLogValue(value);
+        if (rendered)
+            details.push(`${key}=${rendered}`);
+    }
+    return details;
+}
+function appendNestedObjectDetails(lines, record, key, label) {
+    const value = record[key];
+    if (!value || typeof value !== 'object')
+        return;
+    const details = collectErrorDetails(value);
+    if (details.length)
+        lines.push(`${label}.${key} details: ${details.join(', ')}`);
+}
+function renderLogValue(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint')
+        return String(value);
+    return undefined;
 }

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "koishi-plugin-cs2-update-log",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "Koishi plugin for monitoring CS2 official Steam announcements and update logs.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "files": [
+    "assets",
     "lib",
     "README.md"
   ],