﻿Pi 节点面板 v2.9.1 — Windows 绿色便携版
============================================================

【这是什么】
不用装 Docker、不用装 Node。把整个文件夹复制到节点机上，双击
「启动面板.bat」就能用。

【怎么用】
1. 把整个 pi-panel-win 文件夹复制到节点机（例如 D:\pi-panel-win）
   注意：必须整个文件夹一起复制，不能只复制里面的某个文件。
2. 双击 启动面板.bat
3. 约 3 秒后浏览器自动打开 http://127.0.0.1:13147
4. 想关掉面板：直接关闭那个黑色窗口即可。

【文件夹里都是什么】
  node.exe            Node 22 运行时（面板靠它运行，无需另外安装）
  server.js           面板程序本体（以后升级只需替换这一个文件）
  public\             面板前端页面
  启动面板.bat        双击运行
  pi-panel-agent.ps1  可选的本机助手，见下
  data\               首次运行后自动生成：配置、机器编号、历史记录

【数据存在哪】
全部存在 data 目录里，跟着文件夹走：
  data\config.json      面板设置（含管理中心密钥）
  data\machine-id       本机唯一编号
  data\history.jsonl    历史记录（每小时一条，保留 30 天）
换机器时把 data 一起复制过去，原有配置就带过去了。

【要不要填 API 密钥】
不填 = 纯本地模式，只在这台机器上看，不上报任何数据。
要同步到管理中心：登录 https://node.314888.xyz -> 节点数据 -> 添加节点，
复制 API 密钥，粘进面板的「关联管理中心」并保存。

【关于防火墙】
面板只监听 127.0.0.1，仅本机可访问，正常情况下不会弹防火墙提示。
若 Windows 弹窗，选「取消」即可，不影响使用。

【端口被占用怎么办】
默认端口 13147。若被其他程序占用，用记事本打开 启动面板.bat，
把 set PORT=13147 改成别的端口（例如 13148）即可。

【Pi 账户数据（节点因子 / KYC / 锁仓）从哪来】
面板会直接读取本机 Pi Desktop 的数据：
  %APPDATA%\Pi Network\Local Storage
  %APPDATA%\Pi Network\user-preferences
启动时黑窗口里会打印这两行的探测结果，显示「未找到」说明 Pi Desktop
安装位置不同或未安装。此时可加装本机助手（见下）作为补充。

【可选：本机助手 pi-panel-agent.ps1】
面板本身已能完成绝大部分功能，助手是补充，作用是：
  - 让 Pi Desktop 带调试端口(9222)启动，便于取到最新的登录凭证
  - 提供主机真实硬件信息（物理核数、内存）
  - 响应面板上的「重启 Pi Desktop」按钮
安装（管理员 PowerShell）：
  powershell -NoProfile -ExecutionPolicy Bypass -File pi-panel-agent.ps1 -Install
不安装也不影响节点状态、端口检测、数据上报等主要功能。

【怎么升级】
1. 关闭面板（关掉黑窗口）
2. 用新的 server.js 覆盖旧的（若前端有改动，public 也一并替换）
3. 重新双击 启动面板.bat
data 目录不用动，配置和密钥都还在。

【出问题怎么排查】
黑窗口里的日志就是排查依据，常见的几行：
  mode=windows-native        表示按原生 Windows 方式运行（正常）
  pi-store=未找到 ...        没读到 Pi Desktop 的 Local Storage
  pi-prefs=未找到 ...        没读到 Pi Desktop 的 user-preferences
如果窗口一闪就消失，说明启动即失败：用 cmd 进入本目录，
手动执行 node.exe server.js 查看完整报错。
