koishi-plugin-cs2-update-log 1.0.0

package/README.md

@@ -0,0 +1,28 @@
+# koishi-plugin-cs2-update-log
+
+作者：BestBcz
+
+Koishi QQ 机器人插件，用于轮询 CS2 官方 Steam 公告流，按 `gid` 判重后将官方更新日志或官方公告推送到指定群。
+
+## 功能
+
+- 使用 Steam `ISteamNews/GetNewsForApp/v2` 拉取 AppID `730` 的官方公告流。
+- 默认每 30 秒轮询一次。
+- 首次启动默认只记录历史 `gid`，不推送历史内容。
+- 自动分类：
+  - 标题包含 `Counter-Strike 2 Update` / `Release Notes`
+  - 或正文包含 `[MAPS]`、`[GAMEPLAY]`、`[MISC]`、`[AUDIO]`、`[ITEMS]`、`[WORKSHOP]`、`[PREMIER]` 等更新分区
+- 支持纯文本推送或 Puppeteer 深色长图卡片推送。
+- 支持 OpenAI-compatible Chat Completions API 翻译。
+- 提供 `cs2log.check` 与 `cs2log.push` 命令。
+
+## 配置要点
+
+- `targets` 必须配置目标 QQ 群，其中 `channelId` 一般填写群号。
+- `picture` 开启后需要安装并启用 Puppeteer 服务插件，例如 `@koishijs/plugin-puppeteer`。
+- `trans` 开启后需要填写 `translateApiKey`；默认接口是 OpenAI Chat Completions 格式，可按你的服务商修改 `translateApiEndpoint` 和 `translateModel`。
+
+## 命令
+
+- `cs2log.check`：查看最近 5 条新闻的分类结果。
+- `cs2log.push`：手动检查并推送新内容。

package/lib/index.d.ts

@@ -0,0 +1,31 @@
+import { Context, Schema } from 'koishi';
+export declare const name = "cs2-update-log";
+export declare const inject: {
+    required: string[];
+    optional: string[];
+};
+interface TargetConfig {
+    platform: string;
+    selfId?: string;
+    channelId: string;
+    guildId?: string;
+}
+export interface Config {
+    interval: number;
+    count: number;
+    stateFile: string;
+    pushOnFirstRun: boolean;
+    targets: TargetConfig[];
+    brandName: string;
+    siteName: string;
+    picture: boolean;
+    appendLink: boolean;
+    trans: boolean;
+    translateApiKey: string;
+    translateApiEndpoint: string;
+    translateModel: string;
+    translatePrompt: string;
+}
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context, config: Config): void;
+export {};

package/lib/index.js

@@ -0,0 +1,728 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = exports.inject = exports.name = void 0;
+exports.apply = apply;
+const koishi_1 = require("koishi");
+const markdown_it_1 = __importDefault(require("markdown-it"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+exports.name = 'cs2-update-log';
+exports.inject = {
+    required: ['http'],
+    optional: ['puppeteer'],
+};
+const APP_ID = 730;
+const FEED_NAME = 'steam_community_announcements';
+const STEAM_NEWS_API = 'https://api.steampowered.com/ISteamNews/GetNewsForApp/v2/';
+const STATE_LIMIT = 1000;
+const loggerName = 'cs2-update-log';
+exports.Config = koishi_1.Schema.object({
+    interval: koishi_1.Schema.number().min(5).step(1).default(30).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('首次启动时是否推送历史内容。默认关闭，避免刷屏。'),
+    targets: koishi_1.Schema.array(koishi_1.Schema.object({
+        platform: koishi_1.Schema.string().default('onebot').description('目标平台，例如 onebot。'),
+        selfId: koishi_1.Schema.string().description('机器人账号 ID。留空时使用该平台第一个可用机器人。'),
+        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('图片底部站点名。'),
+    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 返回的原文。'),
+    translateApiKey: koishi_1.Schema.string().role('secret').description('AI 翻译 API Key。启用 trans 时必填。'),
+    translateApiEndpoint: koishi_1.Schema.string().default('https://api.openai.com/v1/chat/completions').description('OpenAI-compatible Chat Completions 接口地址。'),
+    translateModel: koishi_1.Schema.string().default('gpt-4o-mini').description('AI 翻译模型名。'),
+    translatePrompt: koishi_1.Schema.string().role('textarea').default('你是一个专业的游戏公告翻译助手。请将 CS2 Steam 官方公告翻译为简体中文，保留 Markdown 结构、更新分区、列表、粗体、行内代码和代码块，不要添加原文没有的解释。').description('AI 翻译系统提示词。'),
+});
+const markdown = new markdown_it_1.default({
+    html: false,
+    linkify: true,
+    breaks: true,
+});
+const updateTitlePattern = /\b(?:Counter-Strike 2 Update|Release Notes)\b/i;
+const updateSectionPattern = /^\s*\[\s*(MAPS|GAMEPLAY|MISC|AUDIO|ITEMS|WORKSHOP|PREMIER|GRAPHICS|ANIMATION|UI|SOUND|INPUT|NETWORKING|MATCHMAKING)\s*\]\s*$/gim;
+const updateSectionInlinePattern = /\[\s*(?:MAPS|GAMEPLAY|MISC|AUDIO|ITEMS|WORKSHOP|PREMIER|GRAPHICS|ANIMATION|UI|SOUND|INPUT|NETWORKING|MATCHMAKING)\s*\]/i;
+function apply(ctx, config) {
+    const logger = ctx.logger(loggerName);
+    const statePath = resolveStatePath(ctx, config.stateFile);
+    const knownGids = new Set();
+    let stateInitialized = false;
+    let polling = false;
+    async function loadState() {
+        try {
+            const raw = await node_fs_1.promises.readFile(statePath, 'utf8');
+            const parsed = JSON.parse(raw);
+            for (const gid of parsed.gids || []) {
+                if (gid)
+                    knownGids.add(String(gid));
+            }
+            stateInitialized = !!parsed.initialized;
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === 'ENOENT')
+                return;
+            logger.warn('读取 state 文件失败，将按首次启动处理：%s', formatError(error));
+        }
+    }
+    async function saveState(recentItems) {
+        try {
+            const recentGids = recentItems.map((item) => item.gid).filter(Boolean);
+            const recentSet = new Set(recentGids);
+            const gids = [
+                ...recentGids,
+                ...Array.from(knownGids).filter((gid) => !recentSet.has(gid)),
+            ].slice(0, STATE_LIMIT);
+            await node_fs_1.promises.mkdir(node_path_1.default.dirname(statePath), { recursive: true });
+            await node_fs_1.promises.writeFile(statePath, `${JSON.stringify({
+                initialized: true,
+                gids,
+                updatedAt: new Date().toISOString(),
+            }, null, 2)}\n`, 'utf8');
+            knownGids.clear();
+            for (const gid of gids)
+                knownGids.add(gid);
+            stateInitialized = true;
+        }
+        catch (error) {
+            logger.error('写入 state 文件失败：%s', formatError(error));
+        }
+    }
+    async function fetchNews() {
+        try {
+            const response = await ctx.http.get(STEAM_NEWS_API, {
+                params: {
+                    appid: APP_ID,
+                    count: config.count,
+                    maxlength: 0,
+                    format: 'json',
+                    feeds: FEED_NAME,
+                },
+            });
+            const items = response?.appnews?.newsitems;
+            if (!Array.isArray(items))
+                return [];
+            return items.filter((item) => item?.gid && item?.title);
+        }
+        catch (error) {
+            logger.error('拉取 Steam CS2 新闻失败：%s', formatError(error));
+            return [];
+        }
+    }
+    async function pollAndPush(source) {
+        if (polling) {
+            logger.debug('已有轮询任务正在执行，跳过本次 %s。', source);
+            return 0;
+        }
+        polling = true;
+        try {
+            const items = await fetchNews();
+            if (!items.length)
+                return 0;
+            const firstRun = !stateInitialized && knownGids.size === 0;
+            if (firstRun && !config.pushOnFirstRun) {
+                for (const item of items)
+                    knownGids.add(item.gid);
+                await saveState(items);
+                logger.info('首次启动已记录 %d 条历史新闻，不推送。', items.length);
+                return 0;
+            }
+            const freshItems = items
+                .filter((item) => !knownGids.has(item.gid))
+                .reverse();
+            let pushed = 0;
+            for (const item of freshItems) {
+                const classified = classifyNews(item);
+                await pushNews(classified);
+                knownGids.add(item.gid);
+                pushed += 1;
+            }
+            await saveState(items);
+            return pushed;
+        }
+        catch (error) {
+            logger.error('检查并推送 CS2 新闻失败：%s', formatError(error));
+            return 0;
+        }
+        finally {
+            polling = false;
+        }
+    }
+    async function pushNews(news) {
+        const link = getNewsLink(news.item);
+        const baseMarkdown = steamBbcodeToMarkdown(news.item.contents);
+        const translated = await maybeTranslate(news.item.title, baseMarkdown);
+        const displayTitle = translated.title || news.item.title;
+        const displayMarkdown = translated.markdown || baseMarkdown;
+        const content = config.picture
+            ? await renderOrFallbackText(news, displayTitle, displayMarkdown, link)
+            : buildTextMessage(news, displayTitle, displayMarkdown, link);
+        if (!config.targets.length) {
+            logger.warn('未配置推送目标，已跳过：%s', news.item.title);
+            return;
+        }
+        for (const target of config.targets) {
+            try {
+                const bot = findTargetBot(ctx, target);
+                if (!bot) {
+                    logger.warn('找不到推送机器人 platform=%s selfId=%s', target.platform, target.selfId || '*');
+                    continue;
+                }
+                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;
+        if (!puppeteer?.page) {
+            logger.warn('已开启 picture，但未检测到 puppeteer 服务，将降级为纯文本推送。');
+            return buildTextMessage(news, title, bodyMarkdown, link);
+        }
+        try {
+            const png = await renderCard(puppeteer, news, title, bodyMarkdown);
+            const image = koishi_1.h.image(png, 'image/png');
+            return config.appendLink ? [image, '\n', link] : image;
+        }
+        catch (error) {
+            logger.error('生成公告长图失败，将降级为纯文本推送：%s', formatError(error));
+            return buildTextMessage(news, title, bodyMarkdown, link);
+        }
+    }
+    async function renderCard(puppeteer, news, title, bodyMarkdown) {
+        const html = buildCardHtml(news, title, bodyMarkdown, config);
+        const page = await puppeteer.page();
+        try {
+            if (page.setViewport) {
+                await page.setViewport({
+                    width: 780,
+                    height: 1200,
+                    deviceScaleFactor: 2,
+                });
+            }
+            await page.setContent(html, {
+                waitUntil: 'networkidle0',
+            });
+            const card = await page.$('#card');
+            if (!card)
+                throw new Error('card element not found');
+            const buffer = await card.screenshot({
+                type: 'png',
+                omitBackground: true,
+            });
+            return Buffer.isBuffer(buffer) ? buffer : Buffer.from(buffer);
+        }
+        finally {
+            await page.close().catch(() => undefined);
+        }
+    }
+    async function maybeTranslate(title, bodyMarkdown) {
+        if (!config.trans)
+            return { title, markdown: bodyMarkdown };
+        if (!config.translateApiKey) {
+            logger.warn('已开启 AI 翻译但未填写 translateApiKey，将推送原文。');
+            return { title, markdown: bodyMarkdown };
+        }
+        try {
+            const response = await ctx.http.post(config.translateApiEndpoint, {
+                model: config.translateModel,
+                messages: [
+                    {
+                        role: 'system',
+                        content: config.translatePrompt,
+                    },
+                    {
+                        role: 'user',
+                        content: [
+                            '请输出严格 JSON，不要使用 Markdown 代码块。',
+                            'JSON 结构为 {"title":"翻译后的标题","markdown":"翻译后的正文 Markdown"}。',
+                            '保留原文的 Markdown 层级、列表、粗体、行内 code 和代码块。',
+                            '',
+                            `标题：${title}`,
+                            '',
+                            '正文 Markdown：',
+                            bodyMarkdown,
+                        ].join('\n'),
+                    },
+                ],
+                temperature: 0.2,
+            }, {
+                headers: {
+                    Authorization: `Bearer ${config.translateApiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                timeout: 60000,
+            });
+            const content = response?.choices?.[0]?.message?.content?.trim();
+            if (!content)
+                throw new Error('empty translation response');
+            const parsed = parseJsonObject(content);
+            return {
+                title: parsed.title || title,
+                markdown: parsed.markdown || bodyMarkdown,
+            };
+        }
+        catch (error) {
+            logger.error('AI 翻译失败，将推送原文：%s', formatError(error));
+            return { title, markdown: bodyMarkdown };
+        }
+    }
+    ctx.command('cs2log.check', '查看最近 5 条 CS2 官方公告分类结果')
+        .action(async () => {
+        const items = await fetchNews();
+        if (!items.length)
+            return '没有拉取到 CS2 官方新闻。';
+        return items.slice(0, 5)
+            .map((item, index) => {
+            const category = classifyNews(item).category === 'update' ? '官方更新日志' : '官方公告';
+            return [
+                `${index + 1}. [${category}] ${item.title}`,
+                `发布时间：${formatDate(item.date)}`,
+                `gid：${item.gid}`,
+                `链接：${getNewsLink(item)}`,
+            ].join('\n');
+        })
+            .join('\n\n');
+    });
+    ctx.command('cs2log.push', '手动检查并推送新的 CS2 官方公告')
+        .action(async () => {
+        const pushed = await pollAndPush('manual');
+        return pushed ? `已推送 ${pushed} 条新的 CS2 官方新闻。` : '没有发现新的 CS2 官方新闻。';
+    });
+    ctx.on('ready', () => {
+        void loadState()
+            .then(() => pollAndPush('startup'))
+            .catch((error) => {
+            logger.error('启动 CS2 新闻轮询失败：%s', formatError(error));
+        });
+    });
+    ctx.setInterval(() => {
+        void pollAndPush('timer');
+    }, Math.max(5, config.interval) * 1000);
+}
+function classifyNews(item) {
+    const body = decodeHtmlEntities(item.contents || '');
+    const isUpdate = updateTitlePattern.test(item.title)
+        || updateSectionPattern.test(body)
+        || updateSectionInlinePattern.test(body);
+    updateSectionPattern.lastIndex = 0;
+    return {
+        item,
+        category: isUpdate ? 'update' : 'announcement',
+    };
+}
+function steamBbcodeToMarkdown(input) {
+    let output = decodeHtmlEntities(input || '')
+        .replace(/\r\n?/g, '\n');
+    output = output
+        .replace(/\[h1\]([\s\S]*?)\[\/h1\]/gi, (_, text) => `\n# ${text.trim()}\n`)
+        .replace(/\[h2\]([\s\S]*?)\[\/h2\]/gi, (_, text) => `\n## ${text.trim()}\n`)
+        .replace(/\[h3\]([\s\S]*?)\[\/h3\]/gi, (_, text) => `\n### ${text.trim()}\n`)
+        .replace(/\[b\]([\s\S]*?)\[\/b\]/gi, '**$1**')
+        .replace(/\[strong\]([\s\S]*?)\[\/strong\]/gi, '**$1**')
+        .replace(/\[i\]([\s\S]*?)\[\/i\]/gi, '*$1*')
+        .replace(/\[em\]([\s\S]*?)\[\/em\]/gi, '*$1*')
+        .replace(/\[u\]([\s\S]*?)\[\/u\]/gi, '$1')
+        .replace(/\[strike\]([\s\S]*?)\[\/strike\]/gi, '~~$1~~')
+        .replace(/\[code\]([\s\S]*?)\[\/code\]/gi, (_, code) => `\n\`\`\`\n${code.trim()}\n\`\`\`\n`)
+        .replace(/\[quote\]([\s\S]*?)\[\/quote\]/gi, (_, quote) => quote.split('\n').map((line) => `> ${line}`).join('\n'))
+        .replace(/\[url=([^\]]+)\]([\s\S]*?)\[\/url\]/gi, '[$2]($1)')
+        .replace(/\[url\]([\s\S]*?)\[\/url\]/gi, '<$1>')
+        .replace(/\[img\]([\s\S]*?)\[\/img\]/gi, '')
+        .replace(/\[previewyoutube=[^\]]+\]([\s\S]*?)\[\/previewyoutube\]/gi, '')
+        .replace(/\[list\]|\[\/list\]|\[olist\]|\[\/olist\]/gi, '\n')
+        .replace(/^\s*\[\*\]\s*/gim, '- ')
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<\/p>\s*<p>/gi, '\n\n')
+        .replace(/<\/?p>/gi, '\n');
+    output = output.replace(updateSectionPattern, (_, section) => `\n## [${String(section).toUpperCase()}]\n`);
+    updateSectionPattern.lastIndex = 0;
+    return output
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+function buildTextMessage(news, title, bodyMarkdown, link) {
+    const categoryName = news.category === 'update' ? 'CS2 官方更新日志' : 'CS2 官方公告';
+    const parts = [
+        `【${categoryName}】`,
+        title,
+        '',
+        truncateText(stripMarkdown(bodyMarkdown), 1800),
+        '',
+        `发布时间：${formatDate(news.item.date)}`,
+    ];
+    if (news.item.author)
+        parts.push(`作者：${news.item.author}`);
+    if (link)
+        parts.push(`原文：${link}`);
+    return parts.join('\n');
+}
+function buildCardHtml(news, title, bodyMarkdown, config) {
+    const categoryName = news.category === 'update' ? 'CS2 官方更新日志' : 'CS2 官方公告';
+    const categoryTag = news.category === 'update' ? 'UPDATE LOG' : 'ANNOUNCEMENT';
+    const rendered = markdown.render(bodyMarkdown);
+    const publishedAt = formatDate(news.item.date);
+    const author = news.item.author || 'Valve';
+    return `<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<style>
+* {
+  box-sizing: border-box;
+}
+html,
+body {
+  margin: 0;
+  padding: 0;
+  width: 780px;
+  min-height: 100%;
+  background: transparent;
+  font-family: Inter, "HarmonyOS Sans SC", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;
+  color: #f7f9ff;
+}
+body {
+  padding: 24px;
+}
+#card {
+  width: 732px;
+  overflow: hidden;
+  border-radius: 0;
+  background:
+    radial-gradient(circle at 88% 6%, rgba(58, 118, 255, 0.16), transparent 28%),
+    radial-gradient(circle at 88% 92%, rgba(132, 66, 210, 0.16), transparent 30%),
+    linear-gradient(180deg, #0a1224 0%, #070b15 54%, #070714 100%);
+  border: 1px solid rgba(149, 177, 255, 0.11);
+  box-shadow: 0 24px 80px rgba(0, 0, 0, 0.45);
+  padding: 44px 48px 42px;
+}
+.topbar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 24px;
+  padding-bottom: 28px;
+  border-bottom: 1px solid rgba(170, 193, 255, 0.14);
+}
+.brand {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  min-width: 0;
+}
+.avatar {
+  display: grid;
+  place-items: center;
+  width: 54px;
+  height: 54px;
+  flex: 0 0 auto;
+  border-radius: 50%;
+  background: linear-gradient(145deg, #1f2b44, #0e1424);
+  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;
+}
+.brand-title {
+  font-size: 21px;
+  font-weight: 800;
+  letter-spacing: 0;
+  line-height: 1.1;
+}
+.brand-subtitle,
+.category-subtitle {
+  margin-top: 5px;
+  color: #8f9bb6;
+  font-size: 14px;
+  line-height: 1.35;
+}
+.category {
+  text-align: right;
+  flex: 0 0 auto;
+}
+.category-title {
+  color: #54a8ff;
+  font-size: 15px;
+  font-weight: 700;
+  letter-spacing: 0;
+}
+.headline {
+  margin: 42px 0 28px;
+  font-size: 34px;
+  line-height: 1.22;
+  font-weight: 900;
+  letter-spacing: 0;
+  color: #f8fbff;
+}
+.type-label {
+  display: inline-flex;
+  align-items: center;
+  height: 28px;
+  margin-bottom: 18px;
+  padding: 0 11px;
+  border-radius: 6px;
+  background: rgba(74, 139, 255, 0.15);
+  color: #8cbfff;
+  border: 1px solid rgba(103, 159, 255, 0.22);
+  font-size: 13px;
+  font-weight: 700;
+}
+.content {
+  color: #d9e1f2;
+  font-size: 21px;
+  line-height: 1.72;
+  word-break: break-word;
+}
+.content h1,
+.content h2,
+.content h3 {
+  margin: 34px 0 14px;
+  line-height: 1.32;
+  color: #ffffff;
+  font-weight: 850;
+  letter-spacing: 0;
+}
+.content h1 {
+  font-size: 28px;
+}
+.content h2 {
+  font-size: 25px;
+}
+.content h3 {
+  font-size: 22px;
+}
+.content p {
+  margin: 0 0 18px;
+}
+.content strong {
+  color: #ffffff;
+  font-weight: 850;
+}
+.content a {
+  color: #7bb6ff;
+  text-decoration: none;
+}
+.content ul,
+.content ol {
+  margin: 8px 0 20px;
+  padding-left: 28px;
+}
+.content li {
+  margin: 8px 0;
+}
+.content code {
+  display: inline-block;
+  max-width: 100%;
+  vertical-align: baseline;
+  padding: 2px 8px 4px;
+  border-radius: 5px;
+  background: rgba(67, 96, 144, 0.56);
+  color: #8bc5ff;
+  font-family: "JetBrains Mono", Consolas, "Courier New", monospace;
+  font-size: 0.78em;
+  line-height: 1.45;
+}
+.content pre {
+  margin: 22px 0 24px;
+  padding: 22px 24px;
+  border-radius: 8px;
+  background: rgba(3, 8, 19, 0.72);
+  border: 1px solid rgba(142, 171, 234, 0.18);
+  overflow: hidden;
+}
+.content pre code {
+  display: block;
+  padding: 0;
+  border-radius: 0;
+  background: transparent;
+  color: #d7e5ff;
+  font-size: 16px;
+  line-height: 1.65;
+  white-space: pre-wrap;
+}
+.footer {
+  display: flex;
+  align-items: end;
+  justify-content: space-between;
+  gap: 28px;
+  margin-top: 42px;
+  padding-top: 28px;
+  border-top: 1px solid rgba(170, 193, 255, 0.14);
+}
+.published-label {
+  color: #70809e;
+  font-size: 11px;
+  font-weight: 800;
+  letter-spacing: 0.8px;
+}
+.published-time {
+  margin-top: 8px;
+  font-size: 29px;
+  line-height: 1.1;
+  font-weight: 900;
+  color: #ffffff;
+}
+.site {
+  text-align: right;
+  min-width: 160px;
+}
+.site-name {
+  font-size: 17px;
+  font-weight: 850;
+  color: #ffffff;
+}
+.author {
+  margin-top: 6px;
+  color: #78b7ff;
+  font-size: 14px;
+}
+</style>
+</head>
+<body>
+  <article id="card">
+    <header class="topbar">
+      <div class="brand">
+        <div class="avatar">CS</div>
+        <div>
+          <div class="brand-title">${escapeHtml(config.brandName)}</div>
+          <div class="brand-subtitle">CS2 更新日志工具</div>
+        </div>
+      </div>
+      <div class="category">
+        <div class="category-title">${categoryTag}</div>
+        <div class="category-subtitle">${escapeHtml(categoryName)}</div>
+      </div>
+    </header>
+    <main>
+      <h1 class="headline">${escapeHtml(title)}</h1>
+      <div class="type-label">${escapeHtml(categoryName)}</div>
+      <section class="content">${rendered}</section>
+    </main>
+    <footer class="footer">
+      <div>
+        <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>
+    </footer>
+  </article>
+</body>
+</html>`;
+}
+function findTargetBot(ctx, target) {
+    const bots = Array.from(ctx.bots || []);
+    return bots.find((bot) => {
+        if (target.platform && bot.platform !== target.platform)
+            return false;
+        if (target.selfId && bot.selfId !== target.selfId)
+            return false;
+        return true;
+    });
+}
+function resolveStatePath(ctx, stateFile) {
+    if (node_path_1.default.isAbsolute(stateFile))
+        return stateFile;
+    const baseDir = typeof ctx.baseDir === 'string' ? ctx.baseDir : process.cwd();
+    return node_path_1.default.resolve(baseDir, stateFile);
+}
+function getNewsLink(item) {
+    return item.url || `https://store.steampowered.com/news/app/${APP_ID}/view/${item.gid}`;
+}
+function formatDate(timestamp) {
+    if (!timestamp)
+        return '未知';
+    const date = new Date(timestamp * 1000);
+    const pad = (value) => value.toString().padStart(2, '0');
+    return [
+        date.getFullYear(),
+        '/',
+        pad(date.getMonth() + 1),
+        '/',
+        pad(date.getDate()),
+        ' ',
+        pad(date.getHours()),
+        ':',
+        pad(date.getMinutes()),
+    ].join('');
+}
+function stripMarkdown(input) {
+    return input
+        .replace(/```[\s\S]*?```/g, (block) => block.replace(/```/g, ''))
+        .replace(/`([^`]+)`/g, '$1')
+        .replace(/\*\*([^*]+)\*\*/g, '$1')
+        .replace(/\*([^*]+)\*/g, '$1')
+        .replace(/!\[([^\]]*)\]\([^)]+\)/g, '$1')
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+        .replace(/^#{1,6}\s+/gm, '')
+        .replace(/^>\s?/gm, '')
+        .trim();
+}
+function truncateText(input, maxLength) {
+    if (input.length <= maxLength)
+        return input;
+    return `${input.slice(0, maxLength).trimEnd()}\n...`;
+}
+function decodeHtmlEntities(input) {
+    return input.replace(/&(#x?[0-9a-f]+|[a-z]+);/gi, (entity, code) => {
+        const lower = String(code).toLowerCase();
+        if (lower === 'amp')
+            return '&';
+        if (lower === 'lt')
+            return '<';
+        if (lower === 'gt')
+            return '>';
+        if (lower === 'quot')
+            return '"';
+        if (lower === 'apos')
+            return '\'';
+        if (lower === 'nbsp')
+            return ' ';
+        if (lower.startsWith('#x'))
+            return String.fromCodePoint(Number.parseInt(lower.slice(2), 16));
+        if (lower.startsWith('#'))
+            return String.fromCodePoint(Number.parseInt(lower.slice(1), 10));
+        return entity;
+    });
+}
+function escapeHtml(input) {
+    return String(input)
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+function parseJsonObject(input) {
+    const cleaned = input
+        .replace(/^```(?:json)?\s*/i, '')
+        .replace(/\s*```$/i, '')
+        .trim();
+    try {
+        return JSON.parse(cleaned);
+    }
+    catch {
+        const start = cleaned.indexOf('{');
+        const end = cleaned.lastIndexOf('}');
+        if (start >= 0 && end > start) {
+            return JSON.parse(cleaned.slice(start, end + 1));
+        }
+        throw new Error('translation response is not valid JSON');
+    }
+}
+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);
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "koishi-plugin-cs2-update-log",
+  "version": "1.0.0",
+  "description": "Koishi plugin for monitoring CS2 official Steam announcements and update logs.",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "keywords": [
+    "koishi",
+    "plugin",
+    "cs2",
+    "counter-strike",
+    "steam",
+    "qq"
+  ],
+  "author": "BestBcz",
+  "license": "MIT",
+  "peerDependencies": {
+    "@koishijs/plugin-puppeteer": "^3.2.0",
+    "koishi": "^4.18.0"
+  },
+  "peerDependenciesMeta": {
+    "@koishijs/plugin-puppeteer": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "markdown-it": "^14.1.0"
+  },
+  "devDependencies": {
+    "@koishijs/plugin-puppeteer": "^3.2.0",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^24.0.10",
+    "koishi": "^4.18.8",
+    "typescript": "^5.8.3"
+  },
+  "koishi": {
+    "description": {
+      "zh": "监控 CS2 官方 Steam 公告和更新日志，并推送到指定 QQ 群。",
+      "en": "Monitor official CS2 Steam announcements and update logs."
+    },
+    "service": {
+      "required": [
+        "http"
+      ],
+      "optional": [
+        "puppeteer"
+      ]
+    }
+  }
+}