wenbobodley/dsh-guandan

🃏 掼蛋-中联储卫（GUANDAN-中联储卫）· DSH 掼蛋扑克牌游戏

中文 · English | DeepSeek Harness (DSH) 掼蛋扑克牌插件 · 4 人两副牌 · 完整规则
一款功能完整的掼蛋（中国爬牌类游戏）DeepSeek Harness 插件——4 名玩家、2 副牌、完整规则。V3+ 与独立服务器共用同一套牌桌 UI。

✨ 功能亮点 / Features

中文

- 完整规则：逢人配（红桃级牌万能、不可单独出）、连对（恰 3 对）、钢板（恰 2 三张）、
三带二（不含王对）、顺子（级牌可参与）、同花顺、炸弹 4-8 张、天王炸（四王）、
进贡/还贡/抗贡、接风、双下、升级 2→A（过 A 需头游且升级≥2）
- 4 人局：你坐 1 家（「卫」），其余 3 家牌友（中 / 联 / 储）自动行牌
- 智能机器人（V3）：拿牌权第一（压不过用炸弹炸）、对家配合（不压对家/帮压回）、
防对手走完（剩 1-5 张避开同张数）、炸弹冲刺（剩≤3 张拿牌权）、组牌领出（优先复合牌型）
- 图形牌桌（V3，与独立服务器同源）：底部 6 按钮（出/过/组/解/清/关）、组牌识别、
真人 60 秒 / 机器人 5 秒限时、出牌中徽标、局结束排名停留 + 手动下一局、底牌公开
- 多人房间：建房/输码加入/选座/开局/机器人补位/真人超时自动过/局结束手动续局
- 4 个工具：guandan_new 开局 / guandan_state 看牌局 / guandan_play 出牌或过 / guandan_hint 查合法出牌
- 双模式同局：UI 直连与 Agent 工具共用同一张牌局表

English

- 完整规则：逢人配（红桃级牌万能、不可单独出）、连对（恰 3 对）、钢板（恰 2 三张）、
三带二（不含王对）、顺子（级牌可参与）、同花顺、炸弹 4-8 张、天王炸（四王）、
进贡/还贡/抗贡、接风、双下、升级 2→A
- 4 人局：你坐 1 家，3 家牌友自动行牌
- 智能机器人（V3）：拿牌权第一（压不过用炸弹炸）、对家配合、防对手走完、炸弹冲刺、组牌领出
- 图形牌桌（V3，与独立服务器同源）：底部 6 按钮（出/过/组/解/清/关）、组牌识别、真人 60 秒 / 机器人 5 秒限时、出牌中徽标、局结束排名停留 + 手动下一局、底牌公开
- 多人房间：建房/输码加入/选座/开局/机器人补位/真人超时自动过/局结束手动续局
- 4 个工具：guandan_new / guandan_state / guandan_play / guandan_hint
- 双模式同局：UI 与 Agent 工具操作同一局游戏

📦 安装 / Installation

中文

dsh plugin --profile web add @zhonglianchuwei/dsh-guandan

重启 dsh web 后，在任意会话中让 Agent 开局：

我们打一局掼蛋（掼蛋-中联储卫）

English

dsh plugin --profile web add @zhonglianchuwei/dsh-guandan

重启 dsh web，然后让 Agent 开局：

我们打一局掼蛋（掼蛋-中联储卫）

🛠 工具用法 / Tools

| 工具 / Tool | 作用 / Purpose |
|---|---|
| guandan_new(seat?) | 开新一局；seat 指定你坐的位置（默认 0，队友为 2 号位）/ 开新一局；seat 默认 0（队友为 2 号位） |
| guandan_state() | 当前局面：手牌/级牌/轮到谁/场上最大/合法动作数 / 当前局面：手牌/级牌/轮到谁/场上最大/合法动作数 |
| guandan_play(cards\|pass) | 出牌（如 "H2 H2 S2"）或过牌（pass: true）/ 出牌或过牌 |
| guandan_hint() | 列出全部合法出牌（含牌型）/ 列出全部合法出牌（含牌型） |

🎮 图形界面 / GUI (V3)

中文

安装并重启 web 后，左侧边栏底部出现「🃏 掼蛋」入口（与「插件市场」同排）：
- 点击打开浮层牌桌（全屏遮罩 + 居中面板）
- 浮层内嵌 iframe 加载插件自托管前端，与独立服务器完全一致：东南西北牌桌、6 按钮、
组牌识别、60 秒限时、出牌中徽标、局结束排名停留、手动下一局、末游底牌公开
- 牌局状态与工具完全共享

中文

安装并重启后，左侧边栏底部会出现 🃏 掼蛋 入口：
- 点击打开悬浮牌桌（全屏遮罩 + 居中面板）
- 悬浮层内嵌 iframe 加载插件托管的前端——与独立服务器完全一致：四向牌桌、6 个按钮、组牌识别、60 秒限时、出牌中徽标、局结束排名停留、手动下一局、末游底牌公开
- 牌局状态与智能体工具完全共享

📐 规则速览 / 规则速查

- 比牌 / 牌序：大王 > 小王 > 级牌 > A > K > … > 3 > 2
- 逢人配 / 万能牌：每局红桃级牌为万能牌 / 红桃级牌为万能牌（不能单独出）
- 连对 / 三连对：恰好 3 个连续对子 / 恰好 3 个连续对子（AA2233 … QQKKAA）
- 钢板 / 钢板：恰好 2 个连续三张 / 恰好 2 个连续三张（AAA222 … KKKAAA）
- 天王炸 / 王炸：4 王（2 小 + 2 大）/ 4 张王；双王只是一对 / 两张王只是一对
- 顺子 / 顺子：5 张连续 / 5 张连续（A2345 … TJQKA）
- 炸弹压制一切非炸弹 / 炸弹压制所有非炸弹；同花顺压顺子 / 同花顺压顺子

🎵 背景音乐 / 背景音乐

中文

- 包内自带缺省音乐 00-guandan.mp3（播放列表第一位）
- 把 MP3/OGG/M4A/WAV/FLAC/AMR 放入 web/bgm/ 即可自行添加（点“🎵”开启，⏭ 切歌，再点关闭；关闭不影响打牌音效）

中文

- 自带默认音乐 00-guandan.mp3（播放列表第一位）
- 将 MP3/OGG/M4A/WAV/FLAC/AMR 放入 web/bgm/ 即可添加自己的音乐（🎵 开关，⏭ 下一首；关闭音乐不影响游戏音效）

📜 版本 / 版本历史

- V3 (3.0.0)：牌桌 UI 与独立服务器同源（iframe 托管 web/）、智能机器人、6 按钮分组、60 秒限时、房间 API
- V2.1 (2.1.x)：UI 入口迁移（侧边栏底部 + 悬浮层 + 插件卡片）
- V2 (2.0.x)：图形化牌桌 UI（工具 + /guandan/* 路由 + 浏览器面板）
- V1 (1.0.0)：初始聊天工具版本

变更见 CHANGELOG.md / 变更见 CHANGELOG.md。

🔧 开发 / 开发

node lib/test.js   # 引擎自测（牌型/合法动作/整局模拟）/ 引擎自测

🏆 独立服务器 / 独立服务器

想不装插件、手机直接玩？独立公网服务器版（同款 UI + AI）：
想不装插件、手机直接玩？独立公网服务器版（同款 UI + AI）：

本地/Local:  http://127.0.0.1:8787
局域网/LAN:  http://:8787
公网/Public: ngrok/端口转发指向 8787

仓库同源代码见 guandan-server/（本仓库）或独立发布。

License

Apache-2.0. 规则引擎改编自 / 引擎改编自 AltmanD/Guandan
（Lu Yudong / Yu Yan），见 / 见 NOTICE. 品牌「掼蛋-中联储卫 / GUANDAN-中联储卫」归品牌方所有 / 品牌归品牌方所有。