Quantus 矿工 · 2026-09-30

从网页矿组卡片点击“下载矿工”，复制当前矿组 ID。
连接配置：
  MQTT 地址：mqtts://s.mqtt.mikevillage.com:443
  主题前缀：external/minner
  用户名、密码：向管理员获取。Windows / Mac 图形版安装包不含账号凭据或钱包材料；Mac 命令行产品版例外，已按要求内置中转凭据。
  设备 ID：每台设备不同；重启沿用原 ID；复制文件到另一台设备后需改 ID。

Windows x64 / NVIDIA CUDA
1. Windows 10/11 64 位，安装支持 CUDA 12.4 的 NVIDIA 驱动；当前使用 GPU 0。
   已验证 RTX 4060 Ti，其他 NVIDIA 型号未逐一验收；不支持 AMD/Intel GPU。
2. 完整解压，程序与所有 DLL 放在同一目录。不需要安装 Go、Rust 或完整 CUDA Toolkit。
3. 用文本编辑器打开 mqtt.json，填写 MQTT 用户名和密码，保留合法 JSON 格式。
4. 双击 start.cmd，按提示粘贴矿组 ID、填写设备 ID；回车使用随机生成并保存的 ID。
5. 保持窗口运行，Ctrl+C 停止。此包不自动注册开机启动任务。

Mac / Apple Silicon Metal
1. 需要 Apple Silicon（M 系列）和 macOS 14+；不支持 Intel Mac。
2. 解压，将 QuantusWorker-macOS.app 移到应用程序后打开。
3. 应用为本地 ad-hoc 签名，未完成 Apple Developer ID 公证；若系统拦截，确认来源后
   使用系统“隐私与安全性”提供的打开提示，不需要关闭系统整体安全保护。
4. 填入上方 MQTT 地址、用户名、密码、主题前缀、矿组 ID；保留自动设备 ID 或自定义。
5. 点击“连接矿组”；保持 App 运行，退出应用或系统休眠会停止计算。

连接后的检查
- 网页“设备与矿工”出现对应设备并显示在线。
- 为该矿工开启温控保护；默认 Center 75°C、本机 82°C、恢复 65°C、最短休息 300 秒。
- 每台设备可独立修改参数。Mac 可能使用 SoC/CPU 替代读数或无法读取传感器，网页显示实际来源。
- 开启保护后持续未知读数会保守暂停，不要把未知当作低温。
- 当前矿组如已启用，矿工连接后可能立即开始真实计算；暂停的矿组等待启用。
- 矿组暂停、单机暂停、温控休息、没有矿长任务，均可能导致算力为零。
- 在线状态和 share 数量不代表收益到账。

故障排查
- 连接失败：检查网络、中转账号密码、主题前缀和矿组 ID；不需要填写 Center IP。
- Windows DLL 缺失：重新完整解压，不要只复制 exe；检查 NVIDIA 驱动和显卡支持情况。
- 同一设备反复上下线：确认没有其他设备使用相同设备 ID。
- 温控暂停：查看网页该设备“设置”中的真实读数、状态和恢复条件。
- SHA256SUMS.txt 提供安装包校验值。下载包不携带生产配置。

Mac 命令行产品版 / mini_launch
在网页矿组下载面板复制一行安装命令，安装时只输入工作空间名字。
程序已内置 MQTT 连接参数（包括账号密码），不再询问这些信息。
矿组 ID 随安装命令传入；设备 ID 由系统硬件 UUID 与工作空间生成并保存。
同一工作空间重启保持 ID，同机不同工作空间使用不同 ID。
已有目录不会覆盖；mini_launch 未安装时显示安装方法。
公开二进制内的凭据可被提取；此为用户明确指定的发布方式。