Linux 客户端 1.7.3 — 2026-10-30
交还 HiveOS 后自动执行一次 hello 同步服务器；成功或失败均分别回报。客户端保持在线，可在群控或本地网页点击“接管回来”。
支持反复切换并保留设备身份、钱包矿池、任务、超频与连接配置。已成功交还后的重复检查不重复执行 hello，失败时可重试。

轻松矿工 Linux 客户端 1.7.1
账号注册与兼容登录（2026-10-28）
打开 https://qk.qswk.net 点击“注册账号”。登录账号可以自定义，纯数字账号至少 6 位；每个账号另分配一个随机六位兼容 ID。
旧版客户端和旧版群控填写六位兼容 ID；新版网页、Linux 1.7.1 和 Windows 群控 0.4.1 可使用登录账号或兼容 ID，密码相同。同账号的多台群控和设备统一汇总。
初始密码按平台要求明文记录，仅用于人工找回；改密不覆盖初始记录。请使用本平台专用密码。
完整安装与使用说明：https://qk.qswk.net/guide.html 。

1.6.36 群控接管与网页中文（2026-10-27）
配合群控 0.3.23 的右键“切回群控”和“交还 HiveOS 并卸载客户端”；沿用本地网页已存在的认证接口及卸载流程。
网页实时核心日志、客户端日志、历史检索和自定义调试日志使用同一套中文显示规则。中文关键词可找到对应原文，导出保留原始内容。
常见网络、文件、显卡及矿池错误显示中文。操作结果明确写成功或失败。
各页面按键、提示及网络设置文字补充中文。核心、算法、版本、地址、参数和单位保留；未知第三方输出不隐藏，系统交互终端保留原始命令和输出。
验收：449 项 Go 测试、go vet、18 组网页单元检查、真实浏览器四页/登录/日志/检索/移动布局截图、12 项隔离卸载检查、DEB 包校验、1.6.35 到 1.6.36 运行和停止两种升级。
仅完成本地构建和隔离验证，未升级或卸载任何真实矿机，未在线发布。

轻松矿工 Linux 客户端 1.6.35

1.6.35：配合群控 0.3.22，普通核心优先使用群控已校验的缓存，通过局域网下发；不可用时回退云端。
核心清单继续由配置的云端校验版本和摘要，只有经过授权的局域网群控地址用于取包。
下载按连续无数据判断异常，持续有数据时不限制总下载时间；仍支持停止、取消及文件校验。
新增与切换操作对应的中文进度，独立小报文上报，不挤占显卡状态报文。
本次为本地安装包交付，未自动更新运行中的矿机，也未发布在线升级。

轻松矿工 Linux 客户端 1.6.31

1.6.31：改善自定义 HiveOS 核心启动兼容性，按需自动选择兼容运行方式；保留系统文件保护与退出清理。
修复部分核心的算力、份额采用数字字符串时无法显示的问题，正常矿池和开发者费用连接继续可用。
配套守护程序 1.0.1 区分私有用户空间权限与宿主机权限，合并频繁事件，保留真实风险记录。
已有配置、官方核心、超频、钱包与自定义任务保持原有使用方式。具体验证范围见 1.6.31自定义核心真机兼容修复.txt。

1.6.24：修复网页密码连续猜测的限流绕过；已登录网页通过独立会话继续操作，不被同一来源的误输密码锁出。
退出登录、修改密码会使相应会话失效。限制异常网页连接、群控报文和命令队列，保留正常群控协议与现有配置。
安全复查范围、验证与剩余边界见 1.6.24客户端安全复查.txt。

1.6.23：开机时 DNS、VPN 或群控连接暂未就绪，不再导致本地网页退出；网络恢复后自动重新上报。
开机服务设置在后台恢复，系统管理器暂时忙碌不阻断网页和群控；服务异常会继续重试。
包含 1.6.22 的启动与升级配置保留修复。保留矿工名、连接、密码、任务和超频设置。
验证范围与限制见 1.6.23重启连接修复.txt；隔离服务测试不等同于真实矿机冷启动验收。

1.6.22：修复自动名称同步失败导致本地网页无法启动的问题，保留已保存名称并在日志记录原因。
自动名称迁移等待升级程序完成配置保留检查，避免旧升级程序误判配置变化并回退。
本版本已通过完整 Go 竞态回归、静态检查和实际安装包的隔离升级回放，尚未部署到 10.8.0.18，未发布在线升级。

1.6.21：统一客户端日志、核心启动环境、日志检索和运行曲线的显示时区，避免 HiveOS 系统、服务和浏览器时区不同。
原版群控不传时区，默认北京时间；支持校时协议的群控可提供自己的时区。每 15 分钟复核时间，失败自动重试。
在真实 HiveOS 上切换 UTC、莫斯科和上海时区验证；原时区、配置、功耗限制及运行中的矿工均已还原或保持。
具体范围见 1.6.21时间与时区修复.txt。

1.6.20：统一群控、网页和命令行的矿工名保存，同步 /hive-config/rig.conf 中的 WORKER_NAME。
手动改名清除旧的“使用计算机名”覆盖开关；服务重启、系统重启和正常升级保留名称。
首次取名去掉 Hive / HiveOS 前缀；旧配置按自动名称匹配迁移，手动名称不重复去前缀。
保留钱包、核心任务、安装标识、密码和超频参数；写入失败回退，避免客户端与 HiveOS 名称不一致。
具体验证范围见 1.6.20矿工名保存修复.txt。

1.6.19：保留安装统计登记，并发布温控与连接修复，详见 1.6.19温控与连接发布说明.txt。

1.6.16：

网页与官网一键卸载默认清理客户端配置、密码、日志、已下载核心、缓存和备份；交还 HiveOS 失败时停止清理。正常升级保留全部原配置。

QSWK Linux 客户端 1.6.15

1.6.15：修复群控连接表单折叠字段校验无提示的问题，云端地址留空沿用已有地址；指定 IP 优先连接，勾选自动发现不再清空地址。
保存按钮旁显示保存进度、校验错误、请求超时与群控连接状态；连接失败明确显示目标及检查事项。已有配置、任务和其他功能保留。
另修复从旧版升级后原版群控显示离线的问题：使用计算机名开关按可兼容旧缓存的数字文本上报，避免旧主机名转换失败阻断在线时间刷新。
详见 1.6.15连接保存修复.txt、3090升级离线复查_20261022.txt。

1.6.14：补齐原版群控单机参数的矿工名、计算机名、群控连接、自动开挖与等待时间、风扇、虚拟内存、低算力和定时重启处理。
配置、钱包、任务、设备身份、已有密码和其他超频参数保留；失败项明确回报，系统设置通过独立任务执行。
WSL 验证与原版群控窗口验收分别记录；原版参数页实际下发尚未完成，不能将协议测试视为原版窗口验收。
已发布至 qswk.net，官网一键安装、群控与网页升级清单提供 1.6.14；旧版本保留。原版完整参数页实际下发验收仍待完成。
功能和验收边界详见 1.6.14单机参数验证.txt；发布记录位于 runtime/release-1614-20261022/。

1.6.13：首次安装明确初始化网页默认密码 admin，默认开启同网段自动发现；修复无群控地址的旧配置未勾选自动发现。
矿工名优先使用 /hive-config/rig.conf 的 WORKER_NAME，去掉 hive 开头；无名称时使用本机局域网 IPv4，不使用镜像自带主机名。
网页密码可使用 1、admin 等短密码，无长度或字符组合要求；已有密码和手动名称继续保留。
系统设置隐藏“系统任务”区域，操作反馈归入对应模块。首次安装接管后清理 /hive/miners/custom/downloads/ 内容，升级和重装不重复清理。
网络连接新增有线静态 IP / DHCP，默认勾选联网失败恢复原设置；接通原版群控动态转静态及单机网络参数。
系统盘空间统一查看占用、清理核心和扩容，与看门狗采用等高卡片。新增本机硬件、内存、CPU 负载与温度、系统和驱动信息。
详见 1.6.13首次安装默认设置.txt；网络修改已在 WSL 独立网络命名空间验证，未改动实体矿机网络。

1.6.12：修复核心退出后自动恢复过快，导致群控和客户端日志偶尔漏报的问题；保留真实退出事件并去重，恢复挖矿后仍能看到故障记录。

1.6.11：群控和本地网页超频后，日志逐卡列出实际应用的核心锁定、核心偏移、显存锁定、显存偏移、功耗上限和风扇设置。
只列出本次操作包含的参数；显存偏移注明 HiveOS 实际单位，功耗显示逐卡换算后的瓦数。
完成硬件读回及配置保存后才发送成功日志；恢复设置列出恢复值，失败仍报告原因及回退结果。
保留 1.6.10 的超频、启动和群控兼容修复，SO 不变。1.6.10 仍保留供手动选版。

1.6.10：保留冷启动时原有的驱动查询等待；只有完整读回后仍是旧值，才启动最多 3 秒的反馈重查。
完整交付与验证见 1.6.10群控超频字段核对.txt。1.6.8、1.6.9 为本次阶段验证版本，使用 1.6.10 安装包。

1.6.9：修复 NVIDIA 风扇目标反馈延迟造成的超频失败误报。
写入和回退均等待准确读回，仍逐项、逐风扇严格核对，不放宽误差、不跳过回退。
保留 1.6.8 的原版群控核心双输入与参数回报修复。验证范围见 1.6.9群控超频字段核对.txt。

1.6.8：原版群控 NVIDIA 核心双输入支持锁频加偏移，例如左侧 1785、右侧 200。
这是 Linux 端对旧 corevolt 字段的兼容扩展，不是电压设置；右侧范围为 -799～799 MHz。
核心只设偏移时填左侧，右侧为 0。显存、风扇、功耗仍按原有口径处理。
所有显卡统一的已保存参数会回报原版群控，逐卡不同或无法无损表达的网页设置不伪装成统一值。
温度上限、真实电压仍明确提示不支持；整组校验后才写入，失败回退，保留现有配置。
验证范围见 1.6.8群控超频字段核对.txt。

1.6.7：修复原版群控一键切换提示“不支持选择使用当前矿池”的问题。
原版按矿工端版本号判断能力，Linux 必须高于 1.6.6；因此从 0.8.17 递增到 1.6.7。
安装包、网页、群控回报和在线更新统一使用真实版本号，保留原设置和历史版本。
保持“使用当前矿池／钱包／核心”的原协议语义，切换时保留设备已保存的对应字段。
本版未改动核心包、SO、超频或已有配置；旧版仍可通过正常升级路径更新。
验证范围见 1.6.7原版群控矿池兼容.txt。

0.8.17：缩小原版群控的 UDP 状态包，解决本次 OpenVPN 路径中大包丢失、群控不能发现矿机的问题。
完整超频诊断仍在本机网页保留，群控继续回报算力、显卡数据、任务、升级状态和校时请求。
已在一张 RTX 3090 上验证原版一键开始、网页运行中切换、290W 限制及重启自动恢复。
原版 F2 选择币种/核心的界面受本机自动化工具限制，尚未完成提交验收；不将网页切换算成原版界面通过。
完整范围、配置保留和证据见 0.8.17VPN与3090实机验证.txt。

0.8.16：修复远程防护与 HiveOS 开机目标的依赖环，升级自动迁移旧启动链接。
自动恢复与手动开挖均等待 HiveOS 初始化，成功完成的 oneshot 初始化也可识别。
超频恢复期间持续显示准备状态，避免超过 20 秒后误报失败；停止操作会取消准备，保留超频校验及回退。
核心文件、SO 和超频恢复错误完整写入客户端日志并回报；核对启动前已发生的失败，不再只显示通用超时。
验证范围与现场限制见 0.8.16开机启动修复.txt。

0.8.15：原版群控和网页超频共用配置，修复风扇设置；核心/显存自动区分偏移与锁定，功耗逐卡判断 W 或百分比。
包含显卡数量、主机信息和矿池日均算力回报修复。验证范围见 0.8.15群控超频与风扇验证.txt。

0.8.13：原版群控升级失败时只回报一次，保留两次真实操作各自的结果。
新装、旧版未配置连接及重置后的连接选项默认勾选同网段自动发现，保留指定群控和多地账号。
修复原版群控空闲时网页误显示未连接；通过已知群控的日志端口核对可达性，断开后自动更新状态。
原版群控与 WSL 的完整验收记录见 0.8.13原版群控联调.txt。

0.8.12：修复原版群控自动发现模式下，客户端升级重启后完成日志丢失的问题。
保留有效的日志回报地址，继续广播发现；没有群控回报地址时保留待通知状态。
回报地址不用于授权命令或判断在线，管理设置改变或地址过期后自动失效。

0.8.11：群控升级支持指定已发布版本与原生 hash 选版；重复请求沿用正在执行的任务。
群控操作：选中 Linux 矿机 → 一键停止 → 一键升级 / 升级矿工 → 选择 OS 版本。
升级完成后显示新版本并回报结果；健康检查失败会报告错误并尝试恢复原版本。
局域网日志优先 TCP，失败后才回退 UDP；重连不重复上报旧的升级、看门狗和异常通知。
升级期间的内部恢复检查不再产生“客户端正在更新”的误报，真实操作和故障继续记录。
复刻群控配套 0.3.11 修复 os:true 被误识别成 Windows；原版群控继续使用原生升级协议。

0.8.10：系统设置新增卸载客户端，二次确认后交还 HiveOS；保留设置、密码、日志与核心缓存。

0.8.9：群控连接合入系统设置；增加 HiveOS NVIDIA 驱动版本选择、安装与维护，Wi-Fi 搜索与连接。
驱动更新使用本机 nvidia-driver-update；需先停挖，后台独立执行，核对实际版本并记录结果。
首次启动后台执行一次 disk-expand -s，已有数据分区不动；结果持久保存，失败可在网页手动重试。
核心标准输出改用 PTY 接收，消除普通管道缓冲导致的最新数行延迟，进程退出前读完尾部输出。
系统维护助手：packaging/system-tools.py；隔离测试：python3 scripts/test-system-tools.py。

0.8.8：新增各卡与总算力、温度、显存温度、风扇、功耗历史曲线，点击时间显示对应数值。
每 30 秒采样，最多保留 7 天 / 64 MiB；自动获取矿工名剔除 hive 前缀，保留手动设置。
0.8.5–0.8.7：统一挖矿状态与桌面布局，移动端适配，核心实时终端与本机登录终端。

0.8.4：本机网页新增挖矿状态、超频设置、群控连接、系统设置、运行日志菜单。
选择已发布的 OS 核心、币种、矿池，填写钱包即可开始或切换挖矿；与群控共用已保存的任务。
超频提供全部/单卡六项设置，留空不修改，复用已有 HiveOS nvtool 执行、读回与失败回退流程。
系统设置保留看门狗、版本更新、网页密码、核心清理、客户端重启及设备重启/关机/重置。

0.8.3：首次安装网页默认密码为 admin，登录页面直接显示。升级保留原密码；可在网页设置自己的密码。
0.8.2：修复核心切换被后续设置指令中断，增加闲置核心清理及磁盘占用显示，修复恢复后群控保留旧错误。

0.8.1：默认自动发现；首次安装自动独立接管；启动先校时，核心日志跟随配套群控 0.3.10 的时间和时区。
旧群控使用 HTTPS 云端时间作为后备。普通更新保留管理方式，网站一键安装会重新接管。
验证范围见 0.8.1安装与校时验证.txt。

0.8.0 新增 overclock_v2：nvtool 六项参数、PCI 映射、单卡继承、读回、失败回滚和启动重用。
配套群控 0.3.0，说明见 超频说明.txt；本次未更新现有 HiveOS 服务，未写实机超频。

0.7.1 修复原版/复刻群控的调度及中继字段被误判为设置字段的问题，
群控下发的看门狗参数现在可以正常保存。保留 0.7.0 全部功能；SO 仍为 1.0.3。

当前源码与构建
本项目已恢复为可独立复制和编译的目录，不再需要工程外的 replace 路径。
SO 源码在 adapter/，当前实现版本 1.0.4，C ABI 1；客户端仍支持旧 ABI 1 核心包与原有无 SO 核心包。
双击根目录“一键编译SO.cmd”，或在 WSL / Linux 运行 bash adapter/build.sh。
输出 adapter/dist/latest/qskg.so；旧构建保存在 previous-*，既有 dist 交付包不覆盖。
此模块保留六个作者核心的启动及算力适配，不包含账户改写；外部独立工程未修改。
构建方法与 ABI 见 adapter/README.txt、adapter/ABI.txt。

0.7.0 更新
- 修复 deb 打包路径与源码包缺少 adapter/go.mod；SO 测试从当前源码编译，产物缺失会失败。
- 网页密码失败按来源计数，正确密码不被错误请求锁死；可在网页修改本机密码。
- 9999 网页检查更新、选择已发布版本、显示进度；群控支持 start_update / start_update_batch。
- 更新运行于独立 systemd 服务，升级前停止挖矿，校验 SHA256 / 包元数据，备份设置并在失败时尝试回退。
- 后台 /clientver.php?os=1 发布 OS deb 的原生升级清单；Windows 清单保持原有行为。
- 群控复刻版可按所选设备区分 Windows / Linux、选择 OS 版本，列表显示进度及失败状态。
- 看门狗支持持续低算力、零算力、缺失有效数据、掉卡、过温和定时重启。
  默认关闭；启动等待、持续判定、冷却及每小时次数限制可设置；过温和次数超限停止挖矿。
  手动停止不会被自动恢复覆盖。重启客户端保留矿工进程的原有机制继续保留。
- 逐卡数据表、客户端日志时间/关键词筛选、核心日志关键词筛选、轮转日志下载。
  未取得有效数据时显示缺失，不当成零。

0.7.1 已发布到 qswk.net；配套云端及六个 OS 核心包内的 SO 已更新，未自动升级矿机。
当前验收、回退路径和待测范围见“0.7.1群控复查与上线.txt”；旧报告保留历史版本当时的结论。

历史功能与使用方法
0.6.0 增加独立 qskg.so 核心适配库，位于每个矿工程序旁。
同一份 SO 支持现有六核心；可单独更新启动参数适配和 API 算力解析。
云端“核心 -> os核心 -> 更换 SO”可批量重新打包并沿用到后续 GitHub 更新。
先升级客户端，再刷新群控清单并重新下发核心；旧缓存和正在运行的任务不热替换。
完整 ABI、扩展与构建方法见 adapter/ABI.txt；原来的无 SO 核心包继续使用内置适配。
本版 SO 已验证真实动态加载、六种 API、实际进程启停及升级扩展；未新增 GPU 实挖验收。

在 HiveOS amd64 上接收现有轻松矿工群控的任务，下载云端 OS 核心，校验 MD5，
运行 Linux 程序，返回真实算力与日志。独立 Go 源码，不依赖 Windows qskg.dll 或旧 qskg.so。
本地网页端口 9999。0.4.0 增加独立管理模式、可恢复的 HiveOS 云端同步暂停，
并在开机初始化完成后恢复之前启用的本地任务；已停止的任务不会自动启动。
历史版本曾在授权的 192.168.8.229 真机测试；本版仅本地隔离验证。
实测范围、未完成项目及证据以同目录“验证报告.txt”和交付的 hardware-acceptance 为准。
0.4.1 修复启动后立即退出却报告成功，以及切换失败丢失原有已停止任务的问题。
开始/重启已保存的任务可直接使用完整本地缓存，不依赖云端清单在线。
0.5.0 补齐原版 set_worker、reboot_app、clean 命令，本地网页增加客户端维护入口。
改名不打断当前进程，下一次启动/重启使用新名称；保存了模板的任务支持离线改名后启动。
0.3.0 已完成六个核心的短时 PRL 功能验证；0.4.x 和 0.5.0 暂未重跑 GPU 挖矿。
整个项目尚未通过长期稳定性验收。
最后一次 Fl4sh 短测停止后，测试机曾出现 GPU 掉卡 Xid 79/154，重启后恢复；
尚未确定是驱动、供电、硬件或核心兼容问题，应先排查再持续挖矿。

目录
- cmd/、internal/：客户端源码，复用 adapter/miner 的核心适配实现。
- adapter/：SO 的完整独立项目，含启动参数、算力解析、C ABI、宿主和一键编译脚本。
- internal/agent/web/：矿机本地管理网页。
- packaging/：systemd、HiveOS 桥接及 deb 安装/卸载脚本。
- scripts/：编译、打包和联调工具；测试凭据通过交互输入，不写进源码包。
- dist/：版本化 deb、ELF 程序、源码包、校验清单及六个官方 Linux 核心包。
- 调研/、样本文件/：原始资料，不参与构建。
- runtime/：隔离测试现场和证据，不打入安装包/源码包。
- ../qskg-server/：当前云端源码。旧 qskg-cloud 不是维护入口。

安装
把 deb 复制到 HiveOS，执行：
  sudo apt install ./qswk-agent_0.8.4_amd64.deb
依赖包括 jq、python3、p7zip-full、ca-certificates、hive-miners-custom、glibc >=2.34（Ubuntu 22.04）。
首次安装自动切换到群控独立管理并启用自动发现，保留 HiveOS 原设置；没有任务时不会开始挖矿。
已有安装升级保留 /etc/qswk-agent/config.json 与 /var/lib/qswk-agent。
升级应先停止挖矿，服务切换可能中断当前托管进程。

本地网页
浏览器打开 http://矿机局域网IP:9999/。
首次安装默认网页密码：admin，无需用户名。登录页直接显示首次使用提示。
从旧版本升级保留原密码，已设置的密码不会被重置。管理员如需查看当前密码：
  sudo qswk-agent web-password
网页密码独立于 SSH、Wi-Fi 和云端管理员密码，可在“网页密码”中修改。
密码保存于 /var/lib/qswk-agent/web-password，权限 0600。网页不将密码写进 URL 或浏览器存储。
仅接受局域网 IP 访问；不要向公网转发 9999。

同网段自动发现默认开启，打开群控后即可等待发现。
跨网段填写“群控 IP”和矿机名称，点“保存并连接”；填写指定 IP 时会关闭自动发现。
跨网段可填写实际可达的群控 IP；DMZ 不会把不同子网合并成一个广播域。
多地群控在展开项填写云端地址及账号；账号密码仍只在 Windows 群控中填写。
首次安装已完成接管。主动交还 HiveOS 后，可用“接管 HiveOS 挖矿”重新接管。
激活会调用 miner stop，备份并修改 MINER、CUSTOM_MINER、CUSTOM_INSTALL_URL。
新安装默认勾选“群控独立管理挖矿”。接管时暂停 HiveOS 的 hello 与 agent 云端入口，
保留驱动、GPU 统计、nvidia-oc、自动风扇和本地工具。重启不会再被云端飞行表覆盖。
HiveOS 云端界面的数据及远程任务同步也会暂停；本机网页和轻松群控继续接收状态。
交还或重置恢复原矿工字段并恢复 HiveOS 云端同步；不主动调用 miner start 启动旧矿工。
HiveOS 云端恢复后仍可按其已有配置下发任务，需由管理员确认其飞行表。
升级安装保留原设置：旧版配置默认仍为 shared，需要先交还，再勾选独立管理、保存并接管。
取消勾选为 shared 模式；此模式需在 HiveOS 云端选择自定义矿工 qswk，否则云端同步会覆盖它。
客户端会拒绝启动冲突任务，不反复抢写。接管期间不能切换这项设置，需先交还。
已有接管备份且飞行表已被覆盖时，先点“交还 HiveOS”归档旧备份，再重新接管。
群控出现设备后，先选中，再下发；操作后需重新选择目标。

网页操作
- 开始/重启挖矿：使用群控最后下发的任务；没有任务时给出提示。
- 停止挖矿：先退出托管核心，再调用 HiveOS miner stop。
- 交还 HiveOS：停止托管任务并恢复接管前的矿工设置，不自动启动旧矿工。
- 重启/关机：调用 HiveOS sreboot / sreboot shutdown，需要再次确认。
- 重启客户端：由 systemd 重新启动连接与网页服务，保留设备身份、密码和挖矿任务。
  此操作不重启机器，也不主动停止由 HiveOS 单独托管的核心进程。
- 清理闲置核心：移除本客户端已验证的闲置核心缓存和下载临时目录，保留当前任务使用的核心。
  已停止但仍选中的核心同样保留；不清理未知目录、外部文件、配置、密码或日志。
- 群控修改矿机名：保存并重连，网页同步新名称，不立即中断当前挖矿；下次启动任务生效。
  升级前保存的旧任务没有启动模板时，改名后的首次启动需云端在线以补齐模板。
- 重置客户端：停止任务、交还 HiveOS、清空群控连接和任务，保留日志、密码与核心缓存。
  重置前保存 config.json.before-reset-时间戳，可由管理员恢复。
- 执行日志与核心日志：分别显示控制命令结果和作者程序输出；无有效算力时不伪造零算力。
“已提交”表示操作进入队列；应以运行状态和执行日志确认最终结果。
核心进程连续存活 3 秒后才确认启动；初始化完成与否继续以核心日志和真实算力为准。
下载或校验失败时保留原任务。新进程启动失败会恢复原来的运行任务；原任务已停止时，
保留原核心选择和停止状态。若停止失败任务或恢复操作失败，日志明确报告失败。

命令行配置
  sudo qswk-agent configure --server https://qswk.net --account 0 --controller 192.168.31.110 --worker rig01 --hive-mode exclusive
  sudo qswk-agent activate
  sudo systemctl restart qswk-agent
多地模式用实际账号替换 123456：
  sudo qswk-agent configure --server https://qswk.net --account 123456 --worker rig01 --hive-mode exclusive
  sudo qswk-agent activate
  sudo systemctl restart qswk-agent

端口与协议
默认网页 TCP 9999，客户端 UDP 9168，群控 UDP 9169，群控日志 TCP 9164。
云端中继仍使用原有 UDP 3620，不启用 P2P，不要求矿机开放公网端口。
显式地址使用 t=0；自动发现广播使用 t=2；多地中继使用 t=3。
自动发现仅接受同网段、正确来源端口的原生群控报文，并固定首次发现的端点。
旧协议不提供端到端加密，自动发现适合可信局域网。
隔离联调可设置 listen、discovery_port、controller_log；日常安装不需要改这些字段。

核心与云端
在后台“核心 -> os核心”选择 Linux amd64 的 tar.gz、ZIP 或 7z 包，选择 ELF 入口，
关联币种、矿池和启动模板，选择该程序的算力接口。一个核心可支持多个币种，单机一次运行一个任务。
启动命令以 {exe} 开始；{server}、{wallet}、{worker}、{add} 来自群控，{port} 默认 4068。
参数按独立实参传递，不执行群控提交的 shell、管道或重定向。
支持 PeakMiner、SRBMiner Multi、OneZeroMiner、ForgeMiner、rgminer、Fl4shMiner 的 API。
具体版本的真实 GPU 结果见验证报告，不能只凭有解析器就视为所有版本/显卡已兼容。
六个官方适配包在 dist/cores-linux-20261015；原作者二进制未修改，没有加入 Windows DLL。
每包有 PRL、QTC 模板；短时实测以 PRL 为主，QTC 不应当作已实挖验收。
GitHub 更新规则按 Linux 包重打包，保留设置，新版本默认待核对后发布。
旧清单同域 HTTP 下载地址自动升级到配置的 HTTPS，拒绝跨域明文地址和 HTTPS 降级。

超频与风扇
原生群控选择 NVIDIA 内置普通模式。客户端写入 /hive-config/nvidia-oc.conf 后调用 nvidia-oc，
并保存备份及执行结果；失败会尝试恢复配置。
只处理勾选项：核心偏移 -> CLOCK；Windows 显存偏移乘 2 -> MEM；风扇百分比 -> FAN；
功耗百分比按 gpu-detect 默认功耗换算每卡瓦数 -> PLIMIT。
特别注意：勾选功耗且填 0 表示恢复显卡默认功耗，不是保留当前限制。
只想改核心/风扇时，应取消功耗等无关项的勾选。
取消启用超频可恢复接管前的对应设置；检测到外部修改时不覆盖。
自动风扇已启用时拒绝手动风扇项；BUSID 冲突、瓦数越界或缺少硬件清单会拒绝命令。
本版明确拒绝 AMD 超频、MSI、高级锁频、电压及非零温度目标。
不改 HiveOS 的 LCLOCK/LMEM、自动风扇、看门狗、维护模式及第二矿工设置。
硬件效果和稳定性需要分别验证；命令执行成功不等于超频稳定。

状态与恢复
  sudo qswk-agent status
  sudo journalctl -u qswk-agent -n 100 --no-pager
  sudo tail -n 100 /var/lib/qswk-agent/agent.log
  sudo tail -n 100 /var/lib/qswk-agent/miner.log
  sudo qswk-agent deactivate
  sudo apt remove qswk-agent
设备身份、任务和缓存保留；已换到其他 HiveOS 飞行表时不会用旧备份覆盖新选择。
独立管理仅使用 dpkg-divert 管理 /hive/bin/agent 与 /hive/bin/hello；原文件在同路径的
.qswk-original 中。HiveOS 软件包更新会写入该原文件；卸载恢复最新原文件，不覆盖为旧快照。
接管标记位于 /var/lib/qswk-agent/hive-cloud-paused。不要手动删除入口或备份文件；
恢复使用 deactivate，卸载使用网页按钮或官网一键卸载命令。若入口已被其他软件修改，操作会报错并保留现场。
安装/升级不自动接管；升级前已接管的配置和暂停标记保持。重启后只有 active=true 的任务恢复。
矿工状态过期、API 无效或算力缺失时，stats_valid=false；旧群控可能自行显示 0/历史值，
但客户端和云端不把缺失样本记录为真实零算力。显卡数据按明确 PCI 地址关联，避免多卡错位。
局域网状态与日志直接给群控；多地模式由云端中继记录，不把下载访问冒充在线状态。

范围
支持开始、停止、重启挖矿、状态、日志、NVIDIA 普通超频、设备重启和关机。
未实现远程桌面、任意 shell、任意路径文件管理、ARM、双矿工并行。
文件下发指云端发布的核心包与配套文件。

编译与打包
Linux / WSL，Go 1.18 或更新版本：
  bash adapter/build.sh
  go test -race ./...
  go vet ./...
  bash scripts/build-deb.sh
  python3 scripts/package-release.py --agent-only --version 新的客户端版本
  python3 scripts/verify_deb.py --version 新的客户端版本
  python3 scripts/verify_release.py --version 新的客户端版本
发布客户端前同步更新客户端版本常量和 build-deb.sh 中的版本；已有发布清单不覆盖。
仅更新 SO 不需要重新打包客户端，也不需要运行 scripts 下的客户端发布脚本。
有真实验收记录时通过 --hardware-report 指定 JSON；不提供时清单不会声称硬件验收通过。
本次没有修改云端程序时使用 --agent-only，避免把旧云端程序重新标记为新版本。

主要安装路径
/etc/qswk-agent/config.json
/opt/qswk-agent/qswk-agent
/var/lib/qswk-agent/cores/<MD5>/exts/<核心目录>/
/hive/miners/custom/qswk/

详细安装、升级、交还、卸载及故障恢复步骤见“安装教程.txt”。

0.8.8：运行日志增加本地历史曲线，30 秒采样，最多保留 7 天和 64 MiB；支持各卡/总算力、核心/显存温度、显卡功耗、风扇，点击或触摸时间查看数值。显卡状态右上角显示算力、接受/拒绝、功耗汇总。自动获取的矿工名去掉 hive 前缀；手动名称保留。历史从升级后开始记录，不会生成过去的数据。

远程访问保护：安装及每次客户端启动调用 HiveOS remote-connections，关闭 SSH、VNC、旧网页终端及临时 tmate 会话；保留 9999 网页和群控。
系统终端经过网页密码及本机账号登录，按需创建会话，断开、闲置超时或客户端退出时关闭。无需重新开放 SSH。
卸载客户端会恢复接管前的远程服务设置；管理员手动修改的 SSH 配置保留，原配置备份另存。

网页卸载：系统设置 → 客户端维护 → 卸载客户端，确认后在后台执行。停止轻松矿工并交还 HiveOS，恢复接管前的远程服务设置；删除本客户端设置、登录密码、日志、已下载核心、更新缓存和备份。重新安装使用默认密码 admin；正常升级保留原数据。网页断开后请使用 HiveOS 管理；HiveOS 可能按原飞行表恢复挖矿。
