koishi-plugin-mcdle 0.1.4 → 0.1.6

package/README.md

@@ -0,0 +1,31 @@
+# koishi-plugin-mcdle
+
+Minecraft 猜词游戏，词库覆盖生物、物品与方块
+
+## 安装
+
+```sh
+yarn add koishi-plugin-mcdle
+```
+
+在 Koishi 配置中启用，并提供 database 服务；puppeteer 可选，用于图片输出。
+
+## 指令
+
+发送 `mcdle` 查看玩法与全部指令。
+
+| 指令 | 说明 |
+| --- | --- |
+| `mcdle` | 玩法与指令说明 |
+| `mcdle.猜 [名称]` | 用有效词条开局或猜测 |
+| `mcdle.裸猜 [开/关]` | 切换本群无前缀续猜 |
+| `mcdle.排行榜` | 群内战绩 |
+| `mcdle.词库` | 全部词条 |
+
+首次猜测的词条决定题目类型。裸猜设置只对当前群生效，插件重载后恢复默认。
+
+提示符号：🟩 完全匹配，🟨 部分匹配，🟥 不匹配；🟥⬆️ 或 🟥⬇️ 表示答案更大或更小。
+
+## 许可证
+
+可按 [Apache-2.0](LICENSE-APACHE) 或 [MIT](LICENSE-MIT) 使用。

package/lib/index.d.ts

@@ -1,7 +1,7 @@
-import { Context, Schema } from 'koishi';
+import { Context, Schema, Session } from 'koishi';
 import { MobData, BlockData, ItemData } from './data';
 export declare const name = "mcdle";
-export declare const usage = "## \u4F7F\u7528\n\n`mcdle.\u731C [\u540D\u79F0]` \u5F00\u5C40\u6216\u731C\u6D4B\u3002\u7CFB\u7EDF\u968F\u673A\u9009\u62E9\u751F\u7269\u3001\u7269\u54C1\u6216\u65B9\u5757\uFF0C\u6309\u5C5E\u6027\u989C\u8272\u63D0\u793A\u63A5\u8FD1\u7A0B\u5EA6\u3002\n\n## \u63D0\u793A\n\n| \u7B26\u53F7 | \u542B\u4E49 |\n| --- | --- |\n| \uD83D\uDFE9 | \u5B8C\u5168\u5339\u914D |\n| \uD83D\uDFE8 | \u90E8\u5206\u5339\u914D |\n| \uD83D\uDFE5 | \u4E0D\u5339\u914D |\n| \uD83D\uDFE5\u2B06\uFE0F / \uD83D\uDFE5\u2B07\uFE0F | \u7B54\u6848\u66F4\u5927 / \u66F4\u5C0F |\n\n## \u6307\u4EE4\n\n| \u6307\u4EE4 | \u8BF4\u660E |\n| --- | --- |\n| `mcdle` | \u67E5\u770B\u5E2E\u52A9 |\n| `mcdle.\u731C [\u540D\u79F0]` | \u5F00\u5C40\u6216\u731C\u6D4B |\n| `mcdle.\u5E2E\u52A9` | \u5B8C\u6574\u8BF4\u660E |\n| `mcdle.\u6392\u884C\u699C` | \u7FA4\u5185\u6218\u7EE9 |\n| `mcdle.\u8BCD\u5E93` | \u5168\u90E8\u8BCD\u6761 |";
+export declare const usage = "## \u4F7F\u7528\n\n\u53D1\u9001 `mcdle` \u67E5\u770B\u73A9\u6CD5\u4E0E\u5168\u90E8\u6307\u4EE4\u3002`mcdle.\u731C [\u540D\u79F0]` \u7528\u6709\u6548\u8BCD\u6761\u5F00\u5C40\u6216\u731C\u6D4B\u3002\u9996\u6B21\u731C\u6D4B\u7684\u8BCD\u6761\u51B3\u5B9A\u751F\u7269\u3001\u7269\u54C1\u6216\u65B9\u5757\u6A21\u5F0F\uFF0C\u7CFB\u7EDF\u518D\u4ECE\u540C\u7C7B\u8BCD\u5E93\u4E2D\u62BD\u53D6\u7B54\u6848\u3002\n\n## \u63D0\u793A\n\n| \u7B26\u53F7 | \u542B\u4E49 |\n| --- | --- |\n| \uD83D\uDFE9 | \u5B8C\u5168\u5339\u914D |\n| \uD83D\uDFE8 | \u90E8\u5206\u5339\u914D |\n| \uD83D\uDFE5 | \u4E0D\u5339\u914D |\n| \uD83D\uDFE5\u2B06\uFE0F / \uD83D\uDFE5\u2B07\uFE0F | \u7B54\u6848\u66F4\u5927 / \u66F4\u5C0F |\n\n## \u6307\u4EE4\n\n| \u6307\u4EE4 | \u8BF4\u660E |\n| --- | --- |\n| `mcdle` | \u73A9\u6CD5\u4E0E\u6307\u4EE4\u8BF4\u660E |\n| `mcdle.\u731C [\u540D\u79F0]` | \u7528\u6709\u6548\u8BCD\u6761\u5F00\u5C40\u6216\u731C\u6D4B |\n| `mcdle.\u88F8\u731C [\u5F00/\u5173]` | \u5207\u6362\u672C\u7FA4\u65E0\u524D\u7F00\u7EED\u731C |\n| `mcdle.\u6392\u884C\u699C` | \u7FA4\u5185\u6218\u7EE9 |\n| `mcdle.\u8BCD\u5E93` | \u5168\u90E8\u8BCD\u6761 |";
 export declare const inject: {
     required: string[];
     optional: string[];
@@ -24,7 +24,7 @@ declare module "koishi" {
         mcdle_rank: McdleRank;
     }
 }
-interface Mcdle {
+export interface Mcdle {
     id: number;
     channelId: string;
     answer: MobData | ItemData | BlockData | null;
@@ -46,5 +46,25 @@ interface McdleRank {
     blockSuccessCount: number;
     totalSuccessCount: number;
 }
+/**
+ * 裸猜只接受一条完整、无修饰、且与 MCDLE 词库精确匹配的纯文本消息。
+ * 引用、@、图片、富文本及机器人消息都可能只是普通聊天的一部分，不能据此猜测。
+ */
+export declare function getMiddlewareGuess(session: Session): string | null;
+/** 裸猜只能加入当前模式下已开始的有效局面，绝不能代替完整指令开新局。 */
+export declare function canHandleMiddlewareGuess(game: Mcdle | null | undefined, guess: string, allowRepeatedGuesses?: boolean): boolean;
+export type MiddlewareSwitch = {
+    error: string;
+} | {
+    /** 写回本群覆盖表的新值；undefined 表示清除覆盖，重新跟随插件配置。 */
+    override: boolean | undefined;
+    on: boolean;
+    reverted: boolean;
+};
+/**
+ * 无参调用在「配置默认」与「本群临时相反」间往返；显式开/关若与配置相同，
+ * 就清除冗余覆盖。临时状态只保存在内存中，插件重载后自然回到配置默认。
+ */
+export declare function resolveMiddlewareSwitch(config: boolean, override: boolean | undefined, action: string | null | undefined): MiddlewareSwitch;
 export declare function apply(ctx: Context, cfg: Config): void;
 export {};

package/lib/index.js

@@ -18,15 +18,18 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var index_exports = {};
-__export(index_exports, {
+var src_exports = {};
+__export(src_exports, {
   Config: () => Config,
   apply: () => apply,
+  canHandleMiddlewareGuess: () => canHandleMiddlewareGuess,
+  getMiddlewareGuess: () => getMiddlewareGuess,
   inject: () => inject,
   name: () => name,
+  resolveMiddlewareSwitch: () => resolveMiddlewareSwitch,
   usage: () => usage
 });
-module.exports = __toCommonJS(index_exports);
+module.exports = __toCommonJS(src_exports);
 var import_koishi = require("koishi");
 
 // src/data.ts
@@ -15395,7 +15398,7 @@ function boardCard(opts) {
   return shell(body, { accent: meta.accent });
 }
 __name(boardCard, "boardCard");
-function startCard(mode, played, limit) {
+function startCard(mode, played, limit, middleware) {
   const meta = MODES[mode];
   const fields = FIELDS[mode];
   const attrs = fields.map((k) => `<div class="attr">${px(fieldIcon(k), 13)}<span>${esc(keyMap[k] || k)}</span></div>`).join("");
@@ -15415,7 +15418,7 @@ function startCard(mode, played, limit) {
       <div class="sec">
         <div class="sec-t"><span>下 一 步</span></div>
         <div class="panel"><div class="rows">
-          <div class="row"><span class="cmd">mcdle.猜 [名称]</span><span class="m">提交一次猜测</span></div>
+          <div class="row"><span class="cmd">${middleware ? `直接发送${esc(meta.name)}名称` : "mcdle.猜 [名称]"}</span><span class="m">提交后续猜测</span></div>
           <div class="row"><span class="cmd">mcdle.词库</span><span class="m">忘了有哪些词条时翻一翻</span></div>
         </div></div>
       </div>
@@ -15466,7 +15469,7 @@ function winCard(o) {
   return shell(body, { accent: meta.accent, width: 720 });
 }
 __name(winCard, "winCard");
-function helpCard(dailyLimit, allowRepeat) {
+function helpCard(dailyLimit, allowRepeat, middleware) {
   const modeCards = ["mob", "item", "block"].map((m) => {
     const meta = MODES[m];
     return `<div class="mode-card" style="--accent:${meta.accent}">
@@ -15476,7 +15479,15 @@ function helpCard(dailyLimit, allowRepeat) {
       </div>`;
   }).join("");
   const legend = legendChips();
-  const body = header(null, "我的世界猜谜 · 玩法说明", { big: `${dailyLimit}`, cap: "每日局数上限" }) + `<div class="pad">
+  const total = mobData.length + itemData.length + blockData.length;
+  const body = header(null, "猜生物 · 猜物品 · 猜方块", { big: `${total}`, cap: "词条总量" }) + `<div class="pad">
+      <div class="sec">
+        <div class="sec-t"><span>玩 什 么</span></div>
+        <div class="panel"><div class="rows">
+          <div class="row"><span>每局随机抽一个生物、物品或方块，你的每次猜测都会逐项与答案比对，用颜色告诉你差在哪里。</span></div>
+          <div class="row"><span>首次猜测的词条属于哪一类，本局就在哪一类里出题。</span></div>
+        </div></div>
+      </div>
       <div class="sec">
         <div class="sec-t"><span>三 种 模 式</span></div>
         <div class="grid3">${modeCards}</div>
@@ -15491,11 +15502,21 @@ function helpCard(dailyLimit, allowRepeat) {
           </div>
         </div>
       </div>
+      <div class="sec">
+        <div class="sec-t"><span>三 步 上 手</span></div>
+        <div class="panel"><div class="rows">
+          <div class="row"><span class="k">壹</span><span class="cmd">mcdle.猜 苦力怕</span><span class="m">用一个有效词条开局</span></div>
+          <div class="row"><span class="k">贰</span><span>${middleware ? "开局后可直接发送当前模式的完整词条名称继续猜测。" : "对照颜色与箭头缩小范围，每一次猜测都会留在棋盘上。"}</span></div>
+          <div class="row"><span class="k">叁</span><span>锁定答案，战绩自动记入 <span class="cmd">mcdle.排行榜</span>。</span></div>
+        </div></div>
+      </div>
       <div class="sec">
         <div class="sec-t"><span>指 令</span></div>
         <div class="panel"><div class="rows">
+          <div class="row"><span class="cmd">mcdle</span><span class="m">这份玩法与指令说明</span></div>
           <div class="row"><span class="cmd">mcdle.猜 [名称]</span><span class="m">开始一局，或提交猜测</span></div>
           <div class="row"><span class="cmd">mcdle.猜</span><span class="m">局中直接使用可回看当前棋盘</span></div>
+          <div class="row"><span class="cmd">mcdle.裸猜 [开/关]</span><span class="m">临时切换本群无前缀续猜</span></div>
           <div class="row"><span class="cmd">mcdle.排行榜</span><span class="m">查看群内战绩</span></div>
           <div class="row"><span class="cmd">mcdle.词库</span><span class="m">查阅全部候选词条</span></div>
         </div></div>
@@ -15505,48 +15526,19 @@ function helpCard(dailyLimit, allowRepeat) {
         <div class="panel"><div class="rows">
           <div class="row"><span class="k">·</span><span>每个群每日可开始 <b>${dailyLimit}</b> 局，跨零点重置。</span></div>
           <div class="row"><span class="k">·</span><span>${allowRepeat ? "允许重复提交已经猜过的词条。" : "同一局内不能重复提交已猜过的词条。"}</span></div>
+          <div class="row"><span class="k">·</span><span>${middleware ? "本群裸猜已开启：只接受当前模式词库中的完整纯文本词条。" : "本群裸猜已停用：续猜请使用完整指令。"}</span></div>
+          <div class="row"><span class="k">·</span><span>空指令与词库外名称不会开启新局或消耗额度。</span></div>
           <div class="row"><span class="k">·</span><span>词条与数据来自 Minecraft Wiki，版本号按发布先后比较。</span></div>
         </div></div>
       </div>
-    </div>` + noteRow("词条数据来自 zh.minecraft.wiki");
+    </div>` + noteRow("灵感来自 Wordle 与 mcdle.net");
   return shell(body, { accent: "#8ec96a", width: 760 });
 }
 __name(helpCard, "helpCard");
-function introCard(dailyLimit) {
-  const modeCards = ["mob", "item", "block"].map((m) => {
-    const meta = MODES[m];
-    return `<div class="mode-card" style="--accent:${meta.accent}">
-        <div class="top" style="color:${meta.accent}">${px(meta.icon, 17)}<span>${meta.name}</span></div>
-        <div class="cnt">${meta.total} 个词条</div>
-      </div>`;
-  }).join("");
-  const body = header(null, "猜生物 · 猜物品 · 猜方块", { big: `${mobData.length + itemData.length + blockData.length}`, cap: "词条总量" }) + `<div class="pad">
-      <div class="sec">
-        <div class="sec-t"><span>玩 什 么</span></div>
-        <div class="grid3">${modeCards}</div>
-      </div>
-      <div class="sec">
-        <div class="sec-t"><span>三 步 上 手</span></div>
-        <div class="panel"><div class="rows">
-          <div class="row"><span class="k">壹</span><span class="cmd">mcdle.猜 苦力怕</span><span class="m">随便报一个名字即可开局</span></div>
-          <div class="row"><span class="k">贰</span><span>对照颜色与箭头缩小范围，每一次猜测都会留在棋盘上。</span></div>
-          <div class="row"><span class="k">叁</span><span>锁定答案，战绩自动记入 <span class="cmd">mcdle.排行榜</span>。</span></div>
-        </div></div>
-      </div>
-      <div class="sec">
-        <div class="sec-t"><span>今 日 额 度</span></div>
-        <div class="panel"><div class="rows">
-          <div class="row"><span class="k">·</span><span>每个群每日 <b>${dailyLimit}</b> 局，跨零点重置；详细规则见 <span class="cmd">mcdle.帮助</span>。</span></div>
-        </div></div>
-      </div>
-    </div>` + noteRow("灵感来自 Wordle 与 mcdle.net");
-  return shell(body, { accent: "#8ec96a", width: 700 });
-}
-__name(introCard, "introCard");
 function rankCard(entries, shown) {
   if (!entries.length) {
     const body2 = header(null, "排行榜", { big: "0", cap: "上榜人数" }) + `<div class="pad"><div class="empty">${px("trophy", 44)}
-        榜单还空着<br><span style="font-size:12px">用 <span class="cmd">mcdle.猜</span> 开出第一局，成为榜首</span></div></div>`;
+        榜单还空着<br><span style="font-size:12px">用 <span class="cmd">mcdle.猜 苦力怕</span> 开出第一局，成为榜首</span></div></div>`;
     return shell(body2, { accent: "#e8b53c", width: 560 });
   }
   const max = Math.max(...entries.map((e) => e.total), 1);
@@ -15574,7 +15566,7 @@ __name(rankCard, "rankCard");
 var name = "mcdle";
 var usage = `## 使用
 
-\`mcdle.猜 [名称]\` 开局或猜测。系统随机选择生物、物品或方块，按属性颜色提示接近程度。
+发送 \`mcdle\` 查看玩法与全部指令。\`mcdle.猜 [名称]\` 用有效词条开局或猜测。首次猜测的词条决定生物、物品或方块模式，系统再从同类词库中抽取答案。
 
 ## 提示
 
@@ -15589,16 +15581,16 @@ var usage = `## 使用
 
 | 指令 | 说明 |
 | --- | --- |
-| \`mcdle\` | 查看帮助 |
-| \`mcdle.猜 [名称]\` | 开局或猜测 |
-| \`mcdle.帮助\` | 完整说明 |
+| \`mcdle\` | 玩法与指令说明 |
+| \`mcdle.猜 [名称]\` | 用有效词条开局或猜测 |
+| \`mcdle.裸猜 [开/关]\` | 切换本群无前缀续猜 |
 | \`mcdle.排行榜\` | 群内战绩 |
 | \`mcdle.词库\` | 全部词条 |`;
 var inject = { required: ["database"], optional: ["puppeteer"] };
 var Config = import_koishi.Schema.object({
   atReply: import_koishi.Schema.boolean().default(false).description("响应时@用户"),
-  quoteReply: import_koishi.Schema.boolean().default(true).description("响应时引用消息"),
-  isEnableMiddleware: import_koishi.Schema.boolean().default(false).description("启用中间件（无需指令直接猜测）"),
+  quoteReply: import_koishi.Schema.boolean().default(false).description("响应时引用消息"),
+  isEnableMiddleware: import_koishi.Schema.boolean().default(false).description("是否默认启用无前缀续猜（仅在游戏进行中生效；mcdle.裸猜 可在单个群内临时切换）"),
   addStatusTextAfterEmoji: import_koishi.Schema.boolean().default(true).description("在状态表情后添加文字说明"),
   maxRank: import_koishi.Schema.number().default(10).min(0).description("排行榜最大显示人数"),
   dailyPlayLimit: import_koishi.Schema.number().default(1).min(1).description("每日游玩次数上限"),
@@ -15626,6 +15618,56 @@ var guessesField = {
     }
   }
 };
+var DATA_BY_MODE = {
+  mob: mobData,
+  item: itemData,
+  block: blockData
+};
+var allChineseTitles = new Set(
+  Object.values(DATA_BY_MODE).flatMap(
+    (entries) => entries.map((entry) => entry.chinese_title)
+  )
+);
+function getMiddlewareGuess(session) {
+  const message = session.event.message;
+  if (!message || message.quote || session.event.user?.isBot || message.user?.isBot) {
+    return null;
+  }
+  const elements = message.elements ?? [];
+  if (elements.length !== 1 || elements[0].type !== "text") return null;
+  const text = elements[0].attrs.content;
+  if (typeof text !== "string" || text !== text.trim() || !text || !allChineseTitles.has(text)) {
+    return null;
+  }
+  return text;
+}
+__name(getMiddlewareGuess, "getMiddlewareGuess");
+function canHandleMiddlewareGuess(game, guess, allowRepeatedGuesses = false) {
+  if (!game || game.gameEnded || !game.answer) return false;
+  const mode = game.gameMode;
+  if (!mode || !DATA_BY_MODE[mode]) return false;
+  if (!allowRepeatedGuesses && game.guessedChineseTitles?.includes(guess)) return false;
+  return DATA_BY_MODE[mode].some((entry) => entry.chinese_title === guess);
+}
+__name(canHandleMiddlewareGuess, "canHandleMiddlewareGuess");
+function resolveMiddlewareSwitch(config, override, action) {
+  const arg = action?.trim();
+  if (!arg) {
+    return override === void 0 ? { override: !config, on: !config, reverted: false } : { override: void 0, on: config, reverted: true };
+  }
+  if (arg === "状态") {
+    return { override, on: override ?? config, reverted: false };
+  }
+  const on = arg === "开" || arg === "开启";
+  if (!on && arg !== "关" && arg !== "关闭") {
+    return { error: "裸猜开关只认 开 / 关 / 状态" };
+  }
+  if (on === config) {
+    return { override: void 0, on: config, reverted: override !== void 0 };
+  }
+  return { override: on, on, reverted: false };
+}
+__name(resolveMiddlewareSwitch, "resolveMiddlewareSwitch");
 function apply(ctx, cfg) {
   ctx.model.extend(
     "mcdle",
@@ -15661,41 +15703,48 @@ function apply(ctx, cfg) {
     }
   );
   const logger = ctx.logger("mcdle");
-  if (cfg.isEnableMiddleware) {
-    ctx.middleware(async (session, next) => {
-      let gameRecords = await ctx.database.get("mcdle", { channelId: session.channelId });
-      if (!gameRecords || gameRecords.length === 0) {
-        return next();
-      }
-      const game = gameRecords[0];
-      if (game.gameEnded) {
-        return next();
-      }
-      const content = session.content.trim();
-      if (content.length > 10 || /[，。！？；：'"“”‘’【】（）《》.,!?;:'"\[\]()<>]/.test(content)) return next();
-      if (!cfg.allowRepeatedGuesses && game.guessedChineseTitles.includes(content)) {
-        return next();
-      }
-      let dataSource = [];
-      if (game.gameMode === "mob") dataSource = mobData;
-      else if (game.gameMode === "item") dataSource = itemData;
-      else if (game.gameMode === "block") dataSource = blockData;
-      else return next();
-      const matched = dataSource.find(
-        (d) => d.chinese_title === content
+  const middlewareOverrides = /* @__PURE__ */ new Map();
+  const middlewareOn = /* @__PURE__ */ __name((channelId) => channelId === void 0 ? cfg.isEnableMiddleware : middlewareOverrides.get(channelId) ?? cfg.isEnableMiddleware, "middlewareOn");
+  ctx.middleware(async (session, next) => {
+    if (!session.channelId || !middlewareOn(session.channelId)) return await next();
+    const guess = getMiddlewareGuess(session);
+    if (!guess) return await next();
+    try {
+      const [game] = await ctx.database.get("mcdle", { channelId: session.channelId });
+      if (!canHandleMiddlewareGuess(game, guess, cfg.allowRepeatedGuesses)) return await next();
+      const handled = await c(session, guess, false);
+      return handled ? void 0 : await next();
+    } catch (error) {
+      logger.warn(
+        "中间件读取或处理游戏状态失败，本次消息不作猜测：%s",
+        error instanceof Error ? error.message : String(error)
       );
-      if (!matched) {
-        return next();
-      }
-      await session.execute(`mcdle.猜 ${content}`);
-      return;
-    });
-  }
-  ctx.command("mcdle", "我的世界猜谜游戏").action(async ({ session }) => mcdle(session));
-  ctx.command("mcdle.猜 [guess:string]").action(async ({ session }, guess) => c(session, guess?.trim()));
-  ctx.command("mcdle.帮助").action(async ({ session }) => bz(session));
+      return await next();
+    }
+  });
+  ctx.command("mcdle", "我的世界猜谜游戏 · 玩法与指令").action(async ({ session }) => mcdle(session));
+  ctx.command("mcdle.猜 [guess:string]").action(async ({ session }, guess) => {
+    await c(session, guess?.trim());
+  });
   ctx.command("mcdle.排行榜").action(async ({ session }) => phb(session));
   ctx.command("mcdle.词库").action(async ({ session }) => ck(session));
+  ctx.command("mcdle.裸猜 [state:string]", "临时开关本群的无前缀续猜").usage("例：mcdle.裸猜（切换）· mcdle.裸猜 开 · mcdle.裸猜 关 · mcdle.裸猜 状态").action(async ({ session }, state) => {
+    const result = resolveMiddlewareSwitch(
+      cfg.isEnableMiddleware,
+      session.channelId === void 0 ? void 0 : middlewareOverrides.get(session.channelId),
+      state
+    );
+    if ("error" in result) {
+      await sendMsg(session, `⚠️ ${result.error}。例：mcdle.裸猜 开`);
+      return;
+    }
+    if (result.override === void 0) middlewareOverrides.delete(session.channelId);
+    else middlewareOverrides.set(session.channelId, result.override);
+    await sendMsg(
+      session,
+      middlewareSwitchText(result.on, result.override !== void 0, result.reverted)
+    );
+  });
   const RULE = "────────────";
   function textCard(title, ...sections) {
     const body = sections.map((s) => Array.isArray(s) ? s.filter(Boolean).join("\n") : s).filter((s) => !!s && !!s.trim()).join("\n\n");
@@ -15755,13 +15804,16 @@ function apply(ctx, cfg) {
     );
   }
   __name(boardText, "boardText");
-  function startText(mode, played) {
+  function startText(mode, played, channelOn) {
     const meta = MODES[mode];
     return textCard(
       `新的一局 · ${meta.name}模式`,
       `${meta.tagline}，从 ${meta.total} 个候选中锁定唯一答案。`,
       `可推理属性：${FIELDS[mode].map((k) => keyMap[k] || k).join(" / ")}`,
-      [`mcdle.猜 [名称]　提交一次猜测`, `今日进度 ${played}/${cfg.dailyPlayLimit}`]
+      [
+        channelOn ? `直接发送词库中的${meta.name}名称，或使用 mcdle.猜 [名称]` : `mcdle.猜 [名称]　提交一次猜测`,
+        `今日进度 ${played}/${cfg.dailyPlayLimit}`
+      ]
     );
   }
   __name(startText, "startText");
@@ -15818,27 +15870,28 @@ function apply(ctx, cfg) {
   }
   __name(sendCard, "sendCard");
   async function mcdle(session) {
-    await sendCard(session, introCard(cfg.dailyPlayLimit), introText());
+    const channelOn = middlewareOn(session.channelId);
+    await sendCard(
+      session,
+      helpCard(cfg.dailyPlayLimit, cfg.allowRepeatedGuesses, channelOn),
+      helpText(channelOn)
+    );
   }
   __name(mcdle, "mcdle");
-  function introText() {
-    const total = mobData.length + itemData.length + blockData.length;
-    return textCard(
-      "MCDLE · 我的世界猜谜",
-      `从 ${total} 个词条里，只凭属性提示锁定唯一答案。`,
-      [
-        `壹　mcdle.猜 苦力怕　随便报个名字即可开局`,
-        `贰　对照颜色与箭头缩小范围，每次猜测都会留在棋盘上`,
-        `叁　猜中后自动记入 mcdle.排行榜`
-      ],
-      [
-        `生物 ${mobData.length} · 物品 ${itemData.length} · 方块 ${blockData.length}`,
-        `每日 ${cfg.dailyPlayLimit} 局，跨零点重置`,
-        `完整规则：mcdle.帮助`
-      ]
-    );
+  function middlewareSwitchText(on, temporary, reverted) {
+    const mark = on ? "✅" : "⛔";
+    const state = on ? "开启" : "停用";
+    const config = cfg.isEnableMiddleware ? "开启" : "停用";
+    if (!temporary) {
+      return `${mark} 裸猜续局 · ${reverted ? "已复原，" : ""}跟随插件配置（${state}）`;
+    }
+    const hint = on ? "仅在已有对局中，直接发送当前模式的完整词条名称才会响应" : "续猜请使用 mcdle.猜 [名称]";
+    return [
+      `${mark} 裸猜续局 · 本群临时${state}（插件配置：${config}）`,
+      `${hint}；再次发送 mcdle.裸猜 可复原`
+    ].join("\n");
   }
-  __name(introText, "introText");
+  __name(middlewareSwitchText, "middlewareSwitchText");
   async function ck(session) {
     const sections = [
       [`生物词库 · ${mobChineseTitle.length} 条`, mobChineseTitle],
@@ -15866,11 +15919,7 @@ ${words.join(" ")}`).join("\n\n")
     );
   }
   __name(ck, "ck");
-  const POOLS = {
-    mob: mobData,
-    item: itemData,
-    block: blockData
-  };
+  const POOLS = DATA_BY_MODE;
   function modeOf(entry) {
     if (mobData.includes(entry)) return "mob";
     if (itemData.includes(entry)) return "item";
@@ -15927,7 +15976,7 @@ ${words.join(" ")}`).join("\n\n")
     return candidates[Math.floor(Math.random() * candidates.length)];
   }
   __name(pickAnswer, "pickAnswer");
-  async function c(session, guess) {
+  async function c(session, guess, allowStart = true) {
     const record = await ensureRecord(session);
     const now = /* @__PURE__ */ new Date();
     await resetDailyIfNeeded(session, record, now);
@@ -15943,12 +15992,12 @@ ${words.join(" ")}`).join("\n\n")
           record.guesses = restored;
           record.formatVersion = FORMAT_VERSION;
         } else {
-          await rollbackLegacyGame(session, record, guess, now);
-          return;
+          await rollbackLegacyGame(session, record, guess, now, allowStart);
+          return true;
         }
       } else if (record.guesses.length) {
-        await rollbackLegacyGame(session, record, guess, now);
-        return;
+        await rollbackLegacyGame(session, record, guess, now, allowStart);
+        return true;
       } else {
         await ctx.database.set(
           "mcdle",
@@ -15959,10 +16008,12 @@ ${words.join(" ")}`).join("\n\n")
       }
     }
     if (record.gameEnded) {
+      if (!allowStart) return false;
       await startNewGame(session, record, guess, now);
     } else {
       await continueGame(session, record, guess);
     }
+    return true;
   }
   __name(c, "c");
   function restoreGuessHistory(record) {
@@ -15975,7 +16026,7 @@ ${words.join(" ")}`).join("\n\n")
     return entries.map((entry) => compareData(entry, record.answer));
   }
   __name(restoreGuessHistory, "restoreGuessHistory");
-  async function rollbackLegacyGame(session, record, guess, now) {
+  async function rollbackLegacyGame(session, record, guess, now, allowStart) {
     const answerTitle = record.answer?.chinese_title;
     const history = answerTitle ? record.historyChineseTitles.filter((title) => title !== answerTitle) : record.historyChineseTitles;
     const refunded = Math.max(0, record.dailyPlayedToday - 1);
@@ -15999,24 +16050,50 @@ ${words.join(" ")}`).join("\n\n")
         "检测到旧版本遗留的一局",
         "这局是在旧版本下开始的，已有的猜测记录没法用新版图片牌面渲染。",
         answerTitle ? `「${answerTitle}」已退回词库，之后仍有机会被抽到。` : null,
-        "这一局已作废并退还今日额度，马上为你重新开一局。"
+        allowStart ? "这一局已作废并退还今日额度，马上按这次的完整指令重新开局。" : "这一局已作废并退还今日额度，请用 mcdle.猜 [名称] 重新开局。"
       )
     );
-    await startNewGame(
-      session,
-      {
-        ...record,
-        historyChineseTitles: history,
-        dailyPlayedToday: refunded,
-        gameEnded: true,
-        formatVersion: FORMAT_VERSION
-      },
-      guess,
-      now
-    );
+    if (allowStart) {
+      await startNewGame(
+        session,
+        {
+          ...record,
+          historyChineseTitles: history,
+          dailyPlayedToday: refunded,
+          gameEnded: true,
+          formatVersion: FORMAT_VERSION
+        },
+        guess,
+        now
+      );
+    }
   }
   __name(rollbackLegacyGame, "rollbackLegacyGame");
   async function startNewGame(session, record, guess, now) {
+    if (!guess) {
+      await sendMsg(
+        session,
+        textCard(
+          "还没有进行中的游戏",
+          "请发送完整指令 mcdle.猜 [名称] 开局，例如 mcdle.猜 苦力怕。",
+          "名称必须来自 mcdle.词库。"
+        )
+      );
+      return;
+    }
+    const opener = findAnywhere(guess);
+    if (!opener) {
+      const near = [...allChineseTitles].filter((title) => title.includes(guess) || guess.includes(title)).slice(0, 3);
+      await sendMsg(
+        session,
+        textCard(
+          `⚠️ 「${guess}」不在 MCDLE 词库里`,
+          near.length ? `是不是想猜：${near.join("、")}？` : null,
+          "没有开启新局，也没有消耗今日额度。请用 mcdle.猜 [词库名称] 开局。"
+        )
+      );
+      return;
+    }
     if (record.dailyPlayedToday >= cfg.dailyPlayLimit) {
       await sendMsg(
         session,
@@ -16028,8 +16105,7 @@ ${words.join(" ")}`).join("\n\n")
       );
       return;
     }
-    const opener = guess ? findAnywhere(guess) : void 0;
-    const mode = opener ? modeOf(opener) : ["mob", "item", "block"][Math.floor(Math.random() * 3)];
+    const mode = modeOf(opener);
     const answer = await pickAnswer(session, record, mode);
     const played = record.dailyPlayedToday + 1;
     await ctx.database.set(
@@ -16047,14 +16123,17 @@ ${words.join(" ")}`).join("\n\n")
         formatVersion: FORMAT_VERSION
       }
     );
-    await sendCard(session, startCard(mode, played, cfg.dailyPlayLimit), startText(mode, played));
-    if (opener) {
-      await applyGuess(
-        session,
-        { mode, answer, guesses: [], titles: [], startedAt: now, played },
-        opener
-      );
-    }
+    const channelOn = middlewareOn(session.channelId);
+    await sendCard(
+      session,
+      startCard(mode, played, cfg.dailyPlayLimit, channelOn),
+      startText(mode, played, channelOn)
+    );
+    await applyGuess(
+      session,
+      { mode, answer, guesses: [], titles: [], startedAt: now, played },
+      opener
+    );
   }
   __name(startNewGame, "startNewGame");
   async function continueGame(session, record, guess) {
@@ -16171,17 +16250,14 @@ ${words.join(" ")}`).join("\n\n")
     );
   }
   __name(applyGuess, "applyGuess");
-  function bz(session) {
-    return sendCard(session, helpCard(cfg.dailyPlayLimit, cfg.allowRepeatedGuesses), helpText());
-  }
-  __name(bz, "bz");
-  function helpText() {
+  function helpText(channelOn) {
+    const total = mobData.length + itemData.length + blockData.length;
     const legend = ["true", "mixed", "false", "false_up", "false_down"].map(
       (s) => `${STATUS_META[s].emoji} ${STATUS_META[s].label}`
     );
     return textCard(
-      "MCDLE 玩法说明",
-      "每局随机抽一个生物、物品或方块，你的每次猜测都会逐项与答案比对，用颜色告诉你差在哪里。",
+      "MCDLE · 我的世界猜谜",
+      `从 ${total} 个词条里，只凭属性提示锁定唯一答案。每局随机抽一个生物、物品或方块，首次猜测的词条属于哪一类，本局就在哪一类里出题。`,
       legend,
       [
         "部分匹配的字段里，【】括起来的就是与答案重合的那几项。",
@@ -16193,14 +16269,23 @@ ${words.join(" ")}`).join("\n\n")
         `方块 ${blockData.length} 条 · ${FIELDS.block.length} 项属性`
       ],
       [
+        `壹　mcdle.猜 苦力怕　用一个有效词条开局`,
+        channelOn ? `贰　开局后可直接发送当前模式的词条名称继续猜测` : `贰　对照颜色与箭头缩小范围，每次猜测都会留在棋盘上`,
+        `叁　猜中后自动记入 mcdle.排行榜`
+      ],
+      [
+        "mcdle　这份玩法与指令说明",
         "mcdle.猜 [名称]　开始一局，或提交猜测",
         "mcdle.猜　局中直接使用可回看当前棋盘",
+        "mcdle.裸猜 [开/关]　临时切换本群无前缀续猜",
         "mcdle.排行榜　查看群内战绩",
         "mcdle.词库　查阅全部候选词条"
       ],
       [
         `每个群每日 ${cfg.dailyPlayLimit} 局，跨零点重置。`,
         cfg.allowRepeatedGuesses ? "允许重复提交已经猜过的词条。" : "同一局内不能重复提交已猜过的词条。",
+        channelOn ? "本群裸猜已开启：仅已有对局、纯文本完整词条、且符合当前模式时响应。" : "本群裸猜已停用：请使用完整猜测指令。",
+        "空指令和词库外名称不会开启新局或消耗额度。",
         "词条与数据来自 zh.minecraft.wiki，版本号按发布先后比较。"
       ]
     );
@@ -16381,7 +16466,10 @@ __name(apply, "apply");
 0 && (module.exports = {
   Config,
   apply,
+  canHandleMiddlewareGuess,
+  getMiddlewareGuess,
   inject,
   name,
+  resolveMiddlewareSwitch,
   usage
 });

package/lib/view.d.ts

@@ -42,7 +42,7 @@ export interface BoardOptions {
     tip?: string;
 }
 export declare function boardCard(opts: BoardOptions): string;
-export declare function startCard(mode: Mode, played: number, limit: number): string;
+export declare function startCard(mode: Mode, played: number, limit: number, middleware: boolean): string;
 export interface WinOptions {
     mode: Mode;
     answer: any;
@@ -56,8 +56,7 @@ export interface WinOptions {
 /** 把秒数说成人话；秒级以内也要有话说，异常才落到破折号。 */
 export declare function formatDuration(seconds: number): string;
 export declare function winCard(o: WinOptions): string;
-export declare function helpCard(dailyLimit: number, allowRepeat: boolean): string;
-export declare function introCard(dailyLimit: number): string;
+export declare function helpCard(dailyLimit: number, allowRepeat: boolean, middleware: boolean): string;
 export interface RankEntry {
     username: string;
     userId: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-mcdle",
   "description": "Koishi 的 Minecraft 猜词游戏插件。",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
@@ -59,6 +59,10 @@
     }
   },
   "devDependencies": {
-    "koishi-plugin-puppeteer": "^3.9.0"
+    "koishi-plugin-puppeteer": "^3.9.0",
+    "tsx": "^4.23.13"
+  },
+  "scripts": {
+    "test": "tsx --test test/*.test.ts"
   }
 }

package/readme.md

@@ -1,51 +0,0 @@
-koishi-plugin-mcdle
-===================
-
-[<img alt="github" src="https://img.shields.io/badge/github-araea/koishi__plugin__mcdle-8da0cb?style=for-the-badge&labelColor=555555&logo=github" height="20">](https://github.com/araea/koishi-plugin-mcdle)
-[<img alt="npm" src="https://img.shields.io/npm/v/koishi-plugin-mcdle.svg?style=for-the-badge&color=fc8d62&logo=npm" height="20">](https://www.npmjs.com/package/koishi-plugin-mcdle)
-
-Koishi 的 Minecraft 猜词游戏插件。
-
-## 使用
-
-`mcdle.猜 [名称]` 开局或猜测。系统随机选择生物、物品或方块，按属性颜色提示接近程度。
-
-## 提示
-
-| 符号 | 含义 |
-| --- | --- |
-| 🟩 | 完全匹配 |
-| 🟨 | 部分匹配 |
-| 🟥 | 不匹配 |
-| 🟥⬆️ / 🟥⬇️ | 答案更大 / 更小 |
-
-## 指令
-
-| 指令 | 说明 |
-| --- | --- |
-| `mcdle` | 查看帮助 |
-| `mcdle.猜 [名称]` | 开局或猜测 |
-| `mcdle.帮助` | 完整说明 |
-| `mcdle.排行榜` | 群内战绩 |
-| `mcdle.词库` | 全部词条 |
-
-## QQ 群
-
-956758505
-
-<br>
-
-#### License
-
-<sup>
-Licensed under either of <a href="LICENSE-APACHE">Apache License, Version
-2.0</a> or <a href="LICENSE-MIT">MIT license</a> at your option.
-</sup>
-
-<br>
-
-<sub>
-Unless you explicitly state otherwise, any contribution intentionally submitted
-for inclusion in this crate by you, as defined in the Apache-2.0 license, shall
-be dual licensed as above, without any additional terms or conditions.
-</sub>