koishi-plugin-cchess 1.0.8 → 1.1.0

package/README.md

@@ -0,0 +1,37 @@
+# koishi-plugin-cchess
+
+中国象棋，支持人人对战与皮卡鱼人机对战
+
+## 安装
+
+```sh
+yarn add koishi-plugin-cchess
+```
+
+在 Koishi 配置中启用，并提供 database、puppeteer 与 canvas 服务。
+
+## 指令
+
+| 指令 | 说明 |
+| --- | --- |
+| `cchess.加入 [红/黑]` | 入座 |
+| `cchess.退出` | 开局前离席 |
+| `cchess.开始 [人人/人机]` | 开局，默认人人对战 |
+| `cchess.移动 <着法>` | 落子 |
+| `cchess.悔棋` | 请求悔棋 |
+| `cchess.悔棋 <同意/拒绝>` | 表决悔棋 |
+| `cchess.认输` | 认输 |
+| `cchess.结束` | 强制结束棋局 |
+| `cchess.编辑棋盘 <FEN>` | 导入局面 |
+| `cchess.编辑棋盘.导出` | 导出局面 |
+| `cchess.查看云库残局 [DTM/DTC]` | 云库残局统计 |
+| `cchess.排行榜 [胜场/输场] [人数]` | 排行榜 |
+| `cchess.查询玩家记录 [@某人]` | 战绩 |
+
+着法可直接发送，例如 `炮二平五` 或 `b2e2`。
+
+悔棋请求送出后，对方直接回复 `同意` 或 `拒绝` 即可表决，不必带指令前缀。
+
+## 许可证
+
+可按 [Apache-2.0](LICENSE-APACHE) 或 [MIT](LICENSE-MIT) 使用。

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.\u52A0\u5165` \u5165\u5EA7\uFF0C`cchess.\u5F00\u59CB.\u4EBA\u4EBA\u5BF9\u6218` \u6216 `cchess.\u5F00\u59CB.\u4EBA\u673A\u5BF9\u6218` \u5F00\u5C40\u3002\u7740\u6CD5\u53EF\u76F4\u63A5\u53D1\u9001\uFF0C\u5982\u70AE\u4E8C\u5E73\u4E94\u6216 `b2e2`\u3002\n\n## \u6307\u4EE4\n\n| \u6307\u4EE4 | \u8BF4\u660E |\n| --- | --- |\n| `cchess.\u52A0\u5165 [\u7EA2/\u9ED1]` | \u5165\u5EA7 |\n| `cchess.\u9000\u51FA` | \u5F00\u5C40\u524D\u79BB\u5E2D |\n| `cchess.\u5F00\u59CB.\u4EBA\u4EBA\u5BF9\u6218` | \u4EBA\u4EBA\u5BF9\u6218 |\n| `cchess.\u5F00\u59CB.\u4EBA\u673A\u5BF9\u6218` | \u4EBA\u673A\u5BF9\u6218\uFF08\u76AE\u5361\u9C7C\uFF09 |\n| `cchess.\u79FB\u52A8 <\u7740\u6CD5>` | \u843D\u5B50 |\n| `cchess.\u6094\u68CB.\u8BF7\u6C42` | \u6094\u68CB |\n| `cchess.\u8BA4\u8F93` | \u8BA4\u8F93 |\n| `cchess.\u7ED3\u675F` | \u5F3A\u5236\u6E05\u76D8 |\n| `cchess.\u7F16\u8F91\u68CB\u76D8.\u5BFC\u5165 <FEN>` | \u5BFC\u5165\u5C40\u9762 |\n| `cchess.\u7F16\u8F91\u68CB\u76D8.\u5BFC\u51FA` | \u5BFC\u51FA\u5C40\u9762 |\n| `cchess.\u6392\u884C\u699C.\u603B\u80DC\u573A [\u4EBA\u6570]` | \u80DC\u573A\u699C |\n| `cchess.\u67E5\u8BE2\u73A9\u5BB6\u8BB0\u5F55 [@\u67D0\u4EBA]` | \u67E5\u770B\u6218\u7EE9 |";
+export declare const usage = "## \u4F7F\u7528\n\n`cchess.\u52A0\u5165` \u5165\u5EA7\uFF0C`cchess.\u5F00\u59CB \u4EBA\u4EBA` \u6216 `cchess.\u5F00\u59CB \u4EBA\u673A` \u5F00\u5C40\u3002\u7740\u6CD5\u53EF\u76F4\u63A5\u53D1\u9001\uFF0C\u4F8B\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\u3002\n\n## \u6307\u4EE4\n\n| \u6307\u4EE4 | \u8BF4\u660E |\n| --- | --- |\n| `cchess.\u52A0\u5165 [\u7EA2/\u9ED1]` | \u5165\u5EA7 |\n| `cchess.\u9000\u51FA` | \u5F00\u5C40\u524D\u79BB\u5E2D |\n| `cchess.\u5F00\u59CB [\u4EBA\u4EBA/\u4EBA\u673A]` | \u5F00\u5C40\uFF0C\u9ED8\u8BA4\u4EBA\u4EBA\u5BF9\u6218 |\n| `cchess.\u79FB\u52A8 <\u7740\u6CD5>` | \u843D\u5B50 |\n| `cchess.\u6094\u68CB` | \u8BF7\u6C42\u6094\u68CB |\n| `cchess.\u6094\u68CB <\u540C\u610F/\u62D2\u7EDD>` | \u8868\u51B3\u6094\u68CB\uFF0C\u4E5F\u53EF\u76F4\u63A5\u56DE\u590D\u540C\u610F\u6216\u62D2\u7EDD |\n| `cchess.\u8BA4\u8F93` | \u8BA4\u8F93 |\n| `cchess.\u7ED3\u675F` | \u5F3A\u5236\u7ED3\u675F\u68CB\u5C40 |\n| `cchess.\u7F16\u8F91\u68CB\u76D8 <FEN>` | \u5BFC\u5165\u5C40\u9762\uFF0C\u4E0D\u5E26\u53C2\u6570\u65F6\u67E5\u770B FEN \u7528\u6CD5 |\n| `cchess.\u7F16\u8F91\u68CB\u76D8.\u5BFC\u51FA` | \u5BFC\u51FA\u5C40\u9762 |\n| `cchess.\u67E5\u770B\u4E91\u5E93\u6B8B\u5C40 [DTM/DTC]` | \u4E91\u5E93\u6B8B\u5C40\u7EDF\u8BA1 |\n| `cchess.\u6392\u884C\u699C [\u80DC\u573A/\u8F93\u573A] [\u4EBA\u6570]` | \u6392\u884C\u699C |\n| `cchess.\u67E5\u8BE2\u73A9\u5BB6\u8BB0\u5F55 [@\u67D0\u4EBA]` | \u6218\u7EE9 |";
 export declare const inject: string[];
 export interface Config {
     boardSkin: string;

package/lib/index.js

@@ -28,22 +28,24 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 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,
   inject: () => inject,
   name: () => name,
   usage: () => usage
 });
-module.exports = __toCommonJS(index_exports);
+module.exports = __toCommonJS(src_exports);
 var import_koishi = require("koishi");
 var path = __toESM(require("path"));
 var fs = __toESM(require("fs"));
 var name = "cchess";
 var usage = `## 使用
 
-\`cchess.加入\` 入座，\`cchess.开始.人人对战\` 或 \`cchess.开始.人机对战\` 开局。着法可直接发送，如炮二平五或 \`b2e2\`。
+\`cchess.加入\` 入座，\`cchess.开始 人人\` 或 \`cchess.开始 人机\` 开局。着法可直接发送，例如 \`炮二平五\` 或 \`b2e2\`。
+
+悔棋请求送出后，对方无需带指令前缀，直接回复 \`同意\` 或 \`拒绝\` 即可表决。
 
 ## 指令
 
@@ -51,16 +53,17 @@ var usage = `## 使用
 | --- | --- |
 | \`cchess.加入 [红/黑]\` | 入座 |
 | \`cchess.退出\` | 开局前离席 |
-| \`cchess.开始.人人对战\` | 人人对战 |
-| \`cchess.开始.人机对战\` | 人机对战（皮卡鱼） |
+| \`cchess.开始 [人人/人机]\` | 开局，默认人人对战 |
 | \`cchess.移动 <着法>\` | 落子 |
-| \`cchess.悔棋.请求\` | 悔棋 |
+| \`cchess.悔棋\` | 请求悔棋 |
+| \`cchess.悔棋 <同意/拒绝>\` | 表决悔棋，也可直接回复同意或拒绝 |
 | \`cchess.认输\` | 认输 |
-| \`cchess.结束\` | 强制清盘 |
-| \`cchess.编辑棋盘.导入 <FEN>\` | 导入局面 |
+| \`cchess.结束\` | 强制结束棋局 |
+| \`cchess.编辑棋盘 <FEN>\` | 导入局面，不带参数时查看 FEN 用法 |
 | \`cchess.编辑棋盘.导出\` | 导出局面 |
-| \`cchess.排行榜.总胜场 [人数]\` | 胜场榜 |
-| \`cchess.查询玩家记录 [@某人]\` | 查看战绩 |`;
+| \`cchess.查看云库残局 [DTM/DTC]\` | 云库残局统计 |
+| \`cchess.排行榜 [胜场/输场] [人数]\` | 排行榜 |
+| \`cchess.查询玩家记录 [@某人]\` | 战绩 |`;
 var inject = ["database", "puppeteer", "canvas"];
 var pieceSkins = ["棋弈无限图形棋子", "云库木制棋子", "刘炳森红黑牛角隶书棋子", "木制棋子", "本纹隶书棋子", "银灰将军体棋子", "棋弈无限红绿正棋子", "棋弈无限红绿棋子", "棋天大圣棋子", "棋者象棋棋子", "楷书玉石棋子", "水墨青瓷棋子", "牛皮纸华康金文棋子", "皮卡鱼棋子", "红蓝祥隶棋子", "红黑精典无阴影棋子", "红黑精典棋子", "行书玉石棋子", "象甲棋子", "金属棋子篆体棋子", "镌刻华彩棋子", "鹏飞红黑棋子", "鹏飞经典棋子", "鹏飞绿龙棋子", "龙腾四海棋子"];
 var boardSkins = ["棋弈无限红绿棋盘", "一鸣惊人棋盘", "三星堆棋盘", "云库木制棋盘", "云心鹤眼棋盘", "兰亭集序无字棋盘", "兰亭集序棋盘", "凤舞九天棋盘", "卯兔添福棋盘", "叱咤风云棋盘", "君临天下棋盘", "壁画古梦棋盘", "大闹天宫棋盘", "天山共色棋盘", "女神之约棋盘", "小吕飞刀棋盘", "山海绘卷棋盘", "护眼绿棋盘", "星河璀璨棋盘", "木制棋盘", "本纹隶书白棋盘", "本纹隶书黑棋盘", "桃花源记棋盘", "棋天大圣棋盘", "棋天无大圣棋盘", "武侠江湖棋盘", "水墨青瓷棋盘", "清悠茶道棋盘", "游园惊梦棋盘", "牛转乾坤棋盘", "玉石太极棋盘", "皓月无痕棋盘", "皮卡鱼棋盘", "盲棋神迹棋盘", "空城计棋盘", "竹波烟雨棋盘", "经典木棋盘棋盘", "绿色棋盘", "象甲2023棋盘", "象甲征程棋盘", "象甲重燃棋盘", "金牛降世棋盘", "金虎贺岁棋盘", "金虎贺岁（王天一签名版）棋盘", "鎏金岁月棋盘", "霸王别姬棋盘", "鸿门宴棋盘", "鹏飞红黑棋盘", "鹏飞经典棋盘", "鹏飞绿龙棋盘", "龙腾天坛棋盘"];
@@ -198,6 +201,26 @@ function apply(ctx, config) {
     primary: "id",
     autoInc: true
   });
+  const REGRET_AGREE = /^(同意|可以|行吧|没问题|同意悔棋|ok|yes)$/i;
+  const REGRET_REJECT = /^(拒绝|不行|不同意|不许|拒绝悔棋|no)$/i;
+  function matchRegretDecision(content) {
+    const text = content.trim().replace(/[。．.!！?？~～,，、;；]+$/, "");
+    if (REGRET_AGREE.test(text)) return "agree";
+    if (REGRET_REJECT.test(text)) return "reject";
+    return null;
+  }
+  __name(matchRegretDecision, "matchRegretDecision");
+  ctx.middleware(async (session, next) => {
+    const { channelId, content, userId } = session;
+    if (!channelId || !content) return next();
+    const decision = matchRegretDecision(content);
+    if (!decision) return next();
+    const [gameRecord] = await ctx.database.get("cchess_game_records", { channelId });
+    if (!gameRecord?.isStarted || !gameRecord.isRegretRequest) return next();
+    const [playerRecord] = await ctx.database.get("cchess_gaming_player_records", { channelId, userId });
+    if (playerRecord?.side !== convertTurnToString(gameRecord.turn)) return next();
+    await resolveRegret(session, decision === "agree");
+  });
   ctx.middleware(async (session, next) => {
     const { channelId, content, userId, username } = session;
     if (!channelId || !content) return next();
@@ -257,7 +280,7 @@ function apply(ctx, config) {
         title: "入座成功",
         at: username,
         body: [field("阵营", withSideIcon(choice)), field("当前人数", `${playersNum + 1} 人`)],
-        tips: ["再次发送「cchess.加入 红 / 黑」即可换边", "人齐后发送「cchess.开始.人人对战」开局"]
+        tips: ["再次发送「cchess.加入 红 / 黑」即可换边", "人齐后发送「cchess.开始 人人」开局"]
       }));
     } else {
       await ctx.database.set("cchess_gaming_player_records", { channelId, userId }, { side: choice });
@@ -297,19 +320,19 @@ function apply(ctx, config) {
       }));
     }
   });
-  ctx.command("cchess.开始", "开始游戏指令帮助").action(async ({ session }) => {
-    await session.execute(`cchess.开始 -h`);
-  });
-  ctx.command("cchess.开始.人人对战", "开始人人对战").action(async ({ session }) => {
+  ctx.command("cchess.开始 [mode:string]", "开始对局，mode 可选「人人」或「人机」").action(async ({ session }, mode) => {
     const { username, userId, channelId } = session;
     await updateNameInPlayerRecord(userId, username);
     const gameRecord = await getGameRecord(channelId);
     if (gameRecord.isStarted) {
       return await sendMessage(session, alreadyStartedPanel(username));
     }
-    void checkEngine(channelId);
     const playerRecords = await ctx.database.get("cchess_gaming_player_records", { channelId });
     const playersNum = playerRecords.length;
+    if (/机|电脑|ai|engine|pve/i.test(mode ?? "")) {
+      return await startVersusEngine(session, gameRecord, playerRecords);
+    }
+    void checkEngine(channelId);
     let redPlayers = playerRecords.filter((player) => player.side === "红方");
     let blackPlayers = playerRecords.filter((player) => player.side === "黑方");
     let assignNotice = "";
@@ -352,62 +375,6 @@ function apply(ctx, config) {
       image: await renderBoard(channelId)
     }));
   });
-  ctx.command("cchess.开始.人机对战", "开始人机对战").action(async ({ session }) => {
-    const { username, userId, channelId } = session;
-    await updateNameInPlayerRecord(userId, username);
-    const gameRecord = await getGameRecord(channelId);
-    if (gameRecord.isStarted) {
-      return await sendMessage(session, alreadyStartedPanel(username));
-    }
-    const playerRecords = await ctx.database.get("cchess_gaming_player_records", { channelId });
-    const playersNum = playerRecords.length;
-    const redPlayers = playerRecords.filter((player) => player.side === "红方");
-    const blackPlayers = playerRecords.filter((player) => player.side === "黑方");
-    if (playersNum < 1 && !config.allowFreePieceMovementInHumanMachineMode) {
-      return await sendMessage(session, panel({
-        icon: "⚠️",
-        title: "尚无棋手入座",
-        at: username,
-        body: ["人机对战至少需要 1 位棋手。"],
-        tips: ["发送「cchess.加入」即可入座挑战皮卡鱼"]
-      }));
-    }
-    if (!await checkEngine(channelId)) {
-      return await sendMessage(session, engineUnavailablePanel(username));
-    }
-    let humanSide;
-    if (playersNum === 1) {
-      humanSide = playerRecords[0].side === "红方" ? "红方" : "黑方";
-    } else if (redPlayers.length !== blackPlayers.length) {
-      humanSide = redPlayers.length > blackPlayers.length ? "红方" : "黑方";
-    } else {
-      humanSide = Math.random() < 0.5 ? "红方" : "黑方";
-    }
-    const engineSide = humanSide === "红方" ? "黑方" : "红方";
-    for (const player of playerRecords) {
-      if (player.side === humanSide) continue;
-      await ctx.database.set("cchess_gaming_player_records", { channelId, userId: player.userId }, { side: humanSide });
-    }
-    await ctx.database.set("cchess_game_records", { channelId }, {
-      isStarted: true,
-      isEnginePlayRed: engineSide === "红方",
-      isEnginePlayBlack: engineSide === "黑方"
-    });
-    const sideString = convertTurnToString(gameRecord.turn);
-    if (engineSide === sideString) await requestEngineMove(channelId);
-    return await sendMessage(session, panel({
-      icon: "✅",
-      title: "人机对局开始",
-      body: [
-        field("棋　手", withSideIcon(humanSide)),
-        field("皮卡鱼", withSideIcon(engineSide)),
-        field("先　手", withSideIcon(sideString)),
-        field("思考深度", `${thinkingDepth} 层`)
-      ],
-      tips: ["直接发送着法即可落子，如「炮二平五」或「b2e2」"],
-      image: await renderBoard(channelId)
-    }));
-  });
   ctx.command("cchess.结束", "强制结束游戏").action(async ({ session }) => {
     const { username, userId, channelId } = session;
     await updateNameInPlayerRecord(userId, username);
@@ -457,7 +424,7 @@ function apply(ctx, config) {
           title: "悔棋请求待决",
           at: username,
           body: ["对方的悔棋请求尚未答复，棋局暂歇。"],
-          tips: ["发送「cchess.悔棋.同意」或「cchess.悔棋.拒绝」"]
+          tips: ["对方回复「同意」或「拒绝」即可表决"]
         }));
       }
       const turn = gameRecord.turn;
@@ -553,12 +520,20 @@ function apply(ctx, config) {
       busyChannels.delete(channelId);
     }
   });
-  ctx.command("cchess.悔棋", "悔棋指令帮助").action(async ({ session }) => {
-    await session.execute(`cchess.悔棋 -h`);
-  });
-  ctx.command("cchess.悔棋.请求", "请求悔棋").action(async ({ session }) => {
+  ctx.command("cchess.悔棋 [decision:string]", "请求悔棋；待决时由对方以「同意 / 拒绝」表决").action(async ({ session }, decision) => {
     const { username, userId, channelId } = session;
     await updateNameInPlayerRecord(userId, username);
+    if (decision) {
+      const choice = matchRegretDecision(decision);
+      if (choice) return await resolveRegret(session, choice === "agree");
+      return await sendMessage(session, panel({
+        icon: "⚠️",
+        title: "表决无效",
+        at: username,
+        body: ["悔棋表决只有同意与拒绝两种。"],
+        tips: ["「cchess.悔棋 同意」或「cchess.悔棋 拒绝」"]
+      }));
+    }
     const gameRecord = await getGameRecord(channelId);
     if (!gameRecord.isStarted) {
       return await sendMessage(session, notStartedPanel(username));
@@ -571,7 +546,8 @@ function apply(ctx, config) {
         icon: "⏳",
         title: "已有悔棋请求",
         at: username,
-        body: ["正在等待对方答复，请勿重复请求。"]
+        body: ["正在等待对方答复，请勿重复请求。"],
+        tips: ["对方回复「同意」或「拒绝」即可表决"]
       }));
     }
     const playerRecord = await ctx.database.get("cchess_gaming_player_records", { channelId, userId });
@@ -613,35 +589,7 @@ function apply(ctx, config) {
       title: "悔棋请求已送出",
       at: username,
       body: [field("等待答复", withSideIcon(sideString))],
-      tips: ["对方可发送「cchess.悔棋.同意」或「cchess.悔棋.拒绝」"]
-    }));
-  });
-  ctx.command("cchess.悔棋.同意", "同意悔棋").action(async ({ session }) => {
-    const { username, channelId } = session;
-    const decision = await checkRegretDecision(session, "同意");
-    if (typeof decision === "string") return await sendMessage(session, decision);
-    await undoMove(channelId);
-    await ctx.database.set("cchess_game_records", { channelId }, { isRegretRequest: false });
-    return await sendMessage(session, panel({
-      icon: "✅",
-      title: "悔棋成功",
-      at: username,
-      body: ["已同意悔棋，棋子已归原位。"],
-      tips: ["对局继续。"],
-      image: await renderBoard(channelId)
-    }));
-  });
-  ctx.command("cchess.悔棋.拒绝", "拒绝悔棋").action(async ({ session }) => {
-    const { username, channelId } = session;
-    const decision = await checkRegretDecision(session, "拒绝");
-    if (typeof decision === "string") return await sendMessage(session, decision);
-    await ctx.database.set("cchess_game_records", { channelId }, { isRegretRequest: false });
-    return await sendMessage(session, panel({
-      icon: "⚠️",
-      title: "悔棋被拒",
-      at: username,
-      body: ["落子无悔，棋局继续。"],
-      image: await renderBoard(channelId)
+      tips: ["对方回复「同意」或「拒绝」即可表决"]
     }));
   });
   ctx.command("cchess.认输", "认输").action(async ({ session }) => {
@@ -676,35 +624,28 @@ function apply(ctx, config) {
     });
     return await sendMessage(session, message);
   });
-  ctx.command("cchess.查看云库残局", "云库残局指令帮助").action(async ({ session }) => {
-    await session.execute(`cchess.查看云库残局 -h`);
-  });
-  ctx.command("cchess.查看云库残局.DTM统计", "云库残局 DTM 统计").action(async ({ session }) => {
-    const { username, userId } = session;
-    await updateNameInPlayerRecord(userId, username);
-    return await sendMessage(session, panel({
-      icon: "📋",
-      title: "云库残局 · DTM 统计",
-      at: username,
-      body: ["DTM：距将死的步数统计。", "https://www.chessdb.cn/egtb_info_dtm.html"]
-    }));
-  });
-  ctx.command("cchess.查看云库残局.DTC统计", "云库残局 DTC 统计").action(async ({ session }) => {
+  ctx.command("cchess.查看云库残局 [type:string]", "云库残局 DTM / DTC 统计").action(async ({ session }, type) => {
     const { username, userId } = session;
     await updateNameInPlayerRecord(userId, username);
+    const isDtc = /dtc/i.test(type ?? "");
     return await sendMessage(session, panel({
       icon: "📋",
-      title: "云库残局 · DTC 统计",
+      title: `云库残局 · ${isDtc ? "DTC" : "DTM"} 统计`,
       at: username,
-      body: ["DTC：距吃子的步数统计。", "https://www.chessdb.cn/egtb_info.html"]
+      body: isDtc ? ["DTC：距吃子的步数统计。", "https://www.chessdb.cn/egtb_info.html"] : ["DTM：距将死的步数统计。", "https://www.chessdb.cn/egtb_info_dtm.html"]
     }));
   });
-  ctx.command("cchess.编辑棋盘", "编辑棋盘指令帮助").action(async ({ session }) => {
-    await session.execute(`cchess.编辑棋盘 -h`);
-  });
-  ctx.command("cchess.编辑棋盘.导入 <fen:text>", "导入FEN串").action(async ({ session }, fen) => {
+  ctx.command("cchess.编辑棋盘 [fen:text]", "导入 FEN 局面，不带参数时查看 FEN 用法").action(async ({ session }, fen) => {
     const { username, userId, channelId } = session;
     await updateNameInPlayerRecord(userId, username);
+    if (!fen) {
+      return await sendMessage(session, panel({
+        icon: "📋",
+        title: "FEN 串使用方法",
+        at: username,
+        body: ["中国象棋 FEN 格式规范：", "https://www.xqbase.com/protocol/cchess_fen.htm"]
+      }));
+    }
     const gameRecord = await getGameRecord(channelId);
     if (gameRecord.isStarted) {
       return await sendMessage(session, panel({
@@ -724,7 +665,7 @@ function apply(ctx, config) {
         body: ["请检查局面串的格式是否完整。"],
         tips: [
           "示例：rnbakabnr/9/1c5c1/p1p1p1p1p/9/9/P1P1P1P1P/1C5C1/9/RNBAKABNR w",
-          "发送「cchess.编辑棋盘.使用方法」查看规范"
+          "发送「cchess.编辑棋盘」查看规范"
         ]
       }));
     }
@@ -748,7 +689,7 @@ function apply(ctx, config) {
       title: "棋盘摆放完毕",
       at: username,
       body: [field("轮走方", withSideIcon(convertTurnToString(record.turn)))],
-      tips: ["发送「cchess.开始.人人对战」或「cchess.开始.人机对战」由此局面开战"],
+      tips: ["发送「cchess.开始 人人」或「cchess.开始 人机」由此局面开战"],
       image: await renderBoard(channelId)
     }));
   });
@@ -768,37 +709,27 @@ function apply(ctx, config) {
       title: "当前局面 FEN",
       at: username,
       body: [fenWithFullMove],
-      tips: ["可用「cchess.编辑棋盘.导入」还原此局面"]
-    }));
-  });
-  ctx.command("cchess.编辑棋盘.使用方法", "查看编辑棋盘的fen使用方法").action(async ({ session }) => {
-    const { username, userId } = session;
-    await updateNameInPlayerRecord(userId, username);
-    return await sendMessage(session, panel({
-      icon: "📋",
-      title: "FEN 串使用方法",
-      at: username,
-      body: ["中国象棋 FEN 格式规范：", "https://www.xqbase.com/protocol/cchess_fen.htm"]
+      tips: ["可用「cchess.编辑棋盘 <FEN>」还原此局面"]
     }));
   });
-  ctx.command("cchess.排行榜", "排行榜指令帮助").action(async ({ session }) => {
-    await session.execute(`cchess.排行榜 -h`);
-  });
-  ctx.command("cchess.排行榜.总胜场 [number:number]", "查看玩家总胜场排行榜").action(async ({ session }, number = config.defaultMaxLeaderboardEntries) => {
+  ctx.command("cchess.排行榜 [type:string] [number:number]", "查看玩家排行榜").action(async ({ session }, type, number = config.defaultMaxLeaderboardEntries) => {
     const { userId, username } = session;
     await updateNameInPlayerRecord(userId, username);
-    if (typeof number !== "number" || isNaN(number) || number < 0) {
-      return await sendMessage(session, invalidLeaderboardSizePanel(username));
+    if (type && /^\d+$/.test(type)) {
+      number = Number(type);
+      type = "";
     }
-    return await getLeaderboard(session, "win", "总胜场排行榜", "🏆", number);
-  });
-  ctx.command("cchess.排行榜.总输场 [number:number]", "查看玩家总输场排行榜").action(async ({ session }, number = config.defaultMaxLeaderboardEntries) => {
-    const { userId, username } = session;
-    await updateNameInPlayerRecord(userId, username);
     if (typeof number !== "number" || isNaN(number) || number < 0) {
       return await sendMessage(session, invalidLeaderboardSizePanel(username));
     }
-    return await getLeaderboard(session, "lose", "总输场排行榜", "🍂", number);
+    const byLose = !!type && /负|输|lose/i.test(type);
+    return await getLeaderboard(
+      session,
+      byLose ? "lose" : "win",
+      byLose ? "总输场排行榜" : "总胜场排行榜",
+      byLose ? "🍂" : "🏆",
+      number
+    );
   });
   ctx.command("cchess.查询玩家记录 [targetUser:text]", "查询玩家记录").action(async ({ session }, targetUser) => {
     let { userId, username } = session;
@@ -848,7 +779,7 @@ function apply(ctx, config) {
       title: "棋局尚未开始",
       at: username,
       body: ["当前频道还没有进行中的对局。"],
-      tips: ["「cchess.加入」入座", "「cchess.开始.人人对战」与好友手谈", "「cchess.开始.人机对战」挑战皮卡鱼"]
+      tips: ["「cchess.加入」入座", "「cchess.开始 人人」与好友手谈", "「cchess.开始 人机」挑战皮卡鱼"]
     });
   }
   __name(notStartedPanel, "notStartedPanel");
@@ -907,7 +838,7 @@ function apply(ctx, config) {
       title: "皮卡鱼尚未就绪",
       at: username,
       body: ["引擎启动失败，暂时无法进行人机对战。"],
-      tips: ["稍后重试，或改用「cchess.开始.人人对战」"]
+      tips: ["稍后重试，或改用「cchess.开始 人人」"]
     });
   }
   __name(engineUnavailablePanel, "engineUnavailablePanel");
@@ -917,7 +848,7 @@ function apply(ctx, config) {
       title: "榜单人数有误",
       at: username,
       body: ["请输入不小于 0 的整数。"],
-      tips: ["例如：cchess.排行榜.总胜场 10"]
+      tips: ["例如：cchess.排行榜 胜场 10"]
     });
   }
   __name(invalidLeaderboardSizePanel, "invalidLeaderboardSizePanel");
@@ -948,34 +879,104 @@ function apply(ctx, config) {
     });
   }
   __name(settleVictory, "settleVictory");
-  async function checkRegretDecision(session, action) {
+  async function startVersusEngine(session, gameRecord, playerRecords) {
+    const { username, channelId } = session;
+    const playersNum = playerRecords.length;
+    const redPlayers = playerRecords.filter((player) => player.side === "红方");
+    const blackPlayers = playerRecords.filter((player) => player.side === "黑方");
+    if (playersNum < 1 && !config.allowFreePieceMovementInHumanMachineMode) {
+      return await sendMessage(session, panel({
+        icon: "⚠️",
+        title: "尚无棋手入座",
+        at: username,
+        body: ["人机对战至少需要 1 位棋手。"],
+        tips: ["发送「cchess.加入」即可入座挑战皮卡鱼"]
+      }));
+    }
+    if (!await checkEngine(channelId)) {
+      return await sendMessage(session, engineUnavailablePanel(username));
+    }
+    let humanSide;
+    if (playersNum === 1) {
+      humanSide = playerRecords[0].side === "红方" ? "红方" : "黑方";
+    } else if (redPlayers.length !== blackPlayers.length) {
+      humanSide = redPlayers.length > blackPlayers.length ? "红方" : "黑方";
+    } else {
+      humanSide = Math.random() < 0.5 ? "红方" : "黑方";
+    }
+    const engineSide = humanSide === "红方" ? "黑方" : "红方";
+    for (const player of playerRecords) {
+      if (player.side === humanSide) continue;
+      await ctx.database.set("cchess_gaming_player_records", { channelId, userId: player.userId }, { side: humanSide });
+    }
+    await ctx.database.set("cchess_game_records", { channelId }, {
+      isStarted: true,
+      isEnginePlayRed: engineSide === "红方",
+      isEnginePlayBlack: engineSide === "黑方"
+    });
+    const sideString = convertTurnToString(gameRecord.turn);
+    if (engineSide === sideString) await requestEngineMove(channelId);
+    return await sendMessage(session, panel({
+      icon: "✅",
+      title: "人机对局开始",
+      body: [
+        field("棋　手", withSideIcon(humanSide)),
+        field("皮卡鱼", withSideIcon(engineSide)),
+        field("先　手", withSideIcon(sideString)),
+        field("思考深度", `${thinkingDepth} 层`)
+      ],
+      tips: ["直接发送着法即可落子，如「炮二平五」或「b2e2」"],
+      image: await renderBoard(channelId)
+    }));
+  }
+  __name(startVersusEngine, "startVersusEngine");
+  async function resolveRegret(session, agree) {
     const { username, userId, channelId } = session;
     await updateNameInPlayerRecord(userId, username);
     const gameRecord = await getGameRecord(channelId);
-    if (!gameRecord.isStarted) return notStartedPanel(username);
-    if (gameRecord.isAnalyzing || busyChannels.has(channelId)) return analyzingPanel(username);
+    if (!gameRecord.isStarted) return await sendMessage(session, notStartedPanel(username));
+    if (gameRecord.isAnalyzing || busyChannels.has(channelId)) return await sendMessage(session, analyzingPanel(username));
     if (!gameRecord.isRegretRequest) {
-      return panel({
+      return await sendMessage(session, panel({
         icon: "⚠️",
         title: "暂无悔棋请求",
         at: username,
-        body: [`当前没有待答复的请求，无从${action}。`]
-      });
+        body: [`当前没有待答复的请求，无从${agree ? "同意" : "拒绝"}。`]
+      }));
     }
     const playerRecord = await ctx.database.get("cchess_gaming_player_records", { channelId, userId });
-    if (playerRecord.length === 0) return notJoinedPanel(username);
+    if (playerRecord.length === 0) return await sendMessage(session, notJoinedPanel(username));
     const sideString = convertTurnToString(gameRecord.turn);
     if (playerRecord[0].side !== sideString) {
-      return panel({
+      return await sendMessage(session, panel({
         icon: "⚠️",
         title: "无权表决",
         at: username,
         body: ["悔棋请求正由对方等待答复。", field("应答方", withSideIcon(sideString))]
-      });
+      }));
     }
-    return null;
+    if (!agree) {
+      await ctx.database.set("cchess_game_records", { channelId }, { isRegretRequest: false });
+      return await sendMessage(session, panel({
+        icon: "⚠️",
+        title: "悔棋被拒",
+        at: username,
+        body: ["落子无悔，棋局继续。"],
+        image: await renderBoard(channelId)
+      }));
+    }
+    await undoMove(channelId);
+    await ctx.database.set("cchess_game_records", { channelId }, { isRegretRequest: false });
+    return await sendMessage(session, panel({
+      icon: "✅",
+      title: "悔棋成功",
+      at: username,
+      body: ["已同意悔棋，棋子已归原位。"],
+      tips: ["对局继续。"],
+      image: await renderBoard(channelId)
+    }));
   }
-  __name(checkRegretDecision, "checkRegretDecision");
+  __name(resolveRegret, "resolveRegret");
   async function replaceAtTags(session, content) {
     const atRegex = /<at id="(\d+)"(?: name="([^"]*)")?\/>/g;
     let match;
@@ -1173,9 +1174,9 @@ function apply(ctx, config) {
       isHistoryMode = true;
     }
     let moveId = targetMove.moveId;
-    let idx = originalState.moveList.findIndex(((m) => m.moveId == moveId));
+    let idx = originalState.moveList.findIndex((m) => m.moveId == moveId);
     moveList = originalState.moveList.slice(0, idx + 1);
-    idx = originalState.movesAfterLastEat.findIndex(((m) => m.moveId == moveId));
+    idx = originalState.movesAfterLastEat.findIndex((m) => m.moveId == moveId);
     if (idx != -1) {
       movesAfterLastEat = originalState.movesAfterLastEat.slice(0, idx + 1);
     } else {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-cchess",
-  "description": "Koishi 的中国象棋插件。支持人人/人机对战。",
-  "version": "1.0.8",
+  "description": "Koishi 的中国象棋插件。",
+  "version": "1.1.0",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/readme.md

@@ -1,49 +0,0 @@
-koishi-plugin-cchess
-====================
-
-[<img alt="github" src="https://img.shields.io/badge/github-araea/koishi__plugin__cchess-8da0cb?style=for-the-badge&labelColor=555555&logo=github" height="20">](https://github.com/araea/koishi-plugin-cchess)
-[<img alt="npm" src="https://img.shields.io/npm/v/koishi-plugin-cchess.svg?style=for-the-badge&color=fc8d62&logo=npm" height="20">](https://www.npmjs.com/package/koishi-plugin-cchess)
-
-Koishi 的中国象棋插件。
-
-## 使用
-
-`cchess.加入` 入座，`cchess.开始.人人对战` 或 `cchess.开始.人机对战` 开局。着法可直接发送，如炮二平五或 `b2e2`。
-
-## 指令
-
-| 指令 | 说明 |
-| --- | --- |
-| `cchess.加入 [红/黑]` | 入座 |
-| `cchess.退出` | 开局前离席 |
-| `cchess.开始.人人对战` | 人人对战 |
-| `cchess.开始.人机对战` | 人机对战（皮卡鱼） |
-| `cchess.移动 <着法>` | 落子 |
-| `cchess.悔棋.请求` | 悔棋 |
-| `cchess.认输` | 认输 |
-| `cchess.结束` | 强制清盘 |
-| `cchess.编辑棋盘.导入 <FEN>` | 导入局面 |
-| `cchess.编辑棋盘.导出` | 导出局面 |
-| `cchess.排行榜.总胜场 [人数]` | 胜场榜 |
-| `cchess.查询玩家记录 [@某人]` | 查看战绩 |
-
-## 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>