Pi 数据采集端 0.1.5 · Windows x64 联网测试版

一、第一次使用
1. 在 Windows 10 / 11 的 64 位电脑上，完整解压运行包到普通文件夹。
2. 双击 PiCollector.exe。不要只复制 EXE，旁边的 DLL 和 models 文件夹也需要保留。
3. 可点击“安装到本机”，将软件复制到当前用户的 Programs 目录并建立桌面快捷方式。
   安装后，从右下角托盘退出当前程序，再通过桌面“Pi 数据采集”快捷方式启动。
   也可以直接在解压目录运行。无需安装 Python 或 .NET。
   如果采集提示“识别引擎所需运行库未加载”，请运行 prerequisites 文件夹内微软官方的 VC_redist.x64.exe，完成安装后重开程序。
4. 只需设置电脑编号，例如 A01，然后保存。无需填写电脑名称。
5. 在 Pi Desktop 中登录 Pi App，并停留在包含右侧绿色闪电的首页。
6. 点击“立即采集”。采集端会暂时隐藏，操作 Pi Desktop。期间请不要操作鼠标或切换窗口。
7. 采集完成后查看结果。确认昵称和“节点奖励”均与 Pi 页面一致，再开启定时采集。

二、采集内容
- 电脑编号、稳定的本机设备标识。
- 左上角 ≡ 菜单页顶部的昵称，不是下面的 @用户名。
- 首页右侧绿色闪电 → 奖励详情 → 向下查找“节点奖励”对应数字。
- 计划采集时间、实际开始及完成时间、成功或失败状态、失败原因。
- 不读取密码、钱包、助记词；不点击增加奖励等业务按钮。
- 前后复核昵称与账号位置，奖励连续读取两次一致后才记为成功。

三、自动采集
勾选“每天自动采集”并保存，固定每天北京时间 06:00、12:00、18:00、23:50 启动。
需要开机自动运行时，勾选“登录 Windows 后自动启动”并保存。
点击窗口右上角关闭按钮会收起到托盘，程序继续运行；真正退出请右键托盘 → 退出采集端。
Windows 必须已经登录、未锁屏且未休眠，Pi Desktop 需保持登录；软件会尝试恢复最小化窗口。
定时开始时间固定，识别和翻页会花费一段时间，实际完成时间另外记录。
在计划时间后 15 分钟内恢复运行，会按原计划启动并保留实际开始时间；超过 15 分钟只记“错过采集”。
不会用现在的数值冒充过去的数值，也不会在失败时写入 0。
已完成或已失败的定时记录不会在同一时段重复运行；需要重试时使用“立即采集”，另存一条手动记录。
按 Esc 可取消当前采集；也可以右键托盘选择“停止当前采集”。

四、按钮位置不对时
先把 Pi Desktop 窗口完整放在屏幕里，窗口至少 700×600。
每次先点击左侧 Pi App，再自动寻找菜单与绿色闪电；建议展开左侧栏；如果当前分辨率或软件版本不适配，点击“按钮校准”。
手动切到对应页面，分别在截图上选择：
1. 左侧 Pi App 按钮（收起侧栏时为手机图标）中心。
2. 首页左上角 ≡ 菜单中心。
3. 昵称菜单页左上角 ← 返回按钮中心。
4. 首页右侧绿色闪电中心。
四项都校准并保存，再回到首页点击“立即采集”。
如果改变了窗口布局或分辨率，可能需要重新校准；也可以“恢复自动定位”。
暂不支持 Pi 软件其他语言或大幅改变后的布局；当前针对提供的简体中文 / 英文混合界面。

五、查看和保存数据
主界面显示最近 300 条记录。双击一行查看计划时间、实际时间和失败详情。
“导出 CSV”会导出全部记录，可以用 Excel / WPS 打开。
“数据目录”打开 %LOCALAPPDATA%\PiCollector
  config.json：这台电脑的编号、定时与校准设置。
  records\：每次采集的独立 JSON 记录，失败记录也会保留。
电脑编号变更不会修改旧记录的历史快照。
把运行包分发到其他电脑时，不要把这份数据目录一并复制；每台电脑会生成独立设备标识。
原始截图只用于内存中的识别与校准，默认不保存、不上传。

六、姓名与服务器同步
- 有空格的中文姓名自动调整，例如「建平 林」→「林建平」。英文姓名与电话号码保持原顺序。
- 选中成功记录，点击「修改姓名 / 电话」。所有姓名类型均可修改；保留原始识别值。
- 修改规则只对同一账号、同一原始姓名生效，切换账号后不会套用旧姓名。无空格中文不猜测姓氏。
- 点击「服务器设置」，地址填写 https://pi.ai1029.com，从管理员后台「接入设置」复制设备接入码，连接一次即可。
- 成功、失败、错过采集均上报；断网记录保留本地，恢复后自动补传。修改名字后会重新同步该记录。
- 后台可查看设备最新情况、按一天/近7天/起止日期筛选、同名标记及失败原因，并给员工分配设备查看权限。
- server.json 保存本机设备连接凭据，请勿随运行包复制给其他电脑；后台接入码只交给需要接入的电脑。
- 尚未在真实 Windows 电脑验证完整点击、滚动、托盘、自启动和定时触发，请先测试单台电脑。
- 本版未做代码签名。窗口需至少700×600，锁屏和休眠时不能操作 Pi Desktop。

七、卸载
在软件中取消“登录 Windows 后自动启动”并保存，然后从托盘退出。
删除软件运行目录和桌面快捷方式即可。数据目录单独保留，方便备份历史记录。


八、0.1.5 更新与升级
- 新增每次采集前点击 Pi App、中文姓名自动调整、中文/英文/电话手动改名。
- 新增服务器连接、成功与失败上传、断网重试和改名同步。
- 保留中英文 Node Bonus 识别与低置信度、多候选保护。
- 升级前从右下角托盘退出旧程序。0.1.1、0.1.2、0.1.3 或 0.1.4 可以用小升级包覆盖原文件夹，不能单独运行升级包。
- 完整运行包可解压到新文件夹。同一 Windows 用户下沿用原编号、设置和历史，不删除原数据。
- 使用开机自启时，在新版重新保存设置以更新启动路径。

九、定时测试（0.1.5）
点击主界面「定时测试」，选择日期和几点几分（北京时间/新加坡时间），点击「预约测试」。也可点「2分钟后」快速填入时间。
主界面会显示一次定时测试的计划时间。预约只执行一次，与每天自动采集开关独立；可在同一入口取消或重新预约。
到点自动执行原采集流程，结果标为「定时测试」，成功或失败都自动上传已连接的后台。
预约会持久保存，重启程序仍有效；超过15分钟未运行记为错过，不会用当前值冒充原计划值。
升级首次打开后，每天四次计划生效；升级前仍按原15:00、21:00历史计划显示，不补造新时段。
请先在一台电脑预约2分钟后的测试，保持Windows未锁屏、Pi Desktop登录，不操作鼠标。

十、0.1.5 更新
客户端只保留电脑编号输入，取消电脑名称。现有服务器连接、稳定设备标识与历史记录保留。