DeepSeek Harness (DSH) 提供了插件化擴展機制,允許開發者掛載自定義浮層。在等待 Agent 執行任務時,有時會出現空窗期。本插件利用 DSH 的 shell.overlay 掛載點,在界面中集成了一個掃雷小遊戲,並附帶鯨魚娘輔助功能,用於輔助玩家決策。
核心功能¶
掃雷本體
* 難度設置:支持三種預設難度(初級 9×9、中級 16×16、高級 16×30),並支持自定義難度。
* 安全機制:首次點擊安全,雷不會出現在第一格及其周圍 8 格。
* 操作自定義:支持自由鍵位綁定(翻開/標記/快速翻開),可在設置面板(⚙️)中配置。
* UI 信息:顯示剩餘雷數、計時器、狀態表情(😊/😵/😎)、重新開始按鈕。
* 窗口交互:窗口可拖動、可自適應左右展開氣泡,不遮擋對話。
鯨魚娘幫選
* 隨機選:鯨魚娘隨機選定一格,優先從最小對等組隨機,無對等組時從全部未知格隨機。選中後有紅圈標記。
* 安全格:利用完備約束求解器(規則傳播 + 回溯枚舉)推出一個確定安全的格子,提示「這裏不是雷」。若推不出則提示「推不出安全格」。
* 反饋機制:根據玩家選擇與結果,鯨魚娘給出不同反應(聽勸+安全/通關、聽勸+炸了、不聽+炸了、不聽+安全)。
安裝¶
本倉庫是一個標準的 DSH 樹外插件(bundle)包,依賴 Node.js 和 pnpm。
前置條件
* Node.js(≥18)
* pnpm(需在 PATH 上)
安裝命令
通過 npm 方式安裝:
npx @deepseek-ai/dsh plugin --profile web add github:snanjib/DSH-minesweeper
若使用本地路徑,將 github:... 替換爲本地目錄。
生效
安裝完成後,需重啓 DSH(Web GUI)或新開一個會話(CLI)以使插件生效。
使用說明¶
- 掛載點:
shell.overlay,ID 爲minesweeper,順序爲1000。 - 操作:在 DSH 界面中,該浮層會常駐顯示。點擊窗口可拖動,點擊空白處或特定按鈕可操作遊戲。
- 配置:打開設置面板(⚙️)可綁定翻轉、標記、快速翻開三個動作的鍵位。
技術細節¶
- 純客戶端:Node 半區爲空
apply,瀏覽器半區通過dsh.client聲明platform: web。 - 無構建需求:倉庫已提交構建產物
lib/client.js,從 git 安裝後無需額外構建。 - 依賴:使用 DSH 的
timer服務和slots服務。
結語¶
該插件通過在 DSH 框架的浮層上掛載,爲等待任務執行提供了消遣功能。結合鯨魚孃的智能輔助,降低了掃雷遊戲的挫敗感。源碼與構建產物已託管,適合直接集成。