Braiins OS API 1.15.0为挖矿暂停请求增加标签
来源发布日期: 2026-09-16 · 编辑分析发布日期: 2026-09-18
9月16日API更新加入可选暂停标签并修正许可证注释。本文说明集成验证，不将其解释为费用变更或自动恢复功能。
分析与实际影响
本节为本站分析及示例计算，与来源报道分开呈现。
官方确认的接口变化
Braiins把Public API 1.15.0标为2026年9月16日发布。PauseMiningRequest新增可选字段tag，用来携带与暂停动作关联的、不透明的标签值。版本记录同时修正了四种许可证消息中关于受限模式和开发者费用的注释。注释修正不等于公司宣布改变费用，也不意味着许可证状态规则被重新定义。API版本号与某台矿机实际安装的固件版本号应分别记录。本文后续内容是本站对集成流程的分析，不把这次接口更新写成所有ASIC已经获得某种新控制功能，更不将一个可选字段解释为完整的自动化系统。
标签是标识，不是控制策略
集成程序可以选用本地维护工单或事件编号作为自己的标签，但不能因为文字写成某个词就推导出设备会执行相应策略。例如，把标签命名为energy-window，不会自动定义电价阈值、暂停持续时间或恢复条件。这些运营决定应放在独立的控制器配置中，并由负责人审查。官方版本说明没有确认标签会保存多久、能否在回复中返回，也没有声明它提供幂等执行或自动恢复保证。本站建议把标签视为有助于组织记录的标识信息，不把它当成脚本命令、设备权限或状态机。对于集成方来说，最重要的是明确哪些行为来自已经验证的接口，哪些仍需要由自己的软件实现并测试。
本地动作日志仍然不可缺少
我们建议在矿场控制器的本地动作日志中，分别记录目标设备身份、请求时间、预期动作、自己选定的标签以及收到的实际回复。失败、超时和明确拒绝也应保留，而不是仅保存成功提交。这样的本地关联不依赖于设备在下一次查询中再次返回tag，因此不会把尚未确认的接口能力当成设计基础。密码和访问令牌不应写进日志。批量任务还应保存每台设备的结果，因为同一批次可能出现部分成功、部分失败；一个请求成功不能代表所有目标完成。交接时，工单编号与设备状态应能分开查阅。标签有助于关联本地记录，但完整审计仍取决于集成程序是否正确保存证据，而不是字段名称本身。
收到回复与实际暂停是不同证据
得到暂停请求的回复之后，操作员仍应独立查看矿机实际状态，并选择合适的时间窗口观察生产结果。矿池侧数据可能延迟，风扇、网络设备及其他辅助负载也可能继续消耗电力。因此，单个接口回复不能证明整座场地已经降到零功耗，更不能代替电表。若请求结果不明确，不宜盲目重复提交；应先检查设备和控制器当前状态，确认是否需要后续动作。本站把收到回复、设备暂停和站点功率变化看作三种不同证据，它们分别回答不同问题。这样的验证过程是我们的建议方法，不是tag新增的事务保证，也不意味着某个回复格式必然包含设备的最终物理状态。只有实测才能判断控制动作在具体环境中的效果。
许可证注释不等于新的收费表
我们不建议因为许可证说明文字被编辑，就修改矿场的收益表或费用百分比。审核时，应把实际商业条款、已经安装的配置，以及真实账单或扣除金额进行比较。开发者费用、矿池手续费和托管费用属于不同成本类别，不能仅凭一个术语把它们合并。若管理界面的解释需要更新，文字仍应与现行协议一致。API版本记录能说明文档注释发生了修正，但不能独立证明收费比例变动。对用户来说，最可靠的做法是保留原合同、费用记录和软件环境，出现差异时再向服务方核实。本文没有提供新的费率，也没有把注释变化描述为取消费用、增加费用或改变许可权限，避免让技术版本新闻影响未经证实的经济估算。
先验证客户端与已安装固件
重新生成API客户端，并不会自动更新矿机上运行的服务。本站建议选择一台备用设备，记录固件版本与控制板身份，然后先测试不带新增字段的普通暂停，再在已确认支持的环境中测试可选字段，并检查错误表现。旧设备应保留明确的兼容处理路径，不能因为目录里有某个型号就假设它实现了同一套接口。对错误结果应进行分类：客户端编码、网络连接、权限和服务兼容性需要不同处置，不能统一理解为硬件故障。不要为了获得新的接口定义，就把不适用于该控制板的固件写入设备。本文讨论的是集成验证方法，不提供某个型号已经兼容的未经证实承诺；实际部署前仍要核实厂商说明及安装环境。
电力效果需要单独测量
本站给出一个纯粹假设的计算：两台设备分别消耗3千瓦，在半小时窗口内的设备总电量为2 × 3 × 0.5 = 3千瓦时。这个数字不是实测节省，也不是Olenox或Braiins披露的运营数据。剩余辅助负载、状态切换所需时间，以及暂停导致的生产损失，都会改变最终效果。因此，现场应依据电表和实际产出来评估，而不是把理论设备电量全部计入收益。控制器还应明确经批准的暂停何时结束，以及谁负责核查和授权恢复。标签不能独立给出这些答案。本例只是说明计量边界：设备层、场地层和经济层的指标需要分开，接口消息成功也不能替代能耗测量或人员确认。
矿场软件维护者下一步做什么
对于维护矿场软件的人员，下一步应是查看官方接口定义、调整自己的本地日志设计，再在小范围且经过批准的样本上验证，最后才考虑扩大部署。请求、回复和最终设备状态应成为可以分别核对的记录。如果业务没有使用标签的需求，可选字段也允许保持较简单的集成，不必仅为追求版本号增加不必要的逻辑。本文解释的是API变更，不是固件下载文件，也不是全部ASIC支持该接口的证据。需要安装固件时，应进入准确型号的固件页面核对文件与控制板兼容性。文章的历史技术插图不表示照片中的设备已经安装本次软件；功能结论仍来自官方版本记录，部署判断则需要与真实设备环境对应。
挖矿计算器 ↗
