koishi-plugin-cchess 2.4.1 → 2.5.0

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+# 2.5.0 · 2026-09-26
+
+主指令在 help 列表里补回描述；去掉「.显示」显示模式指令，有图只发图、出图失败才退回文字；多轮输入不再追加计时说明。
+
 # 2.4.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

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

package/lib/index.js

@@ -43,28 +43,9 @@ 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);
-    }
-  };
-}
-__name(usePresentation, "usePresentation");
 function registerDirectInput(ctx, name2, matches) {
   const owner = { name: name2, matches };
   state(ctx).owners.add(owner);
@@ -87,42 +68,6 @@ async function directInputConflict(ctx, session) {
   return true;
 }
 __name(directInputConflict, "directInputConflict");
-var IMAGE_TEXT_TYPE = "ux-image-text";
-function imageText(text) {
-  return (0, import_koishi.h)(IMAGE_TEXT_TYPE, {}, import_koishi.h.normalize(text));
-}
-__name(imageText, "imageText");
-function isImage(element) {
-  return element.type === "img" || element.type === "image";
-}
-__name(isImage, "isImage");
-function isImageText(element) {
-  return element.type === IMAGE_TEXT_TYPE;
-}
-__name(isImageText, "isImageText");
-function imagesOnly(content) {
-  const walk = /* @__PURE__ */ __name((elements) => elements.flatMap((element) => {
-    if (isImageText(element)) return [];
-    if (isImage(element) || !element.children.length) return [element];
-    return [(0, import_koishi.h)(element.type, element.attrs, walk(element.children))];
-  }), "walk");
-  return walk(import_koishi.h.normalize(content));
-}
-__name(imagesOnly, "imagesOnly");
-function withoutImages(content) {
-  const walk = /* @__PURE__ */ __name((elements) => elements.flatMap((element) => {
-    if (isImage(element)) return [];
-    if (isImageText(element)) return walk(element.children);
-    if (element.children.length) return [(0, import_koishi.h)(element.type, element.attrs, walk(element.children))];
-    return [element];
-  }), "walk");
-  return walk(import_koishi.h.normalize(content));
-}
-__name(withoutImages, "withoutImages");
-function choosePresentation(content, textOnly) {
-  return textOnly ? withoutImages(content) : imagesOnly(content);
-}
-__name(choosePresentation, "choosePresentation");
 
 // src/index.ts
 var import_koishi2 = require("koishi");
@@ -5284,7 +5229,6 @@ function panel(options) {
 }
 __name(panel, "panel");
 function apply(ctx, config) {
-  const presentation = usePresentation(ctx, "cchess");
   const logger = ctx.logger("cchess");
   const engines = {};
   const enginePromises = {};
@@ -6004,7 +5948,7 @@ function apply(ctx, config) {
 ${pieces.join("；")}`;
     if (config.disableImages) return text;
     try {
-      return import_koishi2.h.image(await drawChessBoard(channelId), imageMimeType).toString() + imageText(import_koishi2.h.text(text)).toString();
+      return import_koishi2.h.image(await drawChessBoard(channelId), imageMimeType).toString();
     } catch (error) {
       logger.warn("棋盘图片生成失败：%s", error.message);
       return text;
@@ -7292,8 +7236,8 @@ ${pieces.join("；")}`;
   const sentMessages = {};
   async function sendMessage(session, message) {
     const { bot, channelId } = session;
-    const [messageId] = await session.send(choosePresentation(message, presentation.textOnly(session)));
-    if (presentation.textOnly(session) || config.retractDelay === 0 || !messageId) return;
+    const [messageId] = await session.send(message);
+    if (config.retractDelay === 0 || !messageId) return;
     const previousMessageId = sentMessages[channelId];
     sentMessages[channelId] = messageId;
     if (!previousMessageId) return;

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-cchess",
   "description": "Koishi 中国象棋：支持玩家对战、皮卡鱼引擎和 FEN 局面导入。",
-  "version": "2.4.1",
+  "version": "2.5.0",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [