前言¶
在使用 DeepSeek Harness (DSH) 进行 AI 编码或辅助工作时，有时会遇到长时间等待或任务间隙。为了缓解长时间专注带来的疲劳，可以在工作区底部开辟一个迷你面板，将一个独立的“掼蛋”纸牌游戏嵌入其中。该插件无需后端支持，利用浏览器直接运行，适合在等待 AI 生成代码或思考策略时进行娱乐。
插件简介¶
该插件名为 dsh-guandan，由开发者 jansen-66 维护。它是一个 Web 插件包（Cordis 插件），核心功能是将独立的「掼蛋」纸牌游戏作为底部面板嵌入 DSH 界面。插件占用工作区底部布局，点击侧栏底部的按钮即可展开约 96px 高的游戏栏，中间列内容会被向上推挤，不会遮挡左侧栏。
安装与启用¶
插件已同步至 npm，可通过 DSH 官方命令行工具安装。
dsh plugin --profile web add dsh-guandan
安装完成后，重启 DSH 进程。侧栏底部会出现「♥️ 掼蛋游戏」按钮，点击即可启动游戏。如果不使用插件模式，直接用浏览器打开 guandan/index.html 也能开始一局纯前端的掼蛋游戏。
界面布局¶
游戏栏顶部为状态栏：
* 主题切换：左侧 🌙 图标用于切换明暗主题，插件设置会自动跟随 DSH 全局设置。
* 信息显示：counts 显示各家剩余牌数；turn-info 显示当前轮次提示；game-info 显示当前关卡/级数。
中间区域为手牌区，展示玩家的手牌。操作栏包含「过牌」和「出牌」两个按钮（非玩家回合时置灰）。侧边栏按钮包括「新局」（重开整局）、「日志」（查看对局过程）和「取消」（清空当前选牌）。
基本操作¶
插件绑定了键盘控制，主要按键如下：
* 空格：轮到自己时出牌/过牌，牌局结束进入下一副，贡牌时确认。
* C：过牌。
* N：清除当前选牌。
* V：切换牌桌浮层。
出牌步骤：
1. 选牌：轮到你时，点击手牌选中（高亮抬起），再次点击取消。
2. 出牌：选好牌后点击「出牌」。若未选牌直接点击，系统提示先选牌，消失前再次点击则直接过牌。
3. 过牌：点击「过牌」表示不跟。注意，作为首家或必须出牌时无法过牌，系统会提示。
4. 取消：点击「取消」清空已选牌，重新选择。
牌桌浮层与复盘¶
在游戏栏空白处（非按钮、非牌）点击一下，可切换全屏「牌桌浮层」。浮层左侧为组牌列表，系统自动组合单张、对子、顺子等牌型方案，点击方案可自动选中对应手牌，双击为单选。中间区域显示四家牌桌（队友在上，上家左，下家右，自己下），并显示剩余牌数与上一次出的牌。
复盘功能：
插件支持复盘与试打。在复盘模式下，手牌会自动分组并竖排显示，双击列表可进入全盘试打。若牌桌尺寸大于 540px，复盘时手牌会全部竖排显示。通过顶部按钮的「返回」功能，可退回原始复盘状态。
注意事项¶
- 单机运行：游戏为纯前端单机版，AI 自动出牌，玩家只需在回合内操作。
- AI 策略：由于水平限制，AI 策略无法兼顾所有情况，主要定位为娱乐。
- 维护状态：项目后续暂停更新，除非发现明显 BUG。
- 权限与安全：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
结语¶
这是一个利用 DSH 插件生态实现的轻量级娱乐工具，旨在为开发者提供工作间隙的短暂放松。通过嵌入式面板的设计，在不离开 IDE 界面的情况下体验掼蛋游戏。更多细节与源码可查阅项目目录或 GitHub 仓库。
