koishi-plugin-share-links-analysis 0.15.3 → 0.15.4

package/README.md

@@ -169,7 +169,7 @@ http://127.0.0.1:12001
 | Netease Music | 歌曲、节目，依赖 NeteaseCloudMusicApi 服务 |
 | QQ Music      | 常见歌曲分享链接                         |
 | Kugou Music   | 常见歌曲分享链接                         |
-| GitHub        | 仓库链接基础信息                         |
+| GitHub        | 仓库、分支/标签、发行版、用户与组织主页             |
 
 ## 指令
 

package/lib/index.js

@@ -127,6 +127,58 @@ exports.Config = koishi_1.Schema.intersect([
         netease_apiUrl: koishi_1.Schema.string().role('link').description('网易云音乐 API (NeteaseCloudMusicApi) 的地址<br>' +
             '<a href="https://docs-neteasecloudmusicapi.focalors.ltd/#/?id=neteasecloudmusicapienhanced" target="_blank">点击此处查看部署方式</a>').default('http://127.0.0.1:3000'),
     }).description('网易云音乐设置'),
+    koishi_1.Schema.intersect([
+        koishi_1.Schema.object({
+            githubToken: koishi_1.Schema.string().role('secret').description('GitHub API Token（可选）。留空时匿名请求，速率上限为 60 次/小时；填写后提升到 5000 次/小时，<br>' +
+                '同时可以读取私有仓库与私有发行版。<br>' +
+                '在 GitHub Settings → Developer settings → Personal access tokens 创建，读取公开数据无需勾选任何权限。').default(''),
+            githubCover: koishi_1.Schema.union([
+                koishi_1.Schema.const('off').description('不生成封面图'),
+                koishi_1.Schema.const('opengraph').description('GitHub 官方社交预览图：1200×600，包含仓库头像、简介、Stars/Fork 等'),
+                koishi_1.Schema.const('socialify').description('Socialify 生成：1280×640，主题、字体、纹理与徽标可自定义'),
+            ]).role('radio').default('off').description('封面图来源'),
+        }),
+        koishi_1.Schema.union([
+            koishi_1.Schema.object({
+                githubCover: koishi_1.Schema.const('socialify').required(),
+                socialifyTheme: koishi_1.Schema.union([
+                    koishi_1.Schema.const('Light').description('浅色'),
+                    koishi_1.Schema.const('Dark').description('深色'),
+                ]).default('Light').description('配色主题'),
+                socialifyFont: koishi_1.Schema.union([
+                    koishi_1.Schema.const('Inter'),
+                    koishi_1.Schema.const('JetBrains Mono'),
+                    koishi_1.Schema.const('KoHo'),
+                    koishi_1.Schema.const('Crimson Pro'),
+                    koishi_1.Schema.const('Bitter'),
+                    koishi_1.Schema.const('Roboto'),
+                    koishi_1.Schema.const('Source Code Pro'),
+                    koishi_1.Schema.const('IBM Plex Mono'),
+                    koishi_1.Schema.const('Raleway'),
+                    koishi_1.Schema.const('Poppins'),
+                ]).default('Inter').description('字体'),
+                socialifyPattern: koishi_1.Schema.union([
+                    koishi_1.Schema.const('Plus').description('加号点阵（Socialify 默认）'),
+                    koishi_1.Schema.const('Signal').description('砖块'),
+                    koishi_1.Schema.const('Charlie Brown').description('斜纹'),
+                    koishi_1.Schema.const('Formal Invitation').description('菱形网格'),
+                    koishi_1.Schema.const('Circuit Board').description('电路板'),
+                    koishi_1.Schema.const('Overlapping Hexagons').description('六边形'),
+                    koishi_1.Schema.const('Brick Wall').description('砖墙'),
+                    koishi_1.Schema.const('Hide').description('无纹理'),
+                ]).default('Plus').description('背景纹理'),
+                socialifyLanguage: koishi_1.Schema.boolean().default(true).description('显示语言徽标'),
+                socialifyOwner: koishi_1.Schema.boolean().default(true).description('显示仓库头像'),
+                socialifyName: koishi_1.Schema.boolean().default(true).description('显示仓库名'),
+                socialifyDescription: koishi_1.Schema.boolean().default(false).description('显示仓库简介'),
+                socialifyStars: koishi_1.Schema.boolean().default(true).description('显示 Stars 徽标'),
+                socialifyForks: koishi_1.Schema.boolean().default(true).description('显示 Forks 徽标'),
+                socialifyIssues: koishi_1.Schema.boolean().default(false).description('显示 Issues 徽标'),
+                socialifyPulls: koishi_1.Schema.boolean().default(false).description('显示 Pull Requests 徽标'),
+            }),
+            koishi_1.Schema.object({}),
+        ]),
+    ]).description('GitHub 解析设置'),
     koishi_1.Schema.object({
         onebotReadDir: koishi_1.Schema.string().description('OneBot 实现 (如 NapCat) 所在的容器或环境提供的路径前缀。').default("/app/.config/QQ/NapCat/temp"),
         localDownloadDir: koishi_1.Schema.string().description('与上述路径对应的、Koishi 所在的容器或主机可以访问的路径前缀。').default("/koishi/data/temp"),
@@ -764,7 +816,8 @@ function apply(ctx, config) {
             .join('\n');
         return `当前解析器状态：\n${parserList}\nNSFW 内容：${nsfw ? '✅' : '❌'}`.trim();
     });
-    cmd.subcommand('.parsers [parser:string] [mode:string]', '查看/管理当前会话的解析器状态', { authority: 1 })
+    cmd.subcommand('.parser [parser:string] [mode:string]', '查看/管理当前会话的解析器状态', { authority: 1 })
+        .alias('.parsers')
         .action(async ({ session }, parser, value) => {
         const scope = session && (0, utils_1.getSettingsScope)(session);
         if (!scope)
@@ -774,13 +827,14 @@ function apply(ctx, config) {
         const isValidParser = (name) => core_1.parsers_str.includes(name);
         if (!isValidParser(parser))
             return '请输入正确的解析器名称';
-        if (!value)
-            return '请输入正确的模式';
-        const mode = value.trim().toLowerCase() === 'true';
+        const mode = (0, utils_1.parseBoolean)(value);
+        if (mode === undefined)
+            return '请输入正确的模式（如 true/false、enable/disable、on/off）';
         const data = await ctx.database.get('sla_group_settings', scope);
         const final_parsers = { ...data[0]?.custom_parsers, ...{ [parser]: mode } };
         const record = { guildId: scope, custom_parsers: final_parsers };
         await ctx.database.upsert('sla_group_settings', [record]);
+        await session.execute('share');
     });
     cmd.subcommand('.nsfw [value:string]', '设置是否允许 NSFW 内容', { authority: 1 })
         .action(async ({ session }, value) => {
@@ -789,7 +843,9 @@ function apply(ctx, config) {
             return '当前会话不可用。';
         if (!await canManageSettings(session))
             return '权限不足';
-        const mode = value.trim().toLowerCase() === 'true';
+        const mode = (0, utils_1.parseBoolean)(value);
+        if (mode === undefined)
+            return '请输入正确的值（如 true/false、enable/disable、on/off）';
         const record = { guildId: scope, nsfw_enabled: mode };
         await ctx.database.upsert('sla_group_settings', [record]);
         await session.execute('share');
@@ -802,7 +858,8 @@ function apply(ctx, config) {
         if (!await canManageSettings(session))
             return '权限不足';
         await ctx.database.remove('sla_group_settings', { guildId: scope });
-        return '已重置为全局默认设置。';
+        await session.send('已重置为全局默认设置。');
+        await session.execute('share');
     });
     cmd.subcommand('.migratecache', '迁移旧解析缓存到新时间线并校验', { authority: 4 })
         .action(async () => {

package/lib/parsers/bilibili.js

@@ -444,7 +444,7 @@ async function processArticle(ctx, config, link, logger) {
 async function processOpus(ctx, config, link, logger) {
     const opusId = link.id;
     // B站新版动态必须传递 timezone_offset，否则部分动态获取为空或报错
-    const apiUrl = `https://api.bilibili.com/x/polymer/web-dynamic/v1/detail?timezone_offset=-480&id=${opusId}`;
+    const apiUrl = `https://api.bilibili.com/x/polymer/web-dynamic/v1/detail?timezone_offset=-480&features=itemOpusStyle&id=${opusId}`;
     try {
         // 获取 Cookie
         const cookie = await (0, utils_1.getCookie)(ctx, config, exports.name);

package/lib/parsers/github.d.ts

@@ -2,10 +2,10 @@ import { Context, Session } from 'koishi';
 import { Link, ParsedInfo, PluginConfig } from '../types';
 export declare const name = "github";
 /**
- * 在文本中匹配 GitHub 仓库链接
+ * 在文本中匹配 GitHub 链接
  */
 export declare function match(content: string, ctx: Context, config: PluginConfig): Promise<Link[]>;
 /**
- * 处理单个 GitHub 链接
+ * 解析单个 GitHub 链接
  */
 export declare function process(ctx: Context, config: PluginConfig, link: Link, session: Session): Promise<ParsedInfo | null>;

package/lib/parsers/github.js

@@ -6,125 +6,593 @@ exports.match = match;
 exports.process = process;
 const utils_1 = require("../utils");
 exports.name = "github";
-const linkRules = [
-    {
-        pattern: /(?:https?:\/\/)?(?:www\.)?github\.com\/([a-zA-Z0-9-]+\/[a-zA-Z0-9_-]+(?:\.[a-zA-Z0-9_-]+)*)(?=[.,;!?)]|\s|$)/gi,
-        type: "repo",
-    }
-];
-// 过滤掉 GitHub 官方的一些非仓库根路径
-const IGNORE_OWNERS = [
-    'settings', 'pulls', 'issues', 'search', 'notifications',
-    'explore', 'topics', 'trending', 'collections', 'events',
-    'sponsors', 'features', 'enterprise', 'team', 'pricing',
-    'about', 'contact', 'login', 'join'
-];
+const API_BASE = 'https://api.github.com';
+// 列表类链接单次展示的条目数
+const LIST_LIMIT = 10;
+// 发行版正文摘要的最大长度
+const RELEASE_BODY_LIMIT = 300;
+// 匹配消息中的 github.com 链接（左边界排除 api./gist. 等子域，允许 www.）
+const LINK_PATTERN = /(?<![\w.-])(?:www\.)?github\.com\/([^\s<>"'`]+)/gi;
+// GitHub 路径里允许出现的字符，用于在中文标点等字符处截断
+const PATH_CHARS = /[^A-Za-z0-9._~%+\-@/].*$/;
+// github.com 下指向站点功能而非用户/仓库的保留路径
+const RESERVED_PATHS = new Set([
+    'about', 'account', 'apps', 'blog', 'changelog', 'codespaces', 'collections', 'contact',
+    'copilot', 'customer-stories', 'dashboard', 'education', 'enterprise', 'events', 'explore',
+    'features', 'github-copilot', 'join', 'login', 'logout', 'marketplace', 'mobile', 'models',
+    'new', 'nonprofit', 'notifications', 'organizations', 'orgs', 'pricing', 'premium-support',
+    'pulls', 'readme', 'search', 'security', 'sessions', 'settings', 'signup', 'site', 'sitemap',
+    'sponsors', 'status', 'team', 'topics', 'trending', 'users', 'wiki',
+]);
+function isValidOwner(value) {
+    return /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/.test(value);
+}
+function isValidRepo(value) {
+    return /^[A-Za-z0-9._-]{1,100}$/.test(value);
+}
+/**
+ * 把 github.com/ 之后的路径解析成受支持的链接类型
+ */
+function parseGithubPath(segments) {
+    if (!segments.length)
+        return null;
+    // github.com/orgs/<org> 与 github.com/<org> 指向同一个组织主页
+    if (segments[0].toLowerCase() === 'orgs') {
+        const login = segments[1];
+        if (!login || segments.length > 2 || !isValidOwner(login))
+            return null;
+        return { type: 'org', id: login, url: `https://github.com/${login}` };
+    }
+    if (segments.length === 1) {
+        const login = segments[0];
+        if (RESERVED_PATHS.has(login.toLowerCase()) || !isValidOwner(login))
+            return null;
+        return { type: 'user', id: login, url: `https://github.com/${login}` };
+    }
+    const owner = segments[0];
+    if (RESERVED_PATHS.has(owner.toLowerCase()) || !isValidOwner(owner))
+        return null;
+    let repo = segments[1];
+    if (repo.toLowerCase().endsWith('.git'))
+        repo = repo.slice(0, -4);
+    if (!isValidRepo(repo) || repo === '.' || repo === '..')
+        return null;
+    const base = `${owner}/${repo}`;
+    const repoUrl = `https://github.com/${base}`;
+    if (segments.length === 2) {
+        return { type: 'repo', id: base, url: repoUrl };
+    }
+    const action = segments[2].toLowerCase();
+    const rest = segments.slice(3);
+    if (action === 'tree' && rest.length > 0) {
+        const refPath = rest.join('/');
+        return { type: 'tree', id: `${base}/tree/${refPath}`, url: `${repoUrl}/tree/${refPath}` };
+    }
+    if (action === 'branches' && rest.length === 0) {
+        return { type: 'branches', id: `${base}/branches`, url: `${repoUrl}/branches` };
+    }
+    if (action === 'tags' && rest.length === 0) {
+        return { type: 'tags', id: `${base}/tags`, url: `${repoUrl}/tags` };
+    }
+    if (action === 'releases') {
+        if (rest.length === 0) {
+            return { type: 'releases', id: `${base}/releases`, url: `${repoUrl}/releases` };
+        }
+        if (rest.length === 1 && rest[0].toLowerCase() === 'latest') {
+            return { type: 'release', id: `${base}/releases/latest`, url: `${repoUrl}/releases/latest` };
+        }
+        if (rest[0].toLowerCase() === 'tag' && rest.length > 1) {
+            const tag = rest.slice(1).join('/');
+            return { type: 'release', id: `${base}/releases/tag/${tag}`, url: `${repoUrl}/releases/tag/${tag}` };
+        }
+    }
+    return null;
+}
+/**
+ * 去掉查询串、锚点与句末标点，并切分成路径片段
+ */
+function normalizePath(raw) {
+    const path = raw
+        .replace(PATH_CHARS, '')
+        .replace(/[.,;:!?]+$/, '')
+        .replace(/\/+$/, '');
+    return path.split('/').filter(Boolean).map((segment) => {
+        try {
+            return decodeURIComponent(segment);
+        }
+        catch {
+            return segment;
+        }
+    });
+}
 /**
- * 在文本中匹配 GitHub 仓库链接
+ * 在文本中匹配 GitHub 链接
  */
 async function match(content, ctx, config) {
     const results = [];
     const seen = new Set();
-    for (const rule of linkRules) {
-        let m;
-        rule.pattern.lastIndex = 0;
-        while ((m = rule.pattern.exec(content)) !== null) {
-            const id = m[1];
-            const [owner] = id.split('/');
-            if (owner && IGNORE_OWNERS.includes(owner.toLowerCase())) {
-                continue;
-            }
-            if (!seen.has(id)) {
-                seen.add(id);
-                results.push({
-                    platform: exports.name,
-                    type: rule.type,
-                    id: id,
-                    url: `https://github.com/${id}`
-                });
-            }
-        }
+    LINK_PATTERN.lastIndex = 0;
+    let m;
+    while ((m = LINK_PATTERN.exec(content)) !== null) {
+        const parsed = parseGithubPath(normalizePath(m[1]));
+        if (!parsed)
+            continue;
+        if (seen.has(parsed.id))
+            continue;
+        seen.add(parsed.id);
+        results.push({
+            platform: exports.name,
+            type: parsed.type,
+            id: parsed.id,
+            url: parsed.url,
+        });
     }
     return results;
 }
+function getGithubToken(config) {
+    const raw = String(config.githubToken || '').trim();
+    // 允许直接粘贴 "Bearer xxx" 或 "token xxx"
+    return raw.replace(/^(?:bearer|token)\s+/i, '');
+}
+function requestOptions(config) {
+    const options = {
+        headers: {
+            'User-Agent': config.userAgent,
+            'Accept': 'application/vnd.github.v3+json',
+        },
+    };
+    const token = getGithubToken(config);
+    if (token) {
+        options.headers.Authorization = `Bearer ${token}`;
+    }
+    // 适配插件全局配置里的代理选项
+    if (config.proxy_settings[exports.name] && config.proxy) {
+        options.proxyAgent = config.proxy;
+    }
+    return options;
+}
+async function getOptional(ctx, config, url) {
+    try {
+        return await ctx.http.get(url, requestOptions(config));
+    }
+    catch {
+        return null;
+    }
+}
+function formatDate(value) {
+    if (!value)
+        return '未知';
+    const date = new Date(value);
+    if (isNaN(date.getTime()))
+        return '未知';
+    return date.toLocaleString('zh-CN', { hour12: false });
+}
+function shortSha(sha) {
+    return sha ? sha.slice(0, 7) : '';
+}
+function repoApiUrl(owner, repo) {
+    return `${API_BASE}/repos/${owner}/${repo}`;
+}
+function socialifyFlag(value, fallback) {
+    return (value === undefined ? fallback : value) ? '1' : '0';
+}
+function buildSocialifyUrl(config, owner, repo) {
+    // Socialify 的 /image 返回 SVG，部分适配器无法发送，这里固定取 /png
+    const params = [
+        `font=${encodeURIComponent(config.socialifyFont || 'Inter')}`,
+        `theme=${encodeURIComponent(config.socialifyTheme || 'Light')}`,
+        `pattern=${encodeURIComponent(config.socialifyPattern || 'Plus')}`,
+        `language=${socialifyFlag(config.socialifyLanguage, true)}`,
+        `owner=${socialifyFlag(config.socialifyOwner, true)}`,
+        `name=${socialifyFlag(config.socialifyName, true)}`,
+        `description=${socialifyFlag(config.socialifyDescription, false)}`,
+        `stargazers=${socialifyFlag(config.socialifyStars, true)}`,
+        `forks=${socialifyFlag(config.socialifyForks, true)}`,
+        `issues=${socialifyFlag(config.socialifyIssues, false)}`,
+        `pulls=${socialifyFlag(config.socialifyPulls, false)}`,
+    ];
+    return `https://socialify.git.ci/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/png?${params.join('&')}`;
+}
 /**
- * 处理单个 GitHub 链接
+ * 生成仓库封面图地址，用户/组织主页没有对应预览图，返回空
+ */
+function buildCoverUrl(config, owner, repo) {
+    if (!repo)
+        return '';
+    const mode = config.githubCover || 'off';
+    if (mode === 'off')
+        return '';
+    if (mode === 'socialify') {
+        return buildSocialifyUrl(config, owner, repo);
+    }
+    return `https://opengraph.githubassets.com/1/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`;
+}
+/**
+ * 解析单个 GitHub 链接
  */
 async function process(ctx, config, link, session) {
     const logger = ctx.logger(`share-links-analysis:${exports.name}`);
-    // 使用 GitHub 官方开放 API（免鉴权，有速率限制）
-    const repoUrl = `https://api.github.com/repos/${link.id}`;
+    const segments = link.id.split('/');
+    const [owner, repo] = segments;
     try {
-        logger.debug(`正在请求 GitHub API: ${repoUrl}`);
-        const reqOptions = {
-            headers: {
-                'User-Agent': config.userAgent,
-                'Accept': 'application/vnd.github.v3+json'
-            }
-        };
-        // 适配插件全局配置里的代理选项
-        if (config.proxy_settings[exports.name] && config.proxy) {
-            reqOptions.proxyAgent = config.proxy;
-        }
-        // 核心请求
-        const res = await ctx.http.get(repoUrl, reqOptions);
-        if (!res || !res.full_name) {
-            throw new Error('GitHub API 返回数据无效或仓库不存在');
+        switch (link.type) {
+            case 'user':
+            case 'org':
+                return await processProfile(ctx, config, link, owner, logger);
+            case 'repo':
+                return await processRepo(ctx, config, link, owner, repo, logger);
+            case 'tree':
+                return await processTree(ctx, config, link, owner, repo, segments.slice(3), logger);
+            case 'branches':
+            case 'tags':
+                return await processRefList(ctx, config, link, owner, repo, logger);
+            case 'releases':
+                return await processReleaseList(ctx, config, link, owner, repo, logger);
+            case 'release':
+                return await processRelease(ctx, config, link, owner, repo, segments.slice(3), logger);
+            default:
+                return null;
         }
-        // 尝试获取最新 Release（如果失败静默忽略，防止因限流导致整个卡片解析失败）
-        let latestRelease = '';
-        try {
-            const releaseRes = await ctx.http.get(`${repoUrl}/releases/latest`, reqOptions);
-            if (releaseRes && releaseRes.tag_name) {
-                latestRelease = releaseRes.tag_name;
-            }
+    }
+    catch (error) {
+        const status = error?.response?.status;
+        logger.error(`GitHub 解析失败: ${status ? `[HTTP ${status}] ` : ''}${error.message}`);
+        if (status === 401) {
+            logger.error('GitHub Token 无效，请检查「GitHub 解析设置」中的 Token');
         }
-        catch (e) {
-            logger.debug(`获取 Release 失败或触发限流: ${link.id}`);
+        else if (status === 403 || status === 429) {
+            logger.warn('GitHub API 速率限制已用尽，可在「GitHub 解析设置」配置 Token 提升上限');
         }
-        const title = res.full_name;
-        const authorName = res.owner?.login || 'Unknown';
-        // 提取高价值静态数据
-        const topics = res.topics && res.topics.length > 0 ? res.topics.slice(0, 5).join(', ') : '';
-        const updatedAt = new Date(res.pushed_at || res.updated_at).toLocaleString('zh-CN', { hour12: false });
-        const stars = (0, utils_1.numeral)(res.stargazers_count, config);
-        const forks = (0, utils_1.numeral)(res.forks_count, config);
-        const watchers = (0, utils_1.numeral)(res.subscribers_count || res.watchers_count, config);
-        const issues = (0, utils_1.numeral)(res.open_issues_count, config);
-        const statsString = `Stars: ${stars} | Forks: ${forks} | Watchers: ${watchers} | Issues: ${issues}`;
-        // 组装精炼的正文排版
-        let finalBody = res.description ? (0, utils_1.escapeHtml)(res.description) : '暂无描述';
-        // 补充 Fork 信息：判断是否为派生仓库
-        if (res.fork && res.parent?.full_name) {
-            finalBody = `Forked from: ${res.parent.full_name}\n\n` + finalBody;
+        return null;
+    }
+}
+/**
+ * 仓库主页
+ */
+async function processRepo(ctx, config, link, owner, repo, logger) {
+    const repoUrl = repoApiUrl(owner, repo);
+    logger.debug(`正在请求 GitHub API: ${repoUrl}`);
+    const res = await ctx.http.get(repoUrl, requestOptions(config));
+    if (!res || !res.full_name) {
+        throw new Error('GitHub API 返回数据无效或仓库不存在');
+    }
+    // 尝试获取最新 Release（如果失败静默忽略，防止因限流导致整个卡片解析失败）
+    let latestRelease = '';
+    try {
+        const releaseRes = await ctx.http.get(`${repoUrl}/releases/latest`, requestOptions(config));
+        if (releaseRes && releaseRes.tag_name) {
+            latestRelease = releaseRes.tag_name;
         }
-        if (topics) {
-            finalBody += `\n标签: ${(0, utils_1.escapeHtml)(topics)}`;
+    }
+    catch (e) {
+        logger.debug(`获取 Release 失败或触发限流: ${link.id}`);
+    }
+    const title = res.full_name;
+    const authorName = res.owner?.login || 'Unknown';
+    // 提取高价值静态数据
+    const topics = res.topics && res.topics.length > 0 ? res.topics.slice(0, 5).join(', ') : '';
+    const updatedAt = formatDate(res.pushed_at || res.updated_at);
+    const stars = (0, utils_1.numeral)(res.stargazers_count, config);
+    const forks = (0, utils_1.numeral)(res.forks_count, config);
+    const watchers = (0, utils_1.numeral)(res.subscribers_count || res.watchers_count, config);
+    const issues = (0, utils_1.numeral)(res.open_issues_count, config);
+    const statsString = `Stars: ${stars} | Forks: ${forks} | Watchers: ${watchers} | Issues: ${issues}`;
+    // 组装精炼的正文排版
+    let finalBody = res.description ? (0, utils_1.escapeHtml)(res.description) : '暂无描述';
+    // 补充 Fork 信息：判断是否为派生仓库
+    if (res.fork && res.parent?.full_name) {
+        finalBody = `Forked from: ${res.parent.full_name}\n\n` + finalBody;
+    }
+    if (topics) {
+        finalBody += `\n标签: ${(0, utils_1.escapeHtml)(topics)}`;
+    }
+    finalBody += `\n\n更新时间: ${updatedAt}`;
+    const metaInfo = [];
+    if (res.language)
+        metaInfo.push(`语言: ${res.language}`);
+    if (latestRelease)
+        metaInfo.push(`版本: ${latestRelease}`);
+    if (res.license?.spdx_id)
+        metaInfo.push(`协议: ${res.license.spdx_id}`);
+    if (metaInfo.length > 0) {
+        finalBody += `\n` + metaInfo.join(' | ');
+    }
+    return {
+        platform: exports.name,
+        title: title,
+        authorName: authorName,
+        mainbody: finalBody,
+        coverUrl: buildCoverUrl(config, owner, repo),
+        files: [],
+        sourceUrl: res.html_url,
+        stats: statsString,
+    };
+}
+/**
+ * 用户或组织主页
+ */
+async function processProfile(ctx, config, link, login, logger) {
+    const data = await ctx.http.get(`${API_BASE}/users/${encodeURIComponent(login)}`, requestOptions(config));
+    if (!data || !data.login) {
+        throw new Error('GitHub 用户或组织不存在');
+    }
+    const isOrg = data.type === 'Organization';
+    // /users 接口不返回组织简介，组织主页需要再取一次 /orgs
+    const orgData = isOrg ? await getOptional(ctx, config, `${API_BASE}/orgs/${encodeURIComponent(login)}`) : null;
+    const description = orgData?.description || data.description || data.bio;
+    const lines = [];
+    if (description)
+        lines.push((0, utils_1.escapeHtml)(String(description)));
+    if (data.company)
+        lines.push(`公司: ${(0, utils_1.escapeHtml)(data.company)}`);
+    if (data.location)
+        lines.push(`位置: ${(0, utils_1.escapeHtml)(data.location)}`);
+    if (data.blog)
+        lines.push(`主页: ${(0, utils_1.escapeHtml)(data.blog)}`);
+    if (data.twitter_username)
+        lines.push(`Twitter: @${(0, utils_1.escapeHtml)(data.twitter_username)}`);
+    lines.push(`类型: ${isOrg ? '组织' : '用户'}${orgData?.is_verified ? ' (已认证)' : ''}`);
+    lines.push(`创建时间: ${formatDate(data.created_at)}`);
+    const statsString = [
+        `仓库: ${(0, utils_1.numeral)(data.public_repos || 0, config)}`,
+        `关注者: ${(0, utils_1.numeral)(data.followers || 0, config)}`,
+        `关注: ${(0, utils_1.numeral)(data.following || 0, config)}`,
+    ].join(' | ');
+    return {
+        platform: exports.name,
+        title: data.name || data.login,
+        authorName: data.login,
+        mainbody: lines.join('\n'),
+        coverUrl: '',
+        files: [],
+        sourceUrl: data.html_url || link.url,
+        stats: statsString,
+    };
+}
+async function getLatestCommit(ctx, config, owner, repo, ref) {
+    try {
+        const url = `${repoApiUrl(owner, repo)}/commits?sha=${encodeURIComponent(ref)}&per_page=1`;
+        const res = await ctx.http.get(url, requestOptions(config));
+        return Array.isArray(res) && res.length > 0 ? res[0] : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function listRefNames(ctx, config, owner, repo, kind) {
+    try {
+        const res = await ctx.http.get(`${repoApiUrl(owner, repo)}/${kind}?per_page=100`, requestOptions(config));
+        if (!Array.isArray(res))
+            return [];
+        return res.map((item) => item?.name).filter((value) => typeof value === 'string');
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 在已知引用名中找出与路径片段前缀最长匹配的一项
+ */
+function longestRefPrefix(names, segments) {
+    let best = null;
+    let bestLength = 0;
+    for (const ref of names) {
+        const parts = ref.split('/');
+        if (parts.length === 0 || parts.length > segments.length || parts.length <= bestLength)
+            continue;
+        let matched = true;
+        for (let i = 0; i < parts.length; i++) {
+            if (parts[i] !== segments[i]) {
+                matched = false;
+                break;
+            }
         }
-        finalBody += `\n\n更新时间: ${updatedAt}`;
-        const metaInfo = [];
-        if (res.language)
-            metaInfo.push(`语言: ${res.language}`);
-        if (latestRelease)
-            metaInfo.push(`版本: ${latestRelease}`);
-        if (res.license?.spdx_id)
-            metaInfo.push(`协议: ${res.license.spdx_id}`);
-        if (metaInfo.length > 0) {
-            finalBody += `\n` + metaInfo.join(' | ');
+        if (!matched)
+            continue;
+        best = { ref, path: segments.slice(parts.length).join('/') };
+        bestLength = parts.length;
+    }
+    return best;
+}
+/**
+ * 解析 /tree/<ref> 里的引用：<ref> 之后可能还跟着目录路径，分支/标签名本身也可能带斜杠
+ */
+async function resolveTreeRef(ctx, config, owner, repo, segments, logger) {
+    if (segments.length === 0)
+        return null;
+    // 单段时不存在歧义，直接当作引用
+    if (segments.length === 1) {
+        const commit = await getLatestCommit(ctx, config, owner, repo, segments[0]);
+        if (!commit)
+            return null;
+        return { ref: segments[0], path: '', commit };
+    }
+    // 先尝试整段作为引用，例如分支 feature/xxx
+    const full = segments.join('/');
+    const fullCommit = await getLatestCommit(ctx, config, owner, repo, full);
+    if (fullCommit) {
+        return { ref: full, path: '', commit: fullCommit };
+    }
+    const branches = await listRefNames(ctx, config, owner, repo, 'branches');
+    const branchHit = longestRefPrefix(branches, segments);
+    if (branchHit) {
+        const commit = await getLatestCommit(ctx, config, owner, repo, branchHit.ref);
+        if (commit)
+            return { ref: branchHit.ref, kind: 'branch', path: branchHit.path, commit };
+    }
+    const tags = await listRefNames(ctx, config, owner, repo, 'tags');
+    const tagHit = longestRefPrefix(tags, segments);
+    if (tagHit) {
+        const commit = await getLatestCommit(ctx, config, owner, repo, tagHit.ref);
+        if (commit)
+            return { ref: tagHit.ref, kind: 'tag', path: tagHit.path, commit };
+    }
+    // 兜底：把首段当作引用，其余部分当作目录
+    logger.debug(`无法在分支/标签列表中确认引用，按首段解析: ${segments[0]}`);
+    const fallbackCommit = await getLatestCommit(ctx, config, owner, repo, segments[0]);
+    if (!fallbackCommit)
+        return null;
+    return { ref: segments[0], path: segments.slice(1).join('/'), commit: fallbackCommit };
+}
+/**
+ * 分支或标签页面
+ */
+async function processTree(ctx, config, link, owner, repo, segments, logger) {
+    const resolved = await resolveTreeRef(ctx, config, owner, repo, segments, logger);
+    if (!resolved) {
+        throw new Error('未找到对应的分支或标签');
+    }
+    const { ref, kind, path, commit } = resolved;
+    const kindLabel = kind === 'branch' ? '分支' : kind === 'tag' ? '标签' : '引用';
+    const lines = [];
+    lines.push(`仓库: ${owner}/${repo}`);
+    lines.push(`${kindLabel}: ${ref}`);
+    if (path)
+        lines.push(`路径: ${path}`);
+    let commitAuthor = '';
+    let commitDate = '';
+    if (commit) {
+        const message = String(commit.commit?.message || '').split('\n').filter(Boolean);
+        if (message.length > 0) {
+            lines.push('');
+            lines.push((0, utils_1.escapeHtml)(message.slice(0, 2).join('\n')));
         }
-        return {
-            platform: exports.name,
-            title: title,
-            authorName: authorName,
-            mainbody: finalBody,
-            coverUrl: '',
-            files: [],
-            sourceUrl: res.html_url,
-            stats: statsString,
-        };
+        commitAuthor = commit.author?.login || commit.commit?.author?.name || '';
+        commitDate = formatDate(commit.commit?.committer?.date || commit.commit?.author?.date);
+        const commitLine = [
+            shortSha(commit.sha),
+            commitAuthor,
+            commitDate,
+        ].filter(Boolean).join(' | ');
+        lines.push('');
+        lines.push(`提交: ${(0, utils_1.escapeHtml)(commitLine)}`);
     }
-    catch (error) {
-        logger.error(`GitHub 解析失败: ${error.message}`);
+    const title = path ? `${owner}/${repo} · ${ref}/${path}` : `${owner}/${repo} · ${ref}`;
+    return {
+        platform: exports.name,
+        title,
+        authorName: commitAuthor || owner,
+        mainbody: lines.join('\n'),
+        coverUrl: buildCoverUrl(config, owner, repo),
+        files: [],
+        sourceUrl: link.url,
+        stats: commitDate ? `最近提交: ${commitDate}` : '',
+    };
+}
+/**
+ * 分支列表或标签列表页面
+ */
+async function processRefList(ctx, config, link, owner, repo, logger) {
+    const kind = link.type === 'branches' ? 'branches' : 'tags';
+    const label = kind === 'branches' ? '分支' : '标签';
+    logger.debug(`正在请求 GitHub API: ${repoApiUrl(owner, repo)}/${kind}`);
+    const res = await ctx.http.get(`${repoApiUrl(owner, repo)}/${kind}?per_page=${LIST_LIMIT}`, requestOptions(config));
+    if (!Array.isArray(res)) {
+        throw new Error(`GitHub API 返回的${label}列表无效`);
+    }
+    const lines = res.length > 0
+        ? res.map((item) => {
+            const sha = shortSha(item?.commit?.sha);
+            const extra = item?.protected ? ' (受保护)' : '';
+            return `- ${(0, utils_1.escapeHtml)(String(item?.name || ''))}${sha ? ` (${sha})` : ''}${extra}`;
+        })
+        : [`暂无${label}`];
+    return {
+        platform: exports.name,
+        title: `${owner}/${repo} · ${label}列表`,
+        authorName: owner,
+        mainbody: lines.join('\n'),
+        coverUrl: buildCoverUrl(config, owner, repo),
+        files: [],
+        sourceUrl: link.url,
+        stats: res.length > 0 ? `显示前 ${res.length} 个` : '',
+    };
+}
+/**
+ * 发行版列表页面
+ */
+async function processReleaseList(ctx, config, link, owner, repo, logger) {
+    logger.debug(`正在请求 GitHub API: ${repoApiUrl(owner, repo)}/releases`);
+    const res = await ctx.http.get(`${repoApiUrl(owner, repo)}/releases?per_page=${LIST_LIMIT}`, requestOptions(config));
+    if (!Array.isArray(res)) {
+        throw new Error('GitHub API 返回的发行版列表无效');
+    }
+    const lines = res.length > 0
+        ? res.map((item) => {
+            const name = item?.name || item?.tag_name || '未命名';
+            const tags = [
+                item?.prerelease ? '预发布' : '',
+                item?.draft ? '草稿' : '',
+            ].filter(Boolean).join('、');
+            const date = item?.published_at ? formatDate(item.published_at) : '未发布';
+            return `- ${(0, utils_1.escapeHtml)(String(name))} (${(0, utils_1.escapeHtml)(String(item?.tag_name || ''))}) · ${date}${tags ? ` [${tags}]` : ''}`;
+        })
+        : ['暂无发行版'];
+    return {
+        platform: exports.name,
+        title: `${owner}/${repo} · 发行版列表`,
+        authorName: owner,
+        mainbody: lines.join('\n'),
+        coverUrl: buildCoverUrl(config, owner, repo),
+        files: [],
+        sourceUrl: link.url,
+        stats: res.length > 0 ? `显示前 ${res.length} 个` : '',
+    };
+}
+/**
+ * 发行版详情，支持 /releases/latest 与 /releases/tag/<tag>
+ */
+async function processRelease(ctx, config, link, owner, repo, segments, logger) {
+    const repoUrl = repoApiUrl(owner, repo);
+    let data;
+    if (segments.length === 1 && segments[0].toLowerCase() === 'latest') {
+        logger.debug(`正在请求 GitHub API: ${repoUrl}/releases/latest`);
+        data = await ctx.http.get(`${repoUrl}/releases/latest`, requestOptions(config));
+    }
+    else if (segments[0]?.toLowerCase() === 'tag' && segments.length > 1) {
+        const tag = segments.slice(1).join('/');
+        logger.debug(`正在请求 GitHub API: ${repoUrl}/releases/tags/${tag}`);
+        data = await ctx.http.get(`${repoUrl}/releases/tags/${encodeURIComponent(tag)}`, requestOptions(config));
+    }
+    else {
         return null;
     }
+    if (!data || !data.tag_name) {
+        throw new Error('GitHub API 返回的发行版数据无效');
+    }
+    const assets = Array.isArray(data.assets) ? data.assets : [];
+    const downloads = assets.reduce((sum, asset) => sum + (asset?.download_count || 0), 0);
+    const lines = [];
+    lines.push(`仓库: ${owner}/${repo}`);
+    lines.push(`标签: ${(0, utils_1.escapeHtml)(String(data.tag_name))}`);
+    lines.push(`发布: ${formatDate(data.published_at || data.created_at)}`);
+    const flags = [
+        data.prerelease ? '预发布' : '',
+        data.draft ? '草稿' : '',
+    ].filter(Boolean);
+    if (flags.length > 0)
+        lines.push(`状态: ${flags.join('、')}`);
+    if (data.author?.login)
+        lines.push(`发布者: ${(0, utils_1.escapeHtml)(data.author.login)}`);
+    const body = String(data.body || '')
+        .replace(/!\[[^\]]*\]\([^)]*\)/g, '')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+    if (body) {
+        const excerpt = body.length > RELEASE_BODY_LIMIT
+            ? body.slice(0, RELEASE_BODY_LIMIT) + '…'
+            : body;
+        lines.push('');
+        lines.push((0, utils_1.escapeHtml)(excerpt));
+    }
+    return {
+        platform: exports.name,
+        title: data.name || data.tag_name,
+        authorName: data.author?.login || owner,
+        mainbody: lines.join('\n'),
+        coverUrl: buildCoverUrl(config, owner, repo),
+        files: [],
+        sourceUrl: data.html_url || link.url,
+        stats: `附件: ${assets.length} | 下载: ${(0, utils_1.numeral)(downloads, config)}`,
+    };
 }

package/lib/parsers/xiaohongshu.js

@@ -34,7 +34,7 @@ const linkRules = [
         type: "explore",
     },
     {
-        pattern: /(?:https?:\/\/)?xhslink\.com\/(?:\w\/)?([a-zA-Z0-9]+)\b/gi,
+        pattern: /(?:https?:\/\/)?xhslink\.(?:com|cn)\/(?:\w\/)?([a-zA-Z0-9]+)\b/gi,
         type: "short",
     },
 ];
@@ -153,7 +153,7 @@ async function lc_get_cookie(ctx, config) {
 }
 /**
  * 从分享链接中解析出笔记 ID 与完整笔记地址。
- * 短链只跟随第一跳 (xhslink.com 的 Location 里已经带着完整地址和 token)，不需要登录态。
+ * 短链只跟随第一跳 (xhslink.com | xhslink.cn 的 Location 里已经带着完整地址和 token)，不需要登录态。
  */
 async function resolveShareLink(ctx, url, config, logger, proxy) {
     const direct = parseNoteLink(url);
@@ -280,7 +280,7 @@ async function fetchNoteHtml(ctx, config, logger, noteUrl) {
     throw lastError ?? new Error('获取小红书页面失败');
 }
 /**
- * 短链兜底：页面内 fetch 到 xhslink.com 属跨源会被拦，改为直接导航，
+ * 短链兜底：页面内 fetch 到 xhslink.com | xhslink.cn 属跨源会被拦，改为直接导航，
  * 再从最终地址里取出带 xsec_token 的笔记地址。
  */
 async function followShortLink(ctx, config, logger, shortUrl) {

package/lib/types.d.ts

@@ -60,6 +60,19 @@ export interface PluginConfig {
     allow_sensitive: boolean;
     youtube_ApiUrl: string;
     netease_apiUrl: string;
+    githubToken?: string;
+    githubCover?: 'off' | 'opengraph' | 'socialify';
+    socialifyTheme?: 'Light' | 'Dark';
+    socialifyFont?: string;
+    socialifyPattern?: string;
+    socialifyLanguage?: boolean;
+    socialifyOwner?: boolean;
+    socialifyName?: boolean;
+    socialifyDescription?: boolean;
+    socialifyStars?: boolean;
+    socialifyForks?: boolean;
+    socialifyIssues?: boolean;
+    socialifyPulls?: boolean;
     onebotReadDir: string;
     localDownloadDir: string;
     userAgent: string;

package/lib/utils.d.ts

@@ -4,6 +4,14 @@ import { Agent as HttpAgent } from 'http';
 import { Agent as HttpsAgent } from 'https';
 import 'koishi-plugin-adapter-onebot';
 export declare function buildTelemetryEndpoint(baseUrl: string, path: string): string;
+/**
+ * 把各种表示开关的输入统一映射为布尔值
+ * 支持布尔值、数字 0/1，以及大小写不敏感的 true/false、enable/disable、on/off、yes/no、
+ * 开启/关闭 等写法
+ * @param value 待识别的输入
+ * @returns 识别成功返回 true 或 false，无法识别返回 undefined
+ */
+export declare function parseBoolean(value: unknown): boolean | undefined;
 /**
  * 主动同步：从 CookieCloud 拉取并更新数据库
  * @returns 更新了多少个平台的 Cookie

package/lib/utils.js

@@ -37,6 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildTelemetryEndpoint = buildTelemetryEndpoint;
+exports.parseBoolean = parseBoolean;
 exports.syncCookiesFromCloud = syncCookiesFromCloud;
 exports.getCookie = getCookie;
 exports.expandShortLink = expandShortLink;
@@ -110,6 +111,34 @@ function buildTelemetryEndpoint(baseUrl, path) {
     const cleanBase = baseUrl.replace(/\/+$/, '');
     return `${cleanBase}${path}`;
 }
+/**
+ * 把各种表示开关的输入统一映射为布尔值
+ * 支持布尔值、数字 0/1，以及大小写不敏感的 true/false、enable/disable、on/off、yes/no、
+ * 开启/关闭 等写法
+ * @param value 待识别的输入
+ * @returns 识别成功返回 true 或 false，无法识别返回 undefined
+ */
+function parseBoolean(value) {
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number') {
+        if (value === 1)
+            return true;
+        if (value === 0)
+            return false;
+        return undefined;
+    }
+    if (typeof value !== 'string')
+        return undefined;
+    const normalized = value.trim().toLowerCase();
+    const truthy = ['true', 't', 'yes', 'y', 'on', 'enable', 'enabled', '1', '开', '开启', '打开', '启用', '是'];
+    const falsy = ['false', 'f', 'no', 'n', 'off', 'disable', 'disabled', '0', '关', '关闭', '禁用', '否'];
+    if (truthy.includes(normalized))
+        return true;
+    if (falsy.includes(normalized))
+        return false;
+    return undefined;
+}
 /**
  * OpenSSL EVP_BytesToKey 实现
  */
@@ -415,12 +444,45 @@ function parseHtmlToSegments(html) {
     }
     return segments;
 }
+const CONTENT_TYPE_EXT = {
+    'image/jpeg': '.jpg',
+    'image/png': '.png',
+    'image/gif': '.gif',
+    'image/webp': '.webp',
+    'image/avif': '.avif',
+    'image/bmp': '.bmp',
+    'image/svg+xml': '.svg',
+    'video/mp4': '.mp4',
+    'video/webm': '.webm',
+    'video/quicktime': '.mov',
+    'audio/mpeg': '.mp3',
+    'audio/mp4': '.m4a',
+    'audio/aac': '.aac',
+    'audio/ogg': '.ogg',
+    'audio/wav': '.wav',
+    'audio/flac': '.flac',
+};
+/**
+ * 从响应头 Content-Type 推断文件扩展名，URL 路径里没有扩展名时使用
+ */
+function extensionFromContentType(contentType) {
+    const mime = contentType.split(';')[0].trim().toLowerCase();
+    if (CONTENT_TYPE_EXT[mime])
+        return CONTENT_TYPE_EXT[mime];
+    const [type, subtype] = mime.split('/');
+    if ((type === 'image' || type === 'video' || type === 'audio') && subtype) {
+        const cleaned = subtype.replace(/[^a-z0-9]/g, '');
+        if (cleaned && cleaned !== 'octetstream')
+            return `.${cleaned}`;
+    }
+    return '.bin';
+}
 async function downloadAndMapUrl(ctx, url, proxy, userAgent, localDownloadDir, onebotReadDir, logger, enableCache, statsRef, cacheKey) {
     await fs.promises.mkdir(localDownloadDir, { recursive: true });
     // 1. 计算 Hash
     const hash = getFileCacheHash(url, cacheKey);
     const u = new url_1.URL(url);
-    const ext = path_1.default.extname(u.pathname).split('?')[0] || '.bin';
+    const urlExt = path_1.default.extname(u.pathname).split('?')[0];
     if (enableCache) {
         try {
             const cached = await findExistingFileCache(ctx, url, cacheKey);
@@ -474,22 +536,26 @@ async function downloadAndMapUrl(ctx, url, proxy, userAgent, localDownloadDir, o
         }
     }
     // 2. 生成文件名 (使用 Hash 以实现去重)
-    const safeFilename = `${hash}${ext}`;
-    const actualPath = path_1.default.join(localDownloadDir, safeFilename);
-    const onebotPath = path_1.default.posix.join(onebotReadDir, safeFilename);
-    const fileUrl = `file://${onebotPath}`;
+    // URL 自带扩展名时可以直接落盘；猜不到扩展名时等拿到 Content-Type 再决定
+    const buildTarget = (ext) => {
+        const safeFilename = `${hash}${ext}`;
+        const actualPath = path_1.default.join(localDownloadDir, safeFilename);
+        const onebotPath = path_1.default.posix.join(onebotReadDir, safeFilename);
+        return { actualPath, fileUrl: `file://${onebotPath}` };
+    };
+    let target = urlExt ? buildTarget(urlExt) : null;
     // 3. 检查本地文件是否存在 (双重保险，或者应对未清理的情况)
-    if (enableCache && fs.existsSync(actualPath)) {
+    if (enableCache && target && fs.existsSync(target.actualPath)) {
         // 补写数据库
         await ctx.database.upsert('sla_file_cache', [{
                 hash,
-                path: actualPath,
+                path: target.actualPath,
                 url,
                 created_at: Date.now()
             }]);
         if (statsRef)
             statsRef.fileCacheHits = (statsRef.fileCacheHits || 0) + 1;
-        return fileUrl;
+        return target.fileUrl;
     }
     const attemptDownload = () => new Promise((resolve, reject) => {
         const agent = getProxyAgent(proxy, url);
@@ -523,6 +589,11 @@ async function downloadAndMapUrl(ctx, url, proxy, userAgent, localDownloadDir, o
                 reject(new Error(`Unexpected content type: ${contentType}`));
                 return;
             }
+            if (!target) {
+                target = buildTarget(extensionFromContentType(contentType));
+            }
+            const actualPath = target.actualPath;
+            const fileUrl = target.fileUrl;
             const pipelineAsync = (0, util_1.promisify)(stream_1.pipeline);
             pipelineAsync(res, (0, fs_1.createWriteStream)(actualPath))
                 .then(async () => {

package/package.json

@@ -2,7 +2,7 @@
   "name": "koishi-plugin-share-links-analysis",
   "description": "Koishi 多平台分享链接解析插件，支持内容预览、媒体提取与缓存。",
   "license": "MIT",
-  "version": "0.15.3",
+  "version": "0.15.4",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [