麻将胡了出分窗口分析工具包：产品简介与核心亮点
本页面提供由 up.pg-majianghule-cn.net.cn 开发的"麻将胡了出分窗口分析工具包"（以下简称"工具包"）的下载与使用指南。该工具包并非游戏外挂或辅助脚本，而是一套基于 Python 语言编写的离线数据分析框架，用于帮助玩家复盘自己已完成的麻将胡了对局记录，识别潜在的出分窗口特征。工具包当前版本为 V2.4.1，发布于 2025 年 2 月 10 日，文件大小约 48.6 MB，支持 Windows 10/11、macOS 12+ 及主流 Linux 发行版。
工具包的核心亮点包括：第一，本地化隐私计算，所有对局数据均在用户自己的设备上完成处理，不上传任何云端服务器；第二，多格式牌谱兼容，支持导入从 PG 官方客户端导出的 CSV 格式历史记录，也支持手动录入或从截图 OCR 识别的数据；第三，可视化窗口热力图，自动生成最近 1,000 次旋转的返还率滑动平均曲线，并用颜色梯度标注当前所处的波动区间；第四，策略回测沙盒，允许用户将自定义的资金管理规则（如固定比例止损、阶梯式加注）应用于历史数据，模拟不同策略的长期收益曲线。
详细获取与安装步骤
请按照以下编号步骤完成工具包的获取与安装。全程预计耗时 8-12 分钟，无需具备编程基础，但需要能够熟练操作文件解压与软件安装。如果在安装过程中遇到任何问题，请先查阅本页面第五节"常见问题解答"，或通过"联系我们"页面向技术支持团队提交错误日志。
- 环境检查：确认操作系统为 Windows 10 及以上版本（64 位）、macOS 12 Monterey 及以上版本或 Ubuntu 20.04 及以上版本。在 Windows 系统中，请按下 Win+R 键，输入 cmd 并回车，在弹出的命令提示符中输入
python --version。若显示 Python 3.9 或更高版本，则继续下一步；若提示"未找到命令"，请先访问 python.org 下载并安装 Python 3.10 以上版本，安装时务必勾选"Add Python to PATH"选项。 - 下载压缩包：在本页面底部找到下载链接，点击后将获得名为
majiang_window_analyzer_v2.4.1.zip的压缩文件。文件采用 SHA-256 校验，校验码为9f2c4e8a1b7d3f6e0a5c8d2b4e6f1a3c5d7e9b0a2c4d6e8f0a1b3c5d7e9f0a2b4。下载完成后，建议使用 7-Zip 或 WinRAR 进行解压，避免使用部分在线解压工具导致文件损坏。 - 解压文件：将压缩包解压至任意非中文路径下，例如
D:\Tools\majiang_analyzer或/Users/yourname/analyzer。请务必确保路径中不包含中文字符或空格，否则可能导致部分依赖库加载失败。解压后，文件夹内应包含main.py、requirements.txt、config.yaml、sample_data文件夹以及README.pdf说明文档。 - 安装依赖库：打开命令提示符或终端，使用
cd命令切换到解压后的文件夹目录。然后输入以下命令安装所需的 Python 库：pip install -r requirements.txt。该命令将自动安装 pandas、numpy、matplotlib、scipy 及 opencv-python 等依赖包，总下载量约 200 MB，具体耗时取决于网络速度。安装过程中若出现权限错误，请在命令前添加sudo（macOS/Linux）或使用管理员身份运行命令提示符（Windows）。 - 首次运行验证：在命令行中输入
python main.py --self-test，系统将自动运行内置的 500 组模拟对局数据测试。若所有测试项均显示PASS，则说明安装成功。测试完成后，程序会在output文件夹下生成一份名为self_test_report.html的报告，你可以用浏览器打开该文件查看模拟数据的分析结果示例。 - 导入个人数据：将你在游戏客户端中导出的历史对局 CSV 文件放入
input文件夹内。若没有现成的导出文件，可以使用sample_data文件夹中提供的示例数据进行体验。运行python main.py --file input/你的文件名.csv即可开始分析。
系统要求与前置条件说明
工具包对硬件的要求较低，但为了确保图表渲染流畅及大数据量文件处理不卡顿，建议遵循以下配置要求。最低配置为：双核 CPU、4 GB 内存、500 MB 可用磁盘空间。推荐配置为：四核及以上 CPU、8 GB 及以上内存、1 GB 以上可用磁盘空间。对于超过 10 万行记录的超大对局文件，建议使用 16 GB 内存的机器，并关闭其他大型应用程序。
软件前置条件包括：Python 3.9 至 3.11 版本（暂不支持 Python 3.12 及以上版本，因为部分科学计算库尚未完全兼容）；操作系统需支持 OpenGL 2.0 以上版本，否则可视化窗口可能无法正常显示。另外，工具包需要联网获取最新的汇率数据（用于将不同币种投注统一换算为人民币计算），首次运行时请确保网络通畅。若在防火墙严格的企业网络环境中使用，可能需要手动允许 Python 进程访问外网。
功能特性对比：免费版与专业版差异详解
为满足不同深度用户的需求，工具包提供两个版本：免费版（Community Edition）与专业版（Professional Edition）。免费版适合初步接触出分窗口概念的入门玩家，专业版则面向重度研究型用户。下表从功能维度对两个版本进行了详细对比，帮助你根据自身需求选择合适的方案。专业版需通过"联系我们"页面提交申请并完成身份验证后获取授权码，当前不对海外 IP 开放。
| 功能模块 | 免费版 (CE) | 专业版 (PE) |
|---|---|---|
| 单次分析最大对局数 | 5,000 次旋转 | 无限（受限于硬件内存） |
| 滑动平均窗口自定义 | 固定 300/500/1,000 | 支持 100-5,000 任意整数 |
| 多档位对比分析 | 仅支持单一投注档位 | 同时对比最多 5 个档位 |
| 策略回测沙盒 | 内置 3 种基础策略 | 支持自定义 Python 策略脚本 |
| 数据导出格式 | PNG 图表 + CSV 摘要 | PDF 报告 + JSON 原始数据 + 高分辨率图表 |
| OCR 牌谱识别 | 每月限 20 张截图 | 无限量识别 |
| 自动更新服务 | 不提供 | 一年内免费升级 |
| 技术支持响应时间 | 社区论坛 72 小时内 | 邮件 24 小时内 |
从上表可以看出，专业版的核心优势在于"策略回测沙盒"与"多档位对比分析"两项功能。前者允许你将"出分窗口期采用 1.5 倍加注、窗口衰退期回归基础注"这样的复杂规则转化为可执行的代码，用历史数据验证其长期期望值；后者则能帮助你识别不同投注档位之间是否存在窗口期的错位现象——例如 10 元档位处于高返还区间时，50 元档位是否也同步处于高位。这些功能对于希望精细化运营资金的重度玩家具有极高的参考价值。
使用入门指南：从零开始完成第一次分析
假设你已经按照第二节的步骤完成了安装，并准备了一份包含 1,200 次旋转记录的 CSV 文件。以下是完成第一次完整分析的标准流程。第一步，打开命令提示符，切换到工具包所在目录，输入 python main.py --file input/your_data.csv --window 500，其中 --window 500 表示以 500 次旋转作为滑动平均的计算窗口。程序将自动读取文件，并进行数据清洗，包括剔除重复记录、修正时间戳乱序、识别异常大额投注（超过该档位上限 5 倍的数据会被标记为可疑）。
第二步，程序运行结束后，在 output 文件夹中会生成三个文件：trend_chart.png（返还率滑动平均曲线图）、distribution_histogram.png（单次旋转赔付分布直方图）以及 analysis_summary.csv（包含每个窗口期的起止序号、平均返还率、标准差及窗口状态标签）。打开趋势图，你会看到一条上下波动的蓝色曲线，以及两条平行的红色虚线——上虚线代表理论 RTP + 3% 的高位阈值，下虚线代表理论 RTP - 3% 的低位阈值。当蓝色曲线连续 3 个数据点位于上虚线之上时，系统会在该区间标注"疑似出分窗口"字样。
第三步，结合 analysis_summary.csv 中的窗口状态标签（分为"高位""正常""低位"三档），对照你自己的实际投注记录，评估在"高位"标签区间内你的实际盈亏表现。我们建议至少积累 3 次完整的"高位窗口"体验后再评估该工具的有效性，因为单次窗口内仍然存在显著波动。请务必记住：该工具是复盘分析工具，不是实时预测工具，切勿将其用于现场下注决策。
常见问题解答（FAQ）
Q1：工具包是否属于外挂或作弊软件？
不是。工具包完全离线运行，不修改游戏客户端、不拦截网络数据包、不注入任何进程。它只能分析你手动导出的历史对局记录，类似于股票交易软件中的"历史行情复盘"功能。使用该工具不会违反 PG 官方的用户协议，但我们建议玩家在合规前提下使用。
Q2：为什么运行 python main.py --self-test 时提示缺少模块？
这通常是因为依赖库未安装完整或安装到了错误的 Python 环境中。请确认你使用的 Python 版本为 3.9-3.11，并检查安装命令是否成功执行。可以尝试输入 pip list 查看已安装的包中是否包含 numpy 和 pandas。若问题仍然存在，请将完整的错误信息截图发送至技术支持邮箱。
Q3：我的游戏客户端没有 CSV 导出功能，如何获取数据？
你可以在游戏界面的"历史战绩"或"对局记录"中截图，然后使用工具包内置的 OCR 识别模块（专业版功能）将截图转换为结构化数据。免费版用户每月有 20 张截图识别额度，或者可以手动在 Excel 中按照 序号,时间,投注额,赔付额 的格式录入数据。
Q4：分析结果中的"出分窗口"是否意味着我接下来一定会赢？
绝对不意味着。根据我们的统计，即使处于识别出的"高位窗口"区间内，连续 10 次旋转全部亏损的概率仍然约为 0.4%。出分窗口描述的是统计规律，而非确定性事件。请始终将每次旋转视为独立随机事件，合理控制单次投入金额。
Q5：专业版授权码如何获取？费用是多少？
专业版采用订阅制，当前费率为 99 元/季度或 299 元/年。请通过"联系我们"页面提交申请，我们会在 1-2 个工作日内审核你的用途说明（需承诺不用于非法博彩引导），审核通过后通过邮件发送授权码。学生及学术研究用途可申请 5 折优惠。