dsh-guandan

Readme

## 项目概述

这是一个 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 会自动选中一个方案，用户确认的话可直接点击`出牌`。