koishi-plugin-mcdle 0.2.0 → 0.3.1

package/lib/index.d.ts

@@ -1,7 +1,7 @@
 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\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 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]` | \u5F00\u5173\u672C\u9891\u9053\u7684\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[];

package/lib/index.js

@@ -14956,11 +14956,14 @@ function components() {
 .m3-header__title{font-size:32px;line-height:40px;font-weight:600;letter-spacing:0;color:var(--md-sys-color-on-surface);margin:0}
 .m3-header__support{font-size:14px;line-height:20px;font-weight:400;letter-spacing:.25px;color:var(--md-sys-color-on-surface-variant);margin:0}
 
-/* 页脚署名，压到最低对比度，不与正文抢视线 */
+/*
+ * 页脚署名。层次靠字号与字重拉开，不靠压低对比度 ——
+ * outline 是描边色（WCAG 只要求 3:1），拿来写字会掉到 AA 线下。
+ */
 .m3-footnote{
   padding-top:16px;text-align:center;
   font-size:12px;line-height:16px;letter-spacing:.4px;
-  color:var(--md-sys-color-outline);
+  color:var(--md-sys-color-on-surface-variant);
 }
 `;
 }
@@ -15570,7 +15573,7 @@ th.list .col{max-width:168px}
 .thumb img{max-width:38px;max-height:38px;display:block}
 .thumb img.sharp{image-rendering:pixelated}
 .thumb img.broken{display:none}
-.thumb .fb{display:none;color:var(--md-sys-color-outline)}
+.thumb .fb{display:none;color:var(--md-sys-color-on-surface-variant)}
 .thumb.failed .fb{display:block}
 .name .txt{min-width:0}
 .name .cn{font-size:15px;font-weight:600;line-height:1.25}
@@ -15578,7 +15581,7 @@ th.list .col{max-width:168px}
   white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:150px}
 .name.correct .cn,.name.correct .en,.name.correct .no{color:#fff}
 .name.correct .en,.name.correct .no{opacity:.78}
-.name .no{font-size:10px;color:var(--md-sys-color-outline);margin-top:3px}
+.name .no{font-size:10px;color:var(--md-sys-color-on-surface-variant);margin-top:3px}
 
 /* 最新一行的强调：外圈描边 + 行首的圆头标记 */
 tr.fresh .tile,tr.fresh .name{box-shadow:0 0 0 2px var(--accent)}
@@ -15609,7 +15612,7 @@ tr.fresh .name::before{content:"";position:absolute;left:0;top:14px;bottom:14px;
   font-size:11.5px;color:#fff;background:var(--tile);
 }
 .lg.s-none{color:var(--md-sys-color-on-surface-variant)}
-.tip{margin-left:auto;font-size:11.5px;color:var(--md-sys-color-outline);letter-spacing:.02em}
+.tip{margin-left:auto;font-size:11.5px;color:var(--md-sys-color-on-surface-variant);letter-spacing:.02em}
 
 /* ── 通用区块 ─────────────────────────────────────── */
 .sec{margin-top:22px}
@@ -15665,7 +15668,7 @@ tr.fresh .name::before{content:"";position:absolute;left:0;top:14px;bottom:14px;
 .reveal .big-thumb img{max-width:112px;max-height:112px;display:block}
 .reveal .big-thumb img.sharp{image-rendering:pixelated}
 .reveal .big-thumb img.broken{display:none}
-.reveal .big-thumb .fb{display:none;color:var(--md-sys-color-outline)}
+.reveal .big-thumb .fb{display:none;color:var(--md-sys-color-on-surface-variant)}
 .reveal .big-thumb.failed .fb{display:block}
 .reveal .cn{font-size:36px;font-weight:600;line-height:1.1}
 .reveal .en{font-size:13px;letter-spacing:.1em;color:var(--md-sys-color-on-surface-variant);margin-top:10px}
@@ -15707,11 +15710,11 @@ tr.fresh .name::before{content:"";position:absolute;left:0;top:14px;bottom:14px;
 .rk .sp{display:flex;align-items:center;gap:4px;font-size:11px;color:var(--md-sys-color-on-surface-variant)}
 .rk .tot{flex:none;text-align:right}
 .rk .tot .n{font-size:22px;font-weight:600;color:var(--accent);line-height:1;font-variant-numeric:tabular-nums}
-.rk .tot .c{font-size:10px;color:var(--md-sys-color-outline);margin-top:5px;letter-spacing:.06em}
+.rk .tot .c{font-size:10px;color:var(--md-sys-color-on-surface-variant);margin-top:5px;letter-spacing:.06em}
 
 .empty{padding:36px 20px;min-width:400px;text-align:center;
   color:var(--md-sys-color-on-surface-variant);font-size:13.5px;line-height:2}
-.empty .px{margin:0 auto 14px;color:var(--md-sys-color-outline)}
+.empty .px{margin:0 auto 14px;color:var(--md-sys-color-on-surface-variant)}
 `;
 function shell(body, opts) {
   const width = opts.width ? `width:${opts.width}px;` : "";
@@ -15917,7 +15920,7 @@ function helpCard(dailyLimit, allowRepeat, middleware) {
           <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 class="row"><span class="cmd">mcdle.词库</span><span class="m">查阅全部候选词条</span></div>
         </div></div>
@@ -15927,7 +15930,7 @@ function helpCard(dailyLimit, allowRepeat, middleware) {
         <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>${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>
@@ -15947,7 +15950,7 @@ function rankCard(entries, shown) {
     const pos = i + 1;
     const split = ["mob", "item", "block"].map((m) => {
       const n = m === "mob" ? e.mob : m === "item" ? e.item : e.block;
-      return `<span class="sp" style="color:${n ? MODES[m].accent : SCHEME.outline}">${px(MODES[m].icon, 10)}<span>${n}</span></span>`;
+      return `<span class="sp" style="color:${n ? MODES[m].accent : SCHEME.onSurfaceVariant}">${px(MODES[m].icon, 10)}<span>${n}</span></span>`;
     }).join("");
     const w = Math.round(e.total / max * 100);
     return `<div class="rk p${pos <= 3 ? pos : "n"}">
@@ -15984,22 +15987,22 @@ var usage = `## 使用
 | --- | --- |
 | \`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(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("每日游玩次数上限"),
+  atReply: 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("每个频道每日可开始的局数，跨零点重置。"),
   retractDelay: import_koishi.Schema.number().min(0).default(0).description(
-    `撤回上一条消息的等待时间，单位是秒。值为 0 时不启用自动撤回功能。`
+    `自动撤回延迟（秒），0 表示不撤回。`
   ),
-  allowRepeatedGuesses: import_koishi.Schema.boolean().default(false).description("允许重复猜测已猜过的词语（防止撤回时历史不可见）"),
-  disableImages: import_koishi.Schema.boolean().default(false).description("不发送图片，全部改用文本（解决网络问题导致的图片下载失败）")
+  allowRepeatedGuesses: import_koishi.Schema.boolean().default(false).description("允许重复提交已猜过的词条。消息被撤回、历史不可见时用得上。"),
+  disableImages: import_koishi.Schema.boolean().default(false).description("全部改用文本，不发送图片。图片下载常失败时用得上。")
 });
 var FORMAT_VERSION = 2;
 var guessesField = {
@@ -16061,7 +16064,7 @@ function resolveMiddlewareSwitch(config, override, action) {
   }
   const on = arg === "开" || arg === "开启";
   if (!on && arg !== "关" && arg !== "关闭") {
-    return { error: "裸猜开关只认 开 / 关 / 状态" };
+    return { error: "裸猜开关只认「开」「关」「状态」" };
   }
   if (on === config) {
     return { override: void 0, on: config, reverted: override !== void 0 };
@@ -16124,19 +16127,20 @@ function apply(ctx, cfg) {
     }
   });
   ctx.command("mcdle", "我的世界猜谜游戏 · 玩法与指令").action(async ({ session }) => mcdle(session));
-  ctx.command("mcdle.猜 [guess:string]").action(async ({ session }, guess) => {
+  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) => {
+  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.裸猜 开`);
+      await sendMsg(session, `⚠️ ${result.error}
+例：「mcdle.裸猜 开」，不带参数则来回切换。`);
       return;
     }
     if (result.override === void 0) middlewareOverrides.delete(session.channelId);
@@ -16288,7 +16292,7 @@ function apply(ctx, cfg) {
     }
     const hint = on ? "仅在已有对局中，直接发送当前模式的完整词条名称才会响应" : "续猜请使用 mcdle.猜 [名称]";
     return [
-      `${mark} 裸猜续局 · 本群临时${state}（插件配置：${config}）`,
+      `${mark} 裸猜续局 · 本频道临时${state}（插件配置：${config}）`,
       `${hint}；再次发送 mcdle.裸猜 可复原`
     ].join("\n");
   }
@@ -16451,7 +16455,7 @@ ${words.join(" ")}`).join("\n\n")
         "检测到旧版本遗留的一局",
         "这局是在旧版本下开始的，已有的猜测记录没法用新版图片牌面渲染。",
         answerTitle ? `「${answerTitle}」已退回词库，之后仍有机会被抽到。` : null,
-        allowStart ? "这一局已作废并退还今日额度，马上按这次的完整指令重新开局。" : "这一局已作废并退还今日额度，请用 mcdle.猜 [名称] 重新开局。"
+        allowStart ? "这一局已作废并退还今日额度，马上按这次的完整指令重新开局。" : "这一局已作废并退还今日额度，发送「mcdle.猜 [名称]」重新开局。"
       )
     );
     if (allowStart) {
@@ -16475,8 +16479,8 @@ ${words.join(" ")}`).join("\n\n")
       await sendMsg(
         session,
         textCard(
-          "还没有进行中的游戏",
-          "请发送完整指令 mcdle.猜 [名称] 开局，例如 mcdle.猜 苦力怕。",
+          "💡 本频道没有进行中的对局",
+          "发送完整指令开局，例如「mcdle.猜 苦力怕」。",
           "名称必须来自 mcdle.词库。"
         )
       );
@@ -16490,7 +16494,7 @@ ${words.join(" ")}`).join("\n\n")
         textCard(
           `⚠️ 「${guess}」不在 MCDLE 词库里`,
           near.length ? `是不是想猜：${near.join("、")}？` : null,
-          "没有开启新局，也没有消耗今日额度。请用 mcdle.猜 [词库名称] 开局。"
+          "没有开启新局，也没有消耗今日额度。换一个词库里的名称再来。"
         )
       );
       return;
@@ -16499,9 +16503,9 @@ ${words.join(" ")}`).join("\n\n")
       await sendMsg(
         session,
         textCard(
-          `⚠️ 今日 ${cfg.dailyPlayLimit} 局已经用完`,
+          `⏳ 今日 ${cfg.dailyPlayLimit} 局已经用完`,
           `跨零点后重置，还要等 ${untilReset(now)}。`,
-          "在那之前可以查看 mcdle.排行榜 或 mcdle.词库。"
+          "在那之前可以看看 mcdle.排行榜 或 mcdle.词库。"
         )
       );
       return;
@@ -16547,7 +16551,7 @@ ${words.join(" ")}`).join("\n\n")
       );
       await sendMsg(
         session,
-        textCard("⚠️ 这一局的牌面已经无法还原", "已经把它收掉了。发送 mcdle.猜 [名称] 可以重新开一局。")
+        textCard("⚠️ 这一局的牌面已经无法还原", "已经把它收掉了。发送「mcdle.猜 [名称]」重新开一局。")
       );
       return;
     }
@@ -16572,7 +16576,7 @@ ${words.join(" ")}`).join("\n\n")
           textCard(
             `轮到你了 · ${modeName(mode)}模式`,
             `报一个${modeName(mode)}的名字，比如 mcdle.猜 ${POOLS[mode][0].chinese_title}。`,
-            `拿不准有哪些词条就看 mcdle.词库。`
+            `拿不准有哪些词条，发送「mcdle.词库」翻一翻。`
           )
         );
       }
@@ -16678,14 +16682,14 @@ ${words.join(" ")}`).join("\n\n")
         "mcdle　这份玩法与指令说明",
         "mcdle.猜 [名称]　开始一局，或提交猜测",
         "mcdle.猜　局中直接使用可回看当前棋盘",
-        "mcdle.裸猜 [开/关]　临时切换本群无前缀续猜",
+        "mcdle.裸猜 [开/关]　临时切换本频道的无前缀续猜",
         "mcdle.排行榜　查看群内战绩",
         "mcdle.词库　查阅全部候选词条"
       ],
       [
         `每个群每日 ${cfg.dailyPlayLimit} 局，跨零点重置。`,
         cfg.allowRepeatedGuesses ? "允许重复提交已经猜过的词条。" : "同一局内不能重复提交已猜过的词条。",
-        channelOn ? "本群裸猜已开启：仅已有对局、纯文本完整词条、且符合当前模式时响应。" : "本群裸猜已停用：请使用完整猜测指令。",
+        channelOn ? "本频道裸猜已开启：仅已有对局、纯文本完整词条、且符合当前模式时响应。" : "本频道裸猜已停用：续猜请用完整指令。",
         "空指令和词库外名称不会开启新局或消耗额度。",
         "词条与数据来自 zh.minecraft.wiki，版本号按发布先后比较。"
       ]
@@ -16710,7 +16714,7 @@ ${words.join(" ")}`).join("\n\n")
       await sendCard(
         session,
         rankCard([], 0),
-        textCard("⚠️ 排行榜还空着", "用 mcdle.猜 开出第一局，这里的第一行就是你。")
+        textCard("📋 排行榜还空着", "第一个猜中的人，名字会写在这里。发送「mcdle.猜 苦力怕」开一局。")
       );
       return;
     }
@@ -16722,7 +16726,7 @@ ${words.join(" ")}`).join("\n\n")
     await sendCard(
       session,
       rankCard(entries, entries.length),
-      textCard(`排行榜 · 前 ${entries.length} 名`, lines, "每猜中一局记一分，按模式分别计数。")
+      textCard(`📋 排行榜 · 前 ${entries.length} 名`, lines, "每猜中一局记一分，按模式分别计数。")
     );
   }
   __name(phb, "phb");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-mcdle",
   "description": "Koishi 的 Minecraft 猜词游戏插件。",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [