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 框架的浮层上挂载,为等待任务执行提供了消遣功能。结合鲸鱼娘的智能辅助,降低了扫雷游戏的挫败感。源码与构建产物已托管,适合直接集成。