项目概述

这是一个 DSH（DeepSeek IDE）web 插件包 dsh-guandan（Cordis 插件），实际功能是把独立的「掼蛋」纸牌游戏作为底部面板嵌入 DSH 界面：侧栏底部出现「♥️ 掼蛋游戏」按钮，点击打开 96px 高的游戏栏（占用工作区底部布局，向上推中间列，不遮左侧栏）。游戏为纯前端单机版（4 个 AI 玩家，无需后端）。 水平有限，AI策略没法兼顾，如果要提高只能不停加规则！工作量有点大，原想结合大模型决策，但发现更不靠谱，所以后续主要增加了复盘功能，暂时还是娱乐为主了。 后续暂停更新，除非有明显BUG

更新说明

• v0.2.6 复盘试打加入回退功能，进入试打复盘；【返回】退回原始复盘。
• v0.2.5 优化复盘时出牌区位置；优化炸弹以及小牌处理
• v0.2.4 牌桌大于540时，复盘时手牌均竖排显示；动态调整出牌区位置
• v0.2.3 修复bug: 万能牌主值计算、全局搜索顺子
• v0.2.2 微调复盘时牌桌手牌显示，调整出牌延时，微调AI策略
• v0.2.1 复盘时手牌自动分组，竖排显示时双击可选整列；复盘时双击列表进入全盘试打；微调AI策略
• v0.2.0 用DeepSeek加入复盘功能，加测试，优化显示；复盘试打时自动打开console打印
• v0.1.8 竖排显示时，游戏栏改用牌桌背景；修改万能牌配色；出牌错误可多次重试；关闭console打印
• v0.1.7 竖排显示时动态调整手牌大小位置；组牌列表增加双击仅选中当前牌功能；fix: 新局按钮清理旧游戏残留
• v0.1.6 显示牌桌时，手牌竖向排列，同时增加记牌显示，优化进贡显示，独立版本也加入键盘控制
• v0.1.5 AI出牌增加延时，修改配色，绑定N键，加入版本号显示
• v0.1.4 修复牌局结束点击关闭后，无法继续下一局的问题；贡牌时加入按空格确认
• v0.1.3 插件加入绑定键盘控制：空格，C，V；主题切换直接跟随DSH设置
• v0.1.2 同步npm，可通过 dsh plugin --profile web add dsh-guandan 安装
• v0.1.1 初始版本，基本功能，可直接通过github安装

使用操作说明

• 插件安装：dsh plugin --profile web add dsh-guandan
• 或者github：dsh plugin --profile web add github:jansen-66/dsh-guandan-panel
• 插件已经绑定键盘控制
  • 空格 → #table-turn-info：轮到自己时出牌/过牌，牌局结束进下一副，贡牌时确认。
  • C → #btn-pass：过牌。
  • N → #btn-clear：清除。
  • V → 切换牌桌浮层（#table-overlay 显示/隐藏）。
• 用浏览器打开 guandan/index.html 也可直接开始一局掼蛋，无需后端（4 个 AI 玩家，纯前端单机）。界面为底部常驻游戏栏，整页即牌桌。

界面布局

• 顶部状态栏：左侧 🌙 切换明暗主题【插件直接跟随DSH设置】；counts 显示各家剩余牌数，turn-info 显示当前轮次提示，game-info 显示关卡/级数信息。
• 手牌区：中央展示你自己的手牌。
• 操作栏：过牌、出牌 两个按钮（非你回合时置灰）。
• 侧边栏按钮：新局（重开整局）、日志（打开/关闭对局日志面板）、取消（清空当前选牌）。

基本出牌

1. 选牌：轮到你时，点击手牌即可选中/取消（被选中的牌会高亮抬起）。
2. 出牌：选好牌后点 出牌。未选牌时点击系统会提示先选牌，消失前再次点击直接过牌。
3. 过牌：点 过牌 表示不跟。注意：你是本轮首家 / 必须出牌时不能过，系统会提示「你是首发，必须出牌」。
4. 取消：点 取消 清空已选中的牌，重新选择。

牌桌浮层（看全局）

• 打开/关闭：在游戏栏空白处（非按钮、非牌）点击一下，即可切换全屏「牌桌浮层」。
• 浮层左侧为组牌列表：系统给出自动组合的牌型方案（单张、对子、三带、顺子、同花顺等）。点击某个方案会自动帮你选中对应的手牌；可多选叠加，再次点击取消。双击时为单选，会先自动取消所有选牌。
• 浮层中间为四家牌桌：队友在上方、上家在左、下家在右、自己在下方，各自显示剩余张数与上一次出的牌。
• 浮层中间的「轮到你出牌」按钮：在你回合时点它，有选牌则出牌、无选牌则过牌；非你回合时用于推进结算。
• 点 关闭 退出浮层。

进贡 / 回贡

每副牌结束后根据胜负进入贡牌阶段，会弹出选牌浮层：

• 需进贡 / 回贡时，从候选牌中点选一张（默认已高亮推荐牌），再点 确定。
• 若持有双王触发抗贡，弹窗提示本局免贡，点 知道了 即可。

本副结束与整局结束

• 一副牌打完弹出结算框，显示本副结果；点 下一副 继续，点 返回/关闭 可稍后从顶部继续。
• 整局结束（级数升到最高 A，或打满设定副数）后，结算框的 下一副 会变为开新局。
• 任何时候点侧边栏 新局 可随时重开整局。

其他

• 日志：点 日志 查看/收起完整的对局过程记录。
• 游戏为单机版，AI 自动出牌，你只需在自己回合操作。同时，轮到你出牌时，AI 会自动选中一个方案，用户确认的话可直接点击出牌。