koishi-plugin-dew-bot 1.0.250 → 1.0.252

package/README.md

@@ -10,7 +10,3 @@
 踏入主神空间，成为轮回者。与伙伴迎接未知的试炼，在生死之间积蓄力量，书写属于你的无限冒险。
 
 无论你熟悉原作，还是初次踏入无限流世界，这场轮回，都有你的位置。
-
----
-
-连接 DEW 游戏服后，在聊天中发送 **帮助**，开启第一场冒险。

package/lib/index.js

@@ -42,40 +42,6 @@ var import_koishi2 = require("koishi");
 // src/plugin/serverHandel/image.ts
 var import_koishi = require("koishi");
 
-// src/shared/bot/analysisMsg.ts
-var AnalysisMsg = class {
-  static {
-    __name(this, "AnalysisMsg");
-  }
-  parse(data) {
-    let msg = "";
-    let haveTitle = false;
-    for (const item of data.line) {
-      switch (item.type) {
-        case 0 /* title */:
-          haveTitle = true;
-          msg += `┄━═${item.content}═━┄
-`;
-          break;
-        case 1 /* line */:
-          msg += `${item.content}
-`;
-          break;
-        case 2 /* error */:
-          msg += `❌出错了!错误原因:${item.content},请反馈至联系开发者
-`;
-          break;
-        default:
-          break;
-      }
-    }
-    if (haveTitle) {
-      msg += "┄━════════━┄";
-    }
-    return msg;
-  }
-};
-
 // src/plugin/appearanceCardTemplate.ts
 var escape = /* @__PURE__ */ __name((value) => String(value ?? "").replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]), "escape");
 function appearanceCardHtml(card, artwork, paper) {
@@ -689,28 +655,37 @@ var handel_base = class {
   }
 };
 
-// src/plugin/serverHandel/image.ts
-var ImageHandler = class extends handel_base {
+// src/shared/bot/analysisMsg.ts
+var AnalysisMsg = class {
   static {
-    __name(this, "ImageHandler");
+    __name(this, "AnalysisMsg");
   }
-  async start(data) {
-    let content;
-    let rendered = false;
-    const renderStartedAt = this.timing ? performance.now() : 0;
-    try {
-      if (!data.characterCard && !data.itemCard && !data.card && !data.leaderboard && !data.equipmentCard) throw new Error("缺少卡片数据");
-      const image = await renderSkillCard(this.ctx, data.card, data.leaderboard, data.itemCard, data.characterCard, data.equipmentCard);
-      if (this.timing) this.timing.imageBytes = image.length;
-      content = import_koishi.h.image(image, "image/jpeg").toString();
-      rendered = true;
-    } catch (error) {
-      this.ctx.logger.warn("卡片绘制失败，使用文字详情", error instanceof Error ? error.message : "unknown");
-      content = new AnalysisMsg().parse(data);
-    } finally {
-      if (this.timing) this.timing.renderMs = performance.now() - renderStartedAt;
+  parse(data) {
+    let msg = "";
+    let haveTitle = false;
+    for (const item of data.line) {
+      switch (item.type) {
+        case 0 /* title */:
+          haveTitle = true;
+          msg += `┄━═${item.content}═━┄
+`;
+          break;
+        case 1 /* line */:
+          msg += `${item.content}
+`;
+          break;
+        case 2 /* error */:
+          msg += `❌出错了!错误原因:${item.content},请反馈至联系开发者
+`;
+          break;
+        default:
+          break;
+      }
+    }
+    if (haveTitle) {
+      msg += "┄━════════━┄";
     }
-    await this.send(data, content, rendered ? "image" : "text");
+    return msg;
   }
 };
 
@@ -723,6 +698,12 @@ 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(compactDisplayText, "compactDisplayText");
+function renderQQTitle(content) {
+  return `**${escapeMarkdown(compactDisplayText(content))}**
+
+***`;
+}
+__name(renderQQTitle, "renderQQTitle");
 function compactListLabel(value) {
   const label = compactDisplayText(value);
   return /[📖📚]/u.test(label) ? label.replace(/技能书(?=$|×\d+(?:\.\d+)?(?:｜|$)|｜)/g, "") : label;
@@ -733,6 +714,42 @@ function inlineCommandUrl(command) {
   return `mqqapi://aio/inlinecmd?command=${encoded}&enter=true&reply=false`;
 }
 __name(inlineCommandUrl, "inlineCommandUrl");
+function inlineCommandSpans(content) {
+  const spans = [];
+  let depth = 0, start = 0, labelStart = 0;
+  for (let index = 0; index < content.length; index++) {
+    if (content[index] === "[") {
+      if (depth === 0) {
+        start = index > 0 && content[index - 1] === "\\" ? index - 1 : index;
+        labelStart = index + 1;
+      }
+      depth++;
+    } else if (content[index] === "]" && depth > 0 && --depth === 0) {
+      const label = content.slice(labelStart, index).replace(/\\$/, "");
+      if (!label.trim() || /[\[\]\r\n]/.test(label) || /^\d+$/.test(label.trim())) continue;
+      const command = label.split(/[+＋]/, 1)[0].trim();
+      if (command) spans.push({ start, end: index + 1, label, command });
+    }
+  }
+  return spans;
+}
+__name(inlineCommandSpans, "inlineCommandSpans");
+function hasInlineCommands(content) {
+  return inlineCommandSpans(content).length > 0;
+}
+__name(hasInlineCommands, "hasInlineCommands");
+function renderInlineCommands(content) {
+  const parts = [];
+  let offset = 0;
+  for (const span of inlineCommandSpans(content)) {
+    parts.push(escapeMarkdown(content.slice(offset, span.start)));
+    parts.push("[" + escapeMarkdown(span.label) + "](" + inlineCommandUrl(span.command) + ")");
+    offset = span.end;
+  }
+  parts.push(escapeMarkdown(content.slice(offset)));
+  return parts.join("");
+}
+__name(renderInlineCommands, "renderInlineCommands");
 function pageCommandLines(nav) {
   return [
     ...nav.previousCommand ? [nav.previousCommand] : [],
@@ -746,11 +763,6 @@ function renderQQPageMarkdown(data, showGreeting) {
   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 = [];
@@ -773,20 +785,16 @@ function renderQQPageMarkdown(data, showGreeting) {
     switch (item.type) {
       case 0 /* title */:
         flush();
-        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}` : ""}**`);
-        }
+        sections.push(renderQQTitle(`${isLeaderboardDirectory && !item.content.includes("🏆") ? "🏆" : ""}${item.content}`));
         break;
       case 1 /* line */: {
         const listEntry = listPattern.exec(item.content);
         if (listEntry) {
           flushBody();
           const command2 = entryCommands.get(lineIndex);
-          const label = escapeMarkdown(compactListLabel(listEntry[2]));
-          const name2 = command2 ? `[${label}](${inlineCommandUrl(command2)})` : label;
+          const content = compactListLabel(listEntry[2]);
+          const label = escapeMarkdown(content);
+          const name2 = command2 ? `[${label}](${inlineCommandUrl(command2)})` : renderInlineCommands(content);
           listLines.push(`${listEntry[1]}. ${name2}`);
           break;
         }
@@ -803,31 +811,28 @@ function renderQQPageMarkdown(data, showGreeting) {
         const page = pagePattern.exec(item.content);
         if (page && nav) {
           flushBody();
-          pageFooter = `**第${nav.current}/${nav.total}页${!title && page[1] ? `·共${page[1]}${page[2]}` : ""}**`;
+          pageFooter = `**第${nav.current}/${nav.total}页**`;
           hasPageSummary = true;
           break;
         }
         const command = entryCommands.get(lineIndex);
-        bodyLines.push(command ? `[${escapeMarkdown(compactDisplayText(item.content))}](${inlineCommandUrl(command)})` : escapeMarkdown(item.content));
+        bodyLines.push(command ? `[${escapeMarkdown(compactListLabel(item.content))}](${inlineCommandUrl(command)})` : renderInlineCommands(item.content));
         break;
       }
       case 2 /* error */:
         flush();
-        sections.push(`❌ 出错了！错误原因：${escapeMarkdown(item.content)}，请反馈至联系开发者`);
+        sections.push(`❌ 出错了！错误原因：${renderInlineCommands(item.content)}，请反馈至联系开发者`);
         break;
     }
   }
   flush();
   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 previousLink = nav?.previousCommand ? `[${nav.previousCommand === "上一个" ? "上一个" : "上一页"}](${inlineCommandUrl(nav.previousCommand)})` : void 0;
+  const nextLink = nav?.nextCommand ? `[${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);
-  }
+  if (footer) sections.push(footer);
   return sections.join("\n\n") || " ";
 }
 __name(renderQQPageMarkdown, "renderQQPageMarkdown");
@@ -883,19 +888,19 @@ function renderQQTransactionMarkdown(data, showGreeting) {
   for (const item of data.line) {
     if (item.type === 0 /* title */) {
       flush();
-      sections.push(`**${escapeMarkdown(item.content)}**`);
+      sections.push(renderQQTitle(item.content));
       continue;
     }
     if (item.type === 2 /* error */) {
       flush();
-      sections.push(`❌ 出错了！错误原因：${escapeMarkdown(item.content)}，请反馈至联系开发者`);
+      sections.push(`❌ 出错了！错误原因：${renderInlineCommands(item.content)}，请反馈至联系开发者`);
       continue;
     }
     if (item.type !== 1 /* line */) continue;
     const action = data.transaction && (item.content === "[是]确认交易" ? { command: "是", label: "确认交易" } : item.content === "[否]取消交易" ? { command: "否", label: "取消交易" } : void 0);
     if (action) {
       flushBody();
-      actions.push(`[${action.command}](${inlineCommandUrl(action.command)}) ${action.label}`);
+      actions.push(`[${action.label}](${inlineCommandUrl(action.command)})`);
       continue;
     }
     flushActions();
@@ -908,7 +913,7 @@ function renderQQTransactionMarkdown(data, showGreeting) {
       flushBody();
       sections.push(`**${escapeMarkdown(section?.[1] ?? "还缺")}**`);
     } else {
-      bodyLines.push(escapeMarkdown(item.content));
+      bodyLines.push(renderInlineCommands(item.content));
     }
   }
   flush();
@@ -920,6 +925,90 @@ async function sendQQTransaction(session, data) {
 }
 __name(sendQQTransaction, "sendQQTransaction");
 
+// src/plugin/serverHandel/qqCommandMessage.ts
+function renderQQCommandMarkdown(data, showGreeting) {
+  const sections = [];
+  const bodyLines = [];
+  const flushBody = /* @__PURE__ */ __name(() => {
+    if (bodyLines.length) sections.push(bodyLines.splice(0).join("  \n"));
+  }, "flushBody");
+  if (showGreeting) sections.push(escapeMarkdown("Ciallo～(∠・ω< )"));
+  for (const item of data.line) {
+    switch (item.type) {
+      case 0 /* title */:
+        flushBody();
+        sections.push(renderQQTitle(item.content));
+        break;
+      case 1 /* line */:
+        if (!item.content.trim()) flushBody();
+        else bodyLines.push(renderInlineCommands(item.content));
+        break;
+      case 2 /* error */:
+        flushBody();
+        sections.push(`❌ 出错了！错误原因：${renderInlineCommands(item.content)}，请反馈至联系开发者`);
+        break;
+    }
+  }
+  flushBody();
+  return sections.join("\n\n") || " ";
+}
+__name(renderQQCommandMarkdown, "renderQQCommandMarkdown");
+async function sendQQCommand(session, data) {
+  await sendQQMarkdown(session, renderQQCommandMarkdown(data, session.event?.channel?.type === 0));
+}
+__name(sendQQCommand, "sendQQCommand");
+
+// src/plugin/serverHandel/qqStoryMessage.ts
+function hasStoryCodeBlock(data) {
+  return data.line.some((item) => item.type === 1 /* line */ && item.codeBlock === true);
+}
+__name(hasStoryCodeBlock, "hasStoryCodeBlock");
+function fencedStory(content) {
+  const story = content.replace(/\r\n?/g, "\n");
+  const longestRun = Math.max(0, ...Array.from(story.matchAll(/`+/g), (match) => match[0].length));
+  const fence = "`".repeat(Math.max(3, longestRun + 1));
+  return fence + "\n" + story + (story.endsWith("\n") ? "" : "\n") + fence;
+}
+__name(fencedStory, "fencedStory");
+function renderQQStoryMarkdown(data, showGreeting) {
+  const sections = [];
+  const bodyLines = [];
+  const flushBody = /* @__PURE__ */ __name(() => {
+    if (bodyLines.length) sections.push(bodyLines.splice(0).join("  \n"));
+  }, "flushBody");
+  if (showGreeting) sections.push(escapeMarkdown("Ciallo～(∠・ω< )"));
+  for (const item of data.line) {
+    switch (item.type) {
+      case 0 /* title */:
+        flushBody();
+        sections.push(renderQQTitle(item.content));
+        break;
+      case 1 /* line */:
+        if (item.codeBlock) {
+          flushBody();
+          sections.push(fencedStory(item.content));
+        } else {
+          for (const line of item.content.replace(/\r\n?/g, "\n").split("\n")) {
+            if (!line.trim()) flushBody();
+            else bodyLines.push(renderInlineCommands(line));
+          }
+        }
+        break;
+      case 2 /* error */:
+        flushBody();
+        sections.push("❌ 出错了！错误原因：" + renderInlineCommands(item.content) + "，请反馈至联系开发者");
+        break;
+    }
+  }
+  flushBody();
+  return sections.join("\n\n") || " ";
+}
+__name(renderQQStoryMarkdown, "renderQQStoryMarkdown");
+async function sendQQStory(session, data) {
+  await sendQQMarkdown(session, renderQQStoryMarkdown(data, session.event?.channel?.type === 0));
+}
+__name(sendQQStory, "sendQQStory");
+
 // src/plugin/serverHandel/text.ts
 var handelr_text = class extends handel_base {
   static {
@@ -928,11 +1017,16 @@ var handelr_text = class extends handel_base {
   async start(data) {
     const content = new AnalysisMsg().parse(data);
     const session = sessions_default.get(sessionKey(data.botId, data.userId, data.channelId));
-    if ((data.transaction || data.pageNav) && canSendQQPage(session, data)) {
+    const inlineCommands = data.line.some((item) => (item.type === 1 /* line */ || item.type === 2 /* error */) && hasInlineCommands(item.content));
+    const story = hasStoryCodeBlock(data);
+    if ((story || data.commandHelp || data.transaction || data.pageNav || inlineCommands) && canSendQQPage(session, data)) {
       const sendStartedAt = this.timing ? performance.now() : 0;
       try {
-        if (data.transaction) await sendQQTransaction(session, data);
-        else await sendQQPage(session, data);
+        if (story) await sendQQStory(session, data);
+        else if (data.commandHelp) await sendQQCommand(session, data);
+        else if (data.transaction) await sendQQTransaction(session, data);
+        else if (data.pageNav) await sendQQPage(session, data);
+        else await sendQQCommand(session, data);
         if (this.timing) {
           this.timing.delivery = "qq-markdown";
           this.timing.sendMs = performance.now() - sendStartedAt;
@@ -941,7 +1035,7 @@ var handelr_text = class extends handel_base {
       } catch (error) {
         this.ctx.logger.warn("QQ Markdown 发送失败，改用普通文字", error instanceof Error ? error.message : error);
       }
-      const commands = !data.transaction && data.pageNav ? pageCommandLines(data.pageNav) : [];
+      const commands = !story && !data.commandHelp && !data.transaction && data.pageNav ? pageCommandLines(data.pageNav) : [];
       await this.send(data, commands.length ? `${content.trimEnd()}
 ${commands.join("\n")}` : content);
       return;
@@ -950,6 +1044,38 @@ ${commands.join("\n")}` : content);
   }
 };
 
+// src/plugin/serverHandel/image.ts
+var ImageHandler = class extends handel_base {
+  static {
+    __name(this, "ImageHandler");
+  }
+  async start(data) {
+    let content = "";
+    let rendered = false;
+    const renderStartedAt = this.timing ? performance.now() : 0;
+    try {
+      if (!data.characterCard && !data.itemCard && !data.card && !data.leaderboard && !data.equipmentCard) throw new Error("缺少卡片数据");
+      const image = await renderSkillCard(this.ctx, data.card, data.leaderboard, data.itemCard, data.characterCard, data.equipmentCard);
+      if (this.timing) this.timing.imageBytes = image.length;
+      content = import_koishi.h.image(image, "image/jpeg").toString();
+      rendered = true;
+    } catch (error) {
+      this.ctx.logger.warn("卡片绘制失败，使用文字详情", error instanceof Error ? error.message : "unknown");
+    } finally {
+      if (this.timing) this.timing.renderMs = performance.now() - renderStartedAt;
+    }
+    if (!rendered) {
+      const fallback = new handelr_text(data);
+      fallback.set(this.ctx);
+      if (this.timing) fallback.setTiming(this.timing);
+      fallback.send = (message, text, type = "text") => this.send(message, text, type);
+      await fallback.start(data);
+      return;
+    }
+    await this.send(data, content, "image");
+  }
+};
+
 // src/plugin/messageQueue.ts
 var handlers = {
   ["text" /* text */]: handelr_text,
@@ -1014,7 +1140,7 @@ var import_tsrpc = require("tsrpc");
 
 // src/shared/bot/serviceProto.ts
 var serviceProto = {
-  "version": 12,
+  "version": 14,
   "services": [
     {
       "id": 0,
@@ -1157,6 +1283,14 @@ var serviceProto = {
           },
           "optional": true
         },
+        {
+          "id": 9,
+          "name": "commandHelp",
+          "type": {
+            "type": "Boolean"
+          },
+          "optional": true
+        },
         {
           "id": 1,
           "name": "line",
@@ -1893,6 +2027,14 @@ var serviceProto = {
           "type": {
             "type": "String"
           }
+        },
+        {
+          "id": 2,
+          "name": "codeBlock",
+          "type": {
+            "type": "Boolean"
+          },
+          "optional": true
         }
       ]
     },
@@ -2224,10 +2366,6 @@ var usage = `
 踏入主神空间，成为轮回者。与伙伴迎接未知的试炼，在生死之间积蓄力量，书写属于你的无限冒险。
 
 无论你熟悉原作，还是初次踏入无限流世界，这场轮回，都有你的位置。
-
----
-
-连接 DEW 游戏服后，在聊天中发送 **帮助**，开启第一场冒险。
 `;
 var Config = import_koishi2.Schema.object({
   服务器地址: import_koishi2.Schema.string().default("ws://dew-v7-test:3021").description("DEW 游戏服的 WebSocket 地址；同机部署可填写 ws://127.0.0.1:3021")

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

@@ -0,0 +1,5 @@
+import type { Session } from 'koishi';
+import type { MsgMessage } from '../../shared/bot/MsgMessage';
+/** Render command help and ordinary prose with clickable bracketed commands. */
+export declare function renderQQCommandMarkdown(data: MsgMessage, showGreeting: boolean): string;
+export declare function sendQQCommand(session: Session, data: MsgMessage): Promise<void>;

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

@@ -3,7 +3,12 @@ import { type PageNavData } from '../../shared/face';
 import type { MsgMessage } from '../../shared/bot/MsgMessage';
 /** Escape server-provided lines before embedding them in native QQ Markdown. */
 export declare function escapeMarkdown(value: string): string;
+/** Keep native QQ Markdown titles consistent across message types. */
+export declare function renderQQTitle(content: string): string;
 export declare function inlineCommandUrl(command: string): string;
+export declare function hasInlineCommands(content: string): boolean;
+/** Escape surrounding prose while rendering boxed commands as inline links. */
+export declare function renderInlineCommands(content: string): string;
 export declare function pageCommandLines(nav: PageNavData): 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. */

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

@@ -0,0 +1,6 @@
+import type { Session } from 'koishi';
+import type { MsgMessage } from '../../shared/bot/MsgMessage';
+export declare function hasStoryCodeBlock(data: Pick<MsgMessage, 'line'>): boolean;
+/** Only marked story lines become code blocks; result summaries remain prose. */
+export declare function renderQQStoryMarkdown(data: MsgMessage, showGreeting: boolean): string;
+export declare function sendQQStory(session: Session, data: MsgMessage): Promise<void>;

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

@@ -101,6 +101,8 @@ export interface ITitleMessage {
 export interface ILineMessage {
     type: MessageType.line;
     content: string;
+    /** 原文长故事：支持的平台使用 Markdown 代码块，其余平台按普通文字显示。 */
+    codeBlock?: boolean;
 }
 /** 错误消息项 **/
 export interface IErrorMessage {
@@ -132,6 +134,8 @@ export interface IMessage {
     pageNav?: PageNavData;
     /** 通用交易确认、结果与失败消息；客户端可使用交易 Markdown 展示。 */
     transaction?: boolean;
+    /** 指令系统与指令提示；客户端可用 Markdown 展示可点击的方框指令。 */
+    commandHelp?: boolean;
     /** 消息项列表 **/
     line: IMessageItem[];
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-dew-bot",
   "description": "基于《无限恐怖》小说改编的 RPG 机器人。踏入主神空间，与伙伴迎接轮回试炼，书写属于你的无限冒险。",
-  "version": "1.0.250",
+  "version": "1.0.252",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/src/index.ts

@@ -15,10 +15,6 @@ export const usage: string = `
 踏入主神空间，成为轮回者。与伙伴迎接未知的试炼，在生死之间积蓄力量，书写属于你的无限冒险。
 
 无论你熟悉原作，还是初次踏入无限流世界，这场轮回，都有你的位置。
-
----
-
-连接 DEW 游戏服后，在聊天中发送 **帮助**，开启第一场冒险。
 `
 
 export interface Config {

package/src/plugin/serverHandel/image.ts

@@ -1,11 +1,11 @@
 import { h } from 'koishi'
 import { MsgMessage } from '../../shared/bot/MsgMessage'
-import { AnalysisMsg } from '../../shared/bot/analysisMsg'
 import { renderSkillCard } from '../skillCard'
 import handel_base from './handel_base'
+import TextHandler from './text'
 export default class ImageHandler extends handel_base {
   async start(data: MsgMessage) {
-    let content: string
+    let content = ''
     let rendered = false
     const renderStartedAt = this.timing ? performance.now() : 0
     try {
@@ -16,10 +16,17 @@ export default class ImageHandler extends handel_base {
       rendered = true
     } catch (error) {
       this.ctx.logger.warn('卡片绘制失败，使用文字详情', error instanceof Error ? error.message : 'unknown')
-      content = new AnalysisMsg().parse(data)
     } finally {
       if (this.timing) this.timing.renderMs = performance.now() - renderStartedAt
     }
-    await this.send(data, content, rendered ? 'image' : 'text')
+    if (!rendered) {
+      const fallback = new TextHandler(data)
+      fallback.set(this.ctx)
+      if (this.timing) fallback.setTiming(this.timing)
+      fallback.send = (message, text, type = 'text') => this.send(message, text, type)
+      await fallback.start(data)
+      return
+    }
+    await this.send(data, content, 'image')
   }
 }

package/src/plugin/serverHandel/qqCommandMessage.ts

@@ -0,0 +1,36 @@
+import type { Session } from 'koishi'
+import { MessageType } from '../../shared/face'
+import type { MsgMessage } from '../../shared/bot/MsgMessage'
+import { escapeMarkdown, renderInlineCommands, renderQQTitle, sendQQMarkdown } from './qqPageMessage'
+
+/** Render command help and ordinary prose with clickable bracketed commands. */
+export function renderQQCommandMarkdown(data: MsgMessage, showGreeting: boolean): string {
+  const sections: string[] = []
+  const bodyLines: string[] = []
+  const flushBody = () => {
+    if (bodyLines.length) sections.push(bodyLines.splice(0).join('  \n'))
+  }
+  if (showGreeting) sections.push(escapeMarkdown('Ciallo～(∠・ω< )'))
+  for (const item of data.line) {
+    switch (item.type) {
+      case MessageType.title:
+        flushBody()
+        sections.push(renderQQTitle(item.content))
+        break
+      case MessageType.line:
+        if (!item.content.trim()) flushBody()
+        else bodyLines.push(renderInlineCommands(item.content))
+        break
+      case MessageType.error:
+        flushBody()
+        sections.push(`❌ 出错了！错误原因：${renderInlineCommands(item.content)}，请反馈至联系开发者`)
+        break
+    }
+  }
+  flushBody()
+  return sections.join('\n\n') || ' '
+}
+
+export async function sendQQCommand(session: Session, data: MsgMessage): Promise<void> {
+  await sendQQMarkdown(session, renderQQCommandMarkdown(data, session.event?.channel?.type === 0))
+}

package/src/plugin/serverHandel/qqPageMessage.ts

@@ -35,6 +35,11 @@ function compactDisplayText(value: string): string {
     .replace(/[ \t\u3000]+(?=[\p{Script=Han}\p{Extended_Pictographic}\p{Regional_Indicator}])/gu, '')
 }
 
+/** Keep native QQ Markdown titles consistent across message types. */
+export function renderQQTitle(content: string): string {
+  return `**${escapeMarkdown(compactDisplayText(content))}**\n\n***`
+}
+
 function compactListLabel(value: string): string {
   const label = compactDisplayText(value)
   // The book icon already identifies skill books. Only shorten the displayed
@@ -52,6 +57,47 @@ export function inlineCommandUrl(command: string): string {
   return `mqqapi://aio/inlinecmd?command=${encoded}&enter=true&reply=false`
 }
 
+
+type InlineCommandSpan = { start: number; end: number; label: string; command: string }
+
+/** Bracketed commands may appear anywhere in prose, including escaped brackets. */
+function inlineCommandSpans(content: string): InlineCommandSpan[] {
+  const spans: InlineCommandSpan[] = []
+  let depth = 0, start = 0, labelStart = 0
+  for (let index = 0; index < content.length; index++) {
+    if (content[index] === '[') {
+      if (depth === 0) {
+        start = index > 0 && content[index - 1] === '\\' ? index - 1 : index
+        labelStart = index + 1
+      }
+      depth++
+    } else if (content[index] === ']' && depth > 0 && --depth === 0) {
+      const label = content.slice(labelStart, index).replace(/\\$/, '')
+      if (!label.trim() || /[\[\]\r\n]/.test(label) || /^\d+$/.test(label.trim())) continue
+      const command = label.split(/[+＋]/, 1)[0].trim()
+      if (command) spans.push({ start, end: index + 1, label, command })
+    }
+  }
+  return spans
+}
+
+export function hasInlineCommands(content: string): boolean {
+  return inlineCommandSpans(content).length > 0
+}
+
+/** Escape surrounding prose while rendering boxed commands as inline links. */
+export function renderInlineCommands(content: string): string {
+  const parts: string[] = []
+  let offset = 0
+  for (const span of inlineCommandSpans(content)) {
+    parts.push(escapeMarkdown(content.slice(offset, span.start)))
+    parts.push('[' + escapeMarkdown(span.label) + '](' + inlineCommandUrl(span.command) + ')')
+    offset = span.end
+  }
+  parts.push(escapeMarkdown(content.slice(offset)))
+  return parts.join('')
+}
+
 export function pageCommandLines(nav: PageNavData): string[] {
   return [
     ...(nav.previousCommand ? [nav.previousCommand] : []),
@@ -65,11 +111,6 @@ export function renderQQPageMarkdown(data: MsgMessage, showGreeting: boolean): s
   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[] = []
@@ -90,22 +131,18 @@ export function renderQQPageMarkdown(data: MsgMessage, showGreeting: boolean): s
     switch (item.type) {
       case MessageType.title:
         flush()
-        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}` : ''}**`)
-        }
+        sections.push(renderQQTitle(`${isLeaderboardDirectory && !item.content.includes('🏆') ? '🏆' : ''}${item.content}`))
         break
       case MessageType.line: {
         const listEntry = listPattern.exec(item.content)
         if (listEntry) {
           flushBody()
           const command = entryCommands.get(lineIndex)
-          const label = escapeMarkdown(compactListLabel(listEntry[2]))
+          const content = compactListLabel(listEntry[2])
+          const label = escapeMarkdown(content)
           const name = command
             ? `[${label}](${inlineCommandUrl(command)})`
-            : label
+            : renderInlineCommands(content)
           // Keep the numeric marker as Markdown syntax; escape only the item text.
           listLines.push(`${listEntry[1]}. ${name}`)
           break
@@ -125,35 +162,36 @@ export function renderQQPageMarkdown(data: MsgMessage, showGreeting: boolean): s
         const page = pagePattern.exec(item.content)
         if (page && nav) {
           flushBody()
-          pageFooter = `**第${nav.current}/${nav.total}页${!title && page[1] ? `·共${page[1]}${page[2]}` : ''}**`
+          pageFooter = `**第${nav.current}/${nav.total}页**`
           hasPageSummary = true
           break
         }
         const command = entryCommands.get(lineIndex)
         bodyLines.push(command
-          ? `[${escapeMarkdown(compactDisplayText(item.content))}](${inlineCommandUrl(command)})`
-          : escapeMarkdown(item.content))
+          ? `[${escapeMarkdown(compactListLabel(item.content))}](${inlineCommandUrl(command)})`
+          : renderInlineCommands(item.content))
         break
       }
       case MessageType.error:
         flush()
-        sections.push(`❌ 出错了！错误原因：${escapeMarkdown(item.content)}，请反馈至联系开发者`)
+        sections.push(`❌ 出错了！错误原因：${renderInlineCommands(item.content)}，请反馈至联系开发者`)
         break
     }
   }
   flush()
   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 previousLink = nav?.previousCommand
+    ? `[${nav.previousCommand === '上一个' ? '上一个' : '上一页'}](${inlineCommandUrl(nav.previousCommand)})`
+    : undefined
+  const nextLink = nav?.nextCommand
+    ? `[${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)
-  }
+  if (footer) sections.push(footer)
   return sections.join('\n\n') || ' '
 }
 

package/src/plugin/serverHandel/qqStoryMessage.ts

@@ -0,0 +1,56 @@
+import type { Session } from 'koishi'
+import { MessageType } from '../../shared/face'
+import type { MsgMessage } from '../../shared/bot/MsgMessage'
+import { escapeMarkdown, renderInlineCommands, renderQQTitle, sendQQMarkdown } from './qqPageMessage'
+
+export function hasStoryCodeBlock(data: Pick<MsgMessage, 'line'>): boolean {
+  return data.line.some(item => item.type === MessageType.line && item.codeBlock === true)
+}
+
+function fencedStory(content: string): string {
+  const story = content.replace(/\r\n?/g, '\n')
+  // A story may itself contain backticks. A longer fence keeps its entire text
+  // inside the same block without altering the source used by plain fallback.
+  const longestRun = Math.max(0, ...Array.from(story.matchAll(/`+/g), match => match[0].length))
+  const fence = '`'.repeat(Math.max(3, longestRun + 1))
+  return fence + '\n' + story + (story.endsWith('\n') ? '' : '\n') + fence
+}
+
+/** Only marked story lines become code blocks; result summaries remain prose. */
+export function renderQQStoryMarkdown(data: MsgMessage, showGreeting: boolean): string {
+  const sections: string[] = []
+  const bodyLines: string[] = []
+  const flushBody = () => {
+    if (bodyLines.length) sections.push(bodyLines.splice(0).join('  \n'))
+  }
+  if (showGreeting) sections.push(escapeMarkdown('Ciallo～(∠・ω< )'))
+  for (const item of data.line) {
+    switch (item.type) {
+      case MessageType.title:
+        flushBody()
+        sections.push(renderQQTitle(item.content))
+        break
+      case MessageType.line:
+        if (item.codeBlock) {
+          flushBody()
+          sections.push(fencedStory(item.content))
+        } else {
+          for (const line of item.content.replace(/\r\n?/g, '\n').split('\n')) {
+            if (!line.trim()) flushBody()
+            else bodyLines.push(renderInlineCommands(line))
+          }
+        }
+        break
+      case MessageType.error:
+        flushBody()
+        sections.push('❌ 出错了！错误原因：' + renderInlineCommands(item.content) + '，请反馈至联系开发者')
+        break
+    }
+  }
+  flushBody()
+  return sections.join('\n\n') || ' '
+}
+
+export async function sendQQStory(session: Session, data: MsgMessage): Promise<void> {
+  await sendQQMarkdown(session, renderQQStoryMarkdown(data, session.event?.channel?.type === 0))
+}

package/src/plugin/serverHandel/qqTransactionMessage.ts

@@ -1,7 +1,7 @@
 import type { Session } from 'koishi'
 import { MessageType } from '../../shared/face'
 import type { MsgMessage } from '../../shared/bot/MsgMessage'
-import { escapeMarkdown, inlineCommandUrl, sendQQMarkdown } from './qqPageMessage'
+import { escapeMarkdown, inlineCommandUrl, renderInlineCommands, renderQQTitle, sendQQMarkdown } from './qqPageMessage'
 
 /** Render only explicitly marked transactions; line content never enables this channel. */
 export function renderQQTransactionMarkdown(data: MsgMessage, showGreeting: boolean): string {
@@ -19,23 +19,22 @@ export function renderQQTransactionMarkdown(data: MsgMessage, showGreeting: bool
   for (const item of data.line) {
     if (item.type === MessageType.title) {
       flush()
-      sections.push(`**${escapeMarkdown(item.content)}**`)
+      sections.push(renderQQTitle(item.content))
       continue
     }
     if (item.type === MessageType.error) {
       flush()
-      sections.push(`❌ 出错了！错误原因：${escapeMarkdown(item.content)}，请反馈至联系开发者`)
+      sections.push(`❌ 出错了！错误原因：${renderInlineCommands(item.content)}，请反馈至联系开发者`)
       continue
     }
     if (item.type !== MessageType.line) continue
-    // These are the common trade actions. Names, reasons and arbitrary bracketed
-    // material text remain escaped display text rather than executable commands.
+    // Keep the common trade actions grouped; other bracketed commands render inline.
     const action = data.transaction && (item.content === '[是]确认交易'
       ? { command: '是', label: '确认交易' }
       : item.content === '[否]取消交易' ? { command: '否', label: '取消交易' } : undefined)
     if (action) {
       flushBody()
-      actions.push(`[${action.command}](${inlineCommandUrl(action.command)}) ${action.label}`)
+      actions.push(`[${action.label}](${inlineCommandUrl(action.command)})`)
       continue
     }
     flushActions()
@@ -50,7 +49,7 @@ export function renderQQTransactionMarkdown(data: MsgMessage, showGreeting: bool
     } else {
       // Preserve the server's quoted amounts, names and descriptions verbatim
       // apart from Markdown escaping; rendering never recalculates payments.
-      bodyLines.push(escapeMarkdown(item.content))
+      bodyLines.push(renderInlineCommands(item.content))
     }
   }
   flush()

package/src/plugin/serverHandel/text.ts

@@ -1,19 +1,27 @@
+import { MessageType } from '../../shared/face'
 import { AnalysisMsg } from '../../shared/bot/analysisMsg'
 import { MsgMessage } from '../../shared/bot/MsgMessage'
 import sessions, { sessionKey } from '../sessions'
 import handel_base from './handel_base'
-import { canSendQQPage, pageCommandLines, sendQQPage } from './qqPageMessage'
+import { canSendQQPage, hasInlineCommands, pageCommandLines, sendQQPage } from './qqPageMessage'
 import { sendQQTransaction } from './qqTransactionMessage'
+import { sendQQCommand } from './qqCommandMessage'
+import { hasStoryCodeBlock, sendQQStory } from './qqStoryMessage'
 
 export default class handelr_text extends handel_base {
   async start(data: MsgMessage) {
     const content = new AnalysisMsg().parse(data)
     const session = sessions.get(sessionKey(data.botId, data.userId, data.channelId))
-    if ((data.transaction || data.pageNav) && canSendQQPage(session, data)) {
+    const inlineCommands = data.line.some(item => (item.type === MessageType.line || item.type === MessageType.error) && hasInlineCommands(item.content))
+    const story = hasStoryCodeBlock(data)
+    if ((story || data.commandHelp || data.transaction || data.pageNav || inlineCommands) && canSendQQPage(session, data)) {
       const sendStartedAt = this.timing ? performance.now() : 0
       try {
-        if (data.transaction) await sendQQTransaction(session, data)
-        else await sendQQPage(session, data)
+        if (story) await sendQQStory(session, data)
+        else if (data.commandHelp) await sendQQCommand(session, data)
+        else if (data.transaction) await sendQQTransaction(session, data)
+        else if (data.pageNav) await sendQQPage(session, data)
+        else await sendQQCommand(session, data)
         if (this.timing) {
           this.timing.delivery = 'qq-markdown'
           this.timing.sendMs = performance.now() - sendStartedAt
@@ -22,7 +30,7 @@ export default class handelr_text extends handel_base {
       } catch (error) {
         this.ctx.logger.warn('QQ Markdown 发送失败，改用普通文字', error instanceof Error ? error.message : error)
       }
-      const commands = !data.transaction && data.pageNav ? pageCommandLines(data.pageNav) : []
+      const commands = !story && !data.commandHelp && !data.transaction && data.pageNav ? pageCommandLines(data.pageNav) : []
       await this.send(data, commands.length ? `${content.trimEnd()}\n${commands.join('\n')}` : content)
       return
     }

package/src/shared/bot/serviceProto.ts

@@ -20,7 +20,7 @@ export interface ServiceType {
 }
 
 export const serviceProto: ServiceProto<ServiceType> = {
-    "version": 12,
+    "version": 14,
     "services": [
         {
             "id": 0,
@@ -163,6 +163,14 @@ export const serviceProto: ServiceProto<ServiceType> = {
                     },
                     "optional": true
                 },
+                {
+                    "id": 9,
+                    "name": "commandHelp",
+                    "type": {
+                        "type": "Boolean"
+                    },
+                    "optional": true
+                },
                 {
                     "id": 1,
                     "name": "line",
@@ -899,6 +907,14 @@ export const serviceProto: ServiceProto<ServiceType> = {
                     "type": {
                         "type": "String"
                     }
+                },
+                {
+                    "id": 2,
+                    "name": "codeBlock",
+                    "type": {
+                        "type": "Boolean"
+                    },
+                    "optional": true
                 }
             ]
         },
@@ -1058,4 +1074,4 @@ export const serviceProto: ServiceProto<ServiceType> = {
             ]
         }
     }
-};
+};

package/src/shared/face/index.ts

@@ -73,6 +73,8 @@ export interface ITitleMessage {
 export interface ILineMessage {
     type: MessageType.line;
     content: string;
+    /** 原文长故事：支持的平台使用 Markdown 代码块，其余平台按普通文字显示。 */
+    codeBlock?: boolean;
 }
 
 /** 错误消息项 **/
@@ -105,6 +107,8 @@ export interface IMessage {
     pageNav?: PageNavData;
     /** 通用交易确认、结果与失败消息；客户端可使用交易 Markdown 展示。 */
     transaction?: boolean;
+    /** 指令系统与指令提示；客户端可用 Markdown 展示可点击的方框指令。 */
+    commandHelp?: boolean;
     /** 消息项列表 **/
     line: IMessageItem[];
 }