koishi-plugin-cchess 2.4.1 → 2.6.0

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+# 2.6.0 · 2026-10-02
+
+修复未启用 help 插件时发送 `cchess` 会让指令无限调用自己、Koishi 收不到任何消息的问题。主指令现在自带帮助：直接列出各子指令并给出开局与落子的提示，不再依赖 help 插件；带 `-h` 时仍由 help 插件接手。
+
+# 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

@@ -1,36 +1,57 @@
 # 中国象棋
 
-Koishi 中国象棋插件，支持玩家对战、皮卡鱼引擎对战和 FEN 局面导入。
+Koishi 插件：中国象棋，支持悔棋、棋谱分享与皮卡鱼引擎对战
+
+[![GitHub](https://img.shields.io/badge/GitHub-araea%2Fkoishi--plugin--cchess-181717?logo=github&logoColor=white)](https://github.com/araea/koishi-plugin-cchess)
+[![npm](https://img.shields.io/npm/v/koishi-plugin-cchess?logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/koishi-plugin-cchess)
 
 ## 安装
 
 ```sh
-yarn add koishi-plugin-cchess
+npm i koishi-plugin-cchess
 ```
 
-在 Koishi 中启用，并安装 `database` 与 `canvas` 服务。
+启用插件，并安装 `database` 与 `canvas` 服务。
+
+## 快速使用
 
-## 指令
+发送 `cchess.开始` 入座，双方就位后自动开局；发送 `cchess.开始 人机` 直接挑战皮卡鱼。落子也可直接发送，如 `炮二平五` 或 `b2e2`。悔棋请求送出后，对方直接回复 `同意` 或 `拒绝` 即可表决。
 
 | 指令 | 说明 |
 | --- | --- |
+| `cchess` | 查看指令列表 |
 | `cchess.开始 [红/黑] [人机]` | 入座开局，或挑战皮卡鱼 |
 | `cchess.开始 <FEN>` | 导入局面；随后发送 `cchess.开始` 开局 |
-| `cchess.落子 <着法>` | 按棋谱落子，如 `炮二平五` |
+| `cchess.落子 <着法>` | 按棋谱落子，如 `炮二平五` 或 `b2e2` |
 | `cchess.悔棋 [同意/拒绝]` | 请求悔棋或表决 |
 | `cchess.认输` | 认输 |
 | `cchess.结束` | 结束当前对局 |
 | `cchess.战绩 [@某人/榜] [胜场/输场] [人数]` | 查询战绩或排行 |
 | `cchess.查看云库残局 [DTM/DTC]` | 查询云库残局统计 |
 
-发送 `cchess.开始` 入座，双方就位后自动开局。发送 `cchess.开始 人机` 可直接挑战引擎。落子也可直接发送，如 `炮二平五` 或 `b2e2`。悔棋请求后，对手可直接回复 `同意` 或 `拒绝`。
+## 配置
+
+| 配置项 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `boardSkin` | string | `象甲2023棋盘` | 棋盘皮肤 |
+| `pieceSkin` | string | `象甲棋子` | 棋子皮肤 |
+| `allowFreePieceMovementInHumanMachineMode` | boolean | `false` | 人机模式下允许所有人自由移动棋子 |
+| `enableDirectInput` | boolean | `true` | 对局中直接发送棋谱或「同意」「拒绝」即可应答 |
+| `defaultEngineThinkingDepth` | number | `10` | 引擎思考深度，范围 0–100；越高棋力越强、耗时越长 |
+| `defaultMaxLeaderboardEntries` | number | `4` | 排行榜默认显示的人数 |
+| `retractDelay` | number | `0` | 自动撤回延迟（秒），0 表示不撤回 |
+| `imgScale` | number | `1` | 图片分辨率倍率，最小 1 |
+| `imageType` | `png` / `jpeg` / `webp` | `png` | 发送的图片格式 |
+| `isChessImageWithOutlineEnabled` | boolean | `true` | 给棋盘图片加坐标外框；关闭后出图更快 |
+| `disableImages` | boolean | `false` | 全部改用文本，不发送棋盘图片 |
 
-## 许可证
+## 限制 / 风险
 
-可按 [Apache-2.0](LICENSE-APACHE) 或 [MIT](LICENSE-MIT) 使用。
+必须安装 `database` 与 `canvas` 服务才能运行。
 
-## 显示与交互
+引擎思考深度过高会显著增加响应耗时；Node.js 不支持 SIMD，不建议设置过大。
 
-发送 `cchess.显示 文字` 或 `cchess.显示 图文` 切换个人显示偏好。同一机器人中的配套插件共享选择，重启后恢复图文。图文模式中的信息图片附带文字说明；作品素材与感官测试的适用边界见 [设计系统](./DESIGN_SYSTEM.md)。
+## 链接
 
-本次更新：每次棋盘输出附带完整棋子坐标与轮次；个人文字模式；裸输入冲突保护。
+- [设计系统](DESIGN_SYSTEM.md)
+- [MIT](LICENSE-MIT) / [Apache-2.0](LICENSE-APACHE)

package/lib/help.d.ts

@@ -0,0 +1,14 @@
+import { Session } from 'koishi';
+export interface HelpEntry {
+    name: string;
+    description: string;
+}
+/**
+ * 主指令帮助的内容：从已注册的指令树现取标题与直接子指令，不依赖 help 插件，也不会和指令脱节。
+ * `order` 列出希望靠前的子指令（完整指令名），没列到的按注册顺序排在后面；排版交给各插件。
+ * 不要在动作里 `session.execute('… -h')` 转发：`-h` 由 help 插件提供，缺它指令会无限调用自己。
+ */
+export declare function helpOf(session: Session, name: string, order?: string[]): {
+    title: string;
+    entries: HelpEntry[];
+};

package/lib/index.d.ts

@@ -1,6 +1,6 @@
 import { Context, Schema } from 'koishi';
 export declare const name = "cchess";
-export declare const usage = "## \u4F7F\u7528\n\n`cchess.\u5F00\u59CB` \u5373\u53EF\u5165\u5EA7\uFF0C\u53CC\u65B9\u5C31\u4F4D\u540E\u81EA\u52A8\u5F00\u5C40\uFF1B`cchess.\u5F00\u59CB \u4EBA\u673A` \u76F4\u63A5\u6311\u6218\u76AE\u5361\u9C7C\u3002\u7740\u6CD5\u53EF\u76F4\u63A5\u53D1\u9001\uFF0C\u4F8B\u5982 `\u70AE\u4E8C\u5E73\u4E94` \u6216 `b2e2`\uFF0C\u4E5F\u53EF\u4EE5\u5199\u6210 `cchess.\u843D\u5B50 \u70AE\u4E8C\u5E73\u4E94`\u3002\n\n\u6094\u68CB\u8BF7\u6C42\u9001\u51FA\u540E\uFF0C\u5BF9\u65B9\u65E0\u9700\u5E26\u6307\u4EE4\u524D\u7F00\uFF0C\u76F4\u63A5\u56DE\u590D `\u540C\u610F` \u6216 `\u62D2\u7EDD` \u5373\u53EF\u8868\u51B3\uFF1B\u8BF7\u6C42\u65B9\u53D1\u9001 `cchess.\u6094\u68CB \u62D2\u7EDD` \u53EF\u64A4\u4E0B\u8BF7\u6C42\u3002\n\n## \u6307\u4EE4\n\n| \u6307\u4EE4 | \u8BF4\u660E |\n| --- | --- |\n| `cchess.\u5F00\u59CB [\u7EA2/\u9ED1] [\u4EBA\u673A]` | \u5165\u5EA7\u5F00\u5C40\uFF0C\u6216\u76F4\u63A5\u6311\u6218\u76AE\u5361\u9C7C |\n| `cchess.\u5F00\u59CB <FEN>` | \u6446\u8C31\uFF0C\u5BFC\u5165\u5C40\u9762\u540E\u518D `cchess.\u5F00\u59CB` \u5373\u53EF |\n| `cchess.\u843D\u5B50 <\u7740\u6CD5>` | \u6309\u68CB\u8C31\u843D\u5B50\uFF0C\u5982 `\u70AE\u4E8C\u5E73\u4E94` |\n| `cchess.\u6094\u68CB [\u540C\u610F/\u62D2\u7EDD]` | \u8BF7\u6C42\u6094\u68CB\uFF0C\u4E5F\u53EF\u76F4\u63A5\u56DE\u590D\u540C\u610F\u6216\u62D2\u7EDD\u8868\u51B3 |\n| `cchess.\u8BA4\u8F93` | \u8BA4\u8F93\u5E76\u7ED3\u675F\u5BF9\u5C40 |\n| `cchess.\u7ED3\u675F` | \u7ED3\u675F\u6B63\u5728\u8FDB\u884C\u7684\u4E00\u5C40 |\n| `cchess.\u6218\u7EE9 [@\u67D0\u4EBA/\u699C] [\u80DC\u573A/\u8F93\u573A] [\u4EBA\u6570]` | \u67E5\u8BE2\u6218\u7EE9\u6216\u6392\u884C\u699C |\n| `cchess.\u67E5\u770B\u4E91\u5E93\u6B8B\u5C40 [DTM/DTC]` | \u67E5\u8BE2\u4E91\u5E93\u6B8B\u5C40\u7EDF\u8BA1 |";
+export declare const usage = "## \u4F7F\u7528\n\n\u53D1\u9001 `cchess.\u5F00\u59CB` \u5165\u5EA7\uFF0C\u53CC\u65B9\u5C31\u4F4D\u540E\u81EA\u52A8\u5F00\u5C40\uFF1B\u53D1\u9001 `cchess.\u5F00\u59CB \u4EBA\u673A` \u53EF\u76F4\u63A5\u6311\u6218\u5F15\u64CE\u3002\u843D\u5B50\u4E5F\u53EF\u76F4\u63A5\u53D1\u9001\uFF0C\u5982 `\u70AE\u4E8C\u5E73\u4E94` \u6216 `b2e2`\u3002\n\n\u6094\u68CB\u8BF7\u6C42\u9001\u51FA\u540E\uFF0C\u5BF9\u65B9\u65E0\u9700\u5E26\u6307\u4EE4\u524D\u7F00\uFF0C\u76F4\u63A5\u56DE\u590D `\u540C\u610F` \u6216 `\u62D2\u7EDD` \u5373\u53EF\u8868\u51B3\uFF1B\u8BF7\u6C42\u65B9\u53D1\u9001 `cchess.\u6094\u68CB \u62D2\u7EDD` \u53EF\u64A4\u4E0B\u8BF7\u6C42\u3002\n\n## \u6307\u4EE4\n\n| \u6307\u4EE4 | \u8BF4\u660E |\n| --- | --- |\n| `cchess` | \u67E5\u770B\u6307\u4EE4\u5217\u8868 |\n| `cchess.\u5F00\u59CB [\u7EA2/\u9ED1] [\u4EBA\u673A]` | \u5165\u5EA7\u5F00\u5C40\uFF0C\u6216\u76F4\u63A5\u6311\u6218\u76AE\u5361\u9C7C |\n| `cchess.\u5F00\u59CB <FEN>` | \u5BFC\u5165\u5C40\u9762\uFF1B\u968F\u540E\u53D1\u9001 `cchess.\u5F00\u59CB` \u5F00\u5C40 |\n| `cchess.\u843D\u5B50 <\u7740\u6CD5>` | \u6309\u68CB\u8C31\u843D\u5B50\uFF0C\u5982 `\u70AE\u4E8C\u5E73\u4E94` |\n| `cchess.\u6094\u68CB [\u540C\u610F/\u62D2\u7EDD]` | \u8BF7\u6C42\u6094\u68CB\u6216\u8868\u51B3 |\n| `cchess.\u8BA4\u8F93` | \u8BA4\u8F93 |\n| `cchess.\u7ED3\u675F` | \u7ED3\u675F\u5F53\u524D\u5BF9\u5C40 |\n| `cchess.\u6218\u7EE9 [@\u67D0\u4EBA/\u699C] [\u80DC\u573A/\u8F93\u573A] [\u4EBA\u6570]` | \u67E5\u8BE2\u6218\u7EE9\u6216\u6392\u884C |\n| `cchess.\u67E5\u770B\u4E91\u5E93\u6B8B\u5C40 [DTM/DTC]` | \u67E5\u8BE2\u4E91\u5E93\u6B8B\u5C40\u7EDF\u8BA1 |";
 export declare const inject: string[];
 export interface Config {
     boardSkin: string;

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,24 @@ 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);
+
+// src/help.ts
+function helpOf(session, name2, order = []) {
+  const describe = /* @__PURE__ */ __name((command) => session.text([`commands.${command}.description`, ""]), "describe");
+  const rank = /* @__PURE__ */ __name((command) => {
+    const i = order.indexOf(command);
+    return i < 0 ? order.length : i;
+  }, "rank");
+  const entries = [];
+  for (const child of session.app.$commander.get(name2)?.children ?? []) {
+    const { hidden } = child.config;
+    if (!child.match(session) || session.resolve(hidden)) continue;
+    entries.push({ name: child.name, description: describe(child.name) });
+  }
+  entries.sort((a, b) => rank(a.name) - rank(b.name));
+  return { title: describe(name2), entries };
 }
-__name(choosePresentation, "choosePresentation");
+__name(helpOf, "helpOf");
 
 // src/index.ts
 var import_koishi2 = require("koishi");
@@ -5226,7 +5189,7 @@ var fs = __toESM(require("fs"));
 var name = "cchess";
 var usage = `## 使用
 
-\`cchess.开始\` 即可入座，双方就位后自动开局；\`cchess.开始 人机\` 直接挑战皮卡鱼。着法可直接发送，例如 \`炮二平五\` 或 \`b2e2\`，也可以写成 \`cchess.落子 炮二平五\`。
+发送 \`cchess.开始\` 入座，双方就位后自动开局；发送 \`cchess.开始 人机\` 可直接挑战引擎。落子也可直接发送，如 \`炮二平五\` 或 \`b2e2\`。
 
 悔棋请求送出后，对方无需带指令前缀，直接回复 \`同意\` 或 \`拒绝\` 即可表决；请求方发送 \`cchess.悔棋 拒绝\` 可撤下请求。
 
@@ -5234,13 +5197,14 @@ var usage = `## 使用
 
 | 指令 | 说明 |
 | --- | --- |
+| \`cchess\` | 查看指令列表 |
 | \`cchess.开始 [红/黑] [人机]\` | 入座开局，或直接挑战皮卡鱼 |
-| \`cchess.开始 <FEN>\` | 摆谱，导入局面后再 \`cchess.开始\` 即可 |
+| \`cchess.开始 <FEN>\` | 导入局面；随后发送 \`cchess.开始\` 开局 |
 | \`cchess.落子 <着法>\` | 按棋谱落子，如 \`炮二平五\` |
-| \`cchess.悔棋 [同意/拒绝]\` | 请求悔棋，也可直接回复同意或拒绝表决 |
-| \`cchess.认输\` | 认输并结束对局 |
-| \`cchess.结束\` | 结束正在进行的一局 |
-| \`cchess.战绩 [@某人/榜] [胜场/输场] [人数]\` | 查询战绩或排行榜 |
+| \`cchess.悔棋 [同意/拒绝]\` | 请求悔棋或表决 |
+| \`cchess.认输\` | 认输 |
+| \`cchess.结束\` | 结束当前对局 |
+| \`cchess.战绩 [@某人/榜] [胜场/输场] [人数]\` | 查询战绩或排行 |
 | \`cchess.查看云库残局 [DTM/DTC]\` | 查询云库残局统计 |`;
 var inject = ["database", "canvas"];
 var pieceSkins = ["棋弈无限图形棋子", "云库木制棋子", "刘炳森红黑牛角隶书棋子", "木制棋子", "本纹隶书棋子", "银灰将军体棋子", "棋弈无限红绿正棋子", "棋弈无限红绿棋子", "棋天大圣棋子", "棋者象棋棋子", "楷书玉石棋子", "水墨青瓷棋子", "牛皮纸华康金文棋子", "皮卡鱼棋子", "红蓝祥隶棋子", "红黑精典无阴影棋子", "红黑精典棋子", "行书玉石棋子", "象甲棋子", "金属棋子篆体棋子", "镌刻华彩棋子", "鹏飞红黑棋子", "鹏飞经典棋子", "鹏飞绿龙棋子", "龙腾四海棋子"];
@@ -5284,7 +5248,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 = {};
@@ -5461,7 +5424,13 @@ function apply(ctx, config) {
     await handleMove(session, moveOperation);
   });
   ctx.command("cchess", "中国象棋 · 楚河汉界").action(async ({ session }) => {
-    await session.execute(`cchess -h`);
+    const { title, entries } = helpOf(session, "cchess", ["开始", "落子", "悔棋", "认输", "结束", "战绩", "查看云库残局"].map((name2) => `cchess.${name2}`));
+    return await sendMessage(session, panel({
+      icon: "📋",
+      title,
+      body: entries.map(({ name: name2, description }) => field(name2, description)),
+      tips: ["发送「cchess.开始」入座，「cchess.落子 炮二平五」落子"]
+    }));
   });
   ctx.command("cchess.开始 [args:text]", "入座开局，或挑战皮卡鱼").usage("可选阵营「红」「黑」；参数含「人机」即与皮卡鱼对战，不带则入座等待对手；直接粘贴 FEN 串则按摆谱处理。").example("cchess.开始 红 人机").action(async ({ session }, args) => {
     const { username, channelId } = session;
@@ -6004,7 +5973,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 +7261,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",
+  "description": "Koishi 插件：中国象棋，支持悔棋、棋谱分享与皮卡鱼引擎对战。",
+  "version": "2.6.0",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [