一个在你自己电脑上运行的小程序：在 vast.ai 上按利润率自动租显卡挖 Pearl（PRL），自动部署矿工、实时监控每台机器的算力和收益、亏损自动退租，并支持 Pearlhash / Kryptex 两个矿池一键切换和故障自动切换。

这份说明覆盖程序的每一个页面、每一个按钮、每一个输入框：该填什么、去哪里拿、填了有什么用、怎么设置比较合适。第一次用建议从头读到「第 6 节」，其他部分用到时再查。

作者：X:@zaijin338191　·　许可证：MIT（见 LICENSE）

1. 风险提示（务必先看）
2. 程序是怎么工作的（一分钟看懂）
3. 运行环境要求
4. 安装与启动
5. 准备工作：需要哪些信息、每一项去哪里获取
6. 第一次配置：手把手 8 步
7. 界面总览：左侧栏和顶部栏
8. 「矿场总览」页详解
9. 「矿池」页详解
10. 「市场机会」页详解
11. 「显卡算力」页详解
12. 「运行日志」页详解
13. 设置窗口：每一项的详细说明
14. 自动租用：完整规则
15. 自动退租：完整规则
16. 多矿池、切换与故障自动切换
17. 收益、收益率是怎么算的
18. 租到的机器上发生了什么（部署流程）
19. 推荐设置方案
20. 日常操作指南
21. 数据、隐私与安全
22. 常见问题与排错
23. 更新、迁移与卸载
24. 目录结构与开发者信息
25. 更新记录

• 会真实花钱。 打开「自动租用」后，程序会用你 vast.ai 账户里的余额租机器，按秒计费、按小时报价。第一次请只充值 $10~20 测试，确认一切正常再加大。
• 收益不保证。 挖矿收益取决于 PRL 币价、全网算力、矿池运气、租金，任何一项变化都可能让盈利变成亏损。程序有止损，但止损只能减少损失，不是保险。
• 本程序不是投资建议，作者不对任何收益或损失负责（MIT 许可证，按现状提供）。
• 平台规则请自行确认。 在 vast.ai 上挖矿是否符合其服务条款、你所在地区是否允许挖矿，请自行了解并承担责任。
• 第三方矿工软件。 Pearlhash 用 WildRig Multi（挖 PRL 0 开发费），Kryptex 用 SRBMiner-MULTI（约 2% 开发费）。程序在租到的机器上从它们的 GitHub 官方发布页下载，不会装到你自己的电脑上。
• 关掉程序 ≠ 停止花钱。 程序关掉后，已经租的机器会继续挖矿、继续扣费，只是没人帮你止损了。彻底停止的方法见 20.5。

你的电脑（只需开着程序，不需要显卡）
   │  ① 每隔一段时间搜索 vast.ai 上可租的显卡
   │  ② 用实时币价 + 全网算力算出每台机器的预计收益率
   │  ③ 收益率达标 → 自动租下，并把「开机脚本」交给机器
   ▼
vast.ai 上租到的机器
   │  ④ 开机后自动下载矿工（WildRig / SRBMiner），连上你选的矿池开始挖
   ▼
矿池（Pearlhash / Kryptex）
   │  ⑤ 程序每 15~30 秒读一次矿池上每台机器的算力
   │  ⑥ 算力异常、掉线、亏损 → 自动重启或退租
   ▼
挖到的 PRL 直接由矿池打到你填的钱包地址（程序不经手任何币）

• 程序只在你电脑上运行，控制台网页地址是 http://127.0.0.1:8290，只有本机能打开。
• 程序不经手你的币：币由矿池直接打到你的钱包；程序只需要 vast 的 API Key（用来租机器）和你的钱包地址（不是私钥、不是助记词）。

1. 下载程序压缩包，解压到任意文件夹（例如 D:\PRL-Vast-AutoMiner）。路径里有中文也可以。不要直接在压缩包里双击运行。
2. 双击 一键启动.bat。
   • 第一次启动如果电脑上没有 Node.js 22+，窗口里会显示「正在自动下载便携版」，等 1~2 分钟。
   • 启动成功后窗口里会显示 PRL 自动租卡挖矿控制台已启动： http://127.0.0.1:8290，同时浏览器自动打开控制台。
3. 那个黑色命令行窗口就是程序本身：最小化可以，关掉它程序就停了（已租的机器会继续计费）。

1. 解压后打开「终端」，进入程序文件夹：cd 程序所在路径
2. 第一次运行先加执行权限：chmod +x start.sh
3. 运行：./start.sh。没有 Node.js 22+ 时会自动下载便携版。
4. 启动后浏览器会自动打开；没打开就手动访问 http://127.0.0.1:8290。

• 到 https://nodejs.org 下载 LTS 版（22 或以上）安装，再重新双击 一键启动.bat。
• 国内网络可以设置环境变量 NODE_MIRROR 指定下载源（默认会依次尝试 nodejs.org 和 npmmirror 镜像）。

• 每次开电脑后双击 一键启动.bat 即可，设置都会保留（保存在 data/ 文件夹）。
• 浏览器关了可以随时重新打开 http://127.0.0.1:8290，不影响程序运行。
• 如果提示「端口 8290 被占用」，说明程序已经在运行了，直接打开网址即可。

先看总表，下面逐项讲怎么拿：

1. 打开 https://cloud.vast.ai/ ，右上角 Sign Up，用邮箱注册并点击邮件里的验证链接。
2. 打开 Billing（https://cloud.vast.ai/billing/），点 Add Credit 充值。支持信用卡和加密货币（USDC 等）。
3. 第一次建议只充 $10~20，跑一两台确认整个流程正常后再加。
4. 充值后余额会显示在程序「矿场总览」右上角的「vast 余额」卡片里。
5. 余额用完时，vast 会停掉你所有的机器，所以要留意余额（程序有「余额保留」和「续航保护」，见 13.2 和 13.3）。

1. 登录 vast.ai，打开 https://cloud.vast.ai/manage-keys/ （网页左侧菜单 Keys）。
2. 点 + New（或 Create API Key），名字随便填（例如 prl-auto）。
3. 权限保持默认的完整权限：程序需要读余额、搜索机器、租用、重启、改标签、读日志、销毁机器，少一项都会有功能用不了。
4. 复制生成的那一长串字符，粘贴到程序「⚙ 设置 → 账户 → vast.ai API Key」，点保存。
5. 保存后左下角的「vast.ai」小圆点变绿、顶部出现余额，就说明 Key 正确。
6. 安全提醒：API Key 等同于你账户的使用权，拿到它的人可以花你的余额。不要发给任何人，不要截图发群。万一泄露，到同一页面删掉它再新建一个，然后在程序里换成新的。

关于 vast 的搜索额度：vast 对「搜索可租机器」有每日额度（按返回的条数计，UTC 0 点 = 北京时间早上 8 点重置）。程序会自动控制扫描频率，额度用完会暂停扫描直到重置，期间已租机器照常监控。详见 14.2。

推荐使用 Pearl 官方桌面钱包（开源，由 Pearl Research Labs 发布）：

1. 打开 https://github.com/pearl-research-labs/pearl/releases ，在最新版本下方的 Assets 里下载对应系统的安装包（Windows 选 .exe，macOS 选 .dmg）。
2. 安装后打开，点 Create A New Wallet，设置钱包名称和密码。
3. 钱包会显示一组助记词（seed phrase）。用纸笔抄下来，保存在安全的地方：丢了就永远找不回币；任何人拿到助记词都能转走你的币。不要拍照、不要存在网盘或聊天记录里。
4. 点 Receive（接收），复制 prl1 开头的地址。
5. 把地址填到程序左侧「矿池」页对应矿池卡片的「收款钱包（PRL）」，点保存。

补充说明：

• 程序会校验地址格式（bech32 校验和），错一个字符都会显示「✗ 地址无效」，避免白挖。
• Pearlhash 和 Kryptex 可以填同一个钱包，也可以填不同的钱包。填不同的钱包，两边的收益在钱包里分得清清楚楚，方便对比哪个矿池更赚。
• 也可以用交易所（例如 BigONE）的 PRL 充值地址，但交易所可能更换充值地址、有最低入账金额，而且「不是你的私钥就不是你的币」，不推荐。

Pearlhash 支持合并挖矿：挖 PRL 的同时，按同样的算力份额额外分 NOCK（Nockchain 的币），相当于多一份收益。

1. 安装 Iris Wallet（Chrome 浏览器扩展）：https://iriswallet.io ，创建钱包，抄好助记词，复制收款地址（一长串字母数字）。 也可以用官方命令行钱包：https://github.com/nockchain/nockchain （命令 nockchain-wallet keygen）。
2. 把地址填到「矿池」页 → Pearlhash 卡片 → NOCK 收款地址（可选），点保存。 之后新租的机器会用 PRL地址@nock=NOCK地址 作为用户名登录 Pearlhash。已经在挖的机器不受影响。
3. 在矿池登记：Pearlhash 要求 NOCK 地址登记一次后才会打款，有两种方式（以 https://pearlhash.xyz 官网说明为准）：
   • 用 Pearl 钱包对指定内容签名，在官网提交；
   • 或者让所有矿工都用 @nock= 用户名连续挖满约 24 小时，矿池会自动登记（本程序就是这样做的，你什么都不用操作）。
4. 登记成功后，「矿场总览」顶部「每 TH/s 日收益」卡片右上角会从「NOCK 未登记」变成显示 NOCK 加成。此时勾选「把 NOCK 收益计入利润」，NOCK 才会算进收益率。

• Pearlhash：https://pearlhash.xyz ，在页面的查询框（Lookup）输入你的 PRL 地址。
• Kryptex：https://pool.kryptex.com/prl ，右上角输入你的 PRL 地址。
• 程序内：「矿池」页的「收益对比」会直接读取两个矿池的累计收益，算出各自的实际收益率（见 9.2）。

1. 启动程序（第 4 节），浏览器打开控制台。顶部会出现蓝色提示「第一次使用：先在设置里填 vast API Key……」。
2. 填 API Key：点右上角齿轮 ⚙，在「账户」里粘贴 vast.ai API Key，点「保存」。等几秒，左下角「vast.ai」变绿，顶部显示余额。
3. 填钱包：点左侧「矿池」。
   • 在 Pearlhash 卡片的「Pearlhash 收款钱包（PRL）」粘贴你的 prl1 地址，出现「✓ 地址校验通过」后点「保存」。
   • 想要 NOCK 就再填「NOCK 收款地址」，保存。
   • 想同时用 Kryptex，就在 Kryptex 卡片里也填钱包并保存（可以和 Pearlhash 用不同的地址）。
4. 选默认矿池：在你想主要使用的矿池卡片上点「设为默认」。不确定就用 Pearlhash（手续费低、有 NOCK）。
5. 设置策略：⚙ 设置 → 策略。第一次测试建议：目标收益率 20~30、止损线 0、最多同时租 2、每小时最多花费 0.5。详见 19。
6. 看看市场：点左侧「市场机会」，看有多少台机器是绿色（达标）的、收益率大概多少，心里有个数。
7. 先手动租一台（推荐）：在「市场机会」里挑一台绿色的点「租用」，确认后回到「矿场总览」观察它从「部署中」到「挖矿中」的全过程，一般 2~5 分钟。
8. 打开自动租用：确认第一台正常出算力后，打开右上角「自动租用」开关（会弹窗确认）。之后程序会自动找达标的机器租下。「自动退租」默认就是开着的，保持开着。

• 综合收益率仪表盘：所有在租机器合计的收益率（利润 ÷ 租金）。指针在绿色区 = 达到目标；刻度线是你设置的目标收益率。下面一行是「N 台 · 每天净利」。
• 连接状态卡片：「实时监控中」= 一切正常；「连接异常」= 有数据源连不上（下面一行显示原因）；「等待配置」= 还没填 API Key。
• 数据源小圆点（绿 = 正常，红 = 异常，灰 = 未启用）：
  • Pearlhash / Kryptex：矿池数据（每台机器的算力、待结算），右边显示多久前更新
  • vast.ai：余额和实例列表
  • 市场扫描：上次扫描 vast 市场的时间
  • NOCK 价格：NOCK 币价来源（CoinGecko 或备用的 CoinLore）
• WILDRIG：程序从 GitHub 查到的 WildRig 最新版本号，新租的机器用这个版本。程序每 6 小时检查一次新版本。
• 端口：控制台使用的端口（默认 8290）。

• 自动租用 开关：打开后，达到目标收益率的机器会被自动租下并部署。会真实花钱，打开时会弹窗确认。默认关闭。
• 自动退租 开关：打开后，本程序租的机器在部署失败、掉线、离线、跌破止损线时自动退租。强烈建议一直开着。默认打开。
• 状态标签：「AUTO RENT」= 自动租用中；「AUTO · 暂停」= 开着自动租用但暂时不满足下单条件（原因见顶部横幅）；「WATCH ONLY」= 只监控不租。
• 时钟：当前时间。
• ⚙ 设置：打开设置窗口（第 13 节）。

页面最上方有时会出现一条提示，按重要程度只显示一条：

每台机器一张卡片，异常的机器排在最前面并标红。卡片右上角的标题旁边会显示「最近 20 台平均部署 X 分 X 秒（拉镜像 · 启动矿工）」。

卡片头部

• 2× 图标：这台机器有几张显卡。
• 型号（如 RTX 3090）、实例号（#57038747）、地区、已租时长、显卡温度、显卡负载。
• 矿池标签（如「Pearlhash ⇄」）：这台机器正在挖的矿池。点一下可以切换到另一个矿池（见 16.2）。灰色不能点时，鼠标悬停会显示原因。
• 状态标签：

卡片中部

• 算力 · 5 分钟：最近 5 分钟平均算力，右边是「实测 ÷ 预期」的百分比。刚开始挖的前 3 分钟显示「刚开始挖，算力爬升中」。
• 算力曲线：实线 = 实测算力；虚线 = 预期算力；阴影 = 合理范围（预期 × 算力异常线%）。下方标注「预期 X · 下限 Y TH/s」。
• 逐卡算力条（多卡机器，Pearlhash 才有）：每张卡的算力，中间的刻度线是单卡预期值。某张卡明显短 = 这张卡有问题。
• 时租 / 收益每小时 / 利润每天。
• 大号收益率数字 + 进度条：这台机器的实时收益率；绿色 = 达到目标，橙色 = 盈利但未达标，红色 = 低于止损线。进度条上的刻度是目标收益率。
• 提示条（有情况时出现）：
  • 「① 正在拉取镜像并开机（带宽 X Mbps）（共 X 分，超过 X 分钟无算力自动退租）」
  • 「② 已开机 X 分，正在下载矿工并连接矿池」，后面可能带「机器日志：……」关键信息
  • 「跌破止损已 X 分钟，满 X 分钟将自动退租」
  • 「算力只有预期的 X%」等

卡片底部

• 部署用时：「部署 X 分 X 秒（镜像 X · 矿工 X）」，记录这台机器从租下到出算力用了多久。
• 矿工 v57038747 · 绑定：这台机器在矿池里的矿工名（本程序租的机器是 v + 实例号）。点「绑定」可以手动指定矿工名（给你自己手动租、矿工名不一样的机器用，绑定后就能看到它的算力）。
• 日志：读取这台机器的输出（开机脚本的 [prl] 进度、矿工输出）。部署卡住、没算力时先点这个看原因，弹窗顶部会提取一行「关键信息」。
• ↻ 重启：重启容器。磁盘保留，开机脚本会自动重新拉起矿工，不会多扣费。适合算力突然掉、矿工卡住的情况。5 分钟内不能重复重启。
• 退租：立即销毁这台机器，停止计费。会弹窗确认。

改钱包只影响之后新租的机器；已经在挖的机器继续用租用时的钱包。

用矿池实际到账来比较两个矿池哪个更赚，比理论值更真实。

• 顶部按钮切换统计范围：24 小时 / 7 天 / 全部。
• 各列含义：

• 收益率最高的那行会标「收益率最高」。
• 注意：Pearlhash 按出块分配、按小时结算，有 12 小时延迟，短期受运气影响很大；Kryptex 实时入账。**至少比 23 天**，最好两边放同型号的显卡再比。

• 自动切换 开关：默认打开。两个矿池都填了钱包才会生效。
• 故障持续 N 分钟才切：默认 5 分钟，可填 2~60。
• 下方列出历史切换记录（时间、从哪个池切到哪个池、几台、原因）。
• 规则详见 16.4。

列出 vast.ai 上可租的机器，按预计收益率从高到低排序。

标题右侧的灰色小字依次是：

• 「上次 X 秒前 · 精准搜索 N 个型号 / 全量搜索 · 共 X 台 · 已知型号 X」：上次扫描的时间、搜索方式（见 14.2）、返回的机器数、其中程序认识算力的型号数。
• 「今日已搜 X 次 / X 条」：今天用掉的 vast 搜索额度。
• 「下次扫描 HH:MM:SS」：下一次自动扫描的时间。额度紧张时后面会注明「按学到的每日额度均匀分摊」等原因。
• 只看达标：勾选时只显示收益率达到目标的机器。
• 立即扫描：马上扫描一次（会用掉一次搜索额度）。

实测值是怎么来的：机器挖矿稳定后（最近 15 分钟至少 8 个样本、没有掉线、所有卡都在线），每 10 分钟取一次单卡算力，和当前值做加权平均；累计 3 次后替换参考值。明显异常的机器（低于当前值 25% 或高出 35%）不参与校准，避免一台坏机器把标准拉低。

「达标时租上限」可以直接拿去 vast 网页比价：某型号的单卡价格低于这个数，就值得租。

• 记录程序做过的所有事情：租用、出算力（含部署用时）、退租（含原因）、重启、切换矿池、故障切换、设置修改、各种报错。
• 颜色：绿色 = 成功，黄色 = 警告（退租、止损计时等），红色 = 错误，白色 = 普通信息。
• 页面只显示最近的若干条，完整记录在程序目录的 data/events.log，可以用记事本打开。
• 常见日志的含义：

点右上角 ⚙ 打开。改完点底部「保存」才生效；点「取消」放弃修改。保存后运行日志会记一条「设置已保存：改了哪些」。

钱包、NOCK 地址、默认矿池不在这里，在左侧「矿池」页设置。

最常用、最重要的几项：

点「高级设置（一般不用改）」展开。

「启动方式」「Docker 镜像」「磁盘」「矿工额外参数」「Pearlhash 矿池地址」只影响之后新租的机器。

用记事本打开程序目录的 data/config.json，先关掉程序再改，改完保存后重新启动：

自动租用打开后，每次扫描完市场都会尝试下单。以下情况会暂停下单（顶部横幅会写原因）：

• 没填 vast API Key，或还没读到 vast 余额；
• 没有任何矿池填了有效钱包；
• 还没拿到 WildRig 的下载地址（程序启动后几秒内会自动获取）；
• PRL 行情数据不新鲜（超过 5 分钟没更新，例如连不上 Pearlhash）；
• 已达到「最多同时租几台」或「每小时最多花费」；
• 余额低于「余额保留」，或开了续航保护且余额不够续航；
• vast 搜索额度用完或请求太频繁（暂停扫描）。

• 搜索条件：只看已验证、可租、未被租的按需（on-demand）机器，并满足你设置的最低可靠性、卡数上限、最低 CUDA、最低带宽、磁盘大小；单台时租不超过「每小时最多花费」。结果按「每美元算力」从高到低取前「每次搜索条数」台。
• 精准搜索（v1.1 新增）：
  • 程序从全量搜索结果里学习 vast 上各显卡型号的名字，之后只搜「程序认识算力、并且按当前币价有可能达到目标收益率」的型号。不适合挖矿的卡不再占用搜索条数，同样的额度能搜得更勤。
  • 每 6 次搜索做一次全量搜索，用来发现新上架的型号。第一次搜索、币价数据还没拿到时也用全量搜索。
  • 「市场机会」页顶部会显示「精准搜索 N 个型号」或「全量搜索」。
  • 如果 vast 不接受按型号搜索，程序会当次自动改用全量搜索，之后都用全量，日志里写明原因，不影响使用。
• 扫描频率：按「最短扫描间隔」扫描。自动租用关闭时 15 分钟看一次行情；已经租满或到达花费上限时暂停扫描，不浪费额度。
• 额度管理：vast 的搜索额度按返回条数计，每天 UTC 0 点（北京时间 8 点）重置。额度用完时程序暂停扫描到重置时间，同时记住你今天大约用了多少条，之后会按剩余额度把扫描均匀分摊到重置前。vast 提示请求太频繁时暂停 2 分钟。

1. 每台机器的预计收益 = 预计算力 × 当前每 TH 收益（按默认矿池的手续费，见第 17 节）。预计算力优先用「显卡算力」页里的实测值。
2. 只考虑：收益率 ≥ 目标收益率、型号不是「估算」、不在黑名单里、时租不超过剩余花费额度的机器。
3. 下单前一刻再按最新币价和全网算力重算一次，避免用几分钟前的数据下单。

• 一轮可以连续租多台（v1.1 新增）：一次扫描里同时有好几台达标，就按收益率从高到低连续下单，一轮最多租 5 台、最多下 8 次单，不再像以前那样每分钟只租一台。每租下一台都会重新核对台数上限、花费上限、余额保留、续航保护。两轮之间至少间隔 60 秒。
• 被抢走自动换下一台：便宜机器经常在「扫描」和「下单」之间被别人租走，vast 返回「已被租走」时，程序不拉黑这台机器，直接试下一台。
• 屏蔽「假机器」（v1.1 新增）：同一台机器（按 vast 的机器编号）2 小时内第 2 次「刚被租走」，说明它多半一直挂在列表里、实际租不了，程序会屏蔽它 2 小时，不再浪费下单机会。日志：「反复出现在列表里却租不到，屏蔽 2 小时」。
• 其他原因下单失败（例如 vast 报错），这台机器会被拉黑 6 小时。
• 租用时，所有填了钱包的矿池参数都会写进开机脚本（之后可以在面板上切换），先挖默认矿池。

只针对本程序租的机器（卡片上没有紫色「手动」标签的）。「自动退租」开关关闭时只提醒、不退租。

保护机制（这些时候不做退租判断）：

• 刚出算力的前 10 分钟（Kryptex 前 30 分钟，因为它只给 30 分钟平均算力）不判止损；
• 点了「重启」后的恢复期、正在切换矿池时；
• 连不上 vast 或矿池数据时，相关判断自动暂停（顶部会有红色横幅）；
• 程序重启后，记录里出过算力的机器不会被误当成「部署中」（v1.1 修复）。

被拉黑的机器在拉黑期内不会被自动租用，「市场机会」里会标出拉黑原因。

• 点机器卡片右上角的矿池标签，确认后切换。
• 原理：程序修改 vast 上这台机器的标签（pool=xxx），机器上的脚本每分钟读一次标签，变了就停掉旧矿工、启动新矿工。1~2 分钟生效，不用重启机器，不多扣费。
• 切换期间卡片显示「切换矿池」。8 分钟内没在新矿池出算力会自动改回原矿池，日志写明原因。
• 机器还在部署时切换：部署完成后直接挖新矿池。
• 不能切换的情况（标签变灰，鼠标悬停看原因）：你手动租的机器、旧版本程序租的机器、租的时候还没填该矿池钱包的机器（租用时只会把当时填了钱包的矿池写进机器）。

在「矿池」页目标矿池卡片上点「全部切到这里」，会弹窗告诉你几台能切、几台不能切，确认后批量切换。

在「矿池」页底部开关（默认打开），两个矿池都填了钱包才生效。

• 判定故障（满足任意一条）：
  • 矿池接口连续连不上超过「故障持续分钟」；
  • 在这个矿池挖的机器至少 3 台，并且六成以上同时没算力（v1.1 修复：以前是 2 台里 1 台没算力就判故障，太敏感，一两台机器自己出问题会被当成矿池故障）。
• 切走：故障持续「故障持续 N 分钟」（默认 5）后，把能切换的 vast 机器临时转到另一个矿池（另一个矿池也故障时不切）。
• 切回：原矿池恢复并稳定 15 分钟后自动切回。6 小时内反复故障时，等待时间翻倍（15 → 30 → 60…最多 4 小时），避免来回折腾。
• 每次切换都会记在「矿池」页的切换记录和运行日志里。
• 自动切换只针对 vast 的机器（v1.1 修复）。

看「矿池」页的「收益对比」（实际到账 ÷ 分摊的租金）。Pearlhash 短期受运气影响大，至少对比 2~3 天，最好两边各放同型号的显卡。

每 1 H/s 每小时收益（美元）
  = (3600 ÷ 平均出块时间) × 区块奖励 ÷ 全网算力
    × (1 − 矿池手续费) × (1 − 矿工开发费) × PRL 价格

Pearlhash，且矿池已登记 NOCK、并勾选「计入利润」时：再 × (1 + NOCK 加成)

单台每小时收益 = 算力 × 上式
收益率 = (收益 − 时租) ÷ 时租

• 币价、全网算力、出块时间、区块奖励来自 Pearlhash 的公开接口（链上数据），每 15 秒更新一次。
• NOCK 加成 = 每个 PRL 附带的 NOCK 数量（从同一结算周期的 PRL / NOCK 待结算反推）× NOCK 价格 ÷ PRL 价格。NOCK 价格来自 CoinGecko（CoinLore 备用）。
• 市场机会里用「预计算力」（显卡算力表）；已租机器用矿池上的「实测算力」（最近 10 分钟平均）。
• 以上是理论值。实际到账还受矿池运气、延迟份额、房东限功耗等影响，以「矿池」页的实际到账对比为准。

1. vast 拉取 Docker 镜像并开机（卡片显示「① 正在拉取镜像并开机」）。一般 30 秒~2 分钟，取决于机器网络和是否有镜像缓存。
2. 运行开机脚本（程序租用时自动生成，卡片显示「② 正在下载矿工并连接矿池」）：
   • 读取 vast 给每台机器自带的 CONTAINER_API_KEY，查询自己的标签，决定挖哪个矿池；
   • 从 GitHub 官方发布页下载对应矿工（WildRig 或 SRBMiner），同时从多个下载源下载，谁先下完用谁（国内机器优先走 ghfast.top、gh-proxy.com、ghproxy.net 镜像）；
   • 用守护循环运行矿工，矿工崩溃 10 秒后自动重启；
   • 每分钟检查一次标签，矿池变了就切换；
   • 每次启动矿工 90 秒后，把矿工最近的输出打印到机器日志（卡片「日志」里能看到是否连上矿池、有没有提交份额）。
3. 矿池上出现这台机器的算力（矿工名 v + 实例号），卡片变成「挖矿中」，并记录部署用时。

开机脚本的所有进度都以 [prl] 开头写进机器日志，例如：

[prl] 12:00:01 worker=v57038747 gpu=NVIDIA GeForce RTX 3090, 350.00 W;
[prl] 12:00:02 download wr from 4 sources in parallel
[prl] 12:00:20 downloaded wr in 18s from https://github.com/...
[prl] 12:00:21 miner ready: wr 0.51.7
[prl] 12:00:21 mining on pearlhash (wr)

第一行的功耗（350.00 W）可以用来判断房东有没有限功耗：3090 正常 350W，被限到 220W 左右算力会明显偏低。

• 「最短扫描间隔」改成 60，「每次搜索条数」改成 50（精准搜索下够用）。
• 适当降低目标收益率（每降 5%，能租到的机器会明显变多，但每台赚得少）。
• 不要把「最低可靠性」「最低下行带宽」放得太低，否则会租到大量部署失败的机器。

1. 先点卡片上的「日志」，看第一行的功耗是否被限、有没有报错。
2. 点「↻ 重启」试一次（不多扣费）。
3. 还是偏低就点「退租」，程序会自动租新的（如果开着自动租用）。

• 卡在「① 拉取镜像」：机器网络问题，超时会自动退租并拉黑。可以把「部署超时分钟」调小。
• 卡在「② 下载矿工」：点「日志」看下载情况。
• 改过「启动方式」为 SSH 模式的机器开机更慢，多等 3~5 分钟。

• 程序会显示它们，带紫色「手动」标签，只监控、不自动退租、不能切矿池。
• 如果它们也在挖 Pearlhash，点卡片底部「绑定」填它的矿工名，就能看到算力和收益。

• 关掉右上角「自动租用」即可，已租的机器继续挖、继续受止损保护。

1. 关掉「自动租用」。
2. 在每台机器卡片上点「退租」（或者到 vast 网页的 Instances 页面逐台销毁）。
3. 确认「已租显卡」里没有机器了，再关掉程序窗口。

• 所有设置和状态都保存在程序目录的 data/ 文件夹：
  • config.json：设置、vast API Key、钱包地址（明文保存，不要分享这个文件）
  • state.json：运行状态、收益账本、黑名单、实测算力、学到的 vast 型号名
  • events.log：运行日志
• 控制台只监听 127.0.0.1（本机），并且拒绝非本机的访问，局域网里其他人打不开。
• 程序只连接第 3 节列出的网站，不收集、不上传任何数据。
• 程序不需要也不会要你的私钥或助记词，只需要钱包地址。任何让你填助记词的「矿场程序」都是骗局。
• 截图求助时，注意遮住钱包地址、邮箱和 API Key。

Q：双击一键启动后窗口一闪就没了 / 提示找不到 Node.js？ A：一键启动会自动下载便携版 Node.js。如果下载失败（网络问题），到 https://nodejs.org 安装 LTS 版后重新双击。也可以先打开「命令提示符」，进入程序目录后运行 一键启动.bat，就能看到具体报错。

Q：杀毒软件（如 360）报毒 / 拦截？ A：属于误报：.bat 调用 PowerShell 下载文件的行为容易被启发式规则拦截。程序是开源的，可以自行检查代码。请把程序文件夹（以及 runtime\node\node.exe）加入信任区。如果 360 拦截了 node.exe 的网络，控制台会显示「程序连不上 vast / Pearlhash」的红色横幅。

Q：提示「端口 8290 被占用」？ A：程序已经在运行了（可能开了两次），直接打开 http://127.0.0.1:8290 即可。如果是别的软件占用了 8290，按 13.4 改端口。

Q：填了 API Key 但左下角 vast.ai 一直是红的？ A：① Key 复制不完整或多了空格，重新复制粘贴；② Key 已被删除，到 vast 网页新建；③ 网络连不上 vast.ai，填代理或检查杀毒软件。

Q：钱包显示「✗ 地址无效」？ A：PRL 地址是 prl1 开头、全小写的一长串。检查是否少复制、多复制了字符，或者复制成了别的币的地址。

Q：市场机会里一台达标的都没有？ A：说明按当前币价和全网算力，vast 上的价格不够划算。可以：① 等行情变化；② 适当降低目标收益率；③ 看「显卡算力」页的「达标时租上限」，判断差多少。另外，程序会按你租过的机器修正每张卡的算力（实测值），如果你租到的机器普遍跑不满，实测值会偏低，达标的机器也会变少。这是真实情况，硬租会亏。

Q：市场扫描显示「额度用完」？ A：vast 的每日搜索额度用完了，北京时间早上 8 点重置。期间不会自动租新机器，已租机器照常监控。可以调小「每次搜索条数」或调大「最短扫描间隔」。

Q：日志里很多「已被别人抢先租走」？ A：正常现象，便宜的机器竞争激烈。程序会自动试下一台；同一台反复租不到会被屏蔽 2 小时。想抢得更快，见 19.3。

Q：新租的机器部署很慢？ A：看卡片上卡在哪一步，见 20.2。

Q：算力只有预期的七八成？ A：常见原因是房东限制了显卡功耗（机器日志第一行会打印功耗，比如 3090 正常 350W，被限到 220W），或者显卡温度过高降频。这种机器可以手动退租，换一台。

Q：切到 Kryptex 后算力显示很低？ A：Kryptex 只给 30 分钟平均算力。程序前 30 分钟会按连接时长换算（数字前有「≈」），半小时后显示真实的 30 分钟均值。

Q：为什么某台机器不能切换矿池？ A：鼠标悬停在矿池标签上看原因：手动租的机器、旧版本程序租的机器、租的时候还没填该矿池钱包的机器都不能切。

Q：快速启动模式的机器怎么 SSH 登录？ A：不能登录。需要登录排查时，在设置里把「启动方式」改成 SSH 模式，之后新租的机器就能在 vast 网页上点 SSH / Jupyter 登录。

Q：一台挖了很久的机器突然被退租了？ A：看运行日志里的原因：「机器离线超过 10 分钟」说明 vast 报告它持续离线（房东机器断网或关机）；「矿工掉线超过 10 分钟」说明矿池连续 10 分钟看不到它的算力；「持续 X 分钟低于止损线」说明它在亏钱。v1.1 已修复「vast 短暂报一次离线就立刻退租」的问题。

Q：关掉程序会怎样？ A：已租的机器继续挖矿、继续计费，但没有止损、不会自动退租，也不会自动租新的。重新启动程序后会接着管理这些机器。

Q：电脑休眠了怎么办？ A：休眠期间程序暂停，机器继续计费。建议在系统电源设置里关闭自动休眠，或者用一台常开的电脑运行程序。

• 更新到新版本：
  1. 关掉程序窗口；
  2. 解压新版本到一个新文件夹；
  3. 把旧版本的 data/ 文件夹整个复制到新版本文件夹里（设置、账本、实测算力都在里面）；
  4. 双击新版本的 一键启动.bat。确认正常后可以删除旧文件夹。
  • 已经在挖的机器不受更新影响，新版本启动后会接着管理。
• 迁移到另一台电脑：复制整个程序文件夹（包括 data/）。runtime/ 可以不复制，会自动重新下载。注意两台电脑不要同时运行，否则会重复租机器。
• 卸载：先退租所有机器（20.5），然后删除程序文件夹即可。程序不写注册表、不安装到系统里。

一键启动.bat              Windows 启动（没有 Node.js 时自动下载便携版）
start.sh                  macOS / Linux 启动
scripts/install-node.ps1  下载便携 Node.js（多源、SHA256 校验）
server.js                 本地网页服务（只允许本机访问）
src/engine.js             核心逻辑：行情、扫描、租用、退租、止损、矿池切换、收益账本
src/vast.js               vast.ai 接口
src/pearl.js              Pearlhash 接口、收益公式、钱包校验
src/pools.js              矿池定义、Kryptex 接口、矿工参数
src/onstart.js            生成租用机器上的开机脚本
src/gpus.js               显卡算力参考表
src/store.js              设置与状态存储、默认设置
public/                   控制台网页
test/                     测试（全部接口都是模拟的，不会花钱）
data/                     你的设置和运行数据（自动生成，不要分享）
runtime/                  自动下载的便携 Node.js

• 运行测试：node test/run.mjs（会把程序复制到系统临时目录里跑，所有外部接口都是模拟的，不会碰你的 data/、不会花钱）。
• 没有任何 npm 依赖，Node.js 22+ 直接运行 node server.js。
• 环境变量：PRL_NO_BROWSER=1 启动时不自动打开浏览器；NODE_MIRROR=<地址> 指定便携 Node.js 的下载源。
• 想修改显卡参考算力：编辑 src/gpus.js（实测值会自动覆盖参考值，一般不需要改）。

vast 抢卡优化

• 精准搜索：只搜有可能达标的型号，每 6 次搜索做一次全量搜索；vast 不接受按型号搜索时自动退回全量搜索。
• 一轮可以连续租多台（最多 5 台），不再每分钟只租一台。
• 同一台机器 2 小时内两次「被抢走」，屏蔽 2 小时（假机器）。

Bug 修复

1. 挖了很久的机器被 vast 短暂报离线，就被立刻按「部署超时」退租：现在要连续离线 10 分钟才退租。
2. 程序重启后，出过算力的机器可能被当成「部署中」误杀。
3. 算力记录统一用字符串 ID 当键，避免非数字 ID 转成 NaN 后多台机器共用同一份记录。
4. 矿池故障判断太敏感：原来 2 台里 1 台没算力就切矿池，现在要至少 3 台、六成以上同时没算力才切；自动切换只针对 vast 的机器。

• 首个开源版本：vast.ai 自动租卡挖 PRL、Pearlhash / Kryptex 多矿池、故障自动切换、收益对比、一键启动。

致谢：WildRig Multi、SRBMiner-MULTI、Pearlhash、Kryptex Pool、vast.ai。本程序与以上项目和平台均无关联。