# 骑手考核跟进系统 · 正常最终版

适用城市：赣县、万载、定南、湖口。适用电脑：Windows / Mac。

**这一版不需要扩展或油猴，不需要另外安装 Node.js，不需要输入命令。**
程序打开专用采集浏览器窗口，优先系统 Chrome，启动失败时回退系统 Edge。请在这个窗口登录美团，不能直接沿用日常浏览器登录态。

## 一、管理员发什么

直接把下载网址发给城市负责人：https://kaohe-download.qinxin.xin/ 。负责人选择“本城市 + 本电脑系统”的 ZIP，并先阅读下载页的使用说明。

**每个城市只选一台固定电脑作为采集服务机。其他同事不必安装系统，也不必登录美团，只需打开这台电脑的局域网看板。**不同城市分别使用各自的服务机和账号，不能混用数据。

| 城市 | 文件名中的城市 | 已预填 BI 组织编号 | 注意 |
|---|---|---|---|
| 赣县 | 赣县 | 9610 | 已真实接口确认 |
| 万载 | 万载 | 9282 | 已真实接口确认 |
| 湖口 | 湖口 | 2000102 | 软件内显示九江是正确的，悦跑关闭 |
| 定南 | 定南 | 2015707 | 沿用既有默认，需有定南权限的账号 |

- Windows 电脑发 Windows ZIP，自动匹配 Intel/AMD x64 或 ARM64。
- Mac 电脑发 Mac ZIP，自动匹配 Apple 芯片或 Intel。
- 不发整个项目、不发其他城市的 data、不发旧扩展包或油猴脚本。
- 使用上述下载站的当前版本包；不要混发旧包、其他城市包或仅含源码的轻量包。
- 每个城市先选一台电脑试运行并核对人数，再安排日常使用。

## 二、首次安装

### 第1步：检查电脑

- 推荐 Windows 11+、macOS 14+；Windows 7 不支持，旧系统不作兼容保证。
- 正常安装至少一种系统浏览器：Google Chrome 或 Microsoft Edge，不安装 Chromium for Testing。
- 网络可访问美团，日期时间准确，时区为北京时间。

### 第2步：完整解压

把 ZIP 完整解压到固定位置，例如 Windows 的 D:\考核系统。不要直接在压缩包内运行，不要只拖出启动脚本，也不要移动 runtime、node_modules、src、web 等文件夹。

### 第3步：双击启动

- Windows：双击解压文件夹根目录“启动考核系统.bat”。
- Mac：双击根目录“启动考核系统.command”。

会出现启动窗口，约5秒后打开看板 http://localhost:8791 ，随后打开采集浏览器。启动窗口保留，可以最小化。

Node.js LTS 和依赖已在包内，不需要另装 Node.js，不执行 npm install。已经运行时只打开网页，不重复启动另一份。重复启动检测到端口占用时会直接结束，不再打开采集浏览器。

### 第4步：在采集窗口登录

用本城市有权限的账号，按页面提示依次完成烽火台、阅数/BI 登录；跳转统一登录页时也需完成登录。

不要只在平时浏览器登录。这一版登录态保存在本程序 data/bi-profile 内。不要让多台电脑持续采集同一账号，避免互相挤下线。

### 第5步：验收

等一两分钟，在看板确认：

- 城市正确；湖口显示九江，不要改回湖口。
- 顶栏显示采集在线，最后采集时间更新。
- 骑手名单和注册人数与本城实际大致相符，不是其他城市数据。
- 注册数默认自动识别，不要无故手填覆盖。

首次验收建议截图给管理员。出现“组织架构权限校验不通过”，截图核对账号权限和编号；不要把排班站点ID填进BI组织编号，也不要导入别城配置。

## 三、每天如何使用

1. 开机、联网，双击启动脚本一次，保持启动窗口和采集窗口运行，电脑不要休眠。
2. 打开 http://localhost:8791 。看板约60秒刷新，自动采集约15分钟一轮。
3. 要立即更新点“一键刷”；出现“已有采集在进行”就等待，不连续点击。
4. 在骑手表“预估”下拉选择人工判断。每天默认全部有效/达标，**预计侧不是系统自动预测**；当天刷新和采集不会覆盖人工填写。
5. “未达成预估”表示实际系统分类不等于填写预估；点骑手行展开明细，点备注列记录跟进。
6. 顶部导出加盟/悦跑CSV；选历史日期后导出对应历史数据。

悦跑姓名下方直接显示完成状态：绿色“已完成”、红色“未完成”，待到岗/未出动另行标记。可点“已完成”“未完成”筛选实际完成情况，不要把“预计达标”当成已经完成。单量、时长进度条各自达标会变绿，但只有全部已选班次也达标，才算实际完成。

### 暂停与恢复

暂停阻止后续自动采集和一键刷，不强行中断已开始的一轮，不退出浏览器；推送和定局照常。恢复后按调度继续，要马上更新就点“一键刷”。

### 定局和企微推送

- 默认时刻：14:10、17:10、20:10、23:55。
- **未填写企微机器人 webhook 时，不会发群消息。**需要推送，由当地负责人在设置页填写本城市群的机器人地址并保存。
- 23:55 是定局推送时刻；次日00:10生成历史归档。建议电脑开到归档完成。
- 关机期间不会采到新数据；开机可用已有原始数据补归档，但不能补回关机期间的采集。

## 四、每城一台电脑，局域网多人共用

每城固定一台电脑采集。其他同事优先共用这台电脑的局域网看板，不必每人安装程序。

1. 在采集服务机打开 http://localhost:8791/settings ，找到“局域网共用（白/晚班多机同看同操作）”。
2. 勾选“允许局域网访问”，建议填写访问口令，点“保存设置”。若这次修改了局域网开关，正常停止并重新启动服务，监听范围变更才生效。
3. 回到设置页，看“本机面板地址”。这里会显示“其他电脑浏览器打开”的完整网址，例如 `http://192.168.1.100:8791`。这是示例，不是所有城市通用的地址。
4. 将该城市服务机显示的网址发给同事。同一局域网的手机、电脑直接用浏览器打开，填写设置过的访问口令即可；同一网络中的有线电脑也可访问，前提是网络允许设备互通。
5. 其他同事不再安装、不再启动第二份采集程序。所有人共用同一份骑手数据、预估和备注；一人保存后，其他人的页面随刷新同步。

### 三种网址不要混淆

| 网址 | 谁使用 | 作用 |
|---|---|---|
| https://kaohe-download.qinxin.xin/ | 各城市负责人 | 下载安装包、阅读说明；不是骑手数据看板 |
| http://localhost:8791 | 采集服务机本身 | 本机看板；localhost 指向当前访问设备自己 |
| 设置页显示的 `http://本机IP:8791` | 同一局域网的同事 | 共用该城市看板，端口默认为8791 |

**不能把 localhost 的网址发给其他电脑。**同事应使用服务机显示的局域网网址，也不能照抄别城 IP。

### 同步频率与服务机要求

- 看板默认约60秒自动刷新，采集默认约15分钟一轮，可在设置中调整。大家看到的是同一份“最近一次采集成功”的数据，不是平台实时秒级数据；以顶部最后成功时间为准。
- 需要立即拉新数据，由负责人点“一键刷”；已经在采集中就等待。只刷新网页不会代替采集。
- 服务机必须开机、联网、不休眠，启动窗口和采集浏览器保持运行。锁屏后若电脑进入休眠，采集和局域网访问都会受影响。
- 服务机关闭、服务退出、休眠或断网后，其他人无法继续获取新数据。网页可能还留着旧盘面，不代表仍在采集。
- 换网络或路由器重新分配地址后，IP可能变化，需在设置页重新查看；建议请网络管理员为服务机固定局域网IP。
- 无法打开时，先确认是同一局域网、没有访客WiFi／设备隔离，再由负责人检查防火墙是否允许本程序在专用网络访问8791。不要关闭全局防火墙，也不要将8791映射到公网。

### 白晚班交班

白晚班换人、不换采集电脑：共用网页即可。
真正换电脑：旧机导出交接包，新机导入，在新机采集窗口登录；旧机停止采集，避免账号互踢。交接包含配置和业务数据，不发公开群。

## 五、常见问题

| 现象 | 处理 |
|---|---|
| 页面打不开 | 确认启动窗口未关闭，地址是 http://localhost:8791 ，查看启动窗口错误 |
| 本机能打开，同事打不开 | 同事不要用localhost；核对服务机设置页的局域网网址、局域网开关是否重启生效、网络隔离及防火墙 |
| 各人数据不一致 | 核对是否打开同一台服务机的同一个网址，是否误开历史日期；刷新并检查最后采集成功时间 |
| 端口8791被占用 | 检查是否已启动过；已有服务直接打开网页，不开第二份 |
| 登录过期 | 在专用采集窗口重新登录，随后点“一键刷”并核对采集时间 |
| 没有Chrome但有Edge | Chrome启动失败后会尝试Edge；不需要我们的扩展 |
| 空白、渲染异常或采集失败 | 保留现场，截图启动日志和浏览器地址发管理员，不删data反复重装 |
| 无权限组织值 | 核对本城账号权限与BI编号；定南账号必须有定南权限 |
| Mac拦截启动脚本 | 确认来源可信后查看系统“隐私与安全”中的提示或联系管理员，不关闭全局安全设置 |
| 有数据但没有群消息 | 检查推送开关、本城webhook和推送时刻 |

采集窗口可最小化，但不要主动关闭；看板页面可以随时关闭再打开。
系统会复用已有烽火台和BI工作页，启动空白页会用于打开业务页面；不应持续新增空白页。如果采集窗口被关闭，后续采集会尝试恢复，因此不要反复关闭它。
普通日常操作不用命令行。管理员如需 npm run login，必须先结束服务，登录完成再启动；仅点暂停不会释放浏览器目录锁。

## 六、数据与更新

- 数据在程序目录的 data。备份时先正常停止服务，再完整复制 data。
- 新城市使用空白新包，不导入别城data或交接包。
- 扩展、油猴方案另行保留，本版不安装、不启用，等待后续通知。

### 后续自动更新：不用删除旧版

1. 在采集服务机打开设置页顶部“程序更新”。当前新包已预填官方更新地址，默认开启自动更新。
2. 服务运行时约每小时检查一次；发现新版后下载、验签，等待当前采集／推送结束，再切换新版并重启。页面可能短暂断连，采集窗口可能重开。
3. **不用删除旧版本，不用每次重新下载完整ZIP，不用重新搬data。**本机配置、登录态、备注、人工预估保持原样；新版启动失败会回退。
4. 同事共用同一台服务机，所以只更新服务机。其他电脑、手机不需要升级安装包，更新后刷新网页即可使用新版。
5. 旧程序保留用于回退。不要手动删除 `.updates`、`data`，也不要自行覆盖运行时或依赖目录；历史程序清理由管理员在确认后处理。

也可点“检查更新”“安装更新”，或关闭自动更新开关。只有采集服务机使用 http://localhost:8791/settings 能操作更新；局域网设备仅查看版本。更新设置单独保存，不随城市设置或交接包迁移。关闭电脑或退出服务时不能检查更新，下次启动后再检查。

出现“尚未配置”或“更新失败”时，把更新状态截图发管理员；不要填写陌生下载源，也不要删data重装。需要更换运行时／依赖的版本由管理员发完整包，按下方步骤保留数据。

### 不支持自动更新的老包：首次迁移一次

1. 正常关闭旧服务，确认旧采集浏览器已退出；先备份旧目录整个 `data`。
2. 从下载站选择本城市和Windows／Mac的新包，完整解压到一个新目录。
3. 把旧目录整个 `data` 复制到新目录，替换新包内的默认data。不要反过来用新包默认data覆盖旧数据。
4. 只启动新目录的脚本，核对城市、采集时间、备注和人工预估；旧目录保留备份，不再同时启动。
5. 首次迁移完成后，正常后续版本走自动更新。无需每次删除旧版或搬data。

版本：使用说明更新于2026-10-17。Windows/Edge仍需当地首次启动验收；定南沿用2015707。