一套工具要覆盖哪些环节
网吧挖矿工具不是单个程序，而是一条从门店设备走到云端结算的链路。选型时最容易只看「能不能挖」， 真正决定长期可用的是四件事：设备自动接入、配置统一下发、状态可见、收益对得上账。缺一件，最后都会退化成人盯。
KGMiner 把这条链路拆成四端：管理端定规则，代理端管门店与设备，业主端只读本店数据， 客户端在机位执行动作。四端各有唯一写入口，同一件事不会几处被改。
| 工具端 | 使用者 | 主要职责 |
|---|---|---|
| 管理端 | 平台管理员 | 账号权限、全局配置、币种与矿池、钱包池、汇率、平台抽成、版本发布、审计、超频方案库 |
| 运维代理端 | 代理与日常运维 | 门店增删改、识别码、矿机监控、分组与挖矿开关、超频设置、结算与收益、钱包绑定 |
| 业主端 | 网吧店主 | USDT 钱包地址直达，只读本店矿机、收益、结算与支付记录 |
| 客户端 | 网吧挂机机器 | 识别码接入云端，登记客户机、心跳、算力上报，执行下发的超频、电源与挖矿开关配置 |
客户端做什么
客户端是唯一跑在机位上的部分，也最容易被误解。 它不决定「挖什么」，只负责把云端下发的东西执行到位：按识别码与设备信息换取 Token， 登记客户机与显卡，周期上报心跳与算力采样。
网吧内网里，一台挂机机器作为局域网服务端统一管理其余客户机。云端只定义「下发什么」， 不规定「本地怎么执行」；客户端收到配置后整体应用，版本号不变就不重载。
| 配置项 | 作用 |
|---|---|
| auth | 授权状态、可接入 PC 数、到期日 |
| work | 工作模式（单挖 / 双挖）、币种、矿池、钱包、算法、上报间隔 |
| overclock | 全量超频规则：厂家、关键字、颗粒、显存对应频率或偏移、功耗与风扇，加设备开关，本地匹配后执行 |
| power | 客户机熄屏与关机策略：熄屏分钟数与关机视为重启 |
| mining | 设备分组与挖矿名单：分组列表加设备开关，客户端据此停挖或恢复 |
前四项决定「怎么挖」，mining 决定「哪些机位挖」。名单只含已注册设备， 新装或换网卡在注册完成前不在名单内，客户端按继续挖矿处理——部署和换机时要提前知道。
云端平台做什么
云端是业务与数据的唯一入口，门店、凭证、算力与结算都从这里过。管理端负责全局： 账号权限、全局配置、币种与矿池字典、平台钱包池、汇率历史、平台抽成口径、版本发布、 操作审计，以及按显卡型号维护的官方超频方案库。
代理端负责门店日常：开通门店、绑定业主收款钱包、生成 8 位识别码、查看矿机与设备分组、 下发超频与挖矿开关、处理结算。两端边界明确：代理看不到平台比例，也改不了全局配置。
- 矿池日收益按钱包导入，再按份额拆分到门店，未匹配钱包单独告警。
- 每日 00:25 同步矿池实收，00:30 生成结算单，08:00 自动对账。
- 分成比例与汇率在结算时刻快照，结算单不可变，需要修正只能生成反向单。
- 打款前做地址格式、官方合约、链上余额三层校验，转账后回写 tx_hash。
业主端能看什么
业主端用 USDT 钱包地址直达，没有业务写操作。能看的是本店范围：总览、矿机列表与在线状态、 收益趋势、结算单与支付记录。哪台机器在线、当天贡献多少、这笔结算多少、对应哪个 tx_hash， 都在同一个视图里，不需要再找代理要表格。
边界同样重要：业主端看不到平台抽成与代理分成比例，字段在服务端就被裁剪， 不依赖前端隐藏；其它门店份额更不可见。这是权限设计，不是界面礼貌。
-
只读总览
在线机位、当日收益与结算状态，无修改入口。
-
矿机明细
每台机器的在线状态、显卡型号与算力。
-
收益与结算单
收益趋势与结算金额，结算单不可变。
-
支付记录
USDT（TRC-20）记录与 tx_hash，链上可查。
关键监控指标
监控不是堆数字，而是让门店回答三个问题：多少机器在干活、哪台出了问题、 问题在机器还是网络。KGMiner 的监控围绕五类指标展开。
| 指标 | 看什么 | 异常时先做什么 |
|---|---|---|
| 在线机位 | 心跳与在线状态，心跳超时会话自动置离线 | 先确认是关机、重启还是断网 |
| 算力 | 按 H/s 的实时值与小时、日聚合趋势 | 对比同型号机位，判断是单机还是整组问题 |
| 温度 | GPU 温度与风扇是否落在方案库设定范围内 | 偏高时先降档或取消超频，回退默认方案 |
| 掉线 | 连续心跳缺失的机位清单 | 结合断网缓存与补传记录，区分掉线与丢报 |
| 上报延迟 | 采样产生到入库的时间差 | 延迟升高先查门店出口带宽与内网服务端 |
这五项要放在一起看：算力下降可能只是采样缺失；叠上在线状态与上报延迟，才能判断要不要到现场。
工具之外的管理动作
工具有边界。哪些区域参与、哪些机位永不参与，要门店拍板；营业规则若允许长时间挂机不下机， 「无人上机」的判定就会失效，部署前先把规则讲清楚，再决定开哪些区。
有三件事工具替代不了：机位散热与定期清灰、电费核算、一个明确的参与决定。 KGMiner 只提供软件与部署方案，不做收益承诺；能保证的是算力可计量、结算可追溯， 收益仍随币价、网络难度与电价变化。
客户端在无人上机时的行为见网吧锁屏挖矿； 按营业节奏自动启停的机制见网吧自动挖矿； 收益量级的估算方法见网吧闲时挖矿； 部署步骤与识别码流程见首页部署说明， 硬件的约束与超频边界见硬件与安全。