cortico-world-doudizhu 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -1,49 +1,65 @@
-# 更新日志
-
-## 0.2.1
-
-- **每日自动签到领欢乐豆**：连上服务端 3 秒后查一次签到状态，没签就签（服务端固定 100 豆/天）；
-  之后每 30 分钟复查，跨零点自动补签，已签不会重复请求（日志事件 `checkin` / `checkin_already` / `checkin_skipped`）。
-  新增 `ddz {action:"checkin"}` 可手动查/签；`state` 里多了 `beans`（欢乐豆）与 `checkinDate`。
-- **修复抢地主阶段判定**：服务端把抢地主阶段叫 `grab`（不是 `rob`），之前被当成叫分轮处理、
-  一律提交 `pass_bid`；现在 `rob|grab` 都按抢地主处理（强牌抢、弱牌不抢）。
-- **简介补充参与方式**：主人可在官网参与对局、观战（`/watch`）、点「插手」接管出牌；QQ 群 483590438。
-- 面板错误提示不再常驻：一次拉取超时后，下一次成功就自动清掉红字（并 5 秒后自动重试）。
-
-## 0.2.0
-
-- **时限对齐服务端 v2.0.2-772mu.1**（官方口径：出牌 30 秒、桌宠叫分 20 秒、看门狗 30~32 秒触发）：
-  `fastMoveTimeoutMs` 24000、`decisionDeadlineMs` 28000，都压在 30 秒之前，本地兜底不会再比服务端晚。
-  （之前误按 40 秒设成 32000/38000，当地兜底永远轮不到。）
-- **叫分本地判定（新增）**：叫分阶段（桌宠 20 秒）不再干等服务端托管——按手牌强度直接表态：
-  双王/双 2/炸弹/多 A 计分，叫分轮 score≥9 叫地主、否则不叫；抢地主轮 score≥14 抢、否则不抢。
-  不问模型、不推事件，决策写进 `actions.jsonl` 的 `fast_bid`（带 score / bidPhase）。
-- **总开关断开时机**：关掉后，正在打的局**打完再断**（服务端规则：断线 30 秒不回来就解散房间，中途硬断会拆别人的局）；
-  不在牌局中（waiting / 已结算）时**5 秒内断开**（巡检从 30 秒改成 5 秒），配置热读、不用重启。
-
-- **快决策（fastMove）**：轮到自己时不再把整张牌桌推进主会话，而是用 ~300 token 的小提示词直接问一次主模型
-  （手牌 / 上一手 / 两家剩几张 / 候选列表），拿到一手后**逐个对回服务端给的 legalActions** 再提交。
-  成功即 `POST /api/match/<table>/act`，不推事件、不抢占对话轮。实测中位 2.0~2.9 秒一手。
-  - 模型爱用中文花色（`♠6 ♦6`）而不是 ASCII，解析层同时认 `♠6` / `6S` / `小王` / `SJ`；
-  - 一手牌被塞进一个字符串（`"♠6 ♦6"`）也能拆开；
-  - 对不上候选（mismatch）或解析失败（parse）时**立刻按张数最少的一手出牌**，不再白等兜底；
-  - 只有 timeout / HTTP 错才交给 `localFallback`。
-- **出牌让槽（pauseMainDuringTurn）**：模型服务器只有一个并发槽位时，主会话那种几万 token 的生成会把槽位占住几十秒。
-  出牌期间先 `POST /api/run/pause`（事件照常落库、不唤醒），出完立刻 `resume`。
-  - 主人手动暂停时不会被覆盖（出手前先查 `/api/status`）；
-  - `finally` 里无条件恢复 + 看门狗（`fastMoveTimeout + 15s`）+ 启动自检（`pause-ours.flag`），
-    避免进程在暂停期间被杀导致"重启后一直不回话"。
-- **总开关与时段**：`playWindowEnabled` 是总开关（关掉完全不连接、不打）；`playWindowStart` 填 `0` 或留空 = 不限时段，
-  否则只在 `playWindowStart~playWindowEnd` 之间入座，支持跨零点（`22:00~02:00`）。
-  时段结束时**正在打的局会打完再断**，还没开局则 30 秒内断开；到点每 60 秒检查一次自动回来。
-- **赛后清上下文（resetContextAfterGame）**：结算后等 `resetContextDelayMs` 调 Coopanion 的
-  `/api/session/reload-prefix`，丢掉这一局的对话上下文、用最新系统提示词重新开始（Memory 与人格保留）。
-  超时 90 秒、最多重试 3 次（她正在生成时 reload 要等当前批收尾）。
-- **启动容错**：没有可加入的桌 / 服务端超时不再把整个 World 标成"启动失败"并跳过一整天，
-  改为记 warn + 60 秒后重试。
-- 超时口径按服务端时限重排：`fastMoveTimeoutMs 32000` < `decisionDeadlineMs 38000` < 服务端 40000。
-- 工具仍只有一个 `ddz`（`state`/`act`/`chat`/`next`/`friend`/`square`）。
-
-## 0.1.0
-
-- 首个版本：auth / WS / 事件投递 / `ddz` 工具 / 牌桌面板，按服务端网关 v2.0.1 契约实现。
+# 更新日志
+
+## 0.2.3
+
+- **说了不打就离桌**：之前投「不打」但服务端回 `pending`（其它座位未表态）时，到点会被默认「继续」拖进下一局；
+  现在 `verdict != quit` 且自己的票是「不打」，2 秒后主动断桌换桌（日志 `next_leave` + `leave_table`），不再陪跑。
+  AI 座位本来就不在投票范围里，所以这不会影响真人局。
+
+## 0.2.2
+
+- **自动续桌 `autoNext`**（配合服务端 S-1）：打开后每局结算由服务端代投「继续」，不用每局表态；auth 请求体新增 `autoNext`（默认 false）。
+  服务端仅在「开关开 + WS 在线 + 90 秒内有心跳」三者同时满足时代投，掉线自动失效；`/next {play:false}` 或 `auth {autoNext:false}` 立即停。
+- **30 秒心跳**：每 30 秒 `GET /view`，刷新服务端判离线用的 `last_seen`，也顺便发现连接假死（第 1 次与每第 10 次记 `keepalive`，不刷屏）。
+- **席位协商**：`next_vote` 日志接收服务端返回的 `pendingSeats`（还差哪些座位没表态）。
+- **环境手册瘦身**：2,800 → 682 字符（省约 1,320 token/次请求）。
+- **`ddz state` 瘦身**：候选只列前 `legalPreview`（默认 12）条，另给总数 `legalActionCount`。
+- **修「表态」**：`play` 认中文/字符串/数字/缺省（12 例全过）；`verdict=again` 后 800ms 主动刷新牌局；`verdict=quit` 清桌号并重新找桌。
+
+## 0.2.1
+
+- **每日自动签到领欢乐豆**：连上服务端 3 秒后查一次签到状态，没签就签（服务端固定 100 豆/天）；
+  之后每 30 分钟复查，跨零点自动补签，已签不会重复请求（日志事件 `checkin` / `checkin_already` / `checkin_skipped`）。
+  新增 `ddz {action:"checkin"}` 可手动查/签；`state` 里多了 `beans`（欢乐豆）与 `checkinDate`。
+- **修复抢地主阶段判定**：服务端把抢地主阶段叫 `grab`（不是 `rob`），之前被当成叫分轮处理、
+  一律提交 `pass_bid`；现在 `rob|grab` 都按抢地主处理（强牌抢、弱牌不抢）。
+- **简介补充参与方式**：主人可在官网参与对局、观战（`/watch`）、点「插手」接管出牌；QQ 群 483590438。
+- 面板错误提示不再常驻：一次拉取超时后，下一次成功就自动清掉红字（并 5 秒后自动重试）。
+
+## 0.2.0
+
+- **时限对齐服务端 v2.0.2-772mu.1**（官方口径：出牌 30 秒、桌宠叫分 20 秒、看门狗 30~32 秒触发）：
+  `fastMoveTimeoutMs` 24000、`decisionDeadlineMs` 28000，都压在 30 秒之前，本地兜底不会再比服务端晚。
+  （之前误按 40 秒设成 32000/38000，当地兜底永远轮不到。）
+- **叫分本地判定（新增）**：叫分阶段（桌宠 20 秒）不再干等服务端托管——按手牌强度直接表态：
+  双王/双 2/炸弹/多 A 计分，叫分轮 score≥9 叫地主、否则不叫；抢地主轮 score≥14 抢、否则不抢。
+  不问模型、不推事件，决策写进 `actions.jsonl` 的 `fast_bid`（带 score / bidPhase）。
+- **总开关断开时机**：关掉后，正在打的局**打完再断**（服务端规则：断线 30 秒不回来就解散房间，中途硬断会拆别人的局）；
+  不在牌局中（waiting / 已结算）时**5 秒内断开**（巡检从 30 秒改成 5 秒），配置热读、不用重启。
+
+- **快决策（fastMove）**：轮到自己时不再把整张牌桌推进主会话，而是用 ~300 token 的小提示词直接问一次主模型
+  （手牌 / 上一手 / 两家剩几张 / 候选列表），拿到一手后**逐个对回服务端给的 legalActions** 再提交。
+  成功即 `POST /api/match/<table>/act`，不推事件、不抢占对话轮。实测中位 2.0~2.9 秒一手。
+  - 模型爱用中文花色（`♠6 ♦6`）而不是 ASCII，解析层同时认 `♠6` / `6S` / `小王` / `SJ`；
+  - 一手牌被塞进一个字符串（`"♠6 ♦6"`）也能拆开；
+  - 对不上候选（mismatch）或解析失败（parse）时**立刻按张数最少的一手出牌**，不再白等兜底；
+  - 只有 timeout / HTTP 错才交给 `localFallback`。
+- **出牌让槽（pauseMainDuringTurn）**：模型服务器只有一个并发槽位时，主会话那种几万 token 的生成会把槽位占住几十秒。
+  出牌期间先 `POST /api/run/pause`（事件照常落库、不唤醒），出完立刻 `resume`。
+  - 主人手动暂停时不会被覆盖（出手前先查 `/api/status`）；
+  - `finally` 里无条件恢复 + 看门狗（`fastMoveTimeout + 15s`）+ 启动自检（`pause-ours.flag`），
+    避免进程在暂停期间被杀导致"重启后一直不回话"。
+- **总开关与时段**：`playWindowEnabled` 是总开关（关掉完全不连接、不打）；`playWindowStart` 填 `0` 或留空 = 不限时段，
+  否则只在 `playWindowStart~playWindowEnd` 之间入座，支持跨零点（`22:00~02:00`）。
+  时段结束时**正在打的局会打完再断**，还没开局则 30 秒内断开；到点每 60 秒检查一次自动回来。
+- **赛后清上下文（resetContextAfterGame）**：结算后等 `resetContextDelayMs` 调 Coopanion 的
+  `/api/session/reload-prefix`，丢掉这一局的对话上下文、用最新系统提示词重新开始（Memory 与人格保留）。
+  超时 90 秒、最多重试 3 次（她正在生成时 reload 要等当前批收尾）。
+- **启动容错**：没有可加入的桌 / 服务端超时不再把整个 World 标成"启动失败"并跳过一整天，
+  改为记 warn + 60 秒后重试。
+- 超时口径按服务端时限重排：`fastMoveTimeoutMs 32000` < `decisionDeadlineMs 38000` < 服务端 40000。
+- 工具仍只有一个 `ddz`（`state`/`act`/`chat`/`next`/`friend`/`square`）。
+
+## 0.1.0
+
+- 首个版本：auth / WS / 事件投递 / `ddz` 工具 / 牌桌面板，按服务端网关 v2.0.1 契约实现。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico-world-doudizhu",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "description": "斗地主 World 扩展：桌面宠物自动入座、自己出牌，每天自动领欢乐豆；主人可在官网参与对局、观战（/watch）、或点「插手」接管出牌。QQ 群 483590438。",
   "author": "大肥鱼",

package/src/ENV_PROMPT.md

@@ -1,62 +1,24 @@
 ## 斗地主
 
-你在牌桌上，服务端是唯一裁判，你只负责选牌。**所有操作都走同一个工具 `ddz`，用 `action` 区分。**
+服务端是唯一裁判，你只负责**轮到你时出牌**和**打完说句话**。所有操作都走 `ddz`，用 `action` 区分。
 
-### 每手怎么做
+### 每手
+- 轮到你（`legalActions` 非空且不是主人接管）→ `ddz {action:"act", version:当前版本, cards:[...]}`，压不过就 `pass:true`
+- 一手只提交一次；被拒（stale_version）先 `state` 再选，**别原样重发**
+- 叫分已由本地规则处理，不用你操心
 
-1. `ddz {action:"state"}` 看局面：自己的手牌、上一手、全部合法候选、`version`、`bidPhase`、`timer`
-2. 轮到你（`timer` 非空、`legalActions` 非空）→ `ddz {action:"act", version:..., cards:[...]}` 或 `pass:true`
-3. 收到回执才算完，**一手只提交一次**
+### 频道
+牌桌 `chat`（同桌三人）／私聊 `friend op:"chat"`（对方 uid：人类 `5H`、桌宠 `10001`）／广场 `square op:"send"`（全服，一分钟 3 条）。别串台。
 
-- `version` 必须取自最近一次 state / 事件；被拒就重新 state 再选，**绝不原样重发**
-- 别人出牌不会打扰你，只在你回合才推一条
-
-### 叫分（每局开头，别跳过）
-
-`state` 里 `bidPhase` 非空就是叫分阶段，**只传 `bid`，不传 `cards`**：
-
-| `bidPhase` | 用 |
-|---|---|
-| `call` | `bid:"call"` 叫地主 ／ `bid:"pass_call"` 不叫 |
-| `grab` | `bid:"rob"` 抢（倍数×2 且换地主）／ `bid:"no_rob"` 不抢 |
-
-- 大小王多、2 多、有炸弹 → 叫，可以抢；一手小牌 → 不叫
-- **超时会被自动判「不叫 / 不抢」**，别拖着不动
-
-### 三个频道，别串台
-
-| 频道 | 怎么用 | 谁看得见 |
-|---|---|---|
-| 牌桌 | `ddz {action:"chat", text}` | 同桌三人 |
-| 私聊 | `ddz {action:"friend", op:"chat", other_uid, text}` | 你俩 |
-| 广场 | `ddz {action:"square", op:"send", text}` | 全服 |
-
-广场的话不是牌桌信息；私聊别复述到广场；牌桌的事只在牌桌说。广场一分钟最多 3 条。
-
-### 认人
-
-- **人类**：数字 + 大写 H（`5H`、`12H`）
-- **桌宠**：纯数字（`10001`）
-- 加好友：`ddz {action:"friend", op:"request", other_uid:"5H"}`；同意：`op:"accept"`
-- 好友上限 10 个，满了先删（`op:"remove"`）；人和宠物可以互相加
-
-### 一局打完：接着打还是散场
-
-结算后不要退房间，服务端会开一个表态窗口（`state` 里 `next` 字段，带 `leftMs` 剩余毫秒）：
-
-- 还想打：`ddz {action:"next", play:true}` —— 大家都同意就**同一桌直接再发牌**，座位和令牌都不变
-- 不打算玩了：`ddz {action:"next", play:false}` —— 有人不打就散场
-- 想先问问别人：`ddz {action:"chat", text:"还来吗？"}` 再表态
-- 到点没人反对会默认接着打，所以**不想打一定要明说**
+### 局后
+结算后服务端开表态窗口：还想打 `ddz {action:"next", play:true}` 同桌重开；不打了 `play:false` 散场（到点没人反对会默认继续，不想打要明说）。
 
 ### 省上下文
-
-广场、私聊都**按需读**（`op:"recent"` / `op:"messages"`），别反复刷。一局解说别超过三句，别把牌局念成流水账。
+广场/私聊按需读（`op:"recent"` / `op:"messages"`），别反复刷；一局解说别超过三句，别把牌念成流水账。
 
 当前权限：{{doudizhu.status}}
 
 ## 主人怎么一起玩
-
-- 观战/直播：https://www.772mu.com:8443/watch
-- 主人可在同平台登录后坐进同一张桌和你打；也能在面板点「主人接管」直接接管你这一座，说一句「交还」再还给你。
-- 有问题进 QQ 群 483590438。
+- 观战：https://www.772mu.com:8443/watch
+- 主人可登录同平台坐进同一张桌，或在面板点「主人接管」接管你这一座（说「交还」还给你）。
+- 有问题进 QQ 群 483590438。

package/src/config.ts

@@ -28,6 +28,8 @@ export interface DdzConfigSection {
   pauseMainDuringTurn: boolean;
   /** Coopanion 控制接口基址（暂停/继续、清空上下文都走它）。 */
   controlBaseUrl: string;
+  /** 自动续桌（服务端 S-1）：每局结算自动投「继续」，关=每局自己投票。 */
+  autoNext: boolean;
   /** 总开关：关掉就不连接、不打牌；打开才入座。 */
   playWindowEnabled: boolean;
   /** 游戏开始时间（HH:MM）；填 0 或留空 = 不限时间、整天都能打。 */
@@ -58,6 +60,7 @@ export const DDZ_DEFAULTS: DdzConfigSection = {
   resetContextUrl: 'http://127.0.0.1:17788/api/session/reload-prefix',
   pauseMainDuringTurn: false,
   controlBaseUrl: 'http://127.0.0.1:17788',
+  autoNext: false,
   playWindowEnabled: true,
   playWindowStart: '0',
   playWindowEnd: '',
@@ -138,7 +141,10 @@ export const DDZ_CONFIG_GROUP: ConfigGroup = {
         type: 'string', title: 'Coopanion 控制接口基址', 'x-hot': false,
         description: '默认 http://127.0.0.1:17788（网页端口按实际配置）。暂停/继续、清空上下文都用它。',
       },
-      'worlds.doudizhu.playWindowEnabled': {
+      'worlds.doudizhu.autoNext': {
+        type: 'boolean', title: '自动续桌（每局自动投继续）', 'x-hot': true,
+        description: '打开后每局结算自动投「继续」，不用每局表态。服务端只在「开关开 + 连接在线 + 90 秒内有心跳」三者同时满足时才代投，掉线自动失效。关掉或调 next{play:false} 立即停止。默认关闭。',
+      },      'worlds.doudizhu.playWindowEnabled': {
         type: 'boolean', title: '总开关（关=不连接、不打）', 'x-hot': true,
         description: '关掉：完全不连服务端、不入座、不出一张牌。打开：按下面的时间入座打牌。正在打的那一局会先打完再走。',
       },

package/src/world.ts

@@ -89,6 +89,8 @@ export class DoudizhuWorld implements World {
   private windowTimer?: NodeJS.Timeout;
   /** 每日签到巡检定时器。 */
   private checkinTimer?: NodeJS.Timeout;
+  /** 30 秒心跳（刷新服务端 last_seen）。 */
+  private keepaliveTimer?: NodeJS.Timeout;
   /** 今天已经签到/尝试过的日期（YYYY-MM-DD），防重复请求。 */
   private checkinDate = '';
   /** 最近一次查到的欢乐豆余额。 */
@@ -137,6 +139,7 @@ export class DoudizhuWorld implements World {
       // 每日签到：连上服务端就查一次，跨天也会补
       setTimeout(() => void this.tryDailyCheckin(), 3000);
       this.startCheckinTimer();
+      this.startKeepalive();
     } catch (error) {
       // 没有可加入的桌 / 服务端超时都是常态：不要把整个世界标成"启动失败"然后一直跳过，
       // 留一个 60 秒的重试，桌子出现了自己就进去了。
@@ -193,6 +196,22 @@ export class DoudizhuWorld implements World {
     this.checkinTimer = setInterval(() => void this.tryDailyCheckin(), 30 * 60_000);
   }
 
+  /**
+   * 30 秒一次 GET /view：既给服务端刷新 last_seen（他们会按 90 秒判桌宠离线），
+   * 也顺便发现连接已经假死。第 1 次和之后每 10 次记一行，避免刷日志。
+   */
+  private startKeepalive(): void {
+    if (this.keepaliveTimer) return;
+    let beat = 0;
+    this.keepaliveTimer = setInterval(() => {
+      if (!this.ws || !this.token || !this.tableId) return;
+      beat += 1;
+      void this.refresh().then(() => {
+        if (beat === 1 || beat % 10 === 0) this.log({ event: 'keepalive', n: beat });
+      });
+    }, 30_000);
+  }
+
   private todayKey(): string {
     const now = new Date();
     const mm = String(now.getMonth() + 1).padStart(2, '0');
@@ -293,6 +312,10 @@ export class DoudizhuWorld implements World {
     clearTimeout(this.contextResetTimer);
     this.clearResumeWatchdog();
     this.clearWindowGuard();
+    if (this.keepaliveTimer) {
+      clearInterval(this.keepaliveTimer);
+      this.keepaliveTimer = undefined;
+    }
     if (this.windowTimer) {
       clearTimeout(this.windowTimer);
       this.windowTimer = undefined;
@@ -355,18 +378,64 @@ export class DoudizhuWorld implements World {
    * 全票「打」就直接在同一桌重开一局（座位、令牌、余额都不变），
    * 有人「不打」就散场——不用退出房间重走一遍流程。
    */
+  /** 把「接着打 / 不打」解析成布尔：中文、字符串、数字都认，缺省按"接着打"。 */
+  private parsePlayArg(raw: unknown): boolean {
+    if (raw === undefined || raw === null) return true;
+    if (typeof raw === 'boolean') return raw;
+    if (typeof raw === 'number') return raw !== 0;
+    const text = String(raw).trim().toLowerCase();
+    if (!text) return true;
+    if (/^(false|no|0|off|quit|stop|exit|leave)$/.test(text)) return false;
+    if (/不打|不玩|不接|散场|退出|算了/.test(text)) return false;
+    return true;
+  }
+
+  /** 离桌：断开当前桌，清桌号，重新找一张（说"不打"后调用，不等别人投票）。 */
+  private leaveTable(): void {
+    this.log({ event: 'leave_table', tableId: this.tableId });
+    clearTimeout(this.fallbackTimer);
+    this.fallbackTimer = undefined;
+    try {
+      this.ws?.close();
+    } catch {
+      /* 已关闭 */
+    }
+    this.ws = undefined;
+    this.tableId = '';
+    this.view = undefined;
+    setTimeout(() => void this.reconnect(), 1500);
+  }
+
   private async nextTool(args: Record<string, unknown>) {
     if (!this.tableId) return { failed: true as const, text: '还没入座，没有可结算的牌桌' };
     const raw = args.play ?? args.again ?? args.want;
-    const play = !(raw === false || raw === 'no' || raw === 'false' || raw === 0);
+    const play = this.parsePlayArg(raw);
     try {
       const res = await this.platformPost(
         `/api/match/${encodeURIComponent(this.tableId)}/next`, { play });
       const code = Number(res.code);
       if (code === 1) return { failed: true as const, text: String(res.msg || '表态失败') };
       const verdict = String(res.verdict || '');
-      if (verdict === 'again') return { text: '已表态继续，大家都在同一桌接着打，新一局已经发牌。' };
-      if (verdict === 'quit') return { text: '已表态不打，本桌散场。' };
+      const pending = Array.isArray((res as Record<string, unknown>).pendingSeats) ? (res as Record<string, unknown>).pendingSeats : null;
+      this.log({ event: 'next_vote', play, verdict: verdict || 'pending', pendingSeats: pending });
+      if (verdict === 'again') {
+        // 同一张桌重开：立刻拉一次新牌局，别干等下一帧（否则就是"坐着不动"）
+        setTimeout(() => void this.refresh(), 800);
+        return { text: `已表态${play ? '继续' : '不打'}（服务端判定：同桌重开），新一局已发牌。` };
+      }
+      if (verdict === 'quit') {
+        // 本桌散场：清掉桌号重新找一张，别死守一张已经没了的桌子
+        this.tableId = '';
+        setTimeout(() => void this.reconnect(), 1500);
+        return { text: `已表态${play ? '继续' : '不打'}（服务端判定：本桌散场）。我去找下一张桌。` };
+      }
+      if (!play) {
+        // 说了不打就走：AI 座位不投票，若服务端迟迟不判 quit，到点会默认"继续"，把她拖进下一局。
+        // 所以表完态自己离桌，不等别人。
+        this.log({ event: 'next_leave', verdict: verdict || 'pending' });
+        setTimeout(() => this.leaveTable(), 2000);
+        return { text: '已表态不打。不等别人了，直接离桌换一张。' };
+      }
       return { text: `已表态${play ? '继续' : '不打'}，等其他人表态。` };
     } catch (e) {
       return { failed: true as const, text: `表态失败：${(e as Error).message}` };
@@ -477,7 +546,8 @@ export class DoudizhuWorld implements World {
       seat: v.seat,
       hand: v.hand.map((c) => c),
       lastPlay: v.lastPlay ? { seat: v.lastPlay.seat, cards: v.lastPlay.cards } : null,
-      legalActions: v.legalActions,
+      legalActions: v.legalActions.slice(0, Math.max(1, this.ctx.cfg.legalPreview || 12)),
+      legalActionCount: v.legalActions.length,
       timer: v.timer,
       bidPhase: (v as unknown as Record<string, unknown>).bidPhase ?? null,
       bidIsMe: (v as unknown as Record<string, unknown>).bidIsMe ?? false,
@@ -590,6 +660,7 @@ export class DoudizhuWorld implements World {
         // 昵称：配置优先，否则用部署显示名；服务端存进宠物档案，之后可 /api/pet/nickname 改
         displayName: nick,
         allowAi: this.ctx.cfg.allowAi,
+      autoNext: this.ctx.cfg.autoNext === true,
       }),
       signal: AbortSignal.timeout(15000),
     });