koishi-plugin-mcdle 0.6.1 → 0.7.0

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+# 0.7.0 · 2026-09-26
+
+猜测恢复成一行一次猜测的列表，便于逐项对照；单句页脚居中。 主指令在 help 列表里补回描述；去掉「.显示」显示模式指令，有图只发图、出图失败才退回文字；多轮输入不再追加计时说明。
+
 # 0.6.0 · 2026-09-26
 
 猜测历史保留完整属性文字，棋盘改为两列属性卡；个人文字模式和裸猜冲突保护。

package/DESIGN_SYSTEM.md

@@ -13,12 +13,12 @@
 
 ## 输出、交互与内容
 
-1. 图文模式只发渲染图，不附文字；完整文字只在用户切到「文字」模式时出现。图片的等价文字随图片标记，切换到文字模式时展开，因此不会在群里重复刷屏。
-2. `插件主指令.显示 文字` / `插件主指令.显示 图文` 切换个人显示偏好；同一机器人中的这些插件共享选择。设置保存在内存，重启恢复图文。文本回复不能把后续条目无提示地压掉；较长管理列表分页。
+1. 有渲染图时只发图片，不附同内容的文字，避免在群里重复刷屏；图片生成失败时才退回文字。插件不提供个人显示模式开关。
+2. 每个插件的主指令都带描述，`help` 列表右侧不留空；主指令先于任何子指令注册（Koishi 会忽略已存在指令的描述）。文本回复不能把后续条目无提示地压掉；较长管理列表分页。
 3. 裸输入必须符合词法、对局状态及参与条件。多个插件匹配时不执行，要求明确完整指令；完整指令继续可用。
 4. 回复说明当前结果、未完成原因和可执行的下一步，不用管理员日志替代用户可用的反馈。退款、赔付与渲染失败不能伪装成功。
 5. 破坏性清空需展示范围、不可撤销性和限时确认码。确认码限制到同一机器人、平台、用户与频道，使用后立即失效。
-6. 多轮输入允许 5 分钟等待，发送「延长」重新计时，发送「取消」退出。斗牛、21 点提供延长等待入口。文字模式不主动撤回已发出的说明。
+6. 多轮输入等待 5 分钟，提问里写明可回复的内容与「取消」，不再追加计时说明。对局内的短窗口（如 21 点保险、投降）提供显式跳过，全员表态后立即进入下一阶段，而不是提供「延长」。
 7. 货币发放先写入核对记录，入账结果不明确时保留待核对状态，不自动重发。管理员核对实际流水并按需人工补发后标记确认；确认操作自身不转账。
 
 ## 内容边界
@@ -44,7 +44,7 @@ node markdown-to-image-service/scripts/sync-design-system.mjs --check
 
 官方色彩算法可在源仓库安装开发依赖后通过 `node scripts/build-material-colors.mjs` 重建，再同步消费者。
 
-回归检查覆盖：24 个源色相的明暗角色对比度、奖牌前景、图表填充/轨道差异、浏览器/服务端 HCT 一致性、文字输出与身份隔离、输入冲突、可延长输入、入账异常、清空确认和 Wordle 并发/渲染失败。工作区截图脚本为 `scripts/verify-rendering.ts`，需 Puppeteer Core 和可用 Chromium。
+回归检查覆盖：24 个源色相的明暗角色对比度、奖牌前景、图表填充/轨道差异、浏览器/服务端 HCT 一致性、主指令描述、输入冲突、入账异常、清空确认和 Wordle 并发/渲染失败。工作区截图脚本为 `scripts/verify-rendering.ts`，需 Puppeteer Core 和可用 Chromium。
 
 ## 本轮改动对应关系
 
@@ -53,9 +53,9 @@ node markdown-to-image-service/scripts/sync-design-system.mjs --check
 | 共享设计规范 | 官方 HCT、2025 动态颜色角色、共享字阶与间距、同步与哈希校验 |
 | Markdown | M3 明暗主题；旧主题名按明暗迁移；代码高亮与 Mermaid 使用 M3 角色；长代码可换行 |
 | message-counter / monetary-rank | M3 角色与共享图表字阶、HCT 头像配色、完整文字榜单；保留昵称截断 |
-| Wordle | 替换复制的 NYT 外观；状态符号与图例；明暗角色；文字棋盘；异常释放并发锁；安全解析模式编号 |
-| MCDLE | 历史猜测完整文字属性；两列属性卡减少超宽表格 |
+| Wordle | 替换复制的 NYT 外观；状态符号与图例；明暗角色；异常释放并发锁；安全解析模式编号；裸词只在确定是猜测时回应 |
+| MCDLE | 猜测按行排成一张表，方便逐项对照；单句页脚居中 |
 | 2048 / ciyi | 数字与奖牌前景按实际对比度选色 |
-| 斗牛 / 21 点 | 付款核对记录、如实反馈退款失败、明确下注金额、延长操作窗口 |
+| 斗牛 / 21 点 | 付款核对记录、如实反馈退款失败、明确下注金额、可显式跳过的短窗口 |
 | sentinel | 完整封印列表按每页 10 位展示 |
-| 其余插件 | 图文双通道、个人文字模式、可取消/延长输入与上下文反馈 |
+| 其余插件 | 渲染失败退回文字、可取消输入与上下文反馈 |

package/README.md

@@ -28,6 +28,6 @@ yarn add koishi-plugin-mcdle
 
 ## 显示与交互
 
-发送 `mcdle.显示 文字` 或 `mcdle.显示 图文` 切换个人显示偏好。同一机器人中的配套插件共享选择，重启后恢复图文。图文模式中的信息图片附带文字说明；作品素材与感官测试的适用边界见 [设计系统](./DESIGN_SYSTEM.md)。
+有渲染图时只发图片，不再附带同内容的文字；图片生成失败时才退回文字。作品素材与感官测试的适用边界见 [设计系统](./DESIGN_SYSTEM.md)。
 
-本次更新：猜测历史保留完整属性文字，棋盘改为两列属性卡；个人文字模式和裸猜冲突保护。
+本次更新：猜测恢复成一行一次猜测的列表，便于逐项对照；单句页脚居中。 主指令在 help 列表里补回描述；去掉「.显示」显示模式指令，有图只发图、出图失败才退回文字；多轮输入不再追加计时说明。

package/lib/index.js

@@ -36,28 +36,13 @@ var import_koishi = require("koishi");
 var KEY = Symbol.for("araea.koishi.ux.v1");
 function state(ctx) {
   const root = ctx.root;
-  return root[KEY] ??= { modes: /* @__PURE__ */ new Map(), owners: /* @__PURE__ */ new Set() };
+  return root[KEY] ??= { owners: /* @__PURE__ */ new Set() };
 }
 __name(state, "state");
-var userKey = /* @__PURE__ */ __name((session) => `${session.platform}:${session.selfId}:${session.userId}`, "userKey");
-function usePresentation(ctx, command) {
-  const shared = state(ctx);
-  ctx.command(`${command}.显示 [mode:string]`, "选择图文或文字输出").action(({ session }, mode) => {
-    if (!mode) return `当前：${shared.modes.get(userKey(session)) ? "文字" : "图文"}。发送「${command}.显示 文字」或「${command}.显示 图文」。设置对本机器人各插件生效，重启后恢复图文。`;
-    if (!["文字", "图文"].includes(mode)) return "请选择「文字」或「图文」。";
-    shared.modes.set(userKey(session), mode === "文字");
-    return `已切换为${mode}输出。`;
-  });
-  return {
-    textOnly: /* @__PURE__ */ __name((session) => shared.modes.get(userKey(session)) === true, "textOnly"),
-    /** 图文模式只给图片；图片缺失或用户选了文字模式时才退回文字。 */
-    present(session, image, text) {
-      if (!image || shared.modes.get(userKey(session))) return text;
-      return import_koishi.h.normalize(image);
-    }
-  };
+function present(image, text) {
+  return image ? import_koishi.h.normalize(image) : text;
 }
-__name(usePresentation, "usePresentation");
+__name(present, "present");
 function registerDirectInput(ctx, name2, matches) {
   const owner = { name: name2, matches };
   state(ctx).owners.add(owner);
@@ -20704,7 +20689,7 @@ function legendRow(tip) {
 }
 __name(legendRow, "legendRow");
 function noteRow(note) {
-  return `<footer class="legend"><div class="tip" style="margin:0">${esc(note)}</div></footer>`;
+  return `<footer class="legend" style="justify-content:center"><div class="tip" style="margin:0;text-align:center">${esc(note)}</div></footer>`;
 }
 __name(noteRow, "noteRow");
 function tileCell(guess, key) {
@@ -20719,15 +20704,24 @@ function tileCell(guess, key) {
   return `<td><div class="tile ${m.cls}${isList ? " list" : ""}"><span class="flag">${px(m.icon, 11)}</span>${body}</div></td>`;
 }
 __name(tileCell, "tileCell");
+function isListField(key, sample) {
+  return Array.isArray(sample?.[key]);
+}
+__name(isListField, "isListField");
 function boardCard(opts) {
   const { mode, guesses } = opts;
   const meta = MODES[mode];
   const fields = FIELDS[mode];
   const last = guesses[guesses.length - 1];
-  const cards = guesses.map((g, i) => `<article class="guess-card">
-    <h2 class="m3-title-large">${i + 1}. ${esc(g.chinese_title)} <span class="m3-body-medium">${esc(g.title || "")}</span></h2>
-    <div class="guess-fields">${fields.map((key) => `<table><thead><tr><th>${esc(fieldLabel(key))}</th></tr></thead><tbody><tr>${tileCell(g, key)}</tr></tbody></table>`).join("")}</div>
-  </article>`).join("");
+  const head = `<tr><th class="n"><div class="col"><span class="lb">${guesses.length} 次猜测</span></div></th>` + fields.map(
+    (k) => `<th${isListField(k, last) ? ' class="list"' : ""}><div class="col">${px(fieldIcon(k), 15)}<span class="lb">${esc(fieldLabel(k))}</span></div></th>`
+  ).join("") + "</tr>";
+  const rows = guesses.map((g, i) => {
+    const fresh = i === guesses.length - 1 ? ' class="fresh"' : "";
+    const solved = fields.every((k) => statusOf(g, k) === "true") && g.chinese_title_gui === "true";
+    const name2 = `<td><div class="name${solved ? " correct" : ""}">${thumb(g.wiki_image_url, mode)}<div class="txt"><div class="cn">${esc(g.chinese_title)}${solved ? " " + px("crown", 13) : ""}</div><div class="en">${esc(g.title || "")}</div><div class="no">#${String(i + 1).padStart(2, "0")}</div></div></div></td>`;
+    return `<tr${fresh}>${name2}${fields.map((k) => tileCell(g, k)).join("")}</tr>`;
+  }).join("");
   const locked = fields.filter((k) => statusOf(last, k) === "true").length;
   const pct = Math.round(locked / fields.length * 100);
   const prog = `<div class="prog"><div class="num">已锁定 ${locked}/${fields.length}</div>
@@ -20736,7 +20730,7 @@ function boardCard(opts) {
   const body = header(mode, `${meta.name}模式 · ${meta.tagline}`, {
     big: `#${guesses.length}`,
     cap: "猜测次数"
-  }) + `<style>.board-compact{width:640px;max-width:100%}.guess-card{padding:16px;border-radius:24px;background:var(--md-sys-color-surface-container-low);margin-bottom:16px}.guess-card h2{overflow-wrap:anywhere}.guess-fields{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}.guess-fields table{width:100%;table-layout:fixed}.guess-fields .tile{width:100%;max-width:none;min-width:0}.guess-fields td,.guess-fields th{white-space:normal;overflow-wrap:anywhere}</style><div class="pad board-compact">${cards}${prog}</div>` + legendRow(opts.tip || "箭头指向答案所在的方向");
+  }) + `<div class="pad"><table>${head}${rows}</table>${prog}</div>` + legendRow(opts.tip || "箭头指向答案所在的方向");
   return shell(body, { accent: meta.accent });
 }
 __name(boardCard, "boardCard");
@@ -21012,7 +21006,6 @@ function resolveMiddlewareSwitch(config, override, action) {
 }
 __name(resolveMiddlewareSwitch, "resolveMiddlewareSwitch");
 function apply(ctx, cfg) {
-  const presentation = usePresentation(ctx, "mcdle");
   ctx.model.extend(
     "mcdle",
     {
@@ -21228,8 +21221,8 @@ function apply(ctx, cfg) {
   }
   __name(renderCard, "renderCard");
   async function sendCard(session, html, fallback) {
-    const image = presentation.textOnly(session) ? null : await renderCard(html);
-    await sendMsg(session, import_koishi2.h.normalize(presentation.present(session, image, fallback)).join(""));
+    const image = await renderCard(html);
+    await sendMsg(session, import_koishi2.h.normalize(present(image, fallback)).join(""));
   }
   __name(sendCard, "sendCard");
   async function mcdle(session) {
@@ -21827,7 +21820,7 @@ ${words.join(" ")}`).join("\n\n")
       msg = `${import_koishi2.h.quote(session.messageId)}${msg}`;
     }
     const [messageId] = await session.send(msg);
-    if (!presentation.textOnly(session) && cfg.retractDelay > 0 && messageId) {
+    if (cfg.retractDelay > 0 && messageId) {
       const prevMessage = lastMessageInfo.get(session.channelId);
       if (prevMessage) {
         const timePassed = Date.now() - prevMessage.timestamp;

package/lib/ux.d.ts

@@ -3,29 +3,11 @@ type Owner = {
     name: string;
     matches: (session: Session) => boolean | Promise<boolean>;
 };
-/** 图文模式默认只发渲染图；完整文字只在用户切到「文字」模式时出现。偏好只影响本人。 */
-export declare function usePresentation(ctx: Context, command: string): {
-    textOnly: (session: Session) => boolean;
-    /** 图文模式只给图片；图片缺失或用户选了文字模式时才退回文字。 */
-    present(session: Session, image: h.Fragment | null | undefined, text: h.Fragment): h.Fragment;
-};
+/** 渲染图优先，只发图片；图片缺失时才退回等价文字。 */
+export declare function present(image: h.Fragment | null | undefined, text: h.Fragment): h.Fragment;
 /** Plugins register their active input grammar; overlapping messages are never executed. */
 export declare function registerDirectInput(ctx: Context, name: string, matches: Owner['matches']): void;
 export declare function directInputConflict(ctx: Context, session: Session): Promise<boolean>;
-/** No hidden time limit: users can extend the non-game input step without losing context. */
-export declare function promptInput(session: Session, instruction: string): Promise<string | undefined>;
-export declare const IMAGE_FAILURE = "\u56FE\u7247\u6682\u65F6\u65E0\u6CD5\u751F\u6210\uFF0C\u5DF2\u4FDD\u7559\u6587\u5B57\u5185\u5BB9\u3002\u53EF\u4EE5\u7A0D\u540E\u91CD\u8BD5\uFF1B\u82E5\u6301\u7EED\u5931\u8D25\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002";
-/**
- * 渲染图的等价文字。图文模式随图片一起丢掉、文字模式展开成正文，
- * 因此它永远不会原样发到聊天平台。
- */
-export declare const IMAGE_TEXT_TYPE = "ux-image-text";
-export declare function imageText(text: h.Fragment): h;
-/** 图文模式：保留图片与普通文字，去掉图片的等价文字。 */
-export declare function imagesOnly(content: h.Fragment): h[];
-/** 文字模式：去掉图片，把等价文字展开成普通文本。 */
-export declare function withoutImages(content: h.Fragment): h[];
-/** 发送前的统一选择：文字模式去掉图片，图文模式去掉等价文字。 */
-export declare function choosePresentation(content: h.Fragment, textOnly: boolean): h[];
-export declare function isTextOnly(ctx: Context, session: Session): boolean;
+/** 等待下一句回复。提问本身已经写明了可回复的内容与「取消」，这里不再追加说明。 */
+export declare function promptInput(session: Session): Promise<string | undefined>;
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-mcdle",
   "description": "Koishi《我的世界》猜谜：覆盖生物、物品和方块，支持群内记录与排行。",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [