5分钟跑通Twitch自动掉宝：TwitchDropsMiner AFK挖矿入门指南-开发者社区

5分钟跑通Twitch自动掉宝：TwitchDropsMiner AFK挖矿入门指南

【免费下载链接】TwitchDropsMinerAn app that allows you to AFK mine timed Twitch drops, with automatic drop claiming and channel switching.项目地址: https://gitcode.com/GitHub_Trending/tw/TwitchDropsMiner

TwitchDropsMiner 是一款免费的开源 Twitch 自动掉宝（Twitch Drops）工具：它在后台通过模拟"观看"自动收集定时掉落的奖励，不下载直播视频流，并自动处理频道切换与奖励领取。本文面向需要长时间挂机掉宝的用户，从安装、登录到配置，带你完成第一次完整运行。

它适合谁、解决什么问题

一人多活动：Twitch 的掉宝活动经常同时开放多款游戏，你无法一直挂在浏览器前看流。这个工具按你设定的顺序自动轮换，挂机即可推进进度。
省流量：应用每隔几秒只拉取一次流的元数据就足以推进掉宝，完全绕开音视频下载；频道在线状态、观众数等变化则通过 websocket 连接维护，分片连接最多可同时跟踪199个频道。
省操作：当前频道下线、或有更高优先级游戏的频道上线时会自动切台；登录状态保存在本地 cookies 文件，不用每次重新登录。
自动发现活动：基于你已关联的账号自动发现可挖的掉宝活动，新活动出现时自动开始，全部挖完后自动停止。
边界也说清楚：它只针对掉宝，不挖频道点数；只支持单个受管账号；设计目标是本地随电脑开关机后台运行，而不是部署到远程服务器 7×24 小时托管。

开始前的前提条件

先关联游戏账号：必须在 Twitch 官方的掉宝活动页面把 Twitch 账号与游戏账号完成关联，没关联的游戏不会出现在可挖列表里。这一步工具无法代劳。
准备运行环境（二选一）：
- 预编译包：Windows 为 EXE、Linux 为 AppImage（推荐）或 PyInstaller 包、macOS 为.app压缩包，解压后直接运行即可；
- 源码运行：需要 Python 3.10 或更高版本。
同一账号别并行观看：挖矿期间如果用同一账号在浏览器里看直播，通常会导致进度报告错乱、卡在当前掉宝上。挖矿期间请让该账号只被工具使用。
稳定网络即可：无需特殊配置；如走代理，按下一节所述在系统环境变量里设置。

首次跑通：从安装到看到掉宝进度

方式一：源码运行

git clone https://gitcode.com/GitHub_Trending/tw/TwitchDropsMiner cd TwitchDropsMiner pip install -r requirements.txt python main.py

方式二：预编译包

从项目 release 下载对应平台的压缩包，解压后运行主程序，建议保留在解压后的目录里。

接下来两个方式都一样：

在应用内的登录表单中完成 Twitch 账号登录，登录状态会写入cookies.jar，之后无需重复登录；
登录成功后，应用会拉取你所有可挖的活动与游戏列表；
打开 Settings 选项卡，把想挖的游戏加入Priority List，然后点Reload，工具会拉取全部匹配的直播流并立刻开始挖矿；
需要时也可以手动切换到其他频道。

小提示：首次登录可能收到 Twitch 的"新登录"邮件，且检测到的浏览器会显示为 Chrome，这是工具向 Twitch 服务器呈现的方式，属正常现象。macOS 首次打开.app若被 Gatekeeper 拦截（提示"已损坏"），在终端执行xattr -cr <应用名>.app即可解决。

最影响效果的核心设置

Priority List（优先级列表）：决定挖矿顺序，把最想要的活动放最前面；
Exclusion List（排除列表）：不想参与的游戏直接排除，工具不会去挖；
Priority Mode（优先级模式）：用于规定"优先级列表之外"其余游戏的挖矿顺序，适合想让工具尽量不停下、继续挖其他活动的场景；
流校验是内置的：工具会检查流标签与掉宝活动的一致性，避免挖到根本不计入进度的直播流，一般无需人工干预。

设置改动后记得点 Reload 让其生效。

跑顺之后：进阶用法与参数调优

命令行参数（详见 manual.txt）：
- --tray：启动时最小化到系统托盘；
- -v：提高日志详细程度，可叠加（-vv、-vvv）；
- --log：把运行日志写入log.txt，级别跟随-v；
- --dump：以数据转储模式启动，生成dump.dat（匿名原始 API 数据，便于排障），转储完成后自动退出；
- --version：查看版本。
退出码速查：0正常退出；1被验证码拦截或发生致命异常；2命令行参数错误；3程序已在运行（请勿重复启动）；4设置文件加载失败。
代理：在系统环境变量中设置HTTP_PROXY/HTTPS_PROXY即可，应用走系统代理。
多语言：lang/目录下有 20 个语言包（含简体中文、日本語、Deutsch 等），在应用内切换语言即可生效。
开机自启（Windows）：通过当前用户注册表自启项实现，移动应用目录后需把该开关关闭再打开一次才会重新生效。
安全习惯：cookies.jar保存着登录凭证，拿到它的人可绕过密码进入你的账号，请妥善保管、不要外发。
杀毒误报：Windows 版由 PyInstaller 打包，个别杀毒引擎（含 Windows Defender）可能误报为木马，可忽略；不放心就从源码运行。
想理解原理：从 main.py 看入口与参数解析，twitch.py 是与 Twitch 交互的核心逻辑，settings.py 负责配置处理，websocket.py 管理实时连接。