这篇文档走一遍完整流程。按顺序做，十分钟内应该能看到节点上线。
第 1 步：注册账号
打开首页，点「免费开通」，填写邮箱和密码完成注册。
注册后会收到一封验证邮件，点邮件里的链接完成邮箱验证。没有验证的账号无法创建订单。
检查点：登录后能看到控制台首页，顶栏显示你的账号名。
第 2 步：购买授权
进入「商品」页，选择一个套餐。每个套餐包含固定数量的授权节点和有效期。
选择时注意两点：
- 授权节点数要覆盖你要接入的机器数量。
- 有效期从下单时间起算，不是从接入时间起算。
下单后在订单页完成支付。支付成功后授权即时签发，不需要等待审核。
检查点：在「授权管理」里能看到新签发的授权记录，状态为可用。
第 3 步：下载节点客户端
进入「节点」页，点「添加节点」，页面会给出客户端下载入口。
Windows 和 Linux 各有一个安装包。选择与你节点机器匹配的那个。
检查点：下载的文件大小正常（Windows 约百兆级别，Linux 类似），不是几百字节的错误页。
第 4 步：安装客户端
Windows：双击安装包，按提示完成安装。安装过程会请求管理员权限——客户端需要以服务方式常驻，这是必需的。
Linux：解压后执行安装脚本。脚本会做三件事：检查依赖、写入配置、注册 systemd 服务。
安装过程中会用到一个授权令牌。这个令牌在「添加节点」页面显示，复制粘贴到安装向导里即可。
检查点：安装完成后，服务状态显示为运行中。
- Windows：在「服务」里能看到对应服务，状态是「正在运行」。
- Linux：
systemctl status pi-admin-agentlite显示active (running)。
第 5 步：等待首次上报
客户端启动后会立即尝试连接并上报一次数据。正常情况下几秒内就能在后台看到节点。
如果节点机器上运行着 Pi Desktop，采集脚本还会读取账号数据（用户名、余额、算力、奖励）。这部分依赖 Pi Desktop 的本地调试端口，需要 Pi Desktop 处于运行状态。
检查点：在「节点」列表里看到新节点，状态为「在线」。
第 6 步：确认数据正确
点进节点详情，逐个 tab 核对：
- 概览：节点名称、在线状态、最后心跳时间。
- 性能趋势：算力与奖励的曲线（刚接入时数据点少，等几分钟会有更多）。
- 运行日志：状态变化的时间线。
- 端口状态：节点使用的端口是否正常。
检查点：区块高度在增长、算力不是零、最后心跳时间在刷新。
常见卡点
节点一直显示离线。 先确认服务是否在跑。Windows 看服务状态，Linux 执行 systemctl status。服务没起来通常是安装时令牌填错了。
节点在线但数据是空的。 说明采集端连上了，但读不到 Pi Desktop 的数据。确认 Pi Desktop 是否在运行、是否已登录。
安装时提示缺少依赖（Linux）。 通常是缺 libatomic1 或 libstdc++6。用发行版的包管理器装上即可。
授权令牌提示无效。 令牌一设备一用，换机器要用新令牌。在「添加节点」页面可以重新生成。
下一步
节点接进来之后，建议继续看这两篇：
- 节点状态与告警：理解四态的含义与告警触发条件。
- 授权管理：解绑、换机与扩容的操作方式。
—— Pi Admin X 团队