koishi-plugin-cfmrmod 1.1.9 → 1.1.10

package/dist/cfmr/index.js

@@ -12,6 +12,7 @@ const { Schema, h } = require('koishi');
 const fetch = require('node-fetch');
 const cheerio = require('cheerio');
 const { marked } = require('marked');
+const match_1 = require("../match");
 let createCanvas;
 let loadImage;
 let Path2DRef;
@@ -2478,7 +2479,30 @@ function apply(ctx, config) {
             list.map((item, i) => `${i + 1 + page * size}. [${item.platform}] ${item.name} - ${item.author}`).join('\n') +
             '\n请输入序号查看详情 (p/n 翻页, q 退出)';
     };
-    const handleSearch = async (session, platform, type, keyword, useEnglish = false) => {
+    const renderProjectResult = async (session, item, useEnglish = false) => {
+        let detailData;
+        if (item.platform === 'Modrinth')
+            detailData = await fetchModrinthDetail(item.id, config.requestTimeout);
+        else
+            detailData = await fetchCurseForgeDetail(item.id, config.curseforgeApiKey, config.requestTimeout, item._cfUrl);
+        detailData.type = item.type;
+        detailData._lang = useEnglish ? 'en' : 'zh';
+        const imgBufs = detailData.source === 'CurseForge'
+            ? await drawProjectCardCF({
+                ...detailData,
+                maxCanvasHeight: config.maxCanvasHeight || 8000
+            })
+            : await drawProjectCard({
+                ...detailData,
+                maxCanvasHeight: config.maxCanvasHeight || 8000
+            });
+        for (const buf of imgBufs) {
+            await session.send(h.image(await toImageSrc(buf)));
+        }
+        if (config.sendLink)
+            await session.send(`${useEnglish ? 'Link' : '链接'}: ${detailData.url}`);
+    };
+    const handleSearch = async (session, platform, type, keyword, useEnglish = false, direct = false) => {
         if (!keyword) {
             await session.send(useEnglish ? 'Please enter a keyword' : '请输入关键词');
             return;
@@ -2498,30 +2522,21 @@ function apply(ctx, config) {
             await session.send(useEnglish ? 'No results found' : '未找到结果');
             return;
         }
+        const directItem = direct ? (0, match_1.selectExactSearchResult)(results, keyword) : null;
+        if (directItem) {
+            try {
+                await renderProjectResult(session, directItem, useEnglish);
+            }
+            catch (e) {
+                logger.error(e);
+                return session.send(`${useEnglish ? 'Generation failed' : '生成失败'}: ${e.message}`);
+            }
+            return;
+        }
         if (results.length === 1) {
             const item = results[0];
             try {
-                let detailData;
-                if (item.platform === 'Modrinth')
-                    detailData = await fetchModrinthDetail(item.id, config.requestTimeout);
-                else
-                    detailData = await fetchCurseForgeDetail(item.id, config.curseforgeApiKey, config.requestTimeout, item._cfUrl);
-                detailData.type = item.type;
-                detailData._lang = useEnglish ? 'en' : 'zh';
-                const imgBufs = detailData.source === 'CurseForge'
-                    ? await drawProjectCardCF({
-                        ...detailData,
-                        maxCanvasHeight: config.maxCanvasHeight || 8000
-                    })
-                    : await drawProjectCard({
-                        ...detailData,
-                        maxCanvasHeight: config.maxCanvasHeight || 8000
-                    });
-                for (const buf of imgBufs) {
-                    await session.send(h.image(await toImageSrc(buf)));
-                }
-                if (config.sendLink)
-                    await session.send(`${useEnglish ? 'Link' : '链接'}: ${detailData.url}`);
+                await renderProjectResult(session, item, useEnglish);
             }
             catch (e) {
                 logger.error(e);
@@ -2564,27 +2579,7 @@ function apply(ctx, config) {
                 await tryWithdraw(session, state.listMessageIds);
                 states.delete(session.cid);
                 try {
-                    let detailData;
-                    if (item.platform === 'Modrinth')
-                        detailData = await fetchModrinthDetail(item.id, config.requestTimeout);
-                    else
-                        detailData = await fetchCurseForgeDetail(item.id, config.curseforgeApiKey, config.requestTimeout, item._cfUrl);
-                    detailData.type = item.type;
-                    detailData._lang = useEnglish ? 'en' : 'zh';
-                    const imgBufs = detailData.source === 'CurseForge'
-                        ? await drawProjectCardCF({
-                            ...detailData,
-                            maxCanvasHeight: config.maxCanvasHeight || 8000
-                        })
-                        : await drawProjectCard({
-                            ...detailData,
-                            maxCanvasHeight: config.maxCanvasHeight || 8000
-                        });
-                    for (const buf of imgBufs) {
-                        await session.send(h.image(await toImageSrc(buf)));
-                    }
-                    if (config.sendLink)
-                        await session.send(`${useEnglish ? 'Link' : '链接'}: ${detailData.url}`);
+                    await renderProjectResult(session, item, useEnglish);
                 }
                 catch (e) {
                     logger.error(e);
@@ -2636,35 +2631,39 @@ function apply(ctx, config) {
     ['mod', 'pack', 'resource', 'shader', 'plugin'].forEach(t => {
         ctx.command(`${mrPrefix}.${t} [...keyword]`, `搜索 Modrinth ${t}`)
             .option('e', '-e 使用英文', { fallback: false })
+            .option('direct', '-d, --direct 精确命中时直接渲染', { fallback: false })
             .action((argv, ...args) => {
-            var _a;
+            var _a, _b;
             const allArgs = args.flat().map(String);
             const kw = allArgs.join(' ');
-            return handleSearch(argv.session, 'mr', t, kw, ((_a = argv.options) === null || _a === void 0 ? void 0 : _a.e) === true);
+            return handleSearch(argv.session, 'mr', t, kw, ((_a = argv.options) === null || _a === void 0 ? void 0 : _a.e) === true, ((_b = argv.options) === null || _b === void 0 ? void 0 : _b.direct) === true);
         });
         ctx.command(`${cfPrefix}.${t} [...keyword]`, `搜索 CurseForge ${t}`)
             .option('e', '-e 使用英文', { fallback: false })
+            .option('direct', '-d, --direct 精确命中时直接渲染', { fallback: false })
             .action((argv, ...args) => {
-            var _a;
+            var _a, _b;
             const allArgs = args.flat().map(String);
             const kw = allArgs.join(' ');
-            return handleSearch(argv.session, 'cf', t, kw, ((_a = argv.options) === null || _a === void 0 ? void 0 : _a.e) === true);
+            return handleSearch(argv.session, 'cf', t, kw, ((_a = argv.options) === null || _a === void 0 ? void 0 : _a.e) === true, ((_b = argv.options) === null || _b === void 0 ? void 0 : _b.direct) === true);
         });
     });
     ctx.command(`${mrPrefix} [...keyword]`, '搜索 Modrinth 模组')
         .option('e', '-e 使用英文', { fallback: false })
+        .option('direct', '-d, --direct 精确命中时直接渲染', { fallback: false })
         .action((argv, ...args) => {
-        var _a;
+        var _a, _b;
         const allArgs = args.flat().map(String);
         const kw = allArgs.join(' ');
-        return handleSearch(argv.session, 'mr', 'mod', kw, ((_a = argv.options) === null || _a === void 0 ? void 0 : _a.e) === true);
+        return handleSearch(argv.session, 'mr', 'mod', kw, ((_a = argv.options) === null || _a === void 0 ? void 0 : _a.e) === true, ((_b = argv.options) === null || _b === void 0 ? void 0 : _b.direct) === true);
     });
     ctx.command(`${cfPrefix} [...keyword]`, '搜索 CurseForge 模组')
         .option('e', '-e 使用英文', { fallback: false })
+        .option('direct', '-d, --direct 精确命中时直接渲染', { fallback: false })
         .action((argv, ...args) => {
-        var _a;
+        var _a, _b;
         const allArgs = args.flat().map(String);
         const kw = allArgs.join(' ');
-        return handleSearch(argv.session, 'cf', 'mod', kw, ((_a = argv.options) === null || _a === void 0 ? void 0 : _a.e) === true);
+        return handleSearch(argv.session, 'cf', 'mod', kw, ((_a = argv.options) === null || _a === void 0 ? void 0 : _a.e) === true, ((_b = argv.options) === null || _b === void 0 ? void 0 : _b.direct) === true);
     });
 }

package/dist/match.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeSearchText = normalizeSearchText;
+exports.searchAliases = searchAliases;
+exports.scoreSearchResult = scoreSearchResult;
+exports.selectExactSearchResult = selectExactSearchResult;
+function cleanQueryText(value) {
+    let text = String(value || '').trim();
+    const intentWords = [
+        '帮我', '请', '查询一下', '查一下', '搜索一下', '查询', '搜索', '找一下', '找',
+        '模组', '整合包', '资源包', '材质包', '材质', '光影', '插件', '教程', '作者', '用户',
+        '评论', '短评', '本体', '本身', '详情', '页面',
+    ];
+    let changed = true;
+    while (changed && text) {
+        changed = false;
+        for (const word of intentWords) {
+            if (text.startsWith(word)) {
+                text = text.slice(word.length).trim();
+                changed = true;
+            }
+            if (text.endsWith(word)) {
+                text = text.slice(0, -word.length).trim();
+                changed = true;
+            }
+        }
+    }
+    return text;
+}
+function stripHtml(value) {
+    return String(value || '').replace(/<[^>]+>/g, ' ');
+}
+function normalizeSearchText(value) {
+    return stripHtml(value)
+        .toLowerCase()
+        .normalize('NFKC')
+        .replace(/&[a-z0-9#]+;/gi, ' ')
+        .replace(/[\s"'`‘’“”.,，。:：;；!！?？()[\]（）【】{}<>《》_\-–—+|/\\]+/g, '')
+        .trim();
+}
+function words(value) {
+    return stripHtml(value).match(/[A-Za-z0-9]+/g) || [];
+}
+function acronym(value) {
+    const list = words(value);
+    if (list.length < 2)
+        return '';
+    return list.map(word => word[0]).join('').toLowerCase();
+}
+function pushAlias(aliases, value) {
+    const text = stripHtml(value).replace(/\s+/g, ' ').trim();
+    if (!text)
+        return;
+    aliases.push(text);
+}
+function searchAliases(item) {
+    var _a;
+    const aliases = [];
+    const fields = [item === null || item === void 0 ? void 0 : item.name, item === null || item === void 0 ? void 0 : item.title, item === null || item === void 0 ? void 0 : item.modName, item === null || item === void 0 ? void 0 : item.id].filter(Boolean);
+    for (const field of fields) {
+        const text = stripHtml(field).replace(/\s+/g, ' ').trim();
+        pushAlias(aliases, text);
+        text.replace(/[\[(（【]([^\])）】]+)[\])）】]/g, (_, alias) => {
+            pushAlias(aliases, alias);
+            return '';
+        });
+        pushAlias(aliases, text.replace(/[\[(（【][^\])）】]+[\])）】]/g, ' '));
+        const leading = (_a = text.match(/^\s*[\[(（【]([^\])）】]+)[\])）】]/)) === null || _a === void 0 ? void 0 : _a[1];
+        if (leading)
+            pushAlias(aliases, leading);
+        const acro = acronym(text);
+        if (acro)
+            pushAlias(aliases, acro);
+    }
+    return Array.from(new Set(aliases));
+}
+function looksLikeShortAcronym(queryNorm) {
+    return /^[a-z0-9]{2,5}$/.test(queryNorm);
+}
+function hasAddonWords(value) {
+    return /附属|支持|扩展|集成|兼容|插件|addon|addons|integration|integrations|support|supports|plugin|plugins|bee|bees|hider|history|utility|utilities/i
+        .test(String(value || ''));
+}
+function scoreSearchResult(item, query) {
+    const rawQuery = cleanQueryText(query);
+    const queryNorm = normalizeSearchText(rawQuery);
+    if (!queryNorm)
+        return 0;
+    let best = 0;
+    const title = String((item === null || item === void 0 ? void 0 : item.name) || (item === null || item === void 0 ? void 0 : item.title) || '');
+    const titleNorm = normalizeSearchText(title);
+    const aliases = searchAliases(item);
+    for (const alias of aliases) {
+        const aliasNorm = normalizeSearchText(alias);
+        if (!aliasNorm)
+            continue;
+        if (aliasNorm === queryNorm)
+            best = Math.max(best, 1000);
+        if (acronym(alias) === queryNorm) {
+            const firstWord = normalizeSearchText(words(alias)[0] || '');
+            best = Math.max(best, firstWord === queryNorm ? 640 : 940);
+        }
+        if (aliasNorm.startsWith(queryNorm)) {
+            const lengthPenalty = Math.min(180, Math.max(0, aliasNorm.length - queryNorm.length) * 4);
+            const base = looksLikeShortAcronym(queryNorm) ? 620 : 820;
+            best = Math.max(best, base - lengthPenalty);
+        }
+        if (queryNorm.length >= 3 && aliasNorm.includes(queryNorm)) {
+            const lengthPenalty = Math.min(160, Math.max(0, aliasNorm.length - queryNorm.length) * 2);
+            best = Math.max(best, 520 - lengthPenalty);
+        }
+    }
+    if (titleNorm && titleNorm === queryNorm)
+        best = Math.max(best, 1000);
+    if (titleNorm && titleNorm.startsWith(queryNorm)) {
+        const base = looksLikeShortAcronym(queryNorm) ? 580 : 760;
+        best = Math.max(best, base - Math.min(120, titleNorm.length - queryNorm.length));
+    }
+    if (looksLikeShortAcronym(queryNorm) && hasAddonWords(title))
+        best = Math.max(0, best - 260);
+    return best;
+}
+function selectExactSearchResult(results, query, minScore = 700) {
+    let best = null;
+    let bestScore = 0;
+    for (const item of results || []) {
+        const score = scoreSearchResult(item, query);
+        if (score > bestScore) {
+            best = item;
+            bestScore = score;
+        }
+    }
+    return best && bestScore >= minScore ? best : null;
+}

package/dist/mcmod/plugin.js

@@ -9,6 +9,7 @@ const http_1 = require("./http");
 const rendering_1 = require("./rendering");
 const search_1 = require("./search");
 const utils_1 = require("./utils");
+const match_1 = require("../match");
 // ================= 状态管理和常量 =================
 const searchStates = new Map();
 const commentStates = new Map();
@@ -196,6 +197,57 @@ function apply(ctx, config) {
         commentListStates.set(session.cid, nextState);
         return nextState;
     }
+    async function renderSearchItem(session, item, type) {
+        var _a;
+        await (0, http_1.ensureValidCookie)();
+        let img;
+        if (type === 'author')
+            img = await (0, cards_1.drawAuthorCard)(item.link);
+        else if (type === 'user') {
+            const uid = ((_a = item.link.match(/\/(\d+)(?:\.html|\/)?$/)) === null || _a === void 0 ? void 0 : _a[1]) || '0';
+            img = await (0, cards_1.drawCenterCardImpl)(uid, logger);
+        }
+        else if (type === 'mod' || type === 'pack')
+            img = await (0, cards_1.drawModCard)(item.link);
+        else if (type === 'tutorial')
+            img = await (0, cards_1.drawTutorialCard)(item.link);
+        else
+            img = await (0, cards_1.createInfoCard)(item.link, type);
+        await session.send(h.image(await (0, utils_1.toImageSrc)(img)));
+        if (config.sendLink)
+            await session.send(`链接: ${item.link}`);
+    }
+    async function renderDirectSearchTarget(session, item, type, options = {}) {
+        clearState(session.cid);
+        clearCommentState(session.cid);
+        clearCommentListState(session.cid);
+        if (options === null || options === void 0 ? void 0 : options.commentTarget) {
+            const state = {
+                url: item.link,
+                target: String(options.commentTarget),
+                pageSize: getCommentPageSize(options === null || options === void 0 ? void 0 : options.size),
+                page: 1,
+                totalPages: 1,
+                messageIds: [],
+                timer: null,
+            };
+            await renderCommentPage(session, state, state.page);
+            return;
+        }
+        if (options === null || options === void 0 ? void 0 : options.comments) {
+            const state = {
+                url: item.link,
+                pageSize: getCommentPageSize(options === null || options === void 0 ? void 0 : options.size),
+                page: 1,
+                totalPages: 1,
+                messageIds: [],
+                timer: null,
+            };
+            await renderCommentListPage(session, state, state.page);
+            return;
+        }
+        await renderSearchItem(session, item, type);
+    }
     // --- 注册指令 ---
     const prefix = ((_a = config === null || config === void 0 ? void 0 : config.prefixes) === null || _a === void 0 ? void 0 : _a.cnmc) || 'cnmc';
     const commandTypes = ['mod', 'data', 'pack', 'tutorial', 'author', 'user'];
@@ -204,6 +256,7 @@ function apply(ctx, config) {
         `${prefix}.mod/.data/.pack/.tutorial/.author/.user <关键词>`,
         `${prefix}.comment <url> <楼层|id:评论ID> [page]  | 渲染评论与子评论`,
         `${prefix}.comments <url> [page]  | 渲染页面主评论列表`,
+        '选项：--direct 精确命中时直接出图，--comments 精确命中时渲染评论列表',
         '列表交互：输入序号查看，n 下一页，p 上一页，q 退出',
     ].join('\n'));
     ctx.command(`${prefix}.comment <url:string> <target:string> [page:number]`, '渲染 MCMod 评论与子评论')
@@ -263,40 +316,35 @@ function apply(ctx, config) {
     });
     commandTypes.forEach(type => {
         ctx.command(`${prefix}.${type} <keyword:text>`)
-            .action(async ({ session }, keyword) => {
+            .option('direct', '-d, --direct 精确命中时直接渲染')
+            .option('comments', '--comments 精确命中时渲染主评论列表')
+            .option('commentTarget', '--comment-target <target:string> 精确命中时渲染指定楼层或评论 ID')
+            .option('size', '-s, --size <size:number> 评论单页数量')
+            .action(async ({ session, options }, keyword) => {
             if (!keyword)
                 return '请输入关键词。';
             // 将搜索任务加入队列
             enqueue(session, `search-${type}`, async () => {
-                var _a;
                 try {
                     if (config.debug)
                         logger.debug(`[${session.userId}] 正在搜索 ${keyword} ...`);
-                    let results = await (0, search_1.fetchSearch)(keyword, type);
+                    const directMode = !!((options === null || options === void 0 ? void 0 : options.direct) || (options === null || options === void 0 ? void 0 : options.comments) || (options === null || options === void 0 ? void 0 : options.commentTarget));
+                    const searchResult = directMode
+                        ? await (0, search_1.fetchDirectSearch)(keyword, type)
+                        : { results: await (0, search_1.fetchSearch)(keyword, type), direct: null };
+                    let results = searchResult.results;
                     if (!results.length) {
                         await session.send('未找到相关结果。(备用也没用，我劝你换个关键词试试)');
                         return;
                     }
+                    const directItem = searchResult.direct || (directMode ? (0, match_1.selectExactSearchResult)(results, keyword) : null);
+                    if (directItem) {
+                        await renderDirectSearchTarget(session, directItem, type, options);
+                        return;
+                    }
                     // 单结果直接处理
                     if (results.length === 1) {
-                        const item = results[0];
-                        await (0, http_1.ensureValidCookie)();
-                        let img;
-                        if (type === 'author')
-                            img = await (0, cards_1.drawAuthorCard)(item.link);
-                        else if (type === 'user') {
-                            const uid = ((_a = item.link.match(/\/(\d+)(?:\.html|\/)?$/)) === null || _a === void 0 ? void 0 : _a[1]) || '0';
-                            img = await (0, cards_1.drawCenterCardImpl)(uid, logger);
-                        }
-                        else if (type === 'mod' || type === 'pack')
-                            img = await (0, cards_1.drawModCard)(item.link);
-                        else if (type === 'tutorial')
-                            img = await (0, cards_1.drawTutorialCard)(item.link);
-                        else
-                            img = await (0, cards_1.createInfoCard)(item.link, type);
-                        await session.send(h.image(await (0, utils_1.toImageSrc)(img)));
-                        if (config.sendLink)
-                            await session.send(`链接: ${item.link}`);
+                        await renderDirectSearchTarget(session, results[0], type, options);
                         return;
                     }
                     // 多结果：初始化状态（隔离在 session.cid）
@@ -319,25 +367,33 @@ function apply(ctx, config) {
         });
     });
     ctx.command(`${prefix} <keyword:text>`)
-        .action(async ({ session }, keyword) => {
+        .option('direct', '-d, --direct 精确命中时直接渲染')
+        .option('comments', '--comments 精确命中时渲染主评论列表')
+        .option('commentTarget', '--comment-target <target:string> 精确命中时渲染指定楼层或评论 ID')
+        .option('size', '-s, --size <size:number> 评论单页数量')
+        .action(async ({ session, options }, keyword) => {
         if (!keyword)
             return '请输入关键词。';
         enqueue(session, 'search-mod', async () => {
             try {
                 if (config.debug)
                     logger.debug(`[${session.userId}] 正在搜索 ${keyword} ...`);
-                const results = await (0, search_1.fetchSearch)(keyword, 'mod');
+                const directMode = !!((options === null || options === void 0 ? void 0 : options.direct) || (options === null || options === void 0 ? void 0 : options.comments) || (options === null || options === void 0 ? void 0 : options.commentTarget));
+                const searchResult = directMode
+                    ? await (0, search_1.fetchDirectSearch)(keyword, 'mod')
+                    : { results: await (0, search_1.fetchSearch)(keyword, 'mod'), direct: null };
+                const results = searchResult.results;
                 if (!results.length) {
                     await session.send('未找到相关结果。(备用也没用，我劝你换个关键词试试)');
                     return;
                 }
+                const directItem = searchResult.direct || (directMode ? (0, match_1.selectExactSearchResult)(results, keyword) : null);
+                if (directItem) {
+                    await renderDirectSearchTarget(session, directItem, 'mod', options);
+                    return;
+                }
                 if (results.length === 1) {
-                    const item = results[0];
-                    await (0, http_1.ensureValidCookie)();
-                    const img = await (0, cards_1.drawModCard)(item.link);
-                    await session.send(h.image(await (0, utils_1.toImageSrc)(img)));
-                    if (config.sendLink)
-                        await session.send(`链接: ${item.link}`);
+                    await renderDirectSearchTarget(session, results[0], 'mod', options);
                     return;
                 }
                 clearState(session.cid);

package/dist/mcmod/search.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchSearch = fetchSearch;
+exports.fetchDirectSearch = fetchDirectSearch;
 exports.fetchSearchFallback = fetchSearchFallback;
 exports.formatListPage = formatListPage;
 const constants_1 = require("./constants");
 const http_1 = require("./http");
 const utils_1 = require("./utils");
+const match_1 = require("../match");
 const cheerio = require('cheerio');
 async function fetchSearch(query, typeKey) {
     const filterMap = { mod: 1, pack: 2, data: 3, tutorial: 4, author: 5, user: 6 };
@@ -55,6 +57,53 @@ async function fetchSearch(query, typeKey) {
     }
     return results;
 }
+async function expandDirectQueryFromModrinth(query, typeKey) {
+    if (!['mod', 'pack'].includes(typeKey))
+        return [];
+    const raw = String(query || '').trim();
+    if (!/^[A-Za-z0-9][A-Za-z0-9_-]{1,64}$/.test(raw))
+        return [];
+    try {
+        const res = await (0, http_1.fetchWithTimeout)(`https://api.modrinth.com/v2/project/${encodeURIComponent(raw)}`, {
+            headers: {
+                'User-Agent': 'koishi-plugin-cfmrmod',
+                'Accept': 'application/json',
+            },
+        }, 8000);
+        if (!res.ok)
+            return [];
+        const project = await res.json();
+        const title = (0, utils_1.cleanText)((project === null || project === void 0 ? void 0 : project.title) || '');
+        const slug = (0, utils_1.cleanText)((project === null || project === void 0 ? void 0 : project.slug) || '');
+        const aliases = [
+            title.replace(/\s*[\(（][^\)）]+[\)）]\s*/g, ' ').trim(),
+            title,
+            slug,
+        ].filter(Boolean);
+        return Array.from(new Set(aliases));
+    }
+    catch {
+        return [];
+    }
+}
+async function fetchDirectSearch(query, typeKey) {
+    const results = await fetchSearch(query, typeKey);
+    const direct = (0, match_1.selectExactSearchResult)(results, query);
+    if (direct)
+        return { results, direct, query };
+    const aliases = await expandDirectQueryFromModrinth(query, typeKey);
+    for (const alias of aliases) {
+        if ((0, match_1.normalizeSearchText)(alias) === (0, match_1.normalizeSearchText)(query))
+            continue;
+        const expandedResults = await fetchSearch(alias, typeKey);
+        const expandedDirect = (0, match_1.selectExactSearchResult)(expandedResults, alias, 650) ||
+            (expandedResults.length === 1 ? expandedResults[0] : null);
+        if (expandedDirect) {
+            return { results: expandedResults, direct: expandedDirect, query: alias };
+        }
+    }
+    return { results, direct: null, query };
+}
 async function fetchSearchFallback(query, typeKey) {
     const apiType = constants_1.FALLBACK_TYPE_MAP[typeKey];
     if (!apiType)

package/dist/nlu.js

@@ -37,6 +37,8 @@ const PLATFORM_TYPES = {
     cf: new Set(['mod', 'pack', 'resource', 'shader', 'plugin']),
     mr: new Set(['mod', 'pack', 'resource', 'shader', 'plugin']),
 };
+const COMMENT_ACTIONS = new Set(['comment', 'comment_thread', 'thread_comment', 'floor_comment', 'reply_comment']);
+const COMMENT_LIST_ACTIONS = new Set(['comments', 'comment_list', 'all_comments', 'comments_list']);
 function normalizeEndpoint(endpoint) {
     const value = String(endpoint || DEFAULT_ENDPOINT).trim().replace(/\/+$/, '');
     if (/\/chat\/completions$/i.test(value))
@@ -72,15 +74,42 @@ function normalizeType(value, platform) {
     return ((_a = PLATFORM_TYPES[platform]) === null || _a === void 0 ? void 0 : _a.has(type)) ? type : 'mod';
 }
 function normalizeAiDecision(raw) {
-    const action = String((raw === null || raw === void 0 ? void 0 : raw.action) || '').trim().toLowerCase();
-    if (action && action !== 'search')
+    const rawAction = String((raw === null || raw === void 0 ? void 0 : raw.action) || '').trim().toLowerCase();
+    const action = COMMENT_ACTIONS.has(rawAction)
+        ? 'comment_thread'
+        : COMMENT_LIST_ACTIONS.has(rawAction)
+            ? 'comment_list'
+            : (rawAction === 'direct_search' || rawAction === 'open' || rawAction === 'render')
+                ? 'search'
+                : rawAction;
+    if (action && !['search', 'comment_thread', 'comment_list'].includes(action))
         return { action: 'ignore' };
+    const platform = normalizePlatform(raw === null || raw === void 0 ? void 0 : raw.platform);
+    const type = normalizeType(raw === null || raw === void 0 ? void 0 : raw.type, platform);
+    const url = String((raw === null || raw === void 0 ? void 0 : raw.url) || (raw === null || raw === void 0 ? void 0 : raw.link) || '').replace(/[\r\n]+/g, ' ').trim();
+    const target = String((raw === null || raw === void 0 ? void 0 : raw.target) || (raw === null || raw === void 0 ? void 0 : raw.floor) || (raw === null || raw === void 0 ? void 0 : raw.commentId) || (raw === null || raw === void 0 ? void 0 : raw.comment_id) || '').replace(/[\r\n]+/g, ' ').trim();
+    const page = Math.max(1, Number((raw === null || raw === void 0 ? void 0 : raw.page) || 1) || 1);
+    const size = Math.max(0, Number((raw === null || raw === void 0 ? void 0 : raw.size) || (raw === null || raw === void 0 ? void 0 : raw.pageSize) || (raw === null || raw === void 0 ? void 0 : raw.page_size) || 0) || 0);
     const query = String((raw === null || raw === void 0 ? void 0 : raw.query) || (raw === null || raw === void 0 ? void 0 : raw.keyword) || '').replace(/[\r\n]+/g, ' ').trim();
+    if (action === 'comment_thread') {
+        if (!target)
+            return { action: 'ignore' };
+        if (url)
+            return { action: 'comment_thread', platform: 'mcmod', type, url, target, page, size };
+        if (query)
+            return { action: 'comment_thread', platform: 'mcmod', type, query, target, page, size };
+        return { action: 'ignore' };
+    }
+    if (action === 'comment_list') {
+        if (url)
+            return { action: 'comment_list', platform: 'mcmod', type, url, page, size };
+        if (query)
+            return { action: 'comment_list', platform: 'mcmod', type, query, page, size };
+        return { action: 'ignore' };
+    }
     if (!query)
         return { action: 'ignore' };
-    const platform = normalizePlatform(raw === null || raw === void 0 ? void 0 : raw.platform);
-    const type = normalizeType(raw === null || raw === void 0 ? void 0 : raw.type, platform);
-    return { action: 'search', platform, type, query };
+    return { action: 'search', platform, type, query, direct: (raw === null || raw === void 0 ? void 0 : raw.direct) !== false };
 }
 async function requestAi(config, text) {
     var _a, _b, _c, _d, _e, _f;
@@ -97,10 +126,14 @@ async function requestAi(config, text) {
                 role: 'system',
                 content: [
                     '你是 Minecraft 模组搜索意图解析器，只返回 JSON，不要解释。',
-                    'JSON 格式: {"action":"search|ignore","platform":"mcmod|cf|mr","type":"mod|pack|data|tutorial|author|user|resource|shader|plugin","query":"关键词"}',
+                    'JSON 格式一: {"action":"search|ignore","platform":"mcmod|cf|mr","type":"mod|pack|data|tutorial|author|user|resource|shader|plugin","query":"关键词"}',
+                    'JSON 格式二: {"action":"comment_list","url":"MCMod页面URL","page":1,"size":5}，用于渲染某页面全部主评论列表。',
+                    'JSON 格式三: {"action":"comment_thread","url":"MCMod页面URL","target":"3楼|floor:3|id:2112330","page":1,"size":5}，用于渲染某一楼评论及子评论。',
+                    '如果用户要求某个模组/作者/教程的评论但没有 URL，返回 {"action":"comment_list","type":"mod|pack|tutorial|author|user","query":"关键词"}；如果还指定楼层，再用 comment_thread 并包含 target。',
                     '默认 platform 为 mcmod，默认 type 为 mod。',
                     'cf/curseforge 表示 CurseForge，mr/modrinth 表示 Modrinth，cnmc/mcmod/MC百科 表示 mcmod.cn。',
-                    '“查询/搜索/查一下/找一下/模组”等只是意图词，不要放进 query；保留具体模组名、英文名、ID 或关键词。',
+                    '“查询/搜索/查一下/找一下/模组/评论”等只是意图词，不要放进 query；保留具体模组名、英文名、ID 或关键词。',
+                    '当用户说“JEI模组”“JEI本体”“查JEI”时，query 应为 "JEI"，不要扩展成 JEI 附属或更泛的关键词。',
                     '如果不是搜索请求或没有明确关键词，返回 {"action":"ignore"}。',
                 ].join('\n'),
             },
@@ -193,7 +226,34 @@ function isExplicitCommand(text, prefixes) {
     });
 }
 function buildCommand(decision, prefixes) {
-    if (!decision || decision.action !== 'search')
+    if (!decision || decision.action === 'ignore')
+        return '';
+    const cnmcPrefix = (prefixes === null || prefixes === void 0 ? void 0 : prefixes.cnmc) || 'cnmc';
+    if (decision.action === 'comment_thread') {
+        const page = Math.max(1, Number(decision.page || 1) || 1);
+        const size = Number(decision.size || 0) || 0;
+        if (decision.url) {
+            return `${cnmcPrefix}.comment ${decision.url} ${decision.target} ${page}${size > 0 ? ` -s ${Math.floor(size)}` : ''}`;
+        }
+        if (decision.query) {
+            const type = normalizeType(decision.type, 'mcmod');
+            return `${cnmcPrefix}.${type} --direct --comment-target ${decision.target}${size > 0 ? ` -s ${Math.floor(size)}` : ''} ${decision.query}`;
+        }
+        return '';
+    }
+    if (decision.action === 'comment_list') {
+        const page = Math.max(1, Number(decision.page || 1) || 1);
+        const size = Number(decision.size || 0) || 0;
+        if (decision.url) {
+            return `${cnmcPrefix}.comments ${decision.url} ${page}${size > 0 ? ` -s ${Math.floor(size)}` : ''}`;
+        }
+        if (decision.query) {
+            const type = normalizeType(decision.type, 'mcmod');
+            return `${cnmcPrefix}.${type} --direct --comments${size > 0 ? ` -s ${Math.floor(size)}` : ''} ${decision.query}`;
+        }
+        return '';
+    }
+    if (decision.action !== 'search')
         return '';
     const platform = normalizePlatform(decision.platform);
     const type = normalizeType(decision.type, platform);
@@ -205,7 +265,8 @@ function buildCommand(decision, prefixes) {
         : platform === 'cf'
             ? ((prefixes === null || prefixes === void 0 ? void 0 : prefixes.cf) || 'cf')
             : ((prefixes === null || prefixes === void 0 ? void 0 : prefixes.mr) || 'mr');
-    return `${prefix}.${type} ${query}`;
+    const direct = decision.direct !== false ? '--direct ' : '';
+    return `${prefix}.${type} ${direct}${query}`;
 }
 function apply(ctx, config, shared = {}) {
     if (!(config === null || config === void 0 ? void 0 : config.enabled))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-cfmrmod",
-  "version": "1.1.9",
+  "version": "1.1.10",
   "description": "Koishi 插件：搜索 CurseForge/Modrinth/MCMod 并渲染图片卡片",
   "main": "dist/index.js",
   "files": [