koishi-plugin-mediawiki-fix 0.0.1 → 0.0.3

package/lib/index.d.ts

@@ -18,6 +18,8 @@ export interface Config {
     cmdAuthSearch: number;
     searchIfNotExist: boolean;
     showDetailsByDefault: boolean;
+    enableQQNativeMarkdown: boolean;
+    enableQQInlineCmd: boolean;
     customInfoboxes: InfoboxDefinition[];
 }
 export type MWPages = MWPage[];
@@ -122,6 +124,8 @@ export default class PluginMediawiki {
         cmdAuthSearch: Schema<number, number>;
         searchIfNotExist: Schema<boolean, boolean>;
         showDetailsByDefault: Schema<boolean, boolean>;
+        enableQQNativeMarkdown: Schema<boolean, boolean>;
+        enableQQInlineCmd: Schema<boolean, boolean>;
         customInfoboxes: Schema<Schemastery.ObjectS<{
             match: Schema<string, string>;
             selector: Schema<string[], string[]>;
@@ -140,6 +144,8 @@ export default class PluginMediawiki {
         cmdAuthSearch: Schema<number, number>;
         searchIfNotExist: Schema<boolean, boolean>;
         showDetailsByDefault: Schema<boolean, boolean>;
+        enableQQNativeMarkdown: Schema<boolean, boolean>;
+        enableQQInlineCmd: Schema<boolean, boolean>;
         customInfoboxes: Schema<Schemastery.ObjectS<{
             match: Schema<string, string>;
             selector: Schema<string[], string[]>;
@@ -154,6 +160,19 @@ export default class PluginMediawiki {
     }>>;
     constructor(ctx: Context, config?: Partial<Config>);
     get logger(): Logger;
+    private isQQSession;
+    private shouldUseQQMarkdown;
+    private getCommandText;
+    private formatInlineCmd;
+    private formatAutoFillWikilink;
+    private formatLink;
+    private resolveWikiTitleFromHref;
+    private convertHtmlExtractToMarkdown;
+    private extractIntroHtmlFromParse;
+    private fetchMarkdownExtracts;
+    private sendTextOrMarkdown;
+    private formatWikiQueryMarkdown;
+    private formatWikiSearchMarkdown;
     shotInfobox(url: string, silence?: boolean): Promise<string | h>;
     createInjectStylesFromDefinition({ selector, injectStyles, }: InfoboxDefinition): string;
 }

package/lib/index.js

@@ -78,6 +78,8 @@ var DEFAULT_CONFIGS = {
   cmdAuthSearch: 1,
   searchIfNotExist: false,
   showDetailsByDefault: false,
+  enableQQNativeMarkdown: true,
+  enableQQInlineCmd: true,
   customInfoboxes: []
 };
 var MOCK_HEADERS = [
@@ -148,6 +150,14 @@ function isValidApi(api) {
   return false;
 }
 __name(isValidApi, "isValidApi");
+function escapeMarkdownText(text) {
+  return text.replace(/[\[\]]/g, "\\$&");
+}
+__name(escapeMarkdownText, "escapeMarkdownText");
+function decodeHtmlEntities(text) {
+  return text.replace(/&nbsp;/g, " ").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&#(\d+);/g, (_, code) => String.fromCodePoint(Number(code)));
+}
+__name(decodeHtmlEntities, "decodeHtmlEntities");
 var BulkMessageBuilder = class {
   constructor(session) {
     this.session = session;
@@ -225,6 +235,12 @@ var PluginMediawiki = class {
     showDetailsByDefault: import_koishi.Schema.boolean().description(
       "触发`wiki`指令时，是否默认附带页面摘要和信息框截图"
     ),
+    enableQQNativeMarkdown: import_koishi.Schema.boolean().description(
+      "是否在 QQ 平台优先使用官机原生 Markdown 发送查询结果。"
+    ).default(true),
+    enableQQInlineCmd: import_koishi.Schema.boolean().description(
+      "是否在 QQ 原生 Markdown 中启用 mqqapi 快捷点击指令。"
+    ).default(true),
     customInfoboxes: import_koishi.Schema.array(
       import_koishi.Schema.object({
         match: import_koishi.Schema.string().description(
@@ -241,6 +257,163 @@ var PluginMediawiki = class {
   get logger() {
     return this.ctx.logger("mediawiki");
   }
+  isQQSession(session) {
+    return session.platform === "qq" || session.bot?.platform === "qq";
+  }
+  shouldUseQQMarkdown(session) {
+    return this.config.enableQQNativeMarkdown && this.isQQSession(session);
+  }
+  getCommandText(session, command) {
+    const prefix = session.resolve(session.app.koishi.config.prefix)[0] ?? "";
+    return prefix ? `${prefix}${command}` : `/${command}`;
+  }
+  formatInlineCmd(session, command, text) {
+    const label = escapeMarkdownText(text);
+    if (!this.config.enableQQInlineCmd) return `\`${label}\``;
+    const commandText = this.getCommandText(session, command);
+    return ` [${label}](mqqapi://aio/inlinecmd?command=${encodeURIComponent(commandText)}&enter=true&reply=false) `;
+  }
+  formatAutoFillWikilink(session, title, text, missing = false) {
+    const label = escapeMarkdownText(text);
+    const display = missing ? `${label} (未创建)` : label;
+    if (!this.config.enableQQInlineCmd) return display;
+    const commandText = `[[${title}]]`;
+    return ` [${display}](mqqapi://aio/inlinecmd?command=${encodeURIComponent(commandText)}&enter=false&reply=false) `;
+  }
+  formatLink(text, url) {
+    return ` [${escapeMarkdownText(text)}](${url})`;
+  }
+  resolveWikiTitleFromHref(mwApi, href) {
+    try {
+      const base = new URL(getUrl(mwApi));
+      const url = new URL(href, base);
+      if (url.origin !== base.origin) return "";
+      const titleFromSearch = url.searchParams.get("title");
+      if (titleFromSearch) {
+        return decodeURIComponent(titleFromSearch).replace(/_/g, " ");
+      }
+      const wikiPath = url.pathname.match(/\/wiki\/(.+)$/);
+      if (wikiPath?.[1]) {
+        return decodeURIComponent(wikiPath[1]).replace(/_/g, " ");
+      }
+      const path = decodeURIComponent(url.pathname).replace(/^\/+|\/+$/g, "");
+      if (path && !path.includes(":") && !path.includes("/") && !/\.(php|js|css|jpg|jpeg|png|gif|svg|webp)$/i.test(path)) {
+        return path.replace(/_/g, " ");
+      }
+    } catch {
+    }
+    return "";
+  }
+  convertHtmlExtractToMarkdown(session, mwApi, extract) {
+    const replaced = extract.replace(
+      /<a\b([^>]*)href="([^"]+)"([^>]*)>(.*?)<\/a>/gis,
+      (_, beforeHref, href, afterHref, inner) => {
+        const text = decodeHtmlEntities(inner.replace(/<[^>]+>/g, "")).trim();
+        if (!text) return "";
+        const attrs = `${beforeHref} ${afterHref}`;
+        const isMissing = /\bnew\b/i.test(attrs) || /(?:\?|&)redlink=1\b/i.test(href);
+        const wikiTitle = this.resolveWikiTitleFromHref(mwApi, href);
+        if (wikiTitle) {
+          return this.formatAutoFillWikilink(session, wikiTitle, text, isMissing);
+        }
+        try {
+          return this.formatLink(text, new URL(href, getUrl(mwApi)).href);
+        } catch {
+          return escapeMarkdownText(text);
+        }
+      }
+    );
+    return decodeHtmlEntities(
+      replaced.replace(/<br\s*\/?>/gi, "\n").replace(/<\/p>\s*<p[^>]*>/gi, "\n\n").replace(/<[^>]+>/g, "").replace(/\n{3,}/g, "\n\n").trim()
+    );
+  }
+  extractIntroHtmlFromParse(html) {
+    const cleaned = html.replace(/<style\b[^>]*>.*?<\/style>/gis, "").replace(/<script\b[^>]*>.*?<\/script>/gis, "");
+    const paragraphs = Array.from(cleaned.matchAll(/<p\b[^>]*>(.*?)<\/p>/gis)).map((match) => match[1].trim()).filter((content) => decodeHtmlEntities(content.replace(/<[^>]+>/g, "").trim()));
+    if (paragraphs.length) {
+      return `<p>${paragraphs[0]}</p>`;
+    }
+    return cleaned;
+  }
+  async fetchMarkdownExtracts(session, mwApi, titles) {
+    if (!titles.length) return /* @__PURE__ */ new Map();
+    const entries = await Promise.all(
+      titles.map(async (title) => {
+        const url = `${mwApi}?${new URLSearchParams({
+          action: "parse",
+          page: title,
+          prop: "text",
+          section: "0",
+          format: "json"
+        })}`;
+        const response = await fetch(url, {
+          headers: MOCK_HEADERS.find((item) => item.match(new URL(mwApi)))?.headers
+        });
+        const data = await response.json();
+        const parsedTitle = data.parse?.title;
+        const parsedHtml = data.parse?.text?.["*"];
+        if (!parsedTitle || !parsedHtml) return null;
+        const introHtml = this.extractIntroHtmlFromParse(parsedHtml);
+        return [
+          parsedTitle,
+          this.convertHtmlExtractToMarkdown(session, mwApi, introHtml)
+        ];
+      })
+    );
+    const result = new Map(entries.filter(Boolean));
+    this.logger.info("QQ_MARKDOWN_EXTRACTS", Object.fromEntries(result.entries()));
+    return result;
+  }
+  async sendTextOrMarkdown(session, title, text) {
+    this.logger.info("QQ_MARKDOWN_PAYLOAD", { title, text });
+    if (this.shouldUseQQMarkdown(session)) {
+      const internal = session.bot?.internal;
+      if (internal) {
+        session["seq"] = session["seq"] || 0;
+        const msgSeq = ++session["seq"];
+        const payload = {
+          content: title,
+          msg_type: 2,
+          msg_id: session.messageId,
+          msg_seq: msgSeq,
+          markdown: { content: text }
+        };
+        try {
+          if (session.isDirect) {
+            await internal.sendPrivateMessage(session.channelId, payload);
+          } else {
+            await internal.sendMessage(session.channelId, payload);
+          }
+          return "";
+        } catch (error) {
+          this.logger.warn("QQ native markdown send failed, fallback to text", error);
+        }
+      }
+    }
+    return text;
+  }
+  formatWikiQueryMarkdown(session, pageMsgs, interwiki) {
+    const blocks = [...pageMsgs];
+    for (const item of interwiki || []) {
+      blocks.push(`跨语言链接：
+${item.url}`);
+    }
+    return blocks.join("\n\n");
+  }
+  formatWikiSearchMarkdown(session, mwApi, keywords, totalhits, pages) {
+    const lines = [
+      `🔍关键词“${escapeMarkdownText(keywords)}”共匹配到 ${totalhits || 0} 个相关结果，我来简单整理一下前 ${pages.length} 个结果：`
+    ];
+    pages.sort((a, b) => a.index - b.index).forEach((item, index) => {
+      lines.push("");
+      lines.push(`(${index + 1}) ${this.formatInlineCmd(session, `wiki -d ${item.title}`, item.title)}`);
+      if (item.extract) {
+        lines.push(escapeMarkdownText(item.extract));
+      }
+      lines.push(getUrl(mwApi, { curid: String(item.pageid) }));
+    });
+    return lines.join("\n");
+  }
   #initCommands() {
     this.ctx.command("wiki [titles:text]", "MediaWiki 相关功能", {
       authority: this.config.cmdAuthWiki
@@ -299,6 +472,14 @@ var PluginMediawiki = class {
       });
       this.logger.debug("QUERY DATA", data.query);
       const { pages, redirects, interwiki, specialpagealiases, namespaces } = data.query;
+      const markdownExtracts = this.shouldUseQQMarkdown(session) && options?.details ? await this.fetchMarkdownExtracts(
+        session,
+        mwApi,
+        (pages || []).map((item) => item.title)
+      ).catch((error) => {
+        this.logger.warn("Failed to fetch markdown extracts", error);
+        return /* @__PURE__ */ new Map();
+      }) : /* @__PURE__ */ new Map();
       const dangerPageNames = ["Mypage", "Mytalk"];
       const dangerPages = specialpagealiases.filter((i) => dangerPageNames.includes(i.realname)).map((i) => i.aliases).flat(Infinity);
       const specialNsName = namespaces["-1"].name;
@@ -349,9 +530,9 @@ var PluginMediawiki = class {
           );
         } else if (missing !== void 0) {
           if (!options?.search) {
-            msg.push(`${editurl} (💔页面不存在)`);
+            msg.push(`${this.formatLink("创建页面", editurl)} (💔页面不存在)`);
           } else {
-            msg.push(`${editurl}
+            msg.push(`${this.formatLink("创建页面", editurl)}
 💡页面不存在，即将搜索wiki……`);
           }
         } else {
@@ -360,8 +541,18 @@ var PluginMediawiki = class {
             (shortUrl.length <= canonicalurl.length ? shortUrl : canonicalurl) + pageAnchor
           );
         }
-        if (options?.details && page.extract) {
-          msg.push(page.extract);
+        if (options?.details) {
+          const markdownExtract = markdownExtracts.get(pagetitle);
+          const finalExtract = markdownExtract || page.extract;
+          this.logger.info("QQ_MARKDOWN_PAGE_EXTRACT", {
+            title: pagetitle,
+            hasMarkdownExtract: !!markdownExtract,
+            markdownExtract,
+            fallbackExtract: page.extract
+          });
+          if (finalExtract) {
+            msg.push(finalExtract);
+          }
         }
         return msg.join("\n");
       }) || [];
@@ -370,7 +561,12 @@ var PluginMediawiki = class {
       }) || [];
       const allMsgList = [...pageMsgs, ...interwikiMsgs];
       let finalMsg = "";
-      if (allMsgList.length === 1) {
+      let sentImmediately = false;
+      if (this.shouldUseQQMarkdown(session)) {
+        const markdownMsg = this.formatWikiQueryMarkdown(session, pageMsgs, interwiki);
+        finalMsg = await this.sendTextOrMarkdown(session, "Wiki 查询结果", markdownMsg);
+        sentImmediately = !finalMsg;
+      } else if (allMsgList.length === 1) {
         finalMsg = import_koishi.h.quote(session.messageId) + allMsgList[0];
       } else if (allMsgList.length > 1) {
         const msgBuilder = new BulkMessageBuilder(session);
@@ -380,16 +576,20 @@ var PluginMediawiki = class {
         finalMsg = msgBuilder.prependOriginal().all();
       }
       if (pages && pages.length === 1 && pages[0].ns === 0 && !pages[0].missing && !pages[0].invalid && options?.details) {
-        await session.send(finalMsg);
+        if (!sentImmediately && finalMsg) {
+          await session.send(finalMsg);
+        }
         const infoboxImage = await this.shotInfobox(pages[0].canonicalurl, true);
         if (infoboxImage) {
           await session.send(infoboxImage);
         }
       } else if (options?.search && pages.length === 1 && pages[0].ns === 0 && pages[0].missing && !pages[0].invalid) {
-        await session.send(finalMsg);
+        if (!sentImmediately && finalMsg) {
+          await session.send(finalMsg);
+        }
         await session.execute(`wiki.search ${pages[0].title}`);
       } else {
-        return finalMsg;
+        return sentImmediately ? "" : finalMsg;
       }
     });
     this.ctx.middleware(async (session, next) => {
@@ -460,25 +660,36 @@ var PluginMediawiki = class {
         gsrnamespace: "0",
         gsrlimit: "5"
       });
-      const bulk = new BulkMessageBuilder(session);
       if (search.length < 1) {
         return `💔找不到与“${keywords}”匹配的结果。`;
       } else if (search.length === 1) {
         return session.execute(`wiki -d ${search[0].title}`);
+      } else if (this.shouldUseQQMarkdown(session)) {
+        const markdownMsg = this.formatWikiSearchMarkdown(
+          session,
+          mwApi,
+          keywords,
+          searchinfo?.totalhits,
+          pages
+        );
+        const out = await this.sendTextOrMarkdown(session, "Wiki 搜索结果", markdownMsg);
+        if (out) return out;
+        return "";
       } else {
+        const bulk = new BulkMessageBuilder(session);
         bulk.prependOriginal();
         bulk.botSay(
           `🔍关键词“${keywords}”共匹配到 ${searchinfo?.totalhits || "∅"} 个相关结果，我来简单整理一下前 ${search.length} 个结果：`
         );
-      }
-      pages.sort((a, b) => a.index - b.index).forEach((item, index) => {
-        bulk.botSay(
-          `(${index + 1}) ${item.title}
+        pages.sort((a, b) => a.index - b.index).forEach((item, index) => {
+          bulk.botSay(
+            `(${index + 1}) ${item.title}
 ${item.extract}
 ${getUrl(session.channel.mwApi, { curid: String(item.pageid) })}`
-        );
-      });
-      return bulk.all();
+          );
+        });
+        return bulk.all();
+      }
     });
   }
   async shotInfobox(url, silence = false) {
@@ -554,14 +765,19 @@ ${getUrl(session.channel.mwApi, { curid: String(item.pageid) })}`
   }) {
     const selectorString = Array.isArray(selector) ? selector.join(", ") : selector;
     return `
-      body > *:not(#content),
       #mw-navigation,
       #mw-page-base,
       #mw-head-base,
-      .mw-indicators {
+      .mw-indicators,
+      #firstHeading,
+      .printfooter,
+      .catlinks,
+      #catlinks,
+      .after-content,
+      .mw-editsection {
         display: none !important;
       }
-      html, body, #content, .mw-parser-output {
+      html, body, .mw-body, .mw-body-content, #content, #mw-content-text, .mw-parser-output {
         visibility: visible !important;
         background: white !important;
         min-height: auto !important;

package/lib/types/Config.d.ts

@@ -5,5 +5,7 @@ export interface Config {
     cmdAuthSearch: number;
     searchIfNotExist: boolean;
     showDetailsByDefault: boolean;
+    enableQQNativeMarkdown: boolean;
+    enableQQInlineCmd: boolean;
     customInfoboxes: InfoboxDefinition[];
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-mediawiki-fix",
   "description": "Koishi.js 的 MediaWiki 插件，将您的群聊与 wiki 站点紧密连接！(修复版)",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
@@ -9,7 +9,6 @@
     "dist"
   ],
   "license": "MIT",
-  "scripts": {},
   "dependencies": {
     "tslib": "^2.7.0",
     "wiki-saikou": "^3.4.0"