14 Minesweeper Variants（简称 14mv） 是一款扫雷变体的解谜游戏生成器+游戏服务器(前端项目请使用Minesweeper Variants-Vue)。 支持多种扫雷规则组合，可生成具有唯一解的纸笔类谜题。
本项目要求安装 Python 3.13（推荐）。请从 https://www.python.org 下载并安装对应平台的安装包。
注意：如果你使用虚拟环境（venv/virtualenv）或 Poetry，也可以在虚拟环境中安装本包，推荐在隔离环境中操作以避免与系统包冲突。
使用 pip 安装发布版：
python -m pip install --upgrade pip
python -m pip install minesweepervariants下面给出两种常用的运行方式：启动服务器和运行生成脚本。
启动服务器：
python -m minesweepervariants.server
# 运行后不要关闭, 请在浏览器内打开https://koolshow.github.io/MinesweeperVariants-Vue/运行生成脚本（生成题板/使用命令行工具）：
python -m minesweepervariants你可以在运行生成脚本时附加命令行参数，例如 -s 指定尺寸，-t 指定总雷数，更多参数见下文示例与参数说明。
本项目推荐使用 Poetry 进行依赖管理和环境配置。
Windows 可至 https://www.python.org 下载官方安装包。
请参考官方文档安装 Poetry：https://python-poetry.org/docs/#installation
在项目根目录下执行：
poetry installPoetry 会自动为项目创建隔离的虚拟环境并安装所有依赖。
无需手动激活虚拟环境，直接使用 Poetry 运行项目脚本：
poetry run python run.py [参数列表]其它命令同理，均可用 poetry run <命令> 方式执行。
部分依赖可能需要编译 C 扩展，必须安装：
- Visual C++ Build Tools：
可从以下地址下载安装：
勾选内容包括：
- C++ 生成工具（含 MSVC、Windows SDK）
- CMake
安装完成后请重新启动终端。
run [参数列表]调用主程序，生成谜题。
| 参数 | 类型 | 说明 |
|---|---|---|
-s, --size |
整数（必填） | 谜题尺寸 |
-t, --total |
整数 | 地雷总数 |
-c, --rules |
字符串列表 | 所有规则列表（如 2F 1Q V 1K 1F），会自动分类为左中右线规则 |
-d, --dye |
字符串 | 染色函数名（如 @c） |
-r, --drop-r |
布尔开关 | 是否允许 R 推理 |
-a, --attempts |
整数 | 生成谜题的最大尝试次数 |
-q, --query |
整数 | 生成题板时有几线索推理才会被记录至demo（该选项速度极慢） |
--seed |
整数 | 随机种子（启用后会自动将 --attempts 设置为 1） |
--log-lv |
字符串 | 日志等级，支持 DEBUG、INFO、WARNING 等 |
--board-class |
字符串 | 底层实现的题板 ID，使用默认值即可 |
list |
列出当前所有实现的规则内容 |
run -s 5 -c 2F 1k 1q V -d c -r -q 2生成一道 5×5 题板，棋盘格染色，规则使用 2F、1Q（左线），V、1K（右线） 携带 R 推理，仅记录至少具有 2 条线索推理的题板（写入 demo.txt） 注：规则名大小写不敏感
运行成功后将在 output/ 目录中生成以下文件：
output/
├─ output.png (img 图片默认输出文件)
├─ demo.txt (历史所有可推理解密文本)
├─ demo.png (题目图片)
└─ answer.png (答案图片)
demo.txt 中将包含以下内容：
- 生成时间
- 线索表（仅使用
-q时生效） - 生成用时
- 总雷数：格式为 总雷数 / 总空格
- 种子 / 题号：一串整数数字
- 题板的题目内容
- 题板的答案和无问号时内容
- 题板图片的命令生成指令（以
img开头） - 答案图片的命令生成指令
img [参数列表]调用图像输出子命令。
| 参数 | 类型 | 说明 |
|---|---|---|
-c, --code |
字符串 | 题板字节码，表示固定题板内容 |
-r, --rule-text |
字符串 | 规则字符串（含空格需加引号） |
-s, --size |
整数 | 单元格尺寸 |
-o, --output |
字符串 | 输出文件名（不含后缀） |
-w, --white-base |
布尔开关 | 是否使用白底 |
-b, --board-class |
字符串 | 底层实现的board类,使用默认值即可 |
img -c ... -r "[V]-R*/15-4395498" -o demo -s 100 -w生成图片 底部文字使用[V]-R*/15-4395498 输出保存至output/demo.png 每个格子的大小是100x100像素的 白底的图片
注:
...需要替换为题板的代码值 其内容被保存至output/demo.txt内部
项目包含完整的开发文档，位于 doc/ 目录中：
| 文档 | 说明 |
|---|---|
| README.md | 入口文件 |
| dev/rule_mines.md | 左线规则接口说明 |
| dev/rule_clue_mines.md | 中线规则接口说明 |
| dev/rule_clue.md | 右线规则接口说明 |
| dev/board_api.md | 题板结构与坐标系统 |
| dev/utils.md | 工具模块接口 |