﻿NVIDIA 六项超频说明（2026-10-19）

Linux 1.6.10 更新（2026-10-22）
冷启动的首次读回保留原有查询时限；读到旧值之后才启动最多 3 秒的反馈重查，避免误伤慢启动。
完整验证与兼容边界以 1.6.10群控超频字段核对.txt 为准，1.6.8 和 1.6.9 是本次阶段验证版本。

Linux 1.6.9 更新（2026-10-22）
实机确认 nvtool 设置风扇后，TARGET 可能短暂返回旧值；写入及回退都最多等待 3 秒准确反馈。
仍检查全部显卡和全部风扇目标，超时不符继续报错和回退，不用当前转速代替目标值。
完整验证见 1.6.9群控超频字段核对.txt。

Linux 1.6.8 更新（2026-10-22）
原版群控核心左侧 >=800 表示锁定频率；同时允许右侧填写 -799～799 MHz 的核心偏移。
例如左侧 1785、右侧 200，会同时设置 1785 MHz 锁定和 +200 MHz 偏移，并保存供下次开挖恢复。
原版右侧字段名为 corevolt，Windows 将它用于电压；本客户端只在锁频时将小值解释为偏移，这是 Linux 扩展。
右侧 0 或未发送会清除本次勾选核心的偏移；取消整个核心勾选则保留核心锁定和偏移。
只要偏移时填左侧、右侧填 0；右侧 >=800 的真实电压值不支持，不会当作偏移或静默丢弃。
显存 <800 为 Windows 口径偏移（写入 HiveOS 时乘 2），>=800 为锁定；显存电压不支持。
功耗 0 恢复显卡默认上限，不表示保留；例如本次 3090 默认 420W，需要限制 290W 就填写 290。
群控温度框表示温度上限，HiveOS nvtool --settemp 表示自动风扇目标，两者不等同。
当前非零温度上限会提示取消勾选，本次整组不执行；0 仅作为该未支持字段的中性值，不会改动温控策略。
同样不支持的显存电压、AMD 和 MSI/高级模式会明确拒绝，不把未执行操作报告为成功。
网页六项参数及逐卡设置保持不变；原版群控只回报能无损表示的全卡统一值。
本版测试与实机范围见 1.6.8群控超频字段核对.txt，以下为历史说明。

Linux 0.8.15 更新（2026-10-21）
原版群控和网页共用同一份超频设置，不再拒绝新旧格式交替使用。
原版群控核心和显存值小于 800 为偏移，800 及以上为锁定；切换模式会清除另一模式的旧值。
原版显存偏移使用 Windows 口径，换算到 HiveOS 时乘 2；显存锁定直接使用原值。
原版功耗 100 及以上按 W；小于 100 时仅在该卡默认功耗和最小功耗都大于 100W 时按默认功耗百分比，否则按 W。0 恢复默认。
逐卡判断和校验，任何卡超出范围时整次不执行。网页明确标注 W / HiveOS MHz，不使用群控的隐式单位判断。
固定风扇自动暂停 HiveOS 自动风扇，写入 FAN 并核对各风扇目标；全部设为 0 后恢复此前自动风扇。
0 代表驱动自动策略，实时风扇目标可以非零。
以下 Windows 部分保留历史说明；Linux 以 0.8.15群控超频与风扇验证.txt 为准。

历史适用版本：Windows 客户端 0.2.0、群控 0.3.0；HiveOS 客户端源码/二进制 0.8.0。
界面沿用原版紧凑表单、微软雅黑、标准输入框和按钮。客户端保持 744×492；单卡弹窗保持 680×340。

参数与单位
核心偏移      MHz        独立偏移；例如 600 始终表示偏移，不隐式变成锁定。
核心锁定      MHz        绝对目标频率，0 解除锁定。
显存偏移      HiveOS MHz 使用 HiveOS 口径；1600 对应 Windows 偏移 800 MHz。
显存锁定      MHz        绝对目标频率，不做上述二倍换算；0 解除锁定。
功耗限制      W          绝对瓦特，不是百分比；0 使用该卡默认功耗上限。
风扇          %          手动占空比；0 恢复自动策略。多风扇卡应用到该卡的各个风扇。

输入与按钮
1. 客户端在“超频设置”填写六项统一参数；群控先勾选矿机，再点击“一键超频”。
2. 统一值默认用于所有显卡。点击“单卡超频>”可查看列表、勾选目标及全选/反选。
3. 勾选“启用单卡超频”后可编辑单卡值；单卡空白继承统一值。
4. 单卡窗口“确定”保留输入并返回；“取消”放弃本次单卡编辑，两者均不写显卡。
5. 主页面“确定”才应用并保存所填参数。群控弹窗的“关闭”不提交输入。
6. “清空”只清表单；“默认值”将六项填为 0，仍需点击主页面“确定”才生效。
7. 统一值空白不修改，0 是明确重置。“刷新显卡”保留相同 PCI 地址的未提交输入。
显卡按 PCI 地址对应，不依赖列表编号；已移除或重复地址会报错，不转移到别的卡。
换槽或换卡后请刷新并检查保存的单卡配置。

执行与回报
所有目标先校验，再逐卡写入。写入、读回或保存失败会尝试回退本次修改。
偏移、功耗和风扇要求读回匹配。Windows NVML 没有独立的锁定目标读取接口，
涉及核心/显存锁定时仅回报“驱动接口已接受”，不把瞬时运行频率冒充锁定目标。
首次接管某项 Windows 锁频时，原目标不可读；失败回退和退出恢复将解除该锁频。
若由本程序先前设置且保存了目标，则使用所记录目标恢复；外部工具同时改动无法追踪。
回退失败会明确报错并保留恢复记录，不报成功。
旧客户端没有 oc_schema=2 时，群控拒绝发送六项指令并提示升级。
原版 4.6.1 的发现、启动、停止、任务等原有协议继续保留；六项超频需要配套新版客户端。

Windows 后端
工具：tools/nvtool.exe。这是独立实现的 Windows 参数兼容工具，不是 Linux ELF 文件改名。
复用客户端同一套 NVAPI / NVML 后端，核心/显存偏移及风扇使用 NVAPI，
核心/显存锁定和瓦特功耗使用 NVIDIA 驱动自带 NVML。无需随包复制驱动 DLL。
写入需要以管理员身份运行。具体字段和范围以显卡、驱动支持为准；不支持则报错。
配置在 qskg.config 的 hive_oc，恢复记录在 overclock-v2/baseline.json，
最近由本后端设置的参数在 overclock-v2/desired.json。
挖矿启动时重用保存参数；停止或退出默认恢复接管前参数，“停止不恢复”沿用原行为。
启用六项配置后，旧版超频/单独风扇指令会拒绝混用，请在新面板调整。
--offline 和 --render 的超频面板为只读预览，不提交超频命令或恢复 GPU。

Windows 工具用法（只读）
  tools\nvtool.exe --help
  tools\nvtool.exe --all --json
  tools\nvtool.exe --dry-run -i 0 --setcoreoffset 0 --setcore 0 --setmemoffset 0 --setmem 0 --setpl 0 --setfan 0
写入参数：--setcoreoffset、--setcore（--setclocks 为别名）、--setmemoffset、
--setmem、--setpl、--setfan；支持重复 -i 或 --pci 选择显卡。
--data 指定独立状态目录，--restore 恢复该目录记录的接管前参数。
仅移植这六项参数与查询/预检/恢复子集，不声称支持 Linux nvtool 的全部选项及守护进程。

HiveOS 后端
1.6.17：原版群控的“温度”映射到 /hive-config/autofan.conf 的自动风扇目标温度。
正温度值启用自动风扇；同时勾选风扇时，风扇值作为最低转速百分比。
只下发风扇则切回固定转速；温度填 0 或关闭超频，恢复接管前的自动风扇设置。
保留原有显存温度、最高风扇、过热保护和 SMART_MODE；智能模式可能动态调整逐卡目标。
目标温度至少比现有过热保护温度低 10℃，不自动提高过热保护阈值。
逐卡设置按 HiveOS 的 PCI 顺序保存；配置与显卡修改共用校验和失败回滚。
2026-10-22 已在 CMP 50HX、RTX 3080、RTX 4070 SUPER 实机验证自动/固定风扇切换及恢复。
以下早期验证记录保留供追溯，当前验证范围以 1.6.17温控与连接验证.txt 为准。
已参考 nvtool 1.8.8 的真实帮助与只读输出，直接调用 /hive/sbin/nvtool，
参数数组传给进程，不拼接 shell 命令；每次写入前重新按 PCI 定位 nvtool 编号。
保存参数在客户端 state_dir/overclock-v2/desired.json，启动托管核心前重用。
停止挖矿沿用 HiveOS 保留超频的行为。每次修改前在 backups 中记录原值。
0.8.15 可直接接收原版群控的四项超频，自动迁移既有配置，和网页共用保存与恢复流程。
设置固定风扇时暂停 HiveOS 自动风扇；恢复自动或关闭超频时恢复此前的自动风扇。
原值不可读、同卡多个风扇目标不同、非整数瓦特无法精确恢复时，拒绝相应字段。
本次没有部署到现有 HiveOS 服务，也没有修改现有 HiveOS 配置或显卡值。

验证范围
实机只读：Windows RTX 5060 Ti；HiveOS CMP 50HX、RTX 3080、RTX 4070 SUPER。
Windows 六项只读预检通过。实际硬件写入/稳定性和不同驱动支持情况未做验收。
界面、协议、继承/覆盖、范围、PCI 映射、持久化失败及回滚使用隔离测试验证。

参考
HiveOS 官方超频口径：https://hiveon.com/knowledge-base/getting_started/start_oc/
NVIDIA 官方 NVML / nvidia-smi：https://docs.nvidia.com/deploy/nvidia-smi/index.html
nvtool 1.8.8 帮助记录：群控源码 reference/nvtool-help-20261019.txt
