koishi-plugin-dew-bot 1.0.245 → 1.0.248

package/README.md

@@ -1,23 +1,16 @@
-# koishi-plugin-dew-bot
-
-Koishi 插件：把聊天消息交给 dew-v7 Bot 游戏服处理，再把服务器推送的文字发回会话。
-
-## 安装
-
-在 Koishi 模板项目中把本仓库放到 `external/dew-bot`，然后安装依赖并启用插件。
-
-```yaml
-plugins:
-  dew-bot:
-    服务器地址: ws://dew-v7-test:3021
-```
-
-游戏服需先启动 Bot 进程（默认 WebSocket `3021`）。
-
-## 配置
-
-| 项 | 说明 | 默认 |
-| --- | --- | --- |
-| 服务器地址 | 游戏服 WebSocket 地址 | `ws://dew-v7-test:3021` |
-
-插件会忽略机器人自己发出的消息，避免回显再次上传形成循环。
+# 🌀 DEW · 无限轮回 RPG
+
+[![npm](https://img.shields.io/npm/v/koishi-plugin-dew-bot?style=flat-square&color=7c3aed)](https://www.npmjs.com/package/koishi-plugin-dew-bot)
+![Koishi](https://img.shields.io/badge/Koishi-4.x-6366f1?style=flat-square)
+
+> **下一场轮回，主角是你。**
+
+**DEW Bot** 是一款基于《无限恐怖》小说改编的 **RPG 机器人**。
+
+踏入主神空间，成为轮回者。与伙伴迎接未知的试炼，在生死之间积蓄力量，书写属于你的无限冒险。
+
+无论你熟悉原作，还是初次踏入无限流世界，这场轮回，都有你的位置。
+
+---
+
+连接 DEW 游戏服后，在聊天中发送 **帮助**，开启第一场冒险。

package/lib/index.d.ts

@@ -3,6 +3,7 @@ export declare const inject: {
     optional: string[];
 };
 export declare const name = "dew-bot";
+export declare const usage: string;
 export interface Config {
     服务器地址: string;
 }

package/lib/index.js

@@ -33,7 +33,8 @@ __export(src_exports, {
   Config: () => Config,
   apply: () => apply2,
   inject: () => inject,
-  name: () => name
+  name: () => name,
+  usage: () => usage
 });
 module.exports = __toCommonJS(src_exports);
 var import_koishi2 = require("koishi");
@@ -717,66 +718,91 @@ function escapeMarkdown(value) {
   return value.replace(/[\\`*_{}\[\]()#+\-.!|>~<&]/g, "\\$&");
 }
 __name(escapeMarkdown, "escapeMarkdown");
-function pageCommand(command) {
-  return command.startsWith("/") ? command : `/${command}`;
+function compactDisplayText(value) {
+  return value.trim().replace(/[ \t\u3000]*([·×+｜])[ \t\u3000]*/g, "$1").replace(/([\p{Script=Han}\p{Extended_Pictographic}\p{Emoji_Modifier}\p{Regional_Indicator}\uFE0F])[ \t\u3000]+/gu, "$1").replace(/[ \t\u3000]+(?=[\p{Script=Han}\p{Extended_Pictographic}\p{Regional_Indicator}])/gu, "");
 }
-__name(pageCommand, "pageCommand");
+__name(compactDisplayText, "compactDisplayText");
+function compactListLabel(value) {
+  const label = compactDisplayText(value);
+  return /[📖📚]/u.test(label) ? label.replace(/技能书(?=$|×\d+(?:\.\d+)?(?:｜|$)|｜)/g, "") : label;
+}
+__name(compactListLabel, "compactListLabel");
 function inlineCommandUrl(command) {
-  const encoded = encodeURIComponent(pageCommand(command)).replace(/[!'()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
+  const encoded = encodeURIComponent(command).replace(/[!'()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
   return `mqqapi://aio/inlinecmd?command=${encoded}&enter=true&reply=false`;
 }
 __name(inlineCommandUrl, "inlineCommandUrl");
 function pageCommandLines(nav) {
   return [
-    ...nav.previousCommand ? [`上一页：${pageCommand(nav.previousCommand)}`] : [],
-    ...nav.nextCommand ? [`下一页：${pageCommand(nav.nextCommand)}`] : []
+    ...nav.previousCommand ? [nav.previousCommand] : [],
+    ...nav.nextCommand ? [nav.nextCommand] : []
   ];
 }
 __name(pageCommandLines, "pageCommandLines");
-function renderQQPageMarkdown(data, showGreeting, showCommands) {
+function renderQQPageMarkdown(data, showGreeting) {
   const nav = data.pageNav;
   const entryCommands = new Map(nav?.entries?.map((entry) => [entry.lineIndex, entry.viewCommand]) ?? []);
+  const listPattern = /^\[(\d+)\]\s*([^\r\n]+)$/;
+  const pagePattern = /^第\s*\d+\s*\/\s*\d+\s*页(?:\s*[｜|]\s*共\s*(\d+)\s*([项条]))?$/;
+  const title = data.line.find((item) => item.type === 0 /* title */);
+  const summaryLine = data.line.find((item) => item.type === 1 /* line */ && pagePattern.test(item.content));
+  const summary = summaryLine && pagePattern.exec(summaryLine.content);
+  const listCount = data.line.filter((item) => item.type === 1 /* line */ && listPattern.test(item.content)).length;
+  const count = summary?.[1] ?? (nav?.total === 1 ? String(listCount) : void 0);
+  const countUnit = summary?.[2] ?? "项";
+  const isLeaderboardDirectory = !!nav?.entries?.length && /^(?:🏆)?排行榜$/u.test(compactDisplayText(title?.content ?? ""));
   const sections = [];
   const bodyLines = [];
-  const numberedLines = [];
+  const listLines = [];
   const flushBody = /* @__PURE__ */ __name(() => {
     if (bodyLines.length) sections.push(bodyLines.splice(0).join("  \n"));
   }, "flushBody");
-  const flushNumbered = /* @__PURE__ */ __name(() => {
-    if (numberedLines.length) sections.push(numberedLines.splice(0).join("\n"));
-  }, "flushNumbered");
+  const flushList = /* @__PURE__ */ __name(() => {
+    if (listLines.length) sections.push(listLines.splice(0).join("\n"));
+  }, "flushList");
   const flush = /* @__PURE__ */ __name(() => {
-    flushNumbered();
+    flushList();
     flushBody();
   }, "flush");
   let hasPageSummary = false;
+  let hasHelp = false;
+  let pageFooter;
   if (showGreeting) sections.push(escapeMarkdown("Ciallo～(∠・ω< )"));
   for (const [lineIndex, item] of data.line.entries()) {
     switch (item.type) {
       case 0 /* title */:
         flush();
-        sections.push(`### ${escapeMarkdown(item.content)}`);
+        if (isLeaderboardDirectory) {
+          sections.push(`## ${item.content.includes("🏆") ? "" : "🏆"}${escapeMarkdown(compactDisplayText(item.content))}`);
+          sections.push(`> 共${nav.entries.length}个榜单·点击榜名查看`);
+        } else {
+          sections.push(`**${escapeMarkdown(compactDisplayText(item.content))}${count !== void 0 ? `·${count}${countUnit}` : ""}**`);
+        }
         break;
       case 1 /* line */: {
-        const numbered = /^\[(\d+)\]\s*([^\r\n]+)$/.exec(item.content);
-        if (numbered) {
+        const listEntry = listPattern.exec(item.content);
+        if (listEntry) {
           flushBody();
           const command = entryCommands.get(lineIndex);
-          const label = escapeMarkdown(numbered[2]);
+          const label = escapeMarkdown(compactListLabel(listEntry[2]));
           const name2 = command ? `[${label}](${inlineCommandUrl(command)})` : label;
-          numberedLines.push(`${numbered[1]}. ${name2}`);
+          listLines.push(`${listEntry[1]}. ${name2}`);
+          break;
+        }
+        flushList();
+        if (nav && item.content.trim() === "[上一页] [下一页]") {
+          flushBody();
           break;
         }
-        flushNumbered();
         if (/^\[指令\]相关指令$/.test(item.content)) {
           flushBody();
-          sections.push(`更多操作：[指令](${inlineCommandUrl("指令")})`);
+          hasHelp = true;
           break;
         }
-        const page = /^第\s*\d+\s*\/\s*\d+\s*页(?:\s*[｜|]\s*共\s*(\d+)\s*([项条]))?$/.exec(item.content);
+        const page = pagePattern.exec(item.content);
         if (page && nav) {
           flushBody();
-          sections.push(`**第 ${nav.current} / ${nav.total} 页${page[1] ? ` · 共 ${page[1]} ${page[2]}` : ""}**`);
+          pageFooter = `**第${nav.current}/${nav.total}页${!title && page[1] ? `·共${page[1]}${page[2]}` : ""}**`;
           hasPageSummary = true;
           break;
         }
@@ -790,36 +816,19 @@ function renderQQPageMarkdown(data, showGreeting, showCommands) {
     }
   }
   flush();
-  if (nav && !hasPageSummary) sections.push(`**第 ${nav.current} / ${nav.total} 页**`);
-  if (showCommands && nav) {
-    const commands = pageCommandLines(nav);
-    if (commands.length) sections.push(`**翻页指令**  
-${commands.map(escapeMarkdown).join("  \n")}`);
+  if (nav && !hasPageSummary && (nav.total > 1 || nav.previousCommand || nav.nextCommand))
+    pageFooter = `**第${nav.current}/${nav.total}页**`;
+  const previousLink = nav?.previousCommand ? `[上一页](${inlineCommandUrl(nav.previousCommand)})` : void 0;
+  const nextLink = nav?.nextCommand ? `[下一页](${inlineCommandUrl(nav.nextCommand)})` : void 0;
+  const helpLink = hasHelp ? `[指令](${inlineCommandUrl("指令")})` : void 0;
+  const footer = pageFooter ? [pageFooter, previousLink, nextLink, helpLink].filter(Boolean).join("·") : helpLink ? `更多操作：${helpLink}` : void 0;
+  if (footer) {
+    if (isLeaderboardDirectory) sections.push("***");
+    sections.push(footer);
   }
   return sections.join("\n\n") || " ";
 }
 __name(renderQQPageMarkdown, "renderQQPageMarkdown");
-function makeButton(id, label, command, userId, autoEnter) {
-  return {
-    id,
-    render_data: { label, visited_label: label, style: 1 },
-    action: {
-      type: 2,
-      permission: { type: 0, specify_user_ids: [userId] },
-      data: pageCommand(command),
-      ...autoEnter ? { enter: true } : {},
-      unsupport_tips: "当前客户端暂不支持该按钮，请发送上一页或下一页。"
-    }
-  };
-}
-__name(makeButton, "makeButton");
-function buttonsFor(nav, userId, autoEnter) {
-  return [
-    ...nav.previousCommand ? [makeButton("previous", "上一页", nav.previousCommand, userId, autoEnter)] : [],
-    ...nav.nextCommand ? [makeButton("next", "下一页", nav.nextCommand, userId, autoEnter)] : []
-  ];
-}
-__name(buttonsFor, "buttonsFor");
 function canSendQQPage(session, data) {
   if (!session || session.bot.platform !== "qq" || session.bot.userId !== data.botId) return false;
   if (session.userId !== data.userId || (session.channelId ?? session.userId) !== data.channelId) return false;
@@ -827,23 +836,21 @@ function canSendQQPage(session, data) {
   return !!internal?.sendMessage && !!internal.sendPrivateMessage;
 }
 __name(canSendQQPage, "canSendQQPage");
-async function sendQQPage(session, data, withKeyboard) {
+async function sendQQPage(session, data) {
   const internal = session.bot.internal;
   const nav = data.pageNav;
-  const buttons = withKeyboard ? buttonsFor(nav, data.userId, session.isDirect) : [];
-  const markdown = renderQQPageMarkdown(data, session.event?.channel?.type === 0, buttons.length === 0);
-  const hasEntries = !!nav.entries?.length;
+  const markdown = renderQQPageMarkdown(data, session.event?.channel?.type === 0);
+  const hasInlineNavigation = !!(nav.previousCommand || nav.nextCommand || nav.entries?.length);
   const hasInlineHelp = data.line.some((item) => item.type === 1 /* line */ && item.content === "[指令]相关指令");
   const request = {
     // With msg_type=2, QQ requires the ordinary content field to be empty.
     content: "",
     msg_type: 2,
     markdown: {
-      content: !session.isDirect && (buttons.length || hasEntries || hasInlineHelp) ? `${markdown}
+      content: !session.isDirect && (hasInlineNavigation || hasInlineHelp) ? `${markdown}
 
 点击后如未自动发送，请点发送。` : markdown
-    },
-    ...buttons.length ? { keyboard: { content: { rows: [{ buttons }] } } } : {}
+    }
   };
   const age = Date.now() - session.timestamp;
   if (session.messageId && Number.isFinite(age) && age >= 0 && age < 5 * 60 * 1e3 - 2e3) {
@@ -868,20 +875,8 @@ var handelr_text = class extends handel_base {
     const session = sessions_default.get(sessionKey(data.botId, data.userId, data.channelId));
     if (data.pageNav && canSendQQPage(session, data)) {
       const sendStartedAt = this.timing ? performance.now() : 0;
-      if (data.pageNav.previousCommand || data.pageNav.nextCommand) {
-        try {
-          await sendQQPage(session, data, true);
-          if (this.timing) {
-            this.timing.delivery = "qq-markdown-keyboard";
-            this.timing.sendMs = performance.now() - sendStartedAt;
-          }
-          return;
-        } catch (error) {
-          this.ctx.logger.warn("QQ 翻页按钮发送失败，改用 Markdown 文字指令", error instanceof Error ? error.message : error);
-        }
-      }
       try {
-        await sendQQPage(session, data, false);
+        await sendQQPage(session, data);
         if (this.timing) {
           this.timing.delivery = "qq-markdown";
           this.timing.sendMs = performance.now() - sendStartedAt;
@@ -2147,8 +2142,23 @@ __name(apply, "apply");
 // src/index.ts
 var inject = { optional: ["puppeteer"] };
 var name = "dew-bot";
+var usage = `
+## 🌀 DEW · 无限轮回 RPG
+
+> **下一场轮回，主角是你。**
+
+**DEW Bot** 是一款基于《无限恐怖》小说改编的 **RPG 机器人**。
+
+踏入主神空间，成为轮回者。与伙伴迎接未知的试炼，在生死之间积蓄力量，书写属于你的无限冒险。
+
+无论你熟悉原作，还是初次踏入无限流世界，这场轮回，都有你的位置。
+
+---
+
+连接 DEW 游戏服后，在聊天中发送 **帮助**，开启第一场冒险。
+`;
 var Config = import_koishi2.Schema.object({
-  服务器地址: import_koishi2.Schema.string().default("ws://dew-v7-test:3021").description("游戏服 WebSocket 地址")
+  服务器地址: import_koishi2.Schema.string().default("ws://dew-v7-test:3021").description("DEW 游戏服的 WebSocket 地址；同机部署可填写 ws://127.0.0.1:3021")
 });
 function apply2(ctx, config) {
   ctx.plugin(apply, config);
@@ -2159,5 +2169,6 @@ __name(apply2, "apply");
   Config,
   apply,
   inject,
-  name
+  name,
+  usage
 });

package/lib/plugin/serverHandel/handel_base.d.ts

@@ -7,7 +7,7 @@ export interface MessageTiming {
     renderMs?: number;
     imageBytes?: number;
     sendMs?: number;
-    delivery?: 'image' | 'text' | 'qq-markdown-keyboard' | 'qq-markdown' | 'missing-session';
+    delivery?: 'image' | 'text' | 'qq-markdown' | 'missing-session';
 }
 export default class handel_base {
     ctx: Context;

package/lib/plugin/serverHandel/qqPageMessage.d.ts

@@ -1,10 +1,9 @@
 import type { Session } from 'koishi';
 import { type PageNavData } from '../../shared/face';
 import type { MsgMessage } from '../../shared/bot/MsgMessage';
-export declare function pageCommand(command: string): string;
 export declare function pageCommandLines(nav: PageNavData): string[];
-export declare function renderQQPageMarkdown(data: MsgMessage, showGreeting: boolean, showCommands: boolean): string;
+export declare function renderQQPageMarkdown(data: MsgMessage, showGreeting: boolean): string;
 /** Returns false if this is not the matching QQ session or the adapter has no native API. */
 export declare function canSendQQPage(session: Session | undefined, data: MsgMessage): session is Session;
-/** Send a native QQ Markdown page, optionally with auto-sending command buttons. */
-export declare function sendQQPage(session: Session, data: MsgMessage, withKeyboard: boolean): Promise<void>;
+/** Send a native QQ Markdown page with inline command links. */
+export declare function sendQQPage(session: Session, data: MsgMessage): Promise<void>;

package/lib/shared/face/index.d.ts

@@ -108,7 +108,7 @@ export interface IErrorMessage {
 }
 /** 第一阶段支持的消息项 **/
 export type IMessageItem = ITitleMessage | ILineMessage | IErrorMessage;
-/** 平台无关的翻页动作；按钮发送普通指令，客户端决定如何呈现。 */
+/** 平台无关的翻页动作；客户端决定如何呈现可点击文字，点击后发送普通指令。 */
 export interface PageNavData {
     current: number;
     total: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-dew-bot",
-  "description": "连游戏服，把聊天消息交给服务器处理",
-  "version": "1.0.245",
+  "description": "基于《无限恐怖》小说改编的 RPG 机器人。踏入主神空间，与伙伴迎接轮回试炼，书写属于你的无限冒险。",
+  "version": "1.0.248",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
@@ -9,11 +9,27 @@
     "src",
     "assets"
   ],
+  "scripts": {
+    "release": "node scripts/release.cjs",
+    "release:check": "node scripts/release.cjs --dry-run"
+  },
   "license": "MIT",
+  "homepage": "https://gitee.com/ChuXuanD30/koishi-plugin-dew-bot",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitee.com/ChuXuanD30/koishi-plugin-dew-bot.git"
+  },
+  "bugs": {
+    "url": "https://gitee.com/ChuXuanD30/koishi-plugin-dew-bot/issues"
+  },
   "keywords": [
     "chatbot",
     "koishi",
-    "plugin"
+    "plugin",
+    "rpg",
+    "game",
+    "qq",
+    "markdown"
   ],
   "peerDependencies": {
     "koishi": "^4.18.0",
@@ -25,7 +41,7 @@
   },
   "koishi": {
     "description": {
-      "zh": "连游戏服，把聊天消息交给服务器处理"
+      "zh": "基于《无限恐怖》小说改编的 RPG 机器人。踏入主神空间，与伙伴迎接轮回试炼，书写属于你的无限冒险。"
     }
   }
 }

package/src/index.ts

@@ -5,12 +5,28 @@ export const inject = { optional: ['puppeteer'] }
 
 export const name = 'dew-bot'
 
+export const usage: string = `
+## 🌀 DEW · 无限轮回 RPG
+
+> **下一场轮回，主角是你。**
+
+**DEW Bot** 是一款基于《无限恐怖》小说改编的 **RPG 机器人**。
+
+踏入主神空间，成为轮回者。与伙伴迎接未知的试炼，在生死之间积蓄力量，书写属于你的无限冒险。
+
+无论你熟悉原作，还是初次踏入无限流世界，这场轮回，都有你的位置。
+
+---
+
+连接 DEW 游戏服后，在聊天中发送 **帮助**，开启第一场冒险。
+`
+
 export interface Config {
   服务器地址: string
 }
 
 export const Config: Schema<Config> = Schema.object({
-  服务器地址: Schema.string().default('ws://dew-v7-test:3021').description('游戏服 WebSocket 地址'),
+  服务器地址: Schema.string().default('ws://dew-v7-test:3021').description('DEW 游戏服的 WebSocket 地址；同机部署可填写 ws://127.0.0.1:3021'),
 })
 
 export function apply(ctx: Context, config: Config) {

package/src/plugin/serverHandel/handel_base.ts

@@ -9,7 +9,7 @@ export interface MessageTiming {
   renderMs?: number
   imageBytes?: number
   sendMs?: number
-  delivery?: 'image' | 'text' | 'qq-markdown-keyboard' | 'qq-markdown' | 'missing-session'
+  delivery?: 'image' | 'text' | 'qq-markdown' | 'missing-session'
 }
 
 export default class handel_base {

package/src/plugin/serverHandel/qqPageMessage.ts

@@ -2,23 +2,10 @@ import type { Session } from 'koishi'
 import { MessageType, type PageNavData } from '../../shared/face'
 import type { MsgMessage } from '../../shared/bot/MsgMessage'
 
-type Button = {
-  id: string
-  render_data: { label: string; visited_label: string; style: number }
-  action: {
-    type: 2
-    permission: { type: 0; specify_user_ids: string[] }
-    data: string
-    enter?: true
-    unsupport_tips: string
-  }
-}
-
 type QQRequest = {
   content: string
   msg_type: 2
   markdown: { content: string }
-  keyboard?: { content: { rows: Array<{ buttons: Button[] }> } }
   msg_id?: string
   msg_seq?: number
 }
@@ -40,68 +27,105 @@ function escapeMarkdown(value: string): string {
   return value.replace(/[\\`*_{}\[\]()#+\-.!|>~<&]/g, '\\$&')
 }
 
-export function pageCommand(command: string): string {
-  return command.startsWith('/') ? command : `/${command}`
+/** Compact display padding while retaining spaces between English words. */
+function compactDisplayText(value: string): string {
+  return value.trim()
+    .replace(/[ \t\u3000]*([·×+｜])[ \t\u3000]*/g, '$1')
+    .replace(/([\p{Script=Han}\p{Extended_Pictographic}\p{Emoji_Modifier}\p{Regional_Indicator}\uFE0F])[ \t\u3000]+/gu, '$1')
+    .replace(/[ \t\u3000]+(?=[\p{Script=Han}\p{Extended_Pictographic}\p{Regional_Indicator}])/gu, '')
+}
+
+function compactListLabel(value: string): string {
+  const label = compactDisplayText(value)
+  // The book icon already identifies skill books. Only shorten the displayed
+  // name suffix, including before inventory quantities or market columns.
+  return /[📖📚]/u.test(label)
+    ? label.replace(/技能书(?=$|×\d+(?:\.\d+)?(?:｜|$)|｜)/g, '')
+    : label
 }
 
 function inlineCommandUrl(command: string): string {
   // encodeURIComponent leaves parentheses unescaped, which would close the
   // surrounding Markdown link if an item ID ever contained one.
-  const encoded = encodeURIComponent(pageCommand(command)).replace(/[!'()*]/g, character =>
+  const encoded = encodeURIComponent(command).replace(/[!'()*]/g, character =>
     `%${character.charCodeAt(0).toString(16).toUpperCase()}`)
   return `mqqapi://aio/inlinecmd?command=${encoded}&enter=true&reply=false`
 }
 
 export function pageCommandLines(nav: PageNavData): string[] {
   return [
-    ...(nav.previousCommand ? [`上一页：${pageCommand(nav.previousCommand)}`] : []),
-    ...(nav.nextCommand ? [`下一页：${pageCommand(nav.nextCommand)}`] : []),
+    ...(nav.previousCommand ? [nav.previousCommand] : []),
+    ...(nav.nextCommand ? [nav.nextCommand] : []),
   ]
 }
 
-export function renderQQPageMarkdown(data: MsgMessage, showGreeting: boolean, showCommands: boolean): string {
+export function renderQQPageMarkdown(data: MsgMessage, showGreeting: boolean): string {
   const nav = data.pageNav
   const entryCommands = new Map(nav?.entries?.map(entry => [entry.lineIndex, entry.viewCommand]) ?? [])
+  const listPattern = /^\[(\d+)\]\s*([^\r\n]+)$/
+  const pagePattern = /^第\s*\d+\s*\/\s*\d+\s*页(?:\s*[｜|]\s*共\s*(\d+)\s*([项条]))?$/
+  const title = data.line.find(item => item.type === MessageType.title)
+  const summaryLine = data.line.find(item => item.type === MessageType.line && pagePattern.test(item.content))
+  const summary = summaryLine && pagePattern.exec(summaryLine.content)
+  const listCount = data.line.filter(item => item.type === MessageType.line && listPattern.test(item.content)).length
+  const count = summary?.[1] ?? (nav?.total === 1 ? String(listCount) : undefined)
+  const countUnit = summary?.[2] ?? '项'
+  const isLeaderboardDirectory = !!nav?.entries?.length
+    && /^(?:🏆)?排行榜$/u.test(compactDisplayText(title?.content ?? ''))
   const sections: string[] = []
   const bodyLines: string[] = []
-  const numberedLines: string[] = []
+  const listLines: string[] = []
   const flushBody = () => {
     if (bodyLines.length) sections.push(bodyLines.splice(0).join('  \n'))
   }
-  const flushNumbered = () => {
-    if (numberedLines.length) sections.push(numberedLines.splice(0).join('\n'))
+  const flushList = () => {
+    if (listLines.length) sections.push(listLines.splice(0).join('\n'))
   }
-  const flush = () => { flushNumbered(); flushBody() }
+  const flush = () => { flushList(); flushBody() }
   let hasPageSummary = false
+  let hasHelp = false
+  let pageFooter: string | undefined
   if (showGreeting) sections.push(escapeMarkdown('Ciallo～(∠・ω< )'))
   for (const [lineIndex, item] of data.line.entries()) {
     switch (item.type) {
       case MessageType.title:
         flush()
-        sections.push(`### ${escapeMarkdown(item.content)}`)
+        if (isLeaderboardDirectory) {
+          sections.push(`## ${item.content.includes('🏆') ? '' : '🏆'}${escapeMarkdown(compactDisplayText(item.content))}`)
+          sections.push(`> 共${nav!.entries!.length}个榜单·点击榜名查看`)
+        } else {
+          sections.push(`**${escapeMarkdown(compactDisplayText(item.content))}${count !== undefined ? `·${count}${countUnit}` : ''}**`)
+        }
         break
       case MessageType.line: {
-        const numbered = /^\[(\d+)\]\s*([^\r\n]+)$/.exec(item.content)
-        if (numbered) {
+        const listEntry = listPattern.exec(item.content)
+        if (listEntry) {
           flushBody()
           const command = entryCommands.get(lineIndex)
-          const label = escapeMarkdown(numbered[2])
+          const label = escapeMarkdown(compactListLabel(listEntry[2]))
           const name = command
             ? `[${label}](${inlineCommandUrl(command)})`
             : label
-          numberedLines.push(`${numbered[1]}. ${name}`)
+          // Keep the numeric marker as Markdown syntax; escape only the item text.
+          listLines.push(`${listEntry[1]}. ${name}`)
+          break
+        }
+        flushList()
+        // Recruitment pages include this legacy plain-text navigation hint.
+        // QQ navigation is already rendered as clickable links in the footer.
+        if (nav && item.content.trim() === '[上一页] [下一页]') {
+          flushBody()
           break
         }
-        flushNumbered()
         if (/^\[指令\]相关指令$/.test(item.content)) {
           flushBody()
-          sections.push(`更多操作：[指令](${inlineCommandUrl('指令')})`)
+          hasHelp = true
           break
         }
-        const page = /^第\s*\d+\s*\/\s*\d+\s*页(?:\s*[｜|]\s*共\s*(\d+)\s*([项条]))?$/.exec(item.content)
+        const page = pagePattern.exec(item.content)
         if (page && nav) {
           flushBody()
-          sections.push(`**第 ${nav.current} / ${nav.total} 页${page[1] ? ` · 共 ${page[1]} ${page[2]}` : ''}**`)
+          pageFooter = `**第${nav.current}/${nav.total}页${!title && page[1] ? `·共${page[1]}${page[2]}` : ''}**`
           hasPageSummary = true
           break
         }
@@ -115,35 +139,21 @@ export function renderQQPageMarkdown(data: MsgMessage, showGreeting: boolean, sh
     }
   }
   flush()
-  if (nav && !hasPageSummary) sections.push(`**第 ${nav.current} / ${nav.total} 页**`)
-  if (showCommands && nav) {
-    const commands = pageCommandLines(nav)
-    if (commands.length) sections.push(`**翻页指令**  \n${commands.map(escapeMarkdown).join('  \n')}`)
+  if (nav && !hasPageSummary && (nav.total > 1 || nav.previousCommand || nav.nextCommand))
+    pageFooter = `**第${nav.current}/${nav.total}页**`
+  const previousLink = nav?.previousCommand ? `[上一页](${inlineCommandUrl(nav.previousCommand)})` : undefined
+  const nextLink = nav?.nextCommand ? `[下一页](${inlineCommandUrl(nav.nextCommand)})` : undefined
+  const helpLink = hasHelp ? `[指令](${inlineCommandUrl('指令')})` : undefined
+  const footer = pageFooter
+    ? [pageFooter, previousLink, nextLink, helpLink].filter(Boolean).join('·')
+    : helpLink ? `更多操作：${helpLink}` : undefined
+  if (footer) {
+    if (isLeaderboardDirectory) sections.push('***')
+    sections.push(footer)
   }
   return sections.join('\n\n') || ' '
 }
 
-function makeButton(id: string, label: string, command: string, userId: string, autoEnter: boolean): Button {
-  return {
-    id,
-    render_data: { label, visited_label: label, style: 1 },
-    action: {
-      type: 2,
-      permission: { type: 0, specify_user_ids: [userId] },
-      data: pageCommand(command),
-      ...(autoEnter ? { enter: true as const } : {}),
-      unsupport_tips: '当前客户端暂不支持该按钮，请发送上一页或下一页。',
-    },
-  }
-}
-
-function buttonsFor(nav: PageNavData, userId: string, autoEnter: boolean): Button[] {
-  return [
-    ...(nav.previousCommand ? [makeButton('previous', '上一页', nav.previousCommand, userId, autoEnter)] : []),
-    ...(nav.nextCommand ? [makeButton('next', '下一页', nav.nextCommand, userId, autoEnter)] : []),
-  ]
-}
-
 /** Returns false if this is not the matching QQ session or the adapter has no native API. */
 export function canSendQQPage(session: Session | undefined, data: MsgMessage): session is Session {
   if (!session || session.bot.platform !== 'qq' || session.bot.userId !== data.botId) return false
@@ -152,27 +162,24 @@ export function canSendQQPage(session: Session | undefined, data: MsgMessage): s
   return !!internal?.sendMessage && !!internal.sendPrivateMessage
 }
 
-/** Send a native QQ Markdown page, optionally with auto-sending command buttons. */
-export async function sendQQPage(session: Session, data: MsgMessage, withKeyboard: boolean): Promise<void> {
+/** Send a native QQ Markdown page with inline command links. */
+export async function sendQQPage(session: Session, data: MsgMessage): Promise<void> {
   const internal = (session.bot as typeof session.bot & { internal: QQInternal }).internal
   const nav = data.pageNav!
-  const buttons = withKeyboard ? buttonsFor(nav, data.userId, session.isDirect) : []
-  const markdown = renderQQPageMarkdown(data, session.event?.channel?.type === 0, buttons.length === 0)
-  const hasEntries = !!nav.entries?.length
+  const markdown = renderQQPageMarkdown(data, session.event?.channel?.type === 0)
+  const hasInlineNavigation = !!(nav.previousCommand || nav.nextCommand || nav.entries?.length)
   const hasInlineHelp = data.line.some(item => item.type === MessageType.line && item.content === '[指令]相关指令')
   const request: QQRequest = {
     // With msg_type=2, QQ requires the ordinary content field to be empty.
     content: '',
     msg_type: 2,
     markdown: {
-      content: !session.isDirect && (buttons.length || hasEntries || hasInlineHelp)
+      content: !session.isDirect && (hasInlineNavigation || hasInlineHelp)
         ? `${markdown}\n\n点击后如未自动发送，请点发送。`
         : markdown,
     },
-    ...(buttons.length ? { keyboard: { content: { rows: [{ buttons }] } } } : {}),
   }
-  // Match the QQ adapter's passive-reply sequence, including when a prior
-  // keyboard attempt failed and this call retries without the keyboard.
+  // Match the QQ adapter's passive-reply sequence.
   const age = Date.now() - session.timestamp
   if (session.messageId && Number.isFinite(age) && age >= 0 && age < 5 * 60 * 1000 - 2000) {
     const sequenced = session as Session & { seq?: number }

package/src/plugin/serverHandel/text.ts

@@ -10,20 +10,8 @@ export default class handelr_text extends handel_base {
     const session = sessions.get(sessionKey(data.botId, data.userId, data.channelId))
     if (data.pageNav && canSendQQPage(session, data)) {
       const sendStartedAt = this.timing ? performance.now() : 0
-      if (data.pageNav.previousCommand || data.pageNav.nextCommand) {
-        try {
-          await sendQQPage(session, data, true)
-          if (this.timing) {
-            this.timing.delivery = 'qq-markdown-keyboard'
-            this.timing.sendMs = performance.now() - sendStartedAt
-          }
-          return
-        } catch (error) {
-          this.ctx.logger.warn('QQ 翻页按钮发送失败，改用 Markdown 文字指令', error instanceof Error ? error.message : error)
-        }
-      }
       try {
-        await sendQQPage(session, data, false)
+        await sendQQPage(session, data)
         if (this.timing) {
           this.timing.delivery = 'qq-markdown'
           this.timing.sendMs = performance.now() - sendStartedAt

package/src/shared/face/index.ts

@@ -83,7 +83,7 @@ export interface IErrorMessage {
 /** 第一阶段支持的消息项 **/
 export type IMessageItem = ITitleMessage | ILineMessage | IErrorMessage;
 
-/** 平台无关的翻页动作；按钮发送普通指令，客户端决定如何呈现。 */
+/** 平台无关的翻页动作；客户端决定如何呈现可点击文字，点击后发送普通指令。 */
 export interface PageNavData {
     current: number;
     total: number;