@zhin.js/plugin-link-poster 0.0.1

package/lib/index.d.ts

@@ -0,0 +1,17 @@
+declare module 'zhin.js' {
+    namespace Plugin {
+        interface Contexts {
+            'html-renderer': {
+                render(html: string, options?: {
+                    width?: number;
+                }): Promise<{
+                    data: Buffer | string;
+                    format: string;
+                    mimeType: string;
+                }>;
+            };
+        }
+    }
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,MAAM,CAAC;QACf,UAAU,QAAQ;YAChB,eAAe,EAAE;gBACf,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;oBAAE,KAAK,CAAC,EAAE,MAAM,CAAA;iBAAE,GAAG,OAAO,CAAC;oBAC1D,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;oBACrB,MAAM,EAAE,MAAM,CAAA;oBACd,QAAQ,EAAE,MAAM,CAAA;iBACjB,CAAC,CAAA;aACH,CAAA;SACF;KACF;CACF"}

package/lib/index.js

@@ -0,0 +1,38 @@
+/**
+ * @zhin.js/plugin-link-poster
+ *
+ * 自动检测消息中的 Bilibili / GitHub / 抖音 / 小红书链接，
+ * 生成精美内容海报图片并回复。
+ *
+ * 依赖：@zhin.js/plugin-html-renderer（提供 html-renderer Context）
+ */
+import { usePlugin, segment } from 'zhin.js';
+import { detectAndParse } from './platforms.js';
+import { renderPoster } from './render.js';
+const { addMiddleware, useContext, logger } = usePlugin();
+useContext('html-renderer', (renderer) => {
+    logger.info('link-poster: html-renderer 就绪，已启用链接海报');
+    addMiddleware(async (message, next) => {
+        const text = message.$raw || '';
+        // 快速跳过：消息中没有 http 链接
+        if (!text.includes('http'))
+            return next();
+        try {
+            const meta = await detectAndParse(text);
+            if (meta) {
+                const html = renderPoster(meta);
+                const result = await renderer.render(html, { width: 480 });
+                if (result.format === 'png' && typeof result.data === 'object') {
+                    const base64 = Buffer.from(result.data).toString('base64');
+                    const dataUrl = `data:${result.mimeType};base64,${base64}`;
+                    await message.$reply(segment('image', { url: dataUrl }));
+                }
+            }
+        }
+        catch (e) {
+            logger.warn(`link-poster: 海报生成失败 - ${e instanceof Error ? e.message : e}`);
+        }
+        return next();
+    });
+});
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAiB1C,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAA;AAEzD,UAAU,CAAC,eAAe,EAAE,CAAC,QAAQ,EAAE,EAAE;IACvC,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAA;IAEpD,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAA;QAE/B,qBAAqB;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,EAAE,CAAA;QAEzC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAA;YACvC,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;gBAC/B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;gBAE1D,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAc,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;oBACpE,MAAM,OAAO,GAAG,QAAQ,MAAM,CAAC,QAAQ,WAAW,MAAM,EAAE,CAAA;oBAC1D,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;gBAC1D,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QAC5E,CAAC;QAED,OAAO,IAAI,EAAE,CAAA;IACf,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/lib/platforms.d.ts

@@ -0,0 +1,7 @@
+import type { LinkMeta } from './types.js';
+/**
+ * 从消息文本中检测第一个匹配的平台链接并解析元数据。
+ * 仅返回第一个命中结果，避免单条消息产生过多海报。
+ */
+export declare function detectAndParse(text: string): Promise<LinkMeta | null>;
+//# sourceMappingURL=platforms.d.ts.map

package/lib/platforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platforms.d.ts","sourceRoot":"","sources":["../src/platforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AA+N1C;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAc3E"}

package/lib/platforms.js

@@ -0,0 +1,218 @@
+// ── 工具函数 ──────────────────────────────────────────────────────────────────
+const FETCH_TIMEOUT = 10_000;
+async function fetchWithTimeout(url, init) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT);
+    try {
+        return await fetch(url, { ...init, signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** 将远程图片下载并转为 data URI，避免 satori 渲染时遇到防盗链/CORS */
+async function imageToDataUri(url) {
+    if (!url)
+        return undefined;
+    try {
+        if (url.startsWith('//'))
+            url = 'https:' + url;
+        if (url.startsWith('http:'))
+            url = url.replace('http:', 'https:');
+        const res = await fetchWithTimeout(url, {
+            headers: { Referer: new URL(url).origin, 'User-Agent': 'Mozilla/5.0' },
+        });
+        if (!res.ok)
+            return undefined;
+        const buf = Buffer.from(await res.arrayBuffer());
+        const mime = res.headers.get('content-type') || 'image/jpeg';
+        return `data:${mime};base64,${buf.toString('base64')}`;
+    }
+    catch {
+        return undefined;
+    }
+}
+function formatNumber(n) {
+    if (n == null)
+        return '-';
+    if (n >= 100_000_000)
+        return (n / 100_000_000).toFixed(1) + '亿';
+    if (n >= 10_000)
+        return (n / 10_000).toFixed(1) + '万';
+    return String(n);
+}
+function extractMeta(html, property) {
+    // 匹配 <meta property="og:title" content="..."> 或 <meta name="..." content="...">
+    const re = new RegExp(`<meta\\s+(?:property|name)=["']${property}["']\\s+content=["']([^"']*?)["']`, 'i');
+    const m = html.match(re);
+    if (m)
+        return m[1];
+    // 反转属性顺序：content 在前
+    const re2 = new RegExp(`<meta\\s+content=["']([^"']*?)["']\\s+(?:property|name)=["']${property}["']`, 'i');
+    return html.match(re2)?.[1];
+}
+// ── Bilibili ──────────────────────────────────────────────────────────────────
+const BILIBILI_RE = /(?:bilibili\.com\/video\/|b23\.tv\/)/i;
+async function parseBilibili(url) {
+    // 短链跳转
+    if (url.includes('b23.tv')) {
+        const res = await fetchWithTimeout(url, { redirect: 'follow' });
+        url = res.url;
+    }
+    const bvMatch = url.match(/BV[\w]+/);
+    if (!bvMatch)
+        return null;
+    const api = `https://api.bilibili.com/x/web-interface/view?bvid=${bvMatch[0]}`;
+    const res = await fetchWithTimeout(api, {
+        headers: { 'User-Agent': 'Mozilla/5.0', Referer: 'https://www.bilibili.com/' },
+    });
+    const json = await res.json();
+    if (json.code !== 0)
+        return null;
+    const d = json.data;
+    return {
+        platform: 'bilibili',
+        title: d.title,
+        description: d.desc || undefined,
+        author: d.owner?.name,
+        authorAvatar: await imageToDataUri(d.owner?.face),
+        cover: await imageToDataUri(d.pic),
+        url: `https://www.bilibili.com/video/${bvMatch[0]}`,
+        stats: {
+            '播放': formatNumber(d.stat?.view),
+            '弹幕': formatNumber(d.stat?.danmaku),
+            '点赞': formatNumber(d.stat?.like),
+        },
+    };
+}
+// ── GitHub ────────────────────────────────────────────────────────────────────
+const GITHUB_RE = /github\.com\/([\w.-]+)\/([\w.-]+)/i;
+async function parseGithub(url) {
+    const repoMatch = url.match(GITHUB_RE);
+    if (!repoMatch)
+        return null;
+    const [, owner, repo] = repoMatch;
+    const headers = { 'User-Agent': 'zhin-bot', Accept: 'application/vnd.github+json' };
+    // Issue 或 PR
+    const issueMatch = url.match(/\/(issues|pull)\/(\d+)/);
+    if (issueMatch) {
+        const [, type, num] = issueMatch;
+        const apiType = type === 'pull' ? 'pulls' : 'issues';
+        const res = await fetchWithTimeout(`https://api.github.com/repos/${owner}/${repo}/${apiType}/${num}`, { headers });
+        if (!res.ok)
+            return null;
+        const d = await res.json();
+        return {
+            platform: 'github',
+            title: `${type === 'pull' ? 'PR' : 'Issue'} #${num}: ${d.title}`,
+            description: d.body?.slice(0, 200) || undefined,
+            author: d.user?.login,
+            authorAvatar: await imageToDataUri(d.user?.avatar_url),
+            url,
+            stats: {
+                '状态': d.state === 'open' ? '🟢 Open' : '🟣 Closed',
+                '评论': String(d.comments ?? 0),
+            },
+        };
+    }
+    // 仓库
+    const res = await fetchWithTimeout(`https://api.github.com/repos/${owner}/${repo}`, { headers });
+    if (!res.ok)
+        return null;
+    const d = await res.json();
+    return {
+        platform: 'github',
+        title: d.full_name || `${owner}/${repo}`,
+        description: d.description || undefined,
+        author: d.owner?.login,
+        authorAvatar: await imageToDataUri(d.owner?.avatar_url),
+        cover: await imageToDataUri(`https://opengraph.githubassets.com/1/${owner}/${repo}`),
+        url,
+        stats: {
+            'Star': formatNumber(d.stargazers_count),
+            'Fork': formatNumber(d.forks_count),
+            '语言': d.language || '-',
+        },
+    };
+}
+// ── 抖音 ──────────────────────────────────────────────────────────────────────
+const DOUYIN_RE = /(?:douyin\.com\/video\/|v\.douyin\.com\/)/i;
+async function parseDouyin(url) {
+    try {
+        const res = await fetchWithTimeout(url, {
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1',
+            },
+            redirect: 'follow',
+        });
+        const html = await res.text();
+        const title = extractMeta(html, 'og:title');
+        if (!title)
+            return null;
+        return {
+            platform: 'douyin',
+            title,
+            description: extractMeta(html, 'og:description'),
+            cover: await imageToDataUri(extractMeta(html, 'og:image')),
+            url: res.url || url,
+            author: extractMeta(html, 'og:site_name') || '抖音',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ── 小红书 ────────────────────────────────────────────────────────────────────
+const XIAOHONGSHU_RE = /(?:xiaohongshu\.com\/(?:explore|discovery)|xhslink\.com\/)/i;
+async function parseXiaohongshu(url) {
+    try {
+        const res = await fetchWithTimeout(url, {
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1',
+            },
+            redirect: 'follow',
+        });
+        const html = await res.text();
+        const title = extractMeta(html, 'og:title');
+        if (!title)
+            return null;
+        return {
+            platform: 'xiaohongshu',
+            title,
+            description: extractMeta(html, 'og:description'),
+            cover: await imageToDataUri(extractMeta(html, 'og:image')),
+            url: res.url || url,
+            author: extractMeta(html, 'author') || extractMeta(html, 'og:site_name') || '小红书',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+const PARSERS = [
+    { test: BILIBILI_RE, parse: parseBilibili },
+    { test: GITHUB_RE, parse: parseGithub },
+    { test: DOUYIN_RE, parse: parseDouyin },
+    { test: XIAOHONGSHU_RE, parse: parseXiaohongshu },
+];
+/**
+ * 从消息文本中检测第一个匹配的平台链接并解析元数据。
+ * 仅返回第一个命中结果，避免单条消息产生过多海报。
+ */
+export async function detectAndParse(text) {
+    // 提取所有 URL
+    const urls = text.match(/https?:\/\/[^\s<>)"']+/gi);
+    if (!urls)
+        return null;
+    for (const url of urls) {
+        for (const { test, parse } of PARSERS) {
+            if (test.test(url)) {
+                const meta = await parse(url);
+                if (meta)
+                    return meta;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=platforms.js.map

package/lib/platforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platforms.js","sourceRoot":"","sources":["../src/platforms.ts"],"names":[],"mappings":"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"}

package/lib/render.d.ts

@@ -0,0 +1,6 @@
+import type { LinkMeta } from './types.js';
+/**
+ * 生成 satori 兼容的海报 HTML
+ */
+export declare function renderPoster(meta: LinkMeta): string;
+//# sourceMappingURL=render.d.ts.map

package/lib/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAA;AAoCzD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CA+DnD"}

package/lib/render.js

@@ -0,0 +1,91 @@
+const THEMES = {
+    bilibili: { name: 'Bilibili', color: '#00A1D6', bg: '#E3F6FC' },
+    github: { name: 'GitHub', color: '#24292e', bg: '#F0F0F0' },
+    douyin: { name: '抖音', color: '#FE2C55', bg: '#FFF0F3' },
+    xiaohongshu: { name: '小红书', color: '#FF2442', bg: '#FFF0F2' },
+};
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function truncate(s, max) {
+    if (!s)
+        return '';
+    return s.length > max ? s.slice(0, max) + '…' : s;
+}
+function renderStats(stats, color) {
+    if (!stats)
+        return '';
+    const items = Object.entries(stats)
+        .map(([k, v]) => `<span style="display:flex;align-items:center;margin-right:16px;font-size:12px;color:#888;">`
+        + `<span style="color:${color};font-weight:600;margin-right:4px;">${escapeHtml(k)}</span>`
+        + `<span>${escapeHtml(v)}</span>`
+        + `</span>`)
+        .join('');
+    return `<div style="display:flex;flex-wrap:wrap;margin-top:12px;">${items}</div>`;
+}
+/**
+ * 生成 satori 兼容的海报 HTML
+ */
+export function renderPoster(meta) {
+    const theme = THEMES[meta.platform];
+    // ── 封面区域 ──
+    const coverHtml = meta.cover
+        ? `<img src="${meta.cover}" style="width:480px;height:252px;object-fit:cover;" />`
+        : `<div style="display:flex;align-items:center;justify-content:center;width:480px;height:80px;background:${theme.bg};">`
+            + `<span style="font-size:28px;font-weight:700;color:${theme.color};">${escapeHtml(theme.name)}</span>`
+            + `</div>`;
+    // ── 头像 + 作者 ──
+    const avatarHtml = meta.authorAvatar
+        ? `<img src="${meta.authorAvatar}" style="width:28px;height:28px;border-radius:14px;margin-right:8px;" />`
+        : '';
+    const authorHtml = meta.author
+        ? `<div style="display:flex;align-items:center;margin-top:12px;">`
+            + avatarHtml
+            + `<span style="font-size:13px;color:#666;">${escapeHtml(meta.author)}</span>`
+            + `</div>`
+        : '';
+    // ── 描述 ──
+    const descHtml = meta.description
+        ? `<span style="font-size:13px;color:#888;margin-top:8px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;">`
+            + `${escapeHtml(truncate(meta.description, 80))}`
+            + `</span>`
+        : '';
+    // ── 统计 ──
+    const statsHtml = renderStats(meta.stats, theme.color);
+    // ── 链接 ──
+    const displayUrl = truncate(meta.url.replace(/^https?:\/\//, ''), 60);
+    return `<div style="display:flex;flex-direction:column;width:480px;background:#ffffff;border-radius:16px;overflow:hidden;font-family:Noto Sans SC,sans-serif;box-shadow:0 2px 12px rgba(0,0,0,0.08);">`
+        // 封面
+        + coverHtml
+        // 内容区
+        + `<div style="display:flex;flex-direction:column;padding:18px 20px 16px;">`
+        // 平台标签
+        + `<div style="display:flex;align-items:center;margin-bottom:10px;">`
+        + `<span style="display:flex;align-items:center;background:${theme.color};color:#ffffff;padding:3px 10px;border-radius:4px;font-size:11px;font-weight:700;letter-spacing:0.5px;">`
+        + escapeHtml(theme.name)
+        + `</span>`
+        + `</div>`
+        // 标题
+        + `<span style="font-size:18px;font-weight:700;color:#1a1a1a;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;">`
+        + escapeHtml(truncate(meta.title, 50))
+        + `</span>`
+        // 描述
+        + descHtml
+        // 作者
+        + authorHtml
+        // 统计
+        + statsHtml
+        // 底部链接
+        + `<div style="display:flex;margin-top:14px;padding-top:12px;border-top:1px solid #f0f0f0;">`
+        + `<span style="font-size:11px;color:#bbb;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;">`
+        + escapeHtml(displayUrl)
+        + `</span>`
+        + `</div>`
+        + `</div>`
+        + `</div>`;
+}
+//# sourceMappingURL=render.js.map

package/lib/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAgD;IAC1D,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;IAC/D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;IAC3D,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;IACvD,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;CAC9D,CAAA;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAC5B,CAAC;AAED,SAAS,QAAQ,CAAC,CAAqB,EAAE,GAAW;IAClD,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IACjB,OAAO,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;AACnD,CAAC;AAED,SAAS,WAAW,CAAC,KAAyC,EAAE,KAAa;IAC3E,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SAChC,GAAG,CACF,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CACT,6FAA6F;UAC3F,sBAAsB,KAAK,uCAAuC,UAAU,CAAC,CAAC,CAAC,SAAS;UACxF,SAAS,UAAU,CAAC,CAAC,CAAC,SAAS;UAC/B,SAAS,CACd;SACA,IAAI,CAAC,EAAE,CAAC,CAAA;IACX,OAAO,6DAA6D,KAAK,QAAQ,CAAA;AACnF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAEnC,aAAa;IACb,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK;QAC1B,CAAC,CAAC,aAAa,IAAI,CAAC,KAAK,yDAAyD;QAClF,CAAC,CAAC,yGAAyG,KAAK,CAAC,EAAE,KAAK;cACpH,qDAAqD,KAAK,CAAC,KAAK,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS;cACrG,QAAQ,CAAA;IAEd,gBAAgB;IAChB,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY;QAClC,CAAC,CAAC,aAAa,IAAI,CAAC,YAAY,0EAA0E;QAC1G,CAAC,CAAC,EAAE,CAAA;IACN,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM;QAC5B,CAAC,CAAC,gEAAgE;cAC9D,UAAU;cACV,4CAA4C,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS;cAC5E,QAAQ;QACZ,CAAC,CAAC,EAAE,CAAA;IAEN,WAAW;IACX,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW;QAC/B,CAAC,CAAC,oHAAoH;cAClH,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,EAAE;cAC/C,SAAS;QACb,CAAC,CAAC,EAAE,CAAA;IAEN,WAAW;IACX,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAEtD,WAAW;IACX,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;IAErE,OAAO,gMAAgM;QACrM,KAAK;UACH,SAAS;QACX,MAAM;UACJ,0EAA0E;QAC1E,OAAO;UACL,mEAAmE;UACjE,2DAA2D,KAAK,CAAC,KAAK,0GAA0G;UAC9K,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;UACxB,SAAS;UACX,QAAQ;QACV,KAAK;UACH,wHAAwH;UACtH,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;UACtC,SAAS;QACX,KAAK;UACH,QAAQ;QACV,KAAK;UACH,UAAU;QACZ,KAAK;UACH,SAAS;QACX,OAAO;UACL,2FAA2F;UACzF,qGAAqG;UACnG,UAAU,CAAC,UAAU,CAAC;UACxB,SAAS;UACX,QAAQ;UACV,QAAQ;UACV,QAAQ,CAAA;AACZ,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,19 @@
+/** 链接解析结果 */
+export interface LinkMeta {
+    platform: 'bilibili' | 'github' | 'douyin' | 'xiaohongshu';
+    title: string;
+    description?: string;
+    author?: string;
+    authorAvatar?: string;
+    /** 封面图（已转为 data URI） */
+    cover?: string;
+    url: string;
+    stats?: Record<string, string>;
+}
+/** 平台视觉主题 */
+export interface PlatformTheme {
+    name: string;
+    color: string;
+    bg: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAA;IAC1D,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED,aAAa;AACb,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;CACX"}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@zhin.js/plugin-link-poster",
+  "version": "0.0.1",
+  "description": "Auto-detect Bilibili/GitHub/Douyin/Xiaohongshu links and generate beautiful poster cards",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": ["src", "lib", "README.md"],
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rimraf lib"
+  },
+  "keywords": ["zhin", "zhin.js", "bot", "plugin", "link-poster", "bilibili", "github", "douyin", "xiaohongshu"],
+  "author": { "name": "lc-cn", "email": "admin@liucl.cn", "url": "https://github.com/lc-cn" },
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": { "typescript": "^5.9.3", "zhin.js": "workspace:*" },
+  "peerDependencies": { "zhin.js": ">=1.0.60" },
+  "repository": { "type": "git", "url": "git+https://github.com/zhinjs/zhin.git", "directory": "plugins/utils/link-poster" },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}

package/src/index.ts

@@ -0,0 +1,57 @@
+/**
+ * @zhin.js/plugin-link-poster
+ *
+ * 自动检测消息中的 Bilibili / GitHub / 抖音 / 小红书链接，
+ * 生成精美内容海报图片并回复。
+ *
+ * 依赖：@zhin.js/plugin-html-renderer（提供 html-renderer Context）
+ */
+import { usePlugin, segment } from 'zhin.js'
+import { detectAndParse } from './platforms.js'
+import { renderPoster } from './render.js'
+
+// html-renderer Context 的最小类型声明（运行时由 html-renderer 插件注入）
+declare module 'zhin.js' {
+  namespace Plugin {
+    interface Contexts {
+      'html-renderer': {
+        render(html: string, options?: { width?: number }): Promise<{
+          data: Buffer | string
+          format: string
+          mimeType: string
+        }>
+      }
+    }
+  }
+}
+
+const { addMiddleware, useContext, logger } = usePlugin()
+
+useContext('html-renderer', (renderer) => {
+  logger.info('link-poster: html-renderer 就绪，已启用链接海报')
+
+  addMiddleware(async (message, next) => {
+    const text = message.$raw || ''
+
+    // 快速跳过：消息中没有 http 链接
+    if (!text.includes('http')) return next()
+
+    try {
+      const meta = await detectAndParse(text)
+      if (meta) {
+        const html = renderPoster(meta)
+        const result = await renderer.render(html, { width: 480 })
+
+        if (result.format === 'png' && typeof result.data === 'object') {
+          const base64 = Buffer.from(result.data as Buffer).toString('base64')
+          const dataUrl = `data:${result.mimeType};base64,${base64}`
+          await message.$reply(segment('image', { url: dataUrl }))
+        }
+      }
+    } catch (e) {
+      logger.warn(`link-poster: 海报生成失败 - ${e instanceof Error ? e.message : e}`)
+    }
+
+    return next()
+  })
+})

package/src/platforms.ts

@@ -0,0 +1,242 @@
+import type { LinkMeta } from './types.js'
+
+// ── 工具函数 ──────────────────────────────────────────────────────────────────
+
+const FETCH_TIMEOUT = 10_000
+
+async function fetchWithTimeout(url: string, init?: RequestInit): Promise<Response> {
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT)
+  try {
+    return await fetch(url, { ...init, signal: controller.signal })
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+/** 将远程图片下载并转为 data URI，避免 satori 渲染时遇到防盗链/CORS */
+async function imageToDataUri(url: string | undefined): Promise<string | undefined> {
+  if (!url) return undefined
+  try {
+    if (url.startsWith('//')) url = 'https:' + url
+    if (url.startsWith('http:')) url = url.replace('http:', 'https:')
+    const res = await fetchWithTimeout(url, {
+      headers: { Referer: new URL(url).origin, 'User-Agent': 'Mozilla/5.0' },
+    })
+    if (!res.ok) return undefined
+    const buf = Buffer.from(await res.arrayBuffer())
+    const mime = res.headers.get('content-type') || 'image/jpeg'
+    return `data:${mime};base64,${buf.toString('base64')}`
+  } catch {
+    return undefined
+  }
+}
+
+function formatNumber(n: number | undefined): string {
+  if (n == null) return '-'
+  if (n >= 100_000_000) return (n / 100_000_000).toFixed(1) + '亿'
+  if (n >= 10_000) return (n / 10_000).toFixed(1) + '万'
+  return String(n)
+}
+
+function extractMeta(html: string, property: string): string | undefined {
+  // 匹配 <meta property="og:title" content="..."> 或 <meta name="..." content="...">
+  const re = new RegExp(
+    `<meta\\s+(?:property|name)=["']${property}["']\\s+content=["']([^"']*?)["']`,
+    'i',
+  )
+  const m = html.match(re)
+  if (m) return m[1]
+  // 反转属性顺序：content 在前
+  const re2 = new RegExp(
+    `<meta\\s+content=["']([^"']*?)["']\\s+(?:property|name)=["']${property}["']`,
+    'i',
+  )
+  return html.match(re2)?.[1]
+}
+
+// ── Bilibili ──────────────────────────────────────────────────────────────────
+
+const BILIBILI_RE = /(?:bilibili\.com\/video\/|b23\.tv\/)/i
+
+async function parseBilibili(url: string): Promise<LinkMeta | null> {
+  // 短链跳转
+  if (url.includes('b23.tv')) {
+    const res = await fetchWithTimeout(url, { redirect: 'follow' })
+    url = res.url
+  }
+  const bvMatch = url.match(/BV[\w]+/)
+  if (!bvMatch) return null
+
+  const api = `https://api.bilibili.com/x/web-interface/view?bvid=${bvMatch[0]}`
+  const res = await fetchWithTimeout(api, {
+    headers: { 'User-Agent': 'Mozilla/5.0', Referer: 'https://www.bilibili.com/' },
+  })
+  const json = await res.json() as any
+  if (json.code !== 0) return null
+
+  const d = json.data
+  return {
+    platform: 'bilibili',
+    title: d.title,
+    description: d.desc || undefined,
+    author: d.owner?.name,
+    authorAvatar: await imageToDataUri(d.owner?.face),
+    cover: await imageToDataUri(d.pic),
+    url: `https://www.bilibili.com/video/${bvMatch[0]}`,
+    stats: {
+      '播放': formatNumber(d.stat?.view),
+      '弹幕': formatNumber(d.stat?.danmaku),
+      '点赞': formatNumber(d.stat?.like),
+    },
+  }
+}
+
+// ── GitHub ────────────────────────────────────────────────────────────────────
+
+const GITHUB_RE = /github\.com\/([\w.-]+)\/([\w.-]+)/i
+
+async function parseGithub(url: string): Promise<LinkMeta | null> {
+  const repoMatch = url.match(GITHUB_RE)
+  if (!repoMatch) return null
+  const [, owner, repo] = repoMatch
+  const headers = { 'User-Agent': 'zhin-bot', Accept: 'application/vnd.github+json' }
+
+  // Issue 或 PR
+  const issueMatch = url.match(/\/(issues|pull)\/(\d+)/)
+  if (issueMatch) {
+    const [, type, num] = issueMatch
+    const apiType = type === 'pull' ? 'pulls' : 'issues'
+    const res = await fetchWithTimeout(
+      `https://api.github.com/repos/${owner}/${repo}/${apiType}/${num}`,
+      { headers },
+    )
+    if (!res.ok) return null
+    const d = await res.json() as any
+    return {
+      platform: 'github',
+      title: `${type === 'pull' ? 'PR' : 'Issue'} #${num}: ${d.title}`,
+      description: d.body?.slice(0, 200) || undefined,
+      author: d.user?.login,
+      authorAvatar: await imageToDataUri(d.user?.avatar_url),
+      url,
+      stats: {
+        '状态': d.state === 'open' ? '🟢 Open' : '🟣 Closed',
+        '评论': String(d.comments ?? 0),
+      },
+    }
+  }
+
+  // 仓库
+  const res = await fetchWithTimeout(`https://api.github.com/repos/${owner}/${repo}`, { headers })
+  if (!res.ok) return null
+  const d = await res.json() as any
+  return {
+    platform: 'github',
+    title: d.full_name || `${owner}/${repo}`,
+    description: d.description || undefined,
+    author: d.owner?.login,
+    authorAvatar: await imageToDataUri(d.owner?.avatar_url),
+    cover: await imageToDataUri(`https://opengraph.githubassets.com/1/${owner}/${repo}`),
+    url,
+    stats: {
+      'Star': formatNumber(d.stargazers_count),
+      'Fork': formatNumber(d.forks_count),
+      '语言': d.language || '-',
+    },
+  }
+}
+
+// ── 抖音 ──────────────────────────────────────────────────────────────────────
+
+const DOUYIN_RE = /(?:douyin\.com\/video\/|v\.douyin\.com\/)/i
+
+async function parseDouyin(url: string): Promise<LinkMeta | null> {
+  try {
+    const res = await fetchWithTimeout(url, {
+      headers: {
+        'User-Agent':
+          'Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1',
+      },
+      redirect: 'follow',
+    })
+    const html = await res.text()
+    const title = extractMeta(html, 'og:title')
+    if (!title) return null
+
+    return {
+      platform: 'douyin',
+      title,
+      description: extractMeta(html, 'og:description'),
+      cover: await imageToDataUri(extractMeta(html, 'og:image')),
+      url: res.url || url,
+      author: extractMeta(html, 'og:site_name') || '抖音',
+    }
+  } catch {
+    return null
+  }
+}
+
+// ── 小红书 ────────────────────────────────────────────────────────────────────
+
+const XIAOHONGSHU_RE = /(?:xiaohongshu\.com\/(?:explore|discovery)|xhslink\.com\/)/i
+
+async function parseXiaohongshu(url: string): Promise<LinkMeta | null> {
+  try {
+    const res = await fetchWithTimeout(url, {
+      headers: {
+        'User-Agent':
+          'Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1',
+      },
+      redirect: 'follow',
+    })
+    const html = await res.text()
+    const title = extractMeta(html, 'og:title')
+    if (!title) return null
+
+    return {
+      platform: 'xiaohongshu',
+      title,
+      description: extractMeta(html, 'og:description'),
+      cover: await imageToDataUri(extractMeta(html, 'og:image')),
+      url: res.url || url,
+      author: extractMeta(html, 'author') || extractMeta(html, 'og:site_name') || '小红书',
+    }
+  } catch {
+    return null
+  }
+}
+
+// ── 统一检测 ──────────────────────────────────────────────────────────────────
+
+interface PlatformParser {
+  test: RegExp
+  parse: (url: string) => Promise<LinkMeta | null>
+}
+
+const PARSERS: PlatformParser[] = [
+  { test: BILIBILI_RE, parse: parseBilibili },
+  { test: GITHUB_RE, parse: parseGithub },
+  { test: DOUYIN_RE, parse: parseDouyin },
+  { test: XIAOHONGSHU_RE, parse: parseXiaohongshu },
+]
+
+/**
+ * 从消息文本中检测第一个匹配的平台链接并解析元数据。
+ * 仅返回第一个命中结果，避免单条消息产生过多海报。
+ */
+export async function detectAndParse(text: string): Promise<LinkMeta | null> {
+  // 提取所有 URL
+  const urls = text.match(/https?:\/\/[^\s<>)"']+/gi)
+  if (!urls) return null
+
+  for (const url of urls) {
+    for (const { test, parse } of PARSERS) {
+      if (test.test(url)) {
+        const meta = await parse(url)
+        if (meta) return meta
+      }
+    }
+  }
+  return null
+}

package/src/render.ts

@@ -0,0 +1,103 @@
+import type { LinkMeta, PlatformTheme } from './types.js'
+
+const THEMES: Record<LinkMeta['platform'], PlatformTheme> = {
+  bilibili: { name: 'Bilibili', color: '#00A1D6', bg: '#E3F6FC' },
+  github: { name: 'GitHub', color: '#24292e', bg: '#F0F0F0' },
+  douyin: { name: '抖音', color: '#FE2C55', bg: '#FFF0F3' },
+  xiaohongshu: { name: '小红书', color: '#FF2442', bg: '#FFF0F2' },
+}
+
+function escapeHtml(s: string): string {
+  return s
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+}
+
+function truncate(s: string | undefined, max: number): string {
+  if (!s) return ''
+  return s.length > max ? s.slice(0, max) + '…' : s
+}
+
+function renderStats(stats: Record<string, string> | undefined, color: string): string {
+  if (!stats) return ''
+  const items = Object.entries(stats)
+    .map(
+      ([k, v]) =>
+        `<span style="display:flex;align-items:center;margin-right:16px;font-size:12px;color:#888;">`
+        + `<span style="color:${color};font-weight:600;margin-right:4px;">${escapeHtml(k)}</span>`
+        + `<span>${escapeHtml(v)}</span>`
+        + `</span>`,
+    )
+    .join('')
+  return `<div style="display:flex;flex-wrap:wrap;margin-top:12px;">${items}</div>`
+}
+
+/**
+ * 生成 satori 兼容的海报 HTML
+ */
+export function renderPoster(meta: LinkMeta): string {
+  const theme = THEMES[meta.platform]
+
+  // ── 封面区域 ──
+  const coverHtml = meta.cover
+    ? `<img src="${meta.cover}" style="width:480px;height:252px;object-fit:cover;" />`
+    : `<div style="display:flex;align-items:center;justify-content:center;width:480px;height:80px;background:${theme.bg};">`
+      + `<span style="font-size:28px;font-weight:700;color:${theme.color};">${escapeHtml(theme.name)}</span>`
+      + `</div>`
+
+  // ── 头像 + 作者 ──
+  const avatarHtml = meta.authorAvatar
+    ? `<img src="${meta.authorAvatar}" style="width:28px;height:28px;border-radius:14px;margin-right:8px;" />`
+    : ''
+  const authorHtml = meta.author
+    ? `<div style="display:flex;align-items:center;margin-top:12px;">`
+      + avatarHtml
+      + `<span style="font-size:13px;color:#666;">${escapeHtml(meta.author)}</span>`
+      + `</div>`
+    : ''
+
+  // ── 描述 ──
+  const descHtml = meta.description
+    ? `<span style="font-size:13px;color:#888;margin-top:8px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;">`
+      + `${escapeHtml(truncate(meta.description, 80))}`
+      + `</span>`
+    : ''
+
+  // ── 统计 ──
+  const statsHtml = renderStats(meta.stats, theme.color)
+
+  // ── 链接 ──
+  const displayUrl = truncate(meta.url.replace(/^https?:\/\//, ''), 60)
+
+  return `<div style="display:flex;flex-direction:column;width:480px;background:#ffffff;border-radius:16px;overflow:hidden;font-family:Noto Sans SC,sans-serif;box-shadow:0 2px 12px rgba(0,0,0,0.08);">`
+    // 封面
+    + coverHtml
+    // 内容区
+    + `<div style="display:flex;flex-direction:column;padding:18px 20px 16px;">`
+      // 平台标签
+      + `<div style="display:flex;align-items:center;margin-bottom:10px;">`
+        + `<span style="display:flex;align-items:center;background:${theme.color};color:#ffffff;padding:3px 10px;border-radius:4px;font-size:11px;font-weight:700;letter-spacing:0.5px;">`
+          + escapeHtml(theme.name)
+        + `</span>`
+      + `</div>`
+      // 标题
+      + `<span style="font-size:18px;font-weight:700;color:#1a1a1a;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;">`
+        + escapeHtml(truncate(meta.title, 50))
+      + `</span>`
+      // 描述
+      + descHtml
+      // 作者
+      + authorHtml
+      // 统计
+      + statsHtml
+      // 底部链接
+      + `<div style="display:flex;margin-top:14px;padding-top:12px;border-top:1px solid #f0f0f0;">`
+        + `<span style="font-size:11px;color:#bbb;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;">`
+          + escapeHtml(displayUrl)
+        + `</span>`
+      + `</div>`
+    + `</div>`
+  + `</div>`
+}

package/src/types.ts

@@ -0,0 +1,19 @@
+/** 链接解析结果 */
+export interface LinkMeta {
+  platform: 'bilibili' | 'github' | 'douyin' | 'xiaohongshu'
+  title: string
+  description?: string
+  author?: string
+  authorAvatar?: string
+  /** 封面图（已转为 data URI） */
+  cover?: string
+  url: string
+  stats?: Record<string, string>
+}
+
+/** 平台视觉主题 */
+export interface PlatformTheme {
+  name: string
+  color: string
+  bg: string
+}