koishi-plugin-share-links-analysis 0.15.2 → 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

@@ -98,6 +98,10 @@ exports.Config = koishi_1.Schema.intersect([
         parseLimit: koishi_1.Schema.number().default(3).description("单对话多链接解析上限"),
         useNumeral: koishi_1.Schema.boolean().default(true).description("使用格式化数字 (如 10000 -> 1万)"),
         showError: koishi_1.Schema.boolean().default(false).description("当链接被阻止时提醒发送者"),
+        sensitiveMessage: koishi_1.Schema.string().role('textarea').default(`内容包含敏感信息，已停止解析
+如果你是管理员，你可以通过 help share 指令获取更多帮助`).description("内容被判定为敏感且当前会话不允许时返回的提示文案。"),
+        blockedMessage: koishi_1.Schema.string().role('textarea').default(`根据策略，该链接已被阻止解析：平台：{platform}
+如果你是管理员，你可以通过 help share 指令获取更多帮助`).description("链接被会话策略阻止时返回的提示文案。<br/>可用占位符: `{platform}`"),
     }).description("高级解析设置"),
     koishi_1.Schema.object({
         cookieCloud: koishi_1.Schema.object({
@@ -123,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"),
@@ -739,52 +795,71 @@ function apply(ctx, config) {
         ctx.setInterval(cleanExpiredCache, config.autoCleanInterval * 60 * 60 * 1000);
     }
     // 注册指令
+    /**
+     * 会话设置的管理权限：群聊要求管理员，私聊里会话本身就是自己的作用域
+     */
+    const canManageSettings = async (session) => {
+        if (!session.guildId)
+            return true;
+        if (!session.userId)
+            return false;
+        return await (0, utils_1.isUserAdmin)(session, session.userId);
+    };
     const cmd = ctx.command('share', '分享解析插件配置', { authority: 1 })
         .action(async ({ session }) => {
-        if (!session?.guildId || !session?.userId)
-            return '该指令只能在群组中使用。';
-        const { parsers, nsfw } = await (0, utils_1.getEffectiveSettings)(ctx, session.guildId, config);
+        const scope = session && (0, utils_1.getSettingsScope)(session);
+        if (!scope)
+            return '当前会话不可用。';
+        const { parsers, nsfw } = await (0, utils_1.getEffectiveSettings)(ctx, scope, config);
         const parserList = Object.entries(parsers)
             .map(([name, enabled]) => `${enabled ? '✅' : '❌'} ${name}`)
             .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) => {
-        if (!session?.guildId || !session?.userId)
-            return '该指令只能在群组中使用。';
-        if (!await (0, utils_1.isUserAdmin)(session, session.userId))
+        const scope = session && (0, utils_1.getSettingsScope)(session);
+        if (!scope)
+            return '当前会话不可用。';
+        if (!await canManageSettings(session))
             return '权限不足';
         const isValidParser = (name) => core_1.parsers_str.includes(name);
         if (!isValidParser(parser))
             return '请输入正确的解析器名称';
-        if (!value)
-            return '请输入正确的模式';
-        const mode = value.trim().toLowerCase() === 'true';
-        const data = await ctx.database.get('sla_group_settings', session.guildId);
+        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: session.guildId, custom_parsers: final_parsers };
+        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) => {
-        if (!session?.guildId || !session?.userId)
-            return '该指令只能在群组中使用。';
-        if (!await (0, utils_1.isUserAdmin)(session, session.userId))
+        const scope = session && (0, utils_1.getSettingsScope)(session);
+        if (!scope)
+            return '当前会话不可用。';
+        if (!await canManageSettings(session))
             return '权限不足';
-        const mode = value.trim().toLowerCase() === 'true';
-        const record = { guildId: session.guildId, nsfw_enabled: mode };
+        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');
     });
     cmd.subcommand('.reset', '重置为全局默认设置', { authority: 1 })
         .action(async ({ session }) => {
-        if (!session?.guildId || !session?.userId)
-            return '该指令只能在群组中使用。';
-        if (!await (0, utils_1.isUserAdmin)(session, session.userId))
+        const scope = session && (0, utils_1.getSettingsScope)(session);
+        if (!scope)
+            return '当前会话不可用。';
+        if (!await canManageSettings(session))
             return '权限不足';
-        await ctx.database.remove('sla_group_settings', { guildId: session.guildId });
-        return '已重置为全局默认设置。';
+        await ctx.database.remove('sla_group_settings', { guildId: scope });
+        await session.send('已重置为全局默认设置。');
+        await session.execute('share');
     });
     cmd.subcommand('.migratecache', '迁移旧解析缓存到新时间线并校验', { authority: 4 })
         .action(async () => {
@@ -1110,22 +1185,13 @@ function apply(ctx, config) {
             return next();
         let linkCount = 0;
         for (const link of links) {
-            if (session.guildId) {
-                const settings = await (0, utils_1.getEffectiveSettings)(ctx, session.guildId, config);
-                if (!settings.parsers[link.platform]) {
-                    logger.debug(`根据策略，该链接已被阻止解析：平台：${link.platform}，链接：${link.url}`);
-                    if (config.showError)
-                        await session.send(`根据策略，该链接已被阻止解析：平台：${link.platform}\n如果你是管理员，你可以通过#help share指令获取更多帮助`);
-                    continue;
-                }
-            }
-            else {
-                if (!config.default_parsers[link.platform]) {
-                    logger.debug(`根据策略，该链接已被阻止解析：平台：${link.platform}，链接：${link.url}`);
-                    if (config.showError)
-                        await session.send(`根据策略，该链接已被阻止解析：平台：${link.platform}`);
-                    continue;
-                }
+            // 会话策略（群组自定义或全局默认）在解析前后都要用到，这里取一次
+            const settings = await (0, utils_1.getEffectiveSettings)(ctx, (0, utils_1.getSettingsScope)(session), config);
+            if (!settings.parsers[link.platform]) {
+                logger.debug(`根据策略，该链接已被阻止解析：平台：${link.platform}，链接：${link.url}`);
+                if (config.showError)
+                    await session.send(config.blockedMessage.replace(/\{platform\}/g, link.platform));
+                continue;
             }
             if (linkCount >= config.parseLimit) {
                 await session.send("已达到单次解析上限…");
@@ -1292,6 +1358,15 @@ function apply(ctx, config) {
                 }
                 if (result) {
                     lastProcessedUrls[channelId][link.url] = Date.now();
+                    // 敏感内容在会话层统一拦截：解析结果来自缓存时同样要过这一关
+                    if (result.sensitive && !settings.nsfw) {
+                        result = {
+                            ...result,
+                            mainbody: (0, utils_1.escapeHtml)(config.sensitiveMessage),
+                            coverUrl: undefined,
+                            files: []
+                        };
+                    }
                     await (0, utils_1.sendResult)(ctx, session, config, result, logger, sendStats);
                 }
                 else {

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>;