koishi-plugin-cfmrmod 1.0.2 → 1.0.3

package/dist/cfmr/index.js

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Config = exports.name = void 0;
+exports.drawProjectCard = drawProjectCard;
+exports.drawProjectCardCF = drawProjectCardCF;
+exports.drawProjectCardMRNotify = drawProjectCardMRNotify;
+exports.drawProjectCardCFNotify = drawProjectCardCFNotify;
+exports.fetchModrinthDetail = fetchModrinthDetail;
+exports.fetchCurseForgeDetail = fetchCurseForgeDetail;
 exports.apply = apply;
 const { Schema, h } = require('koishi');
 const fetch = require('node-fetch');
@@ -130,6 +136,14 @@ function formatNumber(num) {
         return `${(n / 1e3).toFixed(1).replace('.0', '')}k`;
     return String(n);
 }
+function formatFileSize(bytes) {
+    const n = Number(bytes) || 0;
+    if (n >= 1024 * 1024)
+        return `${(n / (1024 * 1024)).toFixed(2)} MiB`;
+    if (n >= 1024)
+        return `${(n / 1024).toFixed(2)} KiB`;
+    return `${n} B`;
+}
 function parseCompactNumber(text) {
     if (!text)
         return null;
@@ -157,30 +171,45 @@ function fixUrl(url, base = '') {
 async function loadImageSafe(url, timeout = 15000) {
     if (!url)
         return null;
-    const tryUrls = [url];
-    if (url.includes('.webp')) {
-        tryUrls.push(url.replace('.webp', '.png'));
-        if (!url.includes('format='))
-            tryUrls.push(`${url}${url.includes('?') ? '&' : '?'}format=png`);
-    }
-    let lastErr;
-    for (const u of tryUrls) {
-        try {
-            return await loadImage(u);
-        }
-        catch (e) {
-            lastErr = e;
-        }
-    }
+    // 1. 尝试直接加载 (保留 User-Agent 以防万一，同时检查 res.ok)
     try {
-        const res = await fetchWithTimeout(tryUrls[0], {}, timeout);
+        const res = await fetchWithTimeout(url, {
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36'
+            }
+        }, timeout);
+        // 如果返回 404/403 等非 2xx 状态，直接抛出异常进入 catch
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
         const buf = await res.buffer();
         return await loadImage(buf);
     }
-    catch (e) {
-        lastErr = e;
+    catch (bufferErr) {
+        // 2. 加载失败 (如下载成功但 skia 无法解码 WebP)，尝试备用链接
+        const tryUrls = []; // 清空之前的无效尝试
+        if (url.includes('.webp')) {
+            // 【关键修复】使用 wsrv.nl 代理将 WebP 转换为 PNG
+            tryUrls.push(`https://wsrv.nl/?url=${encodeURIComponent(url)}&output=png`);
+        }
+        else {
+            // 如果不是 webp 结尾，也尝试一下原链接 (应对网络波动)
+            tryUrls.push(url);
+        }
+        let lastErr = bufferErr;
+        for (const u of tryUrls) {
+            try {
+                // 备用链接也应当加 UA
+                // 注意：loadImage(string) 内部通常会自动处理 fetch，但为了稳妥这里利用 skia 的远程加载能力
+                // 或者也可以复用 fetchWithTimeout 下载 buffer，这里简化直接调 loadImage
+                return await loadImage(u);
+            }
+            catch (e) {
+                lastErr = e;
+            }
+        }
+        // 如果都失败了，抛出异常（外部会捕获并绘制灰底）
+        throw lastErr;
     }
-    throw lastErr;
 }
 // 简单的 Markdown 转 HTML 配置
 marked.setOptions({ breaks: true, gfm: true });
@@ -788,7 +817,7 @@ async function drawProjectCard(data) {
     ctx.fillStyle = COLORS.textSec;
     ctx.font = `12px "${font}"`;
     ctx.textAlign = 'center';
-    ctx.fillText('Generated by Koishi | Powered by Modrinth & CurseForge', width / 2, footerY);
+    ctx.fillText('Generated by Koishi | Powered by Modrinth & CurseForge | Plugin By Mai_xiyu', width / 2, footerY);
     footerY += 18;
     // 3. 绘制要求的作者署名
     ctx.fillText('Plugin By Mai_xiyu', width / 2, footerY);
@@ -1182,6 +1211,454 @@ async function drawProjectCardCF(data) {
     }
     return [canvas.toBuffer('image/png')];
 }
+// ================= 更新通知卡片（Modrinth） =================
+// ================= 更新通知卡片（Modrinth 还原版） =================
+async function drawProjectCardMRNotify(data, latest) {
+    const width = 1000;
+    const margin = 30; // 稍微增大边距
+    const gap = 30;
+    const font = GLOBAL_FONT_FAMILY;
+    // Modrinth Dark Theme Colors (参考截图取色)
+    const C_BG = '#131516'; // 整体深色背景 (接近黑色)
+    const C_CARD = '#1a1c1d'; // 左侧内容背景 (稍微亮一点)
+    const C_TEXT_MAIN = '#ffffff'; // 主标题白色
+    const C_TEXT_SEC = '#9ca5b5'; // 次要文本 (Label 颜色)
+    const C_DIVIDER = '#252729'; // 分割线
+    const C_GREEN = '#1bd96a'; // Release Green
+    const C_CHIP_BG = '#2c2d30'; // Version ID 背景
+    const C_LINK = '#3d83f7'; // 链接色(备用)
+    const iconSize = 80;
+    const rightW = 300; // 侧边栏宽度
+    const cardW = width - margin * 2;
+    const leftW = cardW - rightW - gap;
+    // 1. 高度计算
+    const dummyC = createCanvas(100, 100);
+    const dummy = dummyC.getContext('2d');
+    // Header 高度
+    const headerTextW = cardW - iconSize - 24;
+    dummy.font = `800 32px "${font}"`;
+    const titleH = wrapText(dummy, data.name || '', 0, 0, headerTextW, 40, 2, false);
+    const headerH = Math.max(iconSize, titleH + 30) + 20;
+    // Changelog 高度
+    const changelogText = ((latest === null || latest === void 0 ? void 0 : latest.changelog) || '').trim() || 'No changelog provided.';
+    dummy.font = `15px "${font}"`;
+    const changelogBodyH = wrapText(dummy, changelogText, 0, 0, leftW - 48, 26, 30, false);
+    const mainContentH = 60 + changelogBodyH + 40;
+    // 侧边栏高度计算 (Metadata)
+    // 固定项目：Release(50) + Version(50) + Loaders(50) + GameVer(50) + Env(70) + DLs(50) + Date(50) + Pub(70) + ID(60)
+    // 估算大约 550px，如果内容多会自动延伸
+    let sidebarH = 600;
+    const bodyH = Math.max(sidebarH, mainContentH);
+    const totalH = margin + headerH + 20 + bodyH + margin + 30;
+    // 2. 绘制
+    const canvas = createCanvas(width, totalH);
+    const ctx = canvas.getContext('2d');
+    // 背景
+    ctx.fillStyle = C_BG;
+    ctx.fillRect(0, 0, width, totalH);
+    // === Header ===
+    let cy = margin;
+    if (data.icon) {
+        try {
+            const icon = await loadImageSafe(data.icon);
+            ctx.save();
+            roundRect(ctx, margin, cy, iconSize, iconSize, 16);
+            ctx.clip();
+            ctx.drawImage(icon, margin, cy, iconSize, iconSize);
+            ctx.restore();
+        }
+        catch (e) {
+            ctx.fillStyle = C_CARD;
+            roundRect(ctx, margin, cy, iconSize, iconSize, 16);
+            ctx.fill();
+        }
+    }
+    const tx = margin + iconSize + 24;
+    let ty = cy + 5;
+    ctx.fillStyle = C_TEXT_MAIN;
+    ctx.font = `800 32px "${font}"`;
+    ty = wrapText(ctx, data.name || '', tx, ty, headerTextW, 40, 2, true) + 8;
+    ctx.fillStyle = C_TEXT_SEC;
+    ctx.font = `16px "${font}"`;
+    // Header 下方显示简单的 By 信息
+    ctx.fillText(`By ${data.author || 'Unknown'}`, tx, ty);
+    // 分割线
+    cy += headerH + 10;
+    ctx.strokeStyle = C_DIVIDER;
+    ctx.lineWidth = 1;
+    ctx.beginPath();
+    ctx.moveTo(margin, cy);
+    ctx.lineTo(width - margin, cy);
+    ctx.stroke();
+    // === Content Area ===
+    cy += 30;
+    const leftX = margin;
+    const rightX = margin + leftW + gap;
+    // --- Left: Changelog ---
+    ctx.fillStyle = C_CARD;
+    roundRect(ctx, leftX, cy, leftW, bodyH, 12);
+    ctx.fill();
+    ctx.fillStyle = C_TEXT_MAIN;
+    ctx.font = `700 22px "${font}"`;
+    ctx.fillText('Changelog', leftX + 24, cy + 40);
+    ctx.strokeStyle = C_DIVIDER;
+    ctx.beginPath();
+    ctx.moveTo(leftX + 24, cy + 60);
+    ctx.lineTo(leftX + leftW - 24, cy + 60);
+    ctx.stroke();
+    ctx.fillStyle = '#b4b4b4'; // Changelog 文本稍微亮一点的灰
+    ctx.font = `15px "${font}"`;
+    wrapText(ctx, changelogText, leftX + 24, cy + 90, leftW - 48, 26, 30, true);
+    // --- Right: Metadata Sidebar (还原截图风格) ---
+    let ry = cy;
+    // Title
+    ctx.fillStyle = C_TEXT_MAIN;
+    ctx.font = `800 22px "${font}"`;
+    ctx.fillText('Metadata', rightX, ry + 10);
+    ry += 40;
+    // Helper: Draw Section Label
+    const drawLabel = (text) => {
+        ctx.fillStyle = C_TEXT_SEC;
+        ctx.font = `700 14px "${font}"`;
+        ctx.fillText(text, rightX, ry);
+        ry += 24;
+    };
+    // Helper: Draw Value Text
+    const drawValue = (text, color = C_TEXT_MAIN, isBold = false) => {
+        ctx.fillStyle = color;
+        ctx.font = `${isBold ? '700' : '500'} 16px "${font}"`;
+        const h = wrapText(ctx, text, rightX, ry, rightW, 22, 2, true);
+        ry = h + 16; // gap
+    };
+    // 1. Release channel
+    drawLabel('Release channel');
+    // Dot
+    const channelType = (latest === null || latest === void 0 ? void 0 : latest.versionType) === 'beta' ? 'Beta' : ((latest === null || latest === void 0 ? void 0 : latest.versionType) === 'alpha' ? 'Alpha' : 'Release');
+    const channelColor = (latest === null || latest === void 0 ? void 0 : latest.versionType) === 'beta' ? '#4695ee' : ((latest === null || latest === void 0 ? void 0 : latest.versionType) === 'alpha' ? '#f04747' : C_GREEN);
+    ctx.beginPath();
+    ctx.arc(rightX + 6, ry - 6, 5, 0, Math.PI * 2);
+    ctx.fillStyle = channelColor;
+    ctx.fill();
+    ctx.fillStyle = channelColor;
+    ctx.font = `700 16px "${font}"`;
+    ctx.fillText(channelType, rightX + 18, ry);
+    ry += 40;
+    // 2. Version number
+    drawLabel('Version number');
+    drawValue((latest === null || latest === void 0 ? void 0 : latest.version) || (latest === null || latest === void 0 ? void 0 : latest.versionId) || '--');
+    // 3. Loaders (With Icons)
+    drawLabel('Loaders');
+    const loaders = (latest === null || latest === void 0 ? void 0 : latest.loaders) || data.loaders || [];
+    let lx = rightX;
+    // 简易 Tag 图标 Path
+    const tagPath = "M15.5 2H10.5C10.2 2 10 2.1 9.8 2.3L2.3 9.8C1.9 10.2 1.9 10.8 2.3 11.2L6.8 15.7C7.2 16.1 7.8 16.1 8.2 15.7L15.7 8.2C15.9 8 16 7.8 16 7.5V2.5C16 2.2 15.8 2 15.5 2ZM13.5 5C13.2 5 13 4.8 13 4.5C13 4.2 13.2 4 13.5 4C13.8 4 14 4.2 14 4.5C14 4.8 13.8 5 13.5 5Z";
+    if (loaders.length === 0) {
+        drawValue('--');
+    }
+    else {
+        // 模拟 Flex 布局
+        let loaderText = '';
+        loaders.forEach((l, i) => {
+            // 图标
+            ctx.save();
+            ctx.translate(lx, ry - 14);
+            ctx.scale(0.9, 0.9);
+            if (Path2DRef) {
+                const p = new Path2DRef(tagPath);
+                ctx.fillStyle = C_TEXT_SEC;
+                ctx.fill(p);
+            }
+            else {
+                // Fallback circle
+                ctx.beginPath();
+                ctx.arc(8, 8, 4, 0, Math.PI * 2);
+                ctx.fill();
+            }
+            ctx.restore();
+            // 文本
+            ctx.fillStyle = '#b4b4b4';
+            ctx.font = `500 15px "${font}"`;
+            const text = l.charAt(0).toUpperCase() + l.slice(1);
+            ctx.fillText(text, lx + 20, ry);
+            const itemW = 20 + ctx.measureText(text).width + 15;
+            lx += itemW;
+            // 简单的换行处理
+            if (lx > rightX + rightW - 50) {
+                lx = rightX;
+                ry += 24;
+            }
+        });
+        ry += 40;
+    }
+    // 4. Game versions
+    drawLabel('Game versions');
+    const gv = ((latest === null || latest === void 0 ? void 0 : latest.gameVersions) || data.gameVersions || []).slice(0, 4).join(', ');
+    drawValue(gv || 'All');
+    // 5. Environment
+    drawLabel('Environment');
+    let envText = 'Client and server';
+    if (data.clientSide === 'unsupported')
+        envText = 'Server only';
+    else if (data.serverSide === 'unsupported')
+        envText = 'Client only';
+    else if (data.clientSide === 'required' && data.serverSide === 'required')
+        envText = 'Client and server, required on both';
+    drawValue(envText);
+    // 6. Downloads
+    drawLabel('Downloads');
+    drawValue(formatNumber((latest === null || latest === void 0 ? void 0 : latest.downloads) || 0));
+    // 7. Publication date
+    drawLabel('Publication date');
+    const dateStr = (latest === null || latest === void 0 ? void 0 : latest.datePublished)
+        ? new Date(latest.datePublished).toLocaleString('en-US', { dateStyle: 'long', timeStyle: 'short' })
+        : '--';
+    drawValue(dateStr);
+    // 8. Publisher (Avatar + Name)
+    drawLabel('Publisher');
+    const authorName = data.author || 'Unknown';
+    const memberRole = 'Member'; // 默认写 Member，API 没返回具体 Role
+    // Avatar
+    const avatarR = 20;
+    ctx.save();
+    ctx.beginPath();
+    ctx.arc(rightX + avatarR, ry + avatarR - 10, avatarR, 0, Math.PI * 2);
+    ctx.fillStyle = C_CHIP_BG;
+    ctx.fill();
+    ctx.clip();
+    if (data.authorIcon) {
+        try {
+            const authorImg = await loadImageSafe(data.authorIcon);
+            ctx.drawImage(authorImg, rightX, ry - 10, avatarR * 2, avatarR * 2);
+        }
+        catch (e) { }
+    }
+    else {
+        // Draw Initials
+        ctx.fillStyle = C_TEXT_SEC;
+        ctx.textAlign = 'center';
+        ctx.textBaseline = 'middle';
+        ctx.font = `bold 16px "${font}"`;
+        ctx.fillText(authorName.charAt(0).toUpperCase(), rightX + avatarR, ry + avatarR - 10);
+    }
+    ctx.restore();
+    // Name & Role
+    ctx.textAlign = 'left';
+    ctx.textBaseline = 'top';
+    ctx.fillStyle = C_TEXT_MAIN;
+    ctx.font = `700 15px "${font}"`;
+    ctx.fillText(authorName, rightX + 50, ry - 5);
+    ctx.fillStyle = C_TEXT_SEC;
+    ctx.font = `13px "${font}"`;
+    ctx.fillText(memberRole, rightX + 50, ry + 15);
+    ry += 60;
+    // 9. Version ID (Chip)
+    drawLabel('Version ID');
+    const verId = (latest === null || latest === void 0 ? void 0 : latest.versionId) || '-------';
+    const chipPadding = 10;
+    ctx.font = `14px "${font}"`; // Monospace ideally, but sans is fine
+    const idW = ctx.measureText(verId).width + 30; // + space for icon
+    ctx.fillStyle = C_CHIP_BG;
+    roundRect(ctx, rightX, ry - 5, idW + chipPadding * 2, 32, 8);
+    ctx.fill();
+    ctx.fillStyle = '#b4b4b4';
+    ctx.fillText(verId, rightX + chipPadding, ry + 5);
+    // Copy Icon (simulated)
+    const iconX = rightX + chipPadding + ctx.measureText(verId).width + 10;
+    ctx.strokeStyle = '#b4b4b4';
+    ctx.lineWidth = 1.5;
+    ctx.strokeRect(iconX, ry + 4, 10, 12);
+    ctx.fillStyle = '#b4b4b4';
+    ctx.fillRect(iconX + 3, ry + 2, 8, 2); // top bit
+    ry += 50;
+    // Footer
+    ctx.fillStyle = C_TEXT_SEC;
+    ctx.font = `12px "${font}"`;
+    ctx.textAlign = 'center';
+    ctx.fillText('Powered by Modrinth | Generated by Koishi | Plugin By Mai_xiyu', width / 2, totalH - 15);
+    return [canvas.toBuffer('image/png')];
+}
+// ================= 更新通知卡片（CurseForge） =================
+async function drawProjectCardCFNotify(data, latest) {
+    const width = 1000;
+    const margin = 24;
+    const gap = 24;
+    const font = GLOBAL_FONT_FAMILY;
+    // CF Colors
+    const C_BG = '#141414';
+    const C_PANEL = '#1d1d1d';
+    const C_TEXT = '#dee2e6';
+    const C_TEXT_SEC = '#adb5bd';
+    const C_ACCENT = '#f16436';
+    const C_DIVIDER = '#2d2d2d';
+    const iconSize = 80;
+    const rightW = 320; // 加宽右侧
+    const cardW = width - margin * 2;
+    const leftW = cardW - rightW - gap;
+    const dummyC = createCanvas(100, 100);
+    const dummy = dummyC.getContext('2d');
+    // --- 辅助：映射 Release Type ---
+    const getReleaseTypeStr = (type) => {
+        if (type === 1)
+            return 'Release';
+        if (type === 2)
+            return 'Beta';
+        if (type === 3)
+            return 'Alpha';
+        return String(type || 'Unknown');
+    };
+    const releaseTypeStr = getReleaseTypeStr(latest === null || latest === void 0 ? void 0 : latest.releaseType);
+    // --- 1. 高度计算 ---
+    const headerTextW = cardW - iconSize - 24;
+    // Header: 标题自适应
+    let titleFontSize = 32;
+    dummy.font = `bold ${titleFontSize}px "${font}"`;
+    while (dummy.measureText(data.name || '').width > headerTextW && titleFontSize > 22) {
+        titleFontSize -= 2;
+        dummy.font = `bold ${titleFontSize}px "${font}"`;
+    }
+    const titleH = wrapText(dummy, data.name || '', 0, 0, headerTextW, titleFontSize * 1.3, 2, false);
+    dummy.font = `16px "${font}"`;
+    const summaryH = wrapText(dummy, (data.summary || '').slice(0, 200), 0, 0, headerTextW, 24, 3, false);
+    const headerH = Math.max(iconSize, titleH + summaryH + 15) + 20;
+    // Sidebar Metadata
+    const metaLines = [
+        { l: 'New Version', v: (latest === null || latest === void 0 ? void 0 : latest.version) || '--', hl: true }, // Highlight
+        { l: 'Downloads', v: formatNumber(latest === null || latest === void 0 ? void 0 : latest.downloads) },
+        { l: 'Game Ver', v: ((latest === null || latest === void 0 ? void 0 : latest.gameVersions) || data.gameVersions || []).slice(0, 5).join(', ') || '--' },
+        { l: 'Loaders', v: ((latest === null || latest === void 0 ? void 0 : latest.loaders) || data.loaders || []).slice(0, 4).join(', ') || '--' },
+        { l: 'Updated', v: (latest === null || latest === void 0 ? void 0 : latest.datePublished) ? new Date(latest.datePublished).toLocaleDateString() : '--' },
+        { l: 'Release Type', v: releaseTypeStr },
+        { l: 'File', v: (latest === null || latest === void 0 ? void 0 : latest.fileName) || '--' },
+        { l: 'Size', v: formatFileSize(latest === null || latest === void 0 ? void 0 : latest.fileSize) },
+        { l: 'Author', v: data.author || '--' },
+    ];
+    // 计算 Sidebar 高度 (支持换行)
+    let metaH = 60; // Title padding
+    dummy.font = `15px "${font}"`;
+    metaLines.forEach(item => {
+        metaH += 20; // Label
+        const valLines = wrapText(dummy, item.v, 0, 0, rightW - 40, 24, 5, false) / 24;
+        metaH += valLines * 24 + 10; // Value + padding
+        metaH += 10; // Divider
+    });
+    // Changelog Height
+    const changelogText = ((latest === null || latest === void 0 ? void 0 : latest.changelog) || '').trim() || 'No changelog provided.';
+    dummy.font = `15px "${font}"`;
+    const changelogBodyH = wrapText(dummy, changelogText, 0, 0, leftW - 48, 26, 60, false);
+    const contentH = 60 + changelogBodyH + 40;
+    const bodyH = Math.max(metaH, contentH, 300);
+    const totalH = margin + headerH + 20 + bodyH + margin + 30;
+    // --- 2. 绘制 ---
+    const canvas = createCanvas(width, totalH);
+    const ctx = canvas.getContext('2d');
+    ctx.fillStyle = C_BG;
+    ctx.fillRect(0, 0, width, totalH);
+    // === Header ===
+    let cy = margin;
+    if (data.icon) {
+        try {
+            const icon = await loadImageSafe(data.icon);
+            ctx.save();
+            ctx.shadowColor = 'rgba(0,0,0,0.5)';
+            ctx.shadowBlur = 10;
+            roundRect(ctx, margin, cy, iconSize, iconSize, 8);
+            ctx.fill();
+            ctx.shadowColor = 'transparent';
+            roundRect(ctx, margin, cy, iconSize, iconSize, 8);
+            ctx.clip();
+            ctx.drawImage(icon, margin, cy, iconSize, iconSize);
+            ctx.restore();
+        }
+        catch (e) {
+            ctx.fillStyle = '#333';
+            roundRect(ctx, margin, cy, iconSize, iconSize, 8);
+            ctx.fill();
+        }
+    }
+    const tx = margin + iconSize + 24;
+    let ty = cy + 5;
+    ctx.fillStyle = C_TEXT;
+    ctx.font = `bold ${titleFontSize}px "${font}"`;
+    ty = wrapText(ctx, data.name || '', tx, ty, headerTextW, titleFontSize * 1.3, 2, true) + 8;
+    ctx.fillStyle = C_TEXT_SEC;
+    ctx.font = `16px "${font}"`;
+    wrapText(ctx, `By ${data.author || 'Unknown'}`, tx, ty, headerTextW, 24, 1, true);
+    // Orange Tab Indicator
+    cy += headerH + 10;
+    ctx.fillStyle = C_ACCENT;
+    ctx.fillRect(margin, cy, 100, 4); // 稍微长一点的指示条
+    ctx.fillStyle = C_DIVIDER;
+    ctx.fillRect(margin + 100, cy, width - margin * 2 - 100, 4);
+    // === Body ===
+    cy += 24;
+    const leftX = margin;
+    const rightX = margin + leftW + gap;
+    // -- 左侧：Changelog --
+    ctx.fillStyle = C_PANEL;
+    roundRect(ctx, leftX, cy, leftW, bodyH, 8);
+    ctx.fill();
+    ctx.fillStyle = C_TEXT;
+    ctx.font = `bold 22px "${font}"`;
+    ctx.fillText('What\'s New', leftX + 24, cy + 40);
+    ctx.fillStyle = C_DIVIDER;
+    ctx.fillRect(leftX + 24, cy + 60, leftW - 48, 2);
+    ctx.fillStyle = '#ced4da';
+    ctx.font = `15px "${font}"`;
+    wrapText(ctx, changelogText, leftX + 24, cy + 85, leftW - 48, 26, 60, true);
+    // -- 右侧：Sidebar --
+    ctx.fillStyle = C_PANEL;
+    roundRect(ctx, rightX, cy, rightW, bodyH, 8);
+    ctx.fill();
+    let ry = cy + 40;
+    const maxRy = cy + bodyH - 20;
+    ctx.fillStyle = C_TEXT;
+    ctx.font = `bold 18px "${font}"`;
+    ctx.fillText('File Details', rightX + 20, ry);
+    ry += 20;
+    metaLines.forEach(item => {
+        if (ry + 40 > maxRy) {
+            ctx.fillStyle = C_TEXT_SEC;
+            ctx.font = `12px "${font}"`;
+            ctx.fillText('...', rightX + 20, maxRy - 6);
+            return;
+        }
+        ry += 15;
+        // Label
+        ctx.fillStyle = C_TEXT_SEC;
+        ctx.font = `13px "${font}"`;
+        ctx.fillText(item.l, rightX + 20, ry);
+        // Value (支持换行)
+        ry += 22;
+        ctx.font = `15px "${font}"`;
+        // 特殊颜色处理
+        if (item.hl)
+            ctx.fillStyle = C_ACCENT;
+        else if (item.l === 'Release Type') {
+            if (item.v === 'Release')
+                ctx.fillStyle = '#1bd96a'; // Green
+            else if (item.v === 'Beta')
+                ctx.fillStyle = '#a020f0'; // Purple
+            else
+                ctx.fillStyle = C_TEXT;
+        }
+        else {
+            ctx.fillStyle = C_TEXT;
+        }
+        // 自动换行绘制
+        const nextY = wrapText(ctx, item.v, rightX + 20, ry, rightW - 40, 24, 5, true);
+        ry = nextY + 10;
+        if (ry + 6 > maxRy)
+            return;
+        ctx.fillStyle = 'rgba(255,255,255,0.05)';
+        ctx.fillRect(rightX + 20, ry, rightW - 40, 1);
+    });
+    // Footer
+    ctx.fillStyle = C_TEXT_SEC;
+    ctx.font = `12px "${font}"`;
+    ctx.textAlign = 'center';
+    ctx.fillText('Powered by CurseForge | Generated by Koishi | Plugin By Mai_xiyu', width / 2, totalH - 15);
+    return [canvas.toBuffer('image/png')];
+}
 // ================= API 交互 =================
 async function fetchModrinthDetail(id, timeout) {
     var _a, _b, _c, _d, _e, _f;
@@ -1241,7 +1718,7 @@ async function fetchModrinthDetail(id, timeout) {
         id: project.id,
         name: project.title,
         author,
-        icon: (pageInfo === null || pageInfo === void 0 ? void 0 : pageInfo.icon) || project.icon_url,
+        icon: project.icon_url || (pageInfo === null || pageInfo === void 0 ? void 0 : pageInfo.icon),
         summary: project.description,
         body,
         bodyIsHtml,

package/dist/index.js

@@ -38,14 +38,30 @@ exports.apply = apply;
 const koishi_1 = require("koishi");
 const cfmr = __importStar(require("./plugins/cfmr"));
 const mcmod = __importStar(require("./plugins/mcmod"));
+const notify = __importStar(require("./notify"));
 exports.name = 'minecraft-search';
-exports.inject = ['skia'];
+exports.inject = ['skia', 'database'];
 exports.Config = koishi_1.Schema.object({
     prefixes: koishi_1.Schema.object({
         cf: koishi_1.Schema.string().default('cf'),
         mr: koishi_1.Schema.string().default('mr'),
         cnmc: koishi_1.Schema.string().default('cnmc'),
     }).description('指令前缀设置'),
+    notify: koishi_1.Schema.object({
+        enabled: koishi_1.Schema.boolean().default(false).description('是否开启模组更新通知'),
+        interval: koishi_1.Schema.number().default(30 * 60 * 1000).description('轮询间隔(ms)，默认 30 分钟'),
+        adminAuthority: koishi_1.Schema.number().default(3).description('机器人管理员权限等级(默认 3)'),
+        stateFile: koishi_1.Schema.string().default('data/cfmrmod_notify_state.json').description('状态存储 JSON 路径（数据库不可用时使用）'),
+        groups: koishi_1.Schema.array(koishi_1.Schema.object({
+            channelId: koishi_1.Schema.string().description('群号/频道 ID'),
+            enabled: koishi_1.Schema.boolean().default(true).description('是否启用本群通知'),
+            subs: koishi_1.Schema.array(koishi_1.Schema.object({
+                platform: koishi_1.Schema.union(['mr', 'cf']).description('平台：mr/cf'),
+                projectId: koishi_1.Schema.string().description('项目 ID'),
+                interval: koishi_1.Schema.number().default(30 * 60 * 1000).description('单独轮询间隔(ms)，默认 30 分钟，<= 0 禁用该订阅'),
+            })).role('table').default([]).description('订阅列表'),
+        })).role('table').default([]).description('通知群与订阅列表'),
+    }).description('—— 更新通知 ——'),
     timeouts: koishi_1.Schema.number().default(60000).description('搜索会话超时时间(ms)'),
     debug: koishi_1.Schema.boolean().default(false).description('开启调试日志'),
     cfmr: cfmr.Config.description('CurseForge/Modrinth 搜索与图片卡片'),
@@ -62,4 +78,6 @@ function apply(ctx, config) {
         cfmr.apply(ctx, { ...((config === null || config === void 0 ? void 0 : config.cfmr) || {}), ...shared });
     if (mcmod.apply)
         mcmod.apply(ctx, { ...((config === null || config === void 0 ? void 0 : config.mcmod) || {}), ...shared });
+    if (notify.apply)
+        notify.apply(ctx, (config === null || config === void 0 ? void 0 : config.notify) || {}, { cfmr: (config === null || config === void 0 ? void 0 : config.cfmr) || {} });
 }

package/dist/notify.js

@@ -0,0 +1,529 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apply = apply;
+const koishi_1 = require("koishi");
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const cfmr_1 = require("./cfmr");
+const fetch = require('node-fetch');
+const MR_BASE = 'https://api.modrinth.com/v2';
+const CF_MIRROR_BASE = 'https://api.curse.tools/v1/cf';
+function normalizePlatform(platform) {
+    if (platform === 'mr' || platform === 'cf')
+        return platform;
+    return null;
+}
+async function toImageSrc(input) {
+    const value = (input && typeof input.then === 'function') ? await input : input;
+    if (!value)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    const buf = Buffer.isBuffer(value) ? value : (value instanceof Uint8Array ? Buffer.from(value) : null);
+    if (buf)
+        return `data:image/png;base64,${buf.toString('base64')}`;
+    return String(value);
+}
+async function fetchJson(url, timeout = 15000) {
+    const controller = new AbortController();
+    const id = setTimeout(() => controller.abort(), timeout);
+    try {
+        const res = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0', 'Accept': 'application/json' }, signal: controller.signal });
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        return await res.json();
+    }
+    finally {
+        clearTimeout(id);
+    }
+}
+function apply(ctx, config, options) {
+    const logger = ctx.logger('cfmr-notify');
+    ctx.model.extend('cfmrmod_notify_sub', {
+        id: 'unsigned',
+        channelId: 'string',
+        platform: 'string',
+        projectId: 'string',
+        lastVersion: 'string',
+        lastNotifiedAt: 'timestamp',
+    }, { primary: 'id', autoInc: true });
+    const getRoleLevel = (session) => {
+        var _a, _b, _c, _d, _e;
+        const roles = new Set();
+        const list = (_a = session === null || session === void 0 ? void 0 : session.member) === null || _a === void 0 ? void 0 : _a.roles;
+        if (Array.isArray(list)) {
+            list.forEach((r) => {
+                if (typeof r === 'string')
+                    roles.add(r);
+                else if (r && typeof r === 'object') {
+                    if (typeof r.id === 'string')
+                        roles.add(r.id);
+                    if (typeof r.name === 'string')
+                        roles.add(r.name);
+                }
+            });
+        }
+        const role = (_b = session === null || session === void 0 ? void 0 : session.member) === null || _b === void 0 ? void 0 : _b.role;
+        if (typeof role === 'string')
+            roles.add(role);
+        const onebotRole = (_d = (_c = session === null || session === void 0 ? void 0 : session.event) === null || _c === void 0 ? void 0 : _c.sender) === null || _d === void 0 ? void 0 : _d.role;
+        if (typeof onebotRole === 'string')
+            roles.add(onebotRole);
+        const eventMember = (_e = session === null || session === void 0 ? void 0 : session.event) === null || _e === void 0 ? void 0 : _e.member;
+        if ((eventMember === null || eventMember === void 0 ? void 0 : eventMember.role) && typeof eventMember.role === 'string')
+            roles.add(eventMember.role);
+        if (Array.isArray(eventMember === null || eventMember === void 0 ? void 0 : eventMember.roles)) {
+            eventMember.roles.forEach((r) => {
+                if (typeof r === 'string')
+                    roles.add(r);
+                else if (r && typeof r === 'object') {
+                    if (typeof r.id === 'string')
+                        roles.add(r.id);
+                    if (typeof r.name === 'string')
+                        roles.add(r.name);
+                }
+            });
+        }
+        if (roles.has('owner'))
+            return 3;
+        if (roles.has('admin'))
+            return 2;
+        if (roles.has('member'))
+            return 1;
+        return 0;
+    };
+    const isOwner = (session) => getRoleLevel(session) >= 3;
+    const isAdmin = (session) => getRoleLevel(session) >= 2;
+    const getRoleLevelAsync = async (session) => {
+        let level = getRoleLevel(session);
+        if (level > 0)
+            return level;
+        const bot = session === null || session === void 0 ? void 0 : session.bot;
+        if ((bot === null || bot === void 0 ? void 0 : bot.getGuildMember) && (session === null || session === void 0 ? void 0 : session.guildId) && (session === null || session === void 0 ? void 0 : session.userId)) {
+            try {
+                const member = await bot.getGuildMember(session.guildId, session.userId);
+                const roles = new Set();
+                if ((member === null || member === void 0 ? void 0 : member.role) && typeof member.role === 'string')
+                    roles.add(member.role);
+                if (Array.isArray(member === null || member === void 0 ? void 0 : member.roles)) {
+                    member.roles.forEach((r) => {
+                        if (typeof r === 'string')
+                            roles.add(r);
+                        else if (r && typeof r === 'object') {
+                            if (typeof r.id === 'string')
+                                roles.add(r.id);
+                            if (typeof r.name === 'string')
+                                roles.add(r.name);
+                        }
+                    });
+                }
+                if (roles.has('owner'))
+                    level = 3;
+                else if (roles.has('admin'))
+                    level = 2;
+                else if (roles.has('member'))
+                    level = 1;
+            }
+            catch { }
+        }
+        return level;
+    };
+    const requireManage = async (session, channelId) => {
+        var _a, _b, _c, _d, _e;
+        const level = Number((_a = config.adminAuthority) !== null && _a !== void 0 ? _a : 3);
+        if (level <= 1)
+            return true;
+        if (channelId && channelId !== session.channelId)
+            return false;
+        const roleLevel = await getRoleLevelAsync(session);
+        if (level <= 2)
+            return roleLevel >= 2;
+        const ok = roleLevel >= 3;
+        if (!ok) {
+            logger.info(`权限不足调试：level=${level}, role=${(_b = session === null || session === void 0 ? void 0 : session.member) === null || _b === void 0 ? void 0 : _b.role}, roles=${JSON.stringify((_c = session === null || session === void 0 ? void 0 : session.member) === null || _c === void 0 ? void 0 : _c.roles)}, onebotRole=${(_e = (_d = session === null || session === void 0 ? void 0 : session.event) === null || _d === void 0 ? void 0 : _d.sender) === null || _e === void 0 ? void 0 : _e.role}`);
+        }
+        return ok;
+    };
+    const parseChannelId = (channelId) => {
+        const idx = channelId.indexOf(':');
+        if (idx <= 0)
+            return null;
+        return { platform: channelId.slice(0, idx), id: channelId.slice(idx + 1) };
+    };
+    const sendToChannel = async (channelId, content) => {
+        const parsed = parseChannelId(channelId);
+        if (parsed) {
+            const bot = ctx.bots.find(b => b.platform === parsed.platform);
+            if (bot) {
+                await bot.sendMessage(parsed.id, content);
+                return true;
+            }
+        }
+        if (ctx.bots.length === 1) {
+            await ctx.bots[0].sendMessage(channelId, content);
+            return true;
+        }
+        if (ctx.bots.length) {
+            for (const bot of ctx.bots) {
+                try {
+                    await bot.sendMessage(channelId, content);
+                    return true;
+                }
+                catch { }
+            }
+        }
+        logger.warn(`无法发送到频道 ${channelId}，请使用 platform:channelId 格式。`);
+        return false;
+    };
+    const lastCheckMap = new Map();
+    const stateCache = new Map();
+    let stateLoaded = false;
+    let saving = false;
+    let dbWarned = false;
+    const getStateKey = (channelId, platform, projectId) => {
+        return `${channelId}|${platform}|${projectId}`;
+    };
+    const resolveStateFile = () => {
+        const p = String(config.stateFile || 'data/cfmrmod_notify_state.json');
+        return path_1.default.isAbsolute(p) ? p : path_1.default.resolve(process.cwd(), p);
+    };
+    const loadStateFromFile = async () => {
+        if (stateLoaded)
+            return;
+        stateLoaded = true;
+        try {
+            const filePath = resolveStateFile();
+            const content = await fs_1.promises.readFile(filePath, 'utf8');
+            const json = JSON.parse(content);
+            if (json && typeof json === 'object') {
+                Object.keys(json).forEach(key => {
+                    const val = json[key];
+                    if (val && typeof val === 'object')
+                        stateCache.set(key, { lastVersion: val.lastVersion });
+                });
+            }
+        }
+        catch { }
+    };
+    const saveStateToFile = async () => {
+        if (saving)
+            return;
+        saving = true;
+        try {
+            const filePath = resolveStateFile();
+            await fs_1.promises.mkdir(path_1.default.dirname(filePath), { recursive: true });
+            const obj = {};
+            for (const [key, val] of stateCache.entries())
+                obj[key] = { lastVersion: val.lastVersion };
+            await fs_1.promises.writeFile(filePath, JSON.stringify(obj, null, 2), 'utf8');
+        }
+        catch (e) {
+            logger.warn(`状态文件写入失败：${e.message}`);
+        }
+        finally {
+            saving = false;
+        }
+    };
+    const getState = async (channelId, platform, projectId) => {
+        await loadStateFromFile();
+        const key = getStateKey(channelId, platform, projectId);
+        return stateCache.get(key) || null;
+    };
+    const createState = async (channelId, platform, projectId, lastVersion) => {
+        await loadStateFromFile();
+        const key = getStateKey(channelId, platform, projectId);
+        stateCache.set(key, { lastVersion });
+        await saveStateToFile();
+    };
+    const updateState = async (channelId, platform, projectId, lastVersion) => {
+        await loadStateFromFile();
+        const key = getStateKey(channelId, platform, projectId);
+        stateCache.set(key, { lastVersion });
+        await saveStateToFile();
+    };
+    const getConfigGroups = () => Array.isArray(config.groups) ? config.groups : [];
+    const getConfigSubs = (channelId) => {
+        const groups = getConfigGroups();
+        const subs = [];
+        for (const group of groups) {
+            if (!(group === null || group === void 0 ? void 0 : group.channelId))
+                continue;
+            if (channelId && group.channelId !== channelId)
+                continue;
+            if (group.enabled === false)
+                continue;
+            const list = Array.isArray(group.subs) ? group.subs : [];
+            for (const sub of list) {
+                const platformKey = normalizePlatform(sub === null || sub === void 0 ? void 0 : sub.platform);
+                const projectId = String((sub === null || sub === void 0 ? void 0 : sub.projectId) || '').trim();
+                if (!platformKey || !projectId)
+                    continue;
+                const rawInterval = Number(sub === null || sub === void 0 ? void 0 : sub.interval);
+                if (Number.isFinite(rawInterval) && rawInterval <= 0)
+                    continue;
+                const interval = Math.max(60 * 1000, rawInterval || Number(config.interval) || 30 * 60 * 1000);
+                subs.push({ channelId: String(group.channelId), platform: platformKey, projectId, interval });
+            }
+        }
+        return subs;
+    };
+    const getConfigSubsOrdered = (channelId) => {
+        const groups = getConfigGroups();
+        const subs = [];
+        for (const group of groups) {
+            if (!(group === null || group === void 0 ? void 0 : group.channelId))
+                continue;
+            if (channelId && group.channelId !== channelId)
+                continue;
+            if (group.enabled === false)
+                continue;
+            const list = Array.isArray(group.subs) ? group.subs : [];
+            for (const sub of list) {
+                const platformKey = normalizePlatform(sub === null || sub === void 0 ? void 0 : sub.platform);
+                const projectId = String((sub === null || sub === void 0 ? void 0 : sub.projectId) || '').trim();
+                if (!platformKey || !projectId)
+                    continue;
+                const rawInterval = Number(sub === null || sub === void 0 ? void 0 : sub.interval);
+                if (Number.isFinite(rawInterval) && rawInterval <= 0)
+                    continue;
+                const interval = Math.max(60 * 1000, rawInterval || Number(config.interval) || 30 * 60 * 1000);
+                subs.push({ channelId: String(group.channelId), platform: platformKey, projectId, interval });
+            }
+        }
+        return subs;
+    };
+    async function getLatestModrinth(projectId, timeout) {
+        const versions = await fetchJson(`${MR_BASE}/project/${projectId}/version`, timeout);
+        const latest = Array.isArray(versions) ? versions[0] : null;
+        if (!latest)
+            return null;
+        const file = Array.isArray(latest.files) && latest.files.length ? latest.files[0] : null;
+        return {
+            versionId: latest.id,
+            version: latest.version_number || latest.name || latest.id,
+            changelog: latest.changelog || '',
+            downloads: latest.downloads,
+            datePublished: latest.date_published,
+            versionType: latest.version_type,
+            loaders: Array.isArray(latest.loaders) ? latest.loaders.map(String) : [],
+            gameVersions: Array.isArray(latest.game_versions) ? latest.game_versions.map(String) : [],
+            fileName: (file === null || file === void 0 ? void 0 : file.filename) || '',
+            fileSize: (file === null || file === void 0 ? void 0 : file.size) || 0,
+        };
+    }
+    async function getLatestCurseForge(projectId, timeout) {
+        var _a;
+        const files = await fetchJson(`${CF_MIRROR_BASE}/mods/${projectId}/files?index=0&pageSize=1`, timeout);
+        const latest = (_a = files === null || files === void 0 ? void 0 : files.data) === null || _a === void 0 ? void 0 : _a[0];
+        if (!latest)
+            return null;
+        return {
+            versionId: String(latest.id),
+            version: latest.displayName || latest.fileName || String(latest.id),
+            changelog: latest.changelog || '',
+            downloads: latest.downloadCount,
+            datePublished: latest.fileDate || null,
+            releaseType: latest.releaseType,
+            loaders: Array.isArray(latest.gameVersions) ? latest.gameVersions.filter((v) => /forge|fabric|quilt|neoforge/i.test(String(v))) : [],
+            gameVersions: Array.isArray(latest.gameVersions) ? latest.gameVersions.filter((v) => /\d/.test(String(v))) : [],
+            fileName: latest.fileName || '',
+            fileSize: latest.fileLength || 0,
+        };
+    }
+    async function sendUpdate(channelId, platform, projectId, latest) {
+        var _a, _b, _c;
+        try {
+            let detailData;
+            if (platform === 'mr')
+                detailData = await (0, cfmr_1.fetchModrinthDetail)(projectId, ((_a = options === null || options === void 0 ? void 0 : options.cfmr) === null || _a === void 0 ? void 0 : _a.requestTimeout) || 15000);
+            else
+                detailData = await (0, cfmr_1.fetchCurseForgeDetail)(projectId, (_b = options === null || options === void 0 ? void 0 : options.cfmr) === null || _b === void 0 ? void 0 : _b.curseforgeApiKey, ((_c = options === null || options === void 0 ? void 0 : options.cfmr) === null || _c === void 0 ? void 0 : _c.requestTimeout) || 15000, null);
+            detailData.type = 'mod';
+            const imgBufs = detailData.source === 'CurseForge'
+                ? await (0, cfmr_1.drawProjectCardCFNotify)({ ...detailData }, latest)
+                : await (0, cfmr_1.drawProjectCardMRNotify)({ ...detailData }, latest);
+            for (const buf of imgBufs) {
+                const src = await toImageSrc(buf);
+                await sendToChannel(channelId, koishi_1.h.image(src));
+            }
+            // 仅发送卡片，不发送文字
+        }
+        catch (e) {
+            logger.warn(`发送通知失败(${platform}:${projectId}): ${e.message}`);
+        }
+    }
+    async function checkOnce(channelId, force = false) {
+        var _a;
+        if (!config.enabled)
+            return;
+        const subs = getConfigSubs(channelId);
+        const stats = { checked: 0, updated: 0, noChange: 0, skipped: 0, failed: 0 };
+        for (const sub of subs) {
+            try {
+                const key = `${sub.channelId}|${sub.platform}|${sub.projectId}`;
+                const lastCheck = lastCheckMap.get(key) || 0;
+                if (!force && Date.now() - lastCheck < sub.interval) {
+                    stats.skipped += 1;
+                    continue;
+                }
+                lastCheckMap.set(key, Date.now());
+                stats.checked += 1;
+                const timeout = ((_a = options === null || options === void 0 ? void 0 : options.cfmr) === null || _a === void 0 ? void 0 : _a.requestTimeout) || 15000;
+                const latest = sub.platform === 'mr'
+                    ? await getLatestModrinth(sub.projectId, timeout)
+                    : await getLatestCurseForge(sub.projectId, timeout);
+                if (!latest) {
+                    stats.failed += 1;
+                    continue;
+                }
+                const state = await getState(sub.channelId, sub.platform, sub.projectId);
+                if (!state) {
+                    await createState(sub.channelId, sub.platform, sub.projectId, latest.version || '');
+                    stats.noChange += 1;
+                    continue;
+                }
+                if (!state.lastVersion) {
+                    await updateState(sub.channelId, sub.platform, sub.projectId, latest.version);
+                    stats.noChange += 1;
+                    continue;
+                }
+                if (latest.version === state.lastVersion) {
+                    stats.noChange += 1;
+                    continue;
+                }
+                await sendUpdate(sub.channelId, sub.platform, sub.projectId, latest);
+                await updateState(sub.channelId, sub.platform, sub.projectId, latest.version);
+                stats.updated += 1;
+            }
+            catch (e) {
+                logger.warn(`检查失败(${sub.platform}:${sub.projectId}): ${e.message}`);
+                stats.failed += 1;
+            }
+        }
+        return stats;
+    }
+    const checkOne = async (sub, forceSendAll) => {
+        var _a;
+        const timeout = ((_a = options === null || options === void 0 ? void 0 : options.cfmr) === null || _a === void 0 ? void 0 : _a.requestTimeout) || 15000;
+        const latest = sub.platform === 'mr'
+            ? await getLatestModrinth(sub.projectId, timeout)
+            : await getLatestCurseForge(sub.projectId, timeout);
+        if (!latest)
+            return { sent: false, updated: false };
+        const state = await getState(sub.channelId, sub.platform, sub.projectId);
+        if (!state) {
+            await createState(sub.channelId, sub.platform, sub.projectId, latest.version || '');
+            if (forceSendAll) {
+                await sendUpdate(sub.channelId, sub.platform, sub.projectId, latest);
+                await updateState(sub.channelId, sub.platform, sub.projectId, latest.version || '');
+                return { sent: true, updated: true };
+            }
+            return { sent: false, updated: false };
+        }
+        if (forceSendAll) {
+            await sendUpdate(sub.channelId, sub.platform, sub.projectId, latest);
+            await updateState(sub.channelId, sub.platform, sub.projectId, latest.version || '');
+            return { sent: true, updated: true };
+        }
+        if (!state.lastVersion) {
+            await updateState(sub.channelId, sub.platform, sub.projectId, latest.version || '');
+            return { sent: false, updated: false };
+        }
+        if (latest.version === state.lastVersion)
+            return { sent: false, updated: false };
+        await sendUpdate(sub.channelId, sub.platform, sub.projectId, latest);
+        await updateState(sub.channelId, sub.platform, sub.projectId, latest.version || '');
+        return { sent: true, updated: true };
+    };
+    if (config.enabled) {
+        const tick = Math.max(60 * 1000, Number(config.interval) || 30 * 60 * 1000);
+        ctx.setInterval(() => checkOnce().catch(() => null), tick);
+    }
+    ctx.command('notify.add <platform> <projectId> [channelId]', '添加更新订阅')
+        .action(async ({ session }, platform, projectId, channelId) => {
+        if (!platform || !projectId)
+            return '参数不足。';
+        const targetChannel = channelId || session.channelId;
+        if (!targetChannel)
+            return '只能在群聊使用或指定 channelId。';
+        if (!await requireManage(session, channelId))
+            return '权限不足。';
+        return '请在配置页面的 notify.groups 中编辑订阅列表。';
+    });
+    ctx.command('notify.remove <platform> <projectId> [channelId]', '删除更新订阅')
+        .action(async ({ session }, platform, projectId, channelId) => {
+        if (!platform || !projectId)
+            return '参数不足。';
+        const targetChannel = channelId || session.channelId;
+        if (!targetChannel)
+            return '只能在群聊使用或指定 channelId。';
+        if (!await requireManage(session, channelId))
+            return '权限不足。';
+        return '请在配置页面的 notify.groups 中编辑订阅列表。';
+    });
+    ctx.command('notify.list [channelId]', '列出订阅')
+        .action(async ({ session }, channelId) => {
+        const targetChannel = channelId || session.channelId;
+        if (!targetChannel)
+            return '只能在群聊使用或指定 channelId。';
+        if (!await requireManage(session, channelId))
+            return '权限不足。';
+        const subs = getConfigSubs(targetChannel);
+        if (!subs.length)
+            return '暂无订阅。';
+        return subs.map(s => `- ${s.platform}:${s.projectId} (${Math.round(s.interval / 60000)} 分钟)`).join('\n');
+    });
+    ctx.command('notify.enable <onoff> [channelId]', '启用/禁用本群通知')
+        .action(async ({ session }, onoff, channelId) => {
+        const targetChannel = channelId || session.channelId;
+        if (!targetChannel)
+            return '只能在群聊使用或指定 channelId。';
+        if (!await requireManage(session, channelId))
+            return '权限不足。';
+        return '请在配置页面的 notify.groups 中编辑 enabled。';
+    });
+    ctx.command('notify.check [arg]', '手动检查更新')
+        .option('broadcast', '-b 直接发送最新版卡片（忽略是否更新）')
+        .action(async ({ session, options }, arg) => {
+        const targetChannel = session.channelId;
+        if (!targetChannel)
+            return '只能在群聊使用或指定 channelId。';
+        if (!await requireManage(session))
+            return '权限不足。';
+        const list = getConfigSubsOrdered(targetChannel);
+        if (!list.length)
+            return '暂无订阅。';
+        let targets = list;
+        if (arg) {
+            const idx = Number(arg);
+            if (Number.isFinite(idx) && idx > 0) {
+                const sub = list[idx - 1];
+                if (!sub)
+                    return '未找到对应序号的订阅。';
+                targets = [sub];
+            }
+            else {
+                const sub = list.find(s => s.projectId === String(arg));
+                if (!sub)
+                    return '未找到对应项目 ID 的订阅。';
+                targets = [sub];
+            }
+        }
+        let sent = 0;
+        for (const sub of targets) {
+            try {
+                const res = await checkOne(sub, !!(options === null || options === void 0 ? void 0 : options.broadcast));
+                if (res.sent)
+                    sent += 1;
+            }
+            catch (e) {
+                logger.warn(`检查失败(${sub.platform}:${sub.projectId}): ${e.message}`);
+            }
+        }
+        if (!sent)
+            return '暂无更新。';
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-cfmrmod",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Koishi 插件：搜索 CurseForge/Modrinth/MCMod 并渲染图片卡片",
   "main": "dist/index.js",
   "files": [
@@ -55,7 +55,7 @@
       "zh": "从 CurseForge/Modrinth/MCMod 搜索模组/整合包/光影等内容，并生成图片卡片。"
     },
     "service": {
-      "required": ["skia"]
+      "required": ["skia", "database"]
     }
   }
 }