🔍 油机 GPS 上线稽核工具 · 工作流程

GPS 超 3 个月未上线清单核查 · 一看就懂版

从 省级发电资源管理系统 导出一张《发电资源详单》Excel → 脚本自动查出 哪些油机超过 1 个月没上线、哪些油机“户口”和“人在哪儿”对不上 → 生成报告、自动发邮件、同步在线表格，全程不用手工核对。

先搞懂一件事：它到底在查什么？

全省几百台油机都装了 GPS，理论上都应该定时“上线报平安”。这个工具就是每天自动点名。

• 📅 点名：还活着吗 —— 最后一次上线时间距今超过 1 个月，就判定为“离线”，列入超期名单。
• 📍 核对：人在哪儿 —— “所属市县”（户口）和“当前市县”（住哪儿）对不上，说明台账可能有错。
• 📊 算账：上线率 —— 算出全省及各市县的 上线率，谁拖后腿一眼看见，还能和上期对比。

🚪 第一步：怎么启动它？（三种姿势任选）

日常最常用的是第 1 种 —— 导出完清单，双击一下就完事。

1. 双击运行 ⭐ 推荐 —— 双击 GPS上线稽核.bat，脚本会自动跑到系统 下载目录，找出文件名带“发电资源详单”、修改时间最新的那个 xlsx 来处理。
2. 拖文件上去 —— 把导出的 Excel 直接拖到 bat 图标上松手，就指定了这个文件来处理。适合清单没放在下载目录、或要用历史清单重跑。
3. 网页上传（远程） —— 双击 启动Web服务.bat，手机或别人电脑打开 http://本机IP:8088，上传清单在线稽核，网页里直接看报告。

🔄 全局数据流：进来什么，出去什么

一张图看懂数据从哪儿来、到哪儿去。

• 📥 输入：《发电资源详单》xlsx（省级发电资源管理系统导出）/ 只读“活动工作表”/ 按表头名称找列
• ⚙️ check_time.py：稽核一：上线率 / 稽核二：超期未上线 / 稽核三：市县核对 / 地图服务定位比对（可选）/ 与上期、各期对比
• 📤 输出：HTML 稽核报告 / 归档 Excel（5 个 sheet）/ 源文件回写 2 个 sheet / 稽核邮件 / 在线协作文档在线表

全程约 1～3 分钟（启用地图服务定位时，每条约 0.7 秒，条数多会慢一些，看到“定位进度 N/总数”是正常现象，不是卡死）。

🧭 第二步：脚本内部跑的 10 个步骤

双击之后黑窗口里刷的那堆字，其实就是下面这 10 步。绿色 = 自动完成，橙色 = 需要你确认，紫色 = 可选功能。

1. 找到清单文件 · 自动

有拖入文件就用拖入的；没有就去下载目录找最新的“发电资源详单”。找不到会提示你改用拖拽方式。

2. 读取清单 · 自动

按 第一行表头名称（当前市县 / 所属市县 / 油机编号 / 监控设备ID / 上线时间）自动定位列号，所以不同版本的清单列顺序变了也不怕。油机编号为空的行直接跳过。

3. 稽核二：挑出超 1 个月未上线的 · 自动

以运行当天为准，上线时间早于 1 个月前 的全部列出，按未上线天数从多到少排序；另外把“压根没有上线时间记录”的也单列出来，交人工确认。

4. 稽核三：挑出市县对不上的 · 自动

逐行比对“所属市县”和“当前市县”。比较时忽略“市/县/自治县”后缀（“示范市” = “示范市”）。所属市县为空的也单独列出。

5. 地图服务定位复核（可选）· 可选

拿经纬度去地图逆地理编码服务，问一句“这个坐标实际属于哪个市县”，再回来和台账比对，判断到底是哪个字段填错了。需要在 geo_config.json 里填 Key 并设 enabled: true；没配就跳过，不影响后面。

6. 稽核一：算上线率 + 各市县排名 · 自动

整体上线率 =（总数 − 超期未上线 − 无上线时间）÷ 总数。再按所属市县统计各市县上线率，从低到高排序，低于全省水平的标红。

7. 归档 Excel + 与上期对比 · 自动

在 归档/ 生成带时间戳的 稽核二_年月日_时分秒.xlsx（不覆盖历史），并和上一期比对：新进超时名单几条、退出几条、净增净减几台。

8. 各期趋势统计 · 自动

扫描全部历史归档，按天去重（同一天多次跑取最后一次），汇总成趋势表：清单总数、上线率、超期数、环比变化。控制台看最近 10 期，归档里存全部。

9. 回写源文件 + 生成 HTML 报告 · 自动

在你导出的那份源 Excel 里新增两个 sheet（超期名单 / 市县不一致），重复运行会先删后建、不会叠加。文件被 Excel 打开占用时回写会失败，但不影响主流程。

10. 预览确认 → 发邮件 → 同步在线表 · 需确认

报告会 自动在浏览器打开 让你先核对；回车 = 发送邮件，输入 n 回车 = 取消发送（报告和归档都还在）。最后自动增量同步到在线协作文档智能表格，供同事在线填写处理情况。

🎯 第三步：三大稽核到底在查啥（通俗版）

编号沿用了历史叫法，看内容就行。

稽核一 · 上线率检测（看整体健康度）

打个比方：统计全班出勤率，顺便排出哪个班最差。

超过 1 个月没上线就算“旷课”。先算全省总上线率，再按所属市县逐个算，从低到高排队，低于全省水平的一律标红提醒。

上线率 =（油机总数 − 超期未上线 − 无上线时间）÷ 油机总数

稽核二 · 超 1 个月未上线（抓具体是哪些台）

打个比方：把旷课超过一个月的同学名字一个个报出来。

按未上线天数从多到少排列，谁最久排最前。附带市县、油机编号、设备ID、经纬度、地图服务链接、定位稽核结论。没上线时间记录的单独列一队交人工确认。

稽核三 · 市县一致性核对（查台账填错没）

打个比方：户口所在地 vs 现居住地，对不上就得查查是哪个填错了。

“所属市县”（G 列）和“当前市县”（A 列）不一致的行全部列出，忽略“市/县/自治县”后缀差异。所属市县为空的单独列出，需要人工补录。

📍 选配：地图服务定位稽核，颜色怎么看

同一行会按“GPS 实际定位到的市县”和台账两个字段比对，用底色告诉你该改哪个。

💡 成本提示： 地图逆地理编码服务免费额度 5000 次/天，QPS 3，日常完全够用。但启用后每次运行会把命中油机的经纬度发给地图服务公开接口，介意的话保持 enabled: false 即可。

📦 第四步：跑完能得到什么

五个产物，各有用处，一个都不会少。

• 📄 HTML 稽核报告 —— GPS稽核报告_最新.html（固定名，方便双击）+ 归档/ 里带时间戳的完整版。含汇总卡片、各市县表、趋势图、本省分布地图。
• 📊 归档 Excel（5 个 sheet） —— 全部源数据 / 各市县上线率 / 超 1 个月未上线 / 市县不一致 / 历史趋势。按颜色标好状态，是下期对比的基准。
• 📧 稽核邮件 —— 主题直接写清“超期 N 台，较上期 ±N 台”。正文是静态报告（客户端可见），附件是完整交互版 HTML + 归档 Excel。
• ☁️ 在线协作文档在线跟踪表 —— 自动增量同步：新条目追加、已恢复的移入「历史归档」、存量只更新脚本字段（人工填写的内容不会被覆盖）。
• 🔁 源文件回写 2 个 sheet —— 在你导出的原 Excel 里加 稽核二_超1个月未上线 和 稽核三_市县不一致，带着地图服务链接，方便直接分发给市县。
• 📝 运行日志 —— check_time.log 记录每次运行的完整输出，出错时第一时间看它。

🗂️ 文件地图：哪个文件是干嘛的

只记加粗那几个就够了，其余不用管。

⚠️ 踩过的坑，提前避开

• 只在“活动工作表”读数据。 导出后别在文件里乱加 sheet 并把它设为默认打开的那个，否则读不到数据。
• 运行中别在黑窗口里拖选文字，会冻结程序。不小心点了按 Esc 解冻。
• 源文件别开着。 Excel 正打开那份清单时回写会失败并提示，其余流程照常走完。
• 看到“定位进度 N/总数”别慌，那是在逐条问地图服务，每条约 0.7 秒，慢慢等它走完。
• 邮件报 454 认证失败 = 企业邮箱 SMTP 授权码过期了，重新生成一个填进 email_config.json。
• 什么都跑不起来先看 check_time.log。常见原因：Python 没加 PATH、没装 openpyxl、文件被占用。

油机 GPS 上线稽核工具 · 工作流程说明 ｜ 适用于《发电资源详单》稽核场景
详细说明见同目录 README.md