前言¶
在使用 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 倉庫。
