想自由

## 一、业务功能 ### 1. 立项背景与目标 游戏/模拟器场景存在大量重复性、节奏性、高频率的界面操作，人工执行反应慢、易疲劳、难一致。本项目目标是落地一条完整视觉自动化链路：**全屏截帧 → 图像识别 → 判定 → 自动化响应**，并解决高 DPI 坐标偏移、颜色漂移、抖动误判等真实精度问题，以「第五人格·作曲家」修机节奏场景作为可视化示例。 ### 2. 核心功能与模块 视觉采集 mss 全屏毫秒级截帧，60fps 不卡顿 目标识别 OpenCV HSV 颜色空间检测，亮度无关抗明暗变化 采样判定 带状区域双窗口统计像素数，抗抗锯齿/抖动 响应触发 跨进程键鼠模拟，220ms 冷却防重复 配置持久化 JSON 落盘，坐标/阈值跨会话复用 手动标注 鼠标点击 3 点完成校准，含坐标校验 诊断调参 峰值检测 + 连拍留痕，调参数据化 运行控制 热键状态机：1启 2停 3标 4退 5诊 6拍 ### 3. 业务流程路径 **首次校准**：启动 → 进入画面 → 按 3 → 依次点击判定线/红轨道/蓝轨道 → 自动校验并保存 JSON。 **日常运行**：按 1 启用 → 200Hz 抓帧 → HSV 采样 → 超阈值且冷却超时 → 模拟按键，触发瞬间自动截图留痕。 **异常排查**：按 5 诊断报告红/蓝峰值 → 判断坐标/阈值问题 → 按 6 连拍离线调参。

### 1. 立项背景与目标 电竞数据分散在官网、Wiki 等多个站点，人工整理耗时且易错。本项目目标是打造一个**合规的赛事数据聚合分析工具**：自动抓取第五人格 IVL 职业联赛公开赛事数据 → 清洗结构化 → 统计分析 → 可视化图表与交互式报告，让"查战绩、看排行、做对比"从手工抄表变成一条命令。 ### 2. 软件核心功能与模块 采集层 直连官方赛事接口（JS 逆向抓包），限速 + UA 伪装 + 超时 + 指数退避重试 解析层 官方 JSON / wiki 快照双源解析，字段清洗与类型兜底 分析层 胜率、胜负差、赛季概览、领跑战队 可视化层 胜率排行图、净胜局对比图、胜率×净胜局散点（中文渲染，红高绿低） 报告层 HTML 交互式报告：概览卡片 + 可排序表格 + 内嵌图表，单文件分发 存储层 JSON / CSV / Excel 三格式导出，utf-8-sig 兼容 Excel 质量保障 pytest 20 用例全覆盖 + GitHub Actions CI（3 个 Python 版本矩阵） 交互层 all / report / team / compare / menu 子命令 + 交互菜单 ### 3. 业务流程功能路径 ``` 【一条命令】python main.py all 官方接口抓取 → 解析 10 支战队 → 胜率/净胜局分析 → 生成 3 张图表 + HTML 报告 → 导出 JSON/CSV/Excel 【日常查询】python main.py menu（交互菜单） 1报表 2查队 3对比 4图表 5导出 6刷新 7退出 team ACT / compare FPX GR 支持模糊匹配 【离线兜底】main.py all --sample（内置样例数据，无网也能完整演示） ```