从 HiveOS 迁移到 RigeOS
迁移不需要从整座矿场同时开始。推荐先记录 HiveOS 中的原配置，在一台非关键矿机上停止 HiveOS 原生控制、安装 RigeOS Client、导入飞行表并完成验证；稳定后再按批次迁移其他矿机。
不要让两个平台同时控制同一资源
HiveOS 和 RigeOS 同时修改 MINER、超频、风扇或网络设置，可能造成配置反复覆盖、MINER 重启或矿机失联。RigeOS 不接管、不停用也不恢复 HiveOS 原生 Client 或服务；迁移前必须由用户停止原控制链，并确保同一资源只有一个控制者。
当前支持范围
RigeOS 当前支持从剪贴板识别并导入单挖、单个 Custom Miner 的 HiveOS 风格飞行表 JSON。导入时会保留可识别的矿池、MINER 和扩展配置，并要求重新关联 RigeOS 钱包。
这里的“兼容 HiveOS”仅指飞行表 JSON 导入和 HiveOS Custom Miner 包格式兼容，不表示 RigeOS 会连接 HiveOS 账户、复用其设备身份或管理 HiveOS 原生服务。
以下配置目前不能直接导入：
- 一个飞行表包含多个 MINER；
- 双挖配置；
- HiveOS 内置 MINER；
- 缺少币种、MINER 名称、HTTPS 下载地址、钱包模板或矿池地址的 Custom Miner 配置。
JSON 导入不等于 MINER 包已经兼容
导入功能负责转换飞行表配置，不会自动改造 MINER 压缩包。RigeOS Client 可以识别原生 rigeos-miner.json，也可以受控运行包含完整 h-manifest.conf、h-config.sh 和 h-run.sh 的 HiveOS Custom Miner 包；只有 Linux 二进制的裸包不能直接使用。参见 MINER 开发者：适配 RigeOS 飞行表。
第 1 步：记录 HiveOS 当前配置
迁移前，为每种硬件和挖矿策略至少保存以下信息：
| HiveOS 信息 | 在 RigeOS 中的用途 |
|---|---|
| Farm 和 Worker 名称 | 创建矿场并规划矿机名称。 |
| 币种与钱包地址 | 创建同币种的 RigeOS 钱包。 |
| 矿池地址与备用地址 | 核对导入后的主矿池及故障切换策略。 |
| Worker 模板 | 核对矿池侧显示的 Worker 名称。 |
| MINER 名称、版本和下载地址 | 判断是否已有兼容 RigeOS 的安装包。 |
| 算法、密码和附加参数 | 核对导入后的 MINER 配置。 |
| 超频、风扇和 Watchdog | 在单独的控制页面重新建立并逐项验证。 |
不要把 HiveOS 登录密码、API Key、私钥或助记词复制到飞行表 JSON、备注或截图中。
第 2 步：建立 RigeOS 矿场并接入测试矿机
- 登录 RigeOS 并创建一个矿场。
- 选择一台不承载关键任务、具备现场或带外恢复方式的矿机。
- 按安装 RigeOS Client生成安装短码命令，并在该矿机执行。
- 等待矿机出现在 RigeOS 工作台，确认在线状态、硬件数量和最后上报时间正常。
- 此时先不要批量下发飞行表、超频或网络配置。
安装 Client 并开始上报，不会自动停用其他控制程序。下发飞行表或其他写操作前，请自行确认 HiveOS 原生 Client、MINER、Watchdog 和调优脚本已经停止；如页面仍提示控制冲突，请按控制冲突与安全切换处理。
第 3 步：迁移钱包
HiveOS 的钱包 ID 只在 HiveOS 内有效，不能在 RigeOS 中直接复用。请在当前 RigeOS 矿场进入“钱包”，创建同币种钱包，并重新核对地址首尾字符和网络。
如果导入飞行表时还没有同币种钱包，也可以在导入窗口中创建钱包并自动关联。无论使用哪种方式，都不要只凭钱包名称相同就跳过地址核对。
第 4 步：导入 HiveOS 飞行表 JSON
- 准备完整的 HiveOS 风格飞行表 JSON。它可以来自你保存的配置，或 MINER 开发者提供的配置模板。
- 在 RigeOS 当前矿场进入“飞行表”。
- 选择“从剪贴板导入”，然后粘贴 JSON 或使用“读取剪贴板”。
- RigeOS 识别到 HiveOS 结构后会自动开启“HiveOS 格式”；未自动识别时，可以手动开启后重新解析。
- 重新选择或创建同币种的 RigeOS 钱包。
- 核对飞行表名称、币种、MINER、下载地址、钱包模板、矿池、算法、密码及附加参数。
- 确认没有不兼容提示后，选择“导入飞行表”。
导入过程中需要特别注意：
- HiveOS 数字钱包 ID 会被移除，必须重新关联 RigeOS 钱包；
pool_urls存在多个地址时，第一项作为当前主地址；其余候选是否自动切换取决于 MINER 版本的适配规则；- 未知扩展字段会尽量保留，但保留不表示当前 Client 会执行这些字段；
- MINER 下载地址必须使用可公开访问的 HTTPS 地址；
- 导入成功只表示飞行表已经保存，不表示 MINER 已经在矿机上运行。
第 5 步：接管并验证单台矿机
- 在矿机列表只选择测试矿机。
- 下发刚导入的飞行表版本。
- 出现控制冲突提示时，先检查并停止冲突程序；确认测试矿机只由 RigeOS 控制后再继续。
- 等待任务从“等待领取”或“执行中”进入“成功”；失败时先查看具体原因，不要连续重复下发。
- 在矿机详情确认实际飞行表版本、MINER 状态、日志、GPU 温度、功耗和算力。
- 在矿池侧确认 Worker 名称、在线状态和有效份额。
- 保持观察一段时间，确认没有持续重启、算力波动或控制冲突事件。
第 6 步：分批扩大迁移范围
单台测试稳定后，按相同硬件、驱动和飞行表分组，每次迁移少量矿机。每个批次都要确认任务结果、MINER、算力和矿池侧 Worker，再继续下一批。
不要把以下动作放进同一个批次：
- 切换管理平台并同时修改超频；
- 切换飞行表并同时更新 Client；
- 修改网络并同时移除 HiveOS 恢复入口；
- 把未经测试的 MINER 包直接下发到全部矿机。
如何回退到 HiveOS
测试失败且需要回退时：
- 在 RigeOS 停止当前飞行表或受管 MINER。
- 按正式卸载或停用流程停止 RigeOS Client；不要只删除部分状态文件。
- 由用户自行恢复 HiveOS 原生 Client 和服务，并重新应用迁移前记录的飞行表与控制配置。
- 确认 HiveOS Worker、MINER、超频和矿池侧数据恢复正常。
- 不要把 RigeOS Client 留作 HiveOS 的只读代理，也不要让两个平台重新同时写入。
RigeOS 不提供“一键恢复 HiveOS 服务”。迁移前记录的配置和可用的系统恢复方式，是回退能否成功的关键。
迁移完成检查清单
继续阅读：下发飞行表与查看进度和飞行表或 MINER 异常。
HiveOS 字段含义可参考其官方的钱包和飞行表说明与 Custom Miner 指南。