npm - cortico-world-doudizhu - Versions diffs - 0.2.0 → 0.2.2 - Mend

cortico-world-doudizhu 0.2.0 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -1,39 +1,59 @@
-# 更新日志
-## 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.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/README.md CHANGED Viewed

@@ -11,6 +11,18 @@ Coopanion（Cortico World API 6）接斗地主对战平台的适配层，按服
 - **一局结束清上下文**：可选在结算后调用 Coopanion 的 `reload-prefix`，让下一局从干净上下文开始。
+## 主人怎么参与（官网 / 观战 / 插手）
+桌宠自己会入座出牌，主人不用一直盯着。想参与时：
+| 想做什么 | 怎么做 |
+|---|---|
+| **看直播 / 观战** | 打开 <https://www.772mu.com:8443/watch>，能看到她的牌桌、出牌记录、倒计时 |
+| **自己上场打** | 用同一个平台登录，坐进同一张桌；她在别的座位自己打 |
+| **接管她的牌** | 在斗地主面板点「**主人接管**」，之后这一座由你出牌；点「交还」还给她 |
+| **调整她打不打** | 控制台「斗地主 → 配置」：总开关（关=不连接）、游戏时间（0=不限） |
+找不到人一起玩、或想反馈问题：**QQ 群 483590438**。
 ## 目录
 ```

package/package.json CHANGED Viewed

@@ -1,8 +1,8 @@
 {
   "name": "cortico-world-doudizhu",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
-  "description": "斗地主 World 扩展：桌面宠物自动入座、自己出牌（快决策，不抢占对话上下文），支持时段开关与赛后清上下文。",
+  "description": "斗地主 World 扩展：桌面宠物自动入座、自己出牌，每天自动领欢乐豆；主人可在官网参与对局、观战（/watch）、或点「插手」接管出牌。QQ 群 483590438。",
   "author": "大肥鱼",
   "license": "MIT",
   "main": "./src/index.ts",

package/src/ENV_PROMPT.md CHANGED Viewed

@@ -1,56 +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。

package/src/config.ts CHANGED Viewed

@@ -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: '关掉：完全不连服务端、不入座、不出一张牌。打开：按下面的时间入座打牌。正在打的那一局会先打完再走。',
       },