前言¶
用 DeepSeek Harness（DSH）跑智能體時，主界面通常是側邊欄、會話區和輸入框的組合；等待模型輸出或長任務執行的空檔裏，開發者往往只能盯着進度條。DSH 生態裏不少插件走「趣味換裝」路線，在不動核心工作流的前提下給 Web 殼加一層輕量交互。下面介紹的 dsh-mine-sweeper 就是在會話區左側空白條上懸浮一塊可拖動的掃雷盤，Agent 在跑、你在旁邊點格子，互不搶佈局。
這是什麼¶
dsh-mine-sweeper 是面向 DeepSeek Harness 的掃雷浮層插件：一塊可拖動、可摺疊的棋盤蓋在對話區域左側（側邊欄與會話區之間的空條），不擠佔側欄、會話列表或輸入框。維護者爲 Mailemailezhu，源碼在 GitHub，npm 包名爲 @meng_long/dsh-mine-sweeper（當前資料中版本 0.1.2），許可證 MIT。社區目錄頁：skillhub.cn 插件頁（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。
核心功能¶
資料中明確寫明的行爲如下。
- 自定義盤面：行、列可在 5–30 之間；雷數可在 1 到「行×列−9」之間。
- 首點安全：雷在第一次左鍵之後才佈置，且避開被點格子及其周圍一圈，避免開局即爆。
- 操作：右鍵插旗；
↻在同一盤面尺寸下重開；–摺疊成單個 💣 按鈕，再展開繼續玩。 - 勝負：踩雷會展示全部雷以及插錯的旗；清完所有非雷格即勝。
- 無持久化：狀態只在 React 內存裏，刷新頁面或停止
dsh web後清空。
插件通過 Cordis 註冊到 shell.overlay 列表槽（覆蓋整幀的 overlay 層），入口 id 爲 sweeper，順序 60；用絕對定位浮在該層內，不進入 AppFrame 網格，因此不會把側欄或會話區頂開。宿主側 index.js 爲空殼，邏輯在瀏覽器 bundle client.js 中；cordis.patch.yml 用於以 bundle 形式安裝。
安裝與啓用¶
官方 README 給出的安裝方式如下（勿自行拼接 github:owner/repo 形式）。
dsh plugin add @meng_long/dsh-mine-sweeper
也可從插件市場安裝 npm 包 @meng_long/dsh-mine-sweeper，然後重啓 Web 服務：
dsh web
環境要求（來自 README 與 package.json）：
- DeepSeek Harness：
>= 0.1.5-rc.2且< 0.3.0 - Node.js：
>= 18
peer 依賴包括 @deepseek-ai/cordis（>=4.0.2 <5）與 @deepseek-ai/dsh（與上列 DSH 範圍一致），由 Harness 運行時提供。
典型用法¶
安裝並重啓 dsh web 後，打開 DSH Web 界面即可在會話區左側看到掃雷浮層（資料未描述額外配置文件或 CLI 開關）。
- 在浮層上設置行、列與雷數（落在上述範圍內），開始左鍵開格、右鍵標雷。
- 需要騰地方時拖動浮層；用
–收成 💣 按鈕，不佔視野。 - 同一局想重來點
↻；換頁或停服務則當局作廢。
開發與自測（維護者倉庫內）：
npm run check # 對 index.js、client.js 做 node --check
npm test # bundle 契約 + 遊戲核心冒煙測試
適用場景與注意¶
適合：已在用 DSH Web、希望長等待時有個不干擾佈局的小遊戲；喜歡「一切皆插件」、願意從社區目錄挑趣味類擴展的開發者。
注意：
- 插件隨當前 dsh 進程 在瀏覽器端執行，安裝前應自行查看 源碼 與 MIT 許可證，確認可接受其權限與行爲。
- 不保存進度，不適合當作正式存檔遊戲；DSH 版本需落在 README 聲明的區間內，否則 peer 依賴可能不匹配。
- 分類上社區站點將其標爲 趣味換裝，與改主題類插件同屬輕鬆向，不改變 Agent 能力本身。
結尾¶
dsh-mine-sweeper 把經典掃雷做成 DSH 上的 overlay 插件：佔 overlay 槽、不推佈局，規則與自定義盤面在 README 裏寫得很具體。若要在 Harness 裏試裝，以官方命令 dsh plugin add @meng_long/dsh-mine-sweeper 爲準，併到 目錄頁 或 GitHub 倉庫 覈對更新與 issue。
