TwitchDropsMiner 完整指南：零带宽挖完 Twitch 掉落的 199 频道自动切换免费教程

TwitchDropsMiner 完整指南：零带宽挖完 Twitch 掉落的 199 频道自动切换免费教程

【免费下载链接】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 是一款开源的 AFK 挖矿应用，专门处理有观看时长要求的 Twitch drops：它会自动"观看"直播、推进掉落进度、自动领取奖励，并在频道掉线时自动切换，全程不下载任何视频流数据。

你有没有算过一笔账：一场游戏掉落活动要求"累计观看 X 小时"，你只能开着浏览器盯着某个主播，他一下播就得手动找下一个，中途关掉窗口进度就停摆，而视频流本身还在哗哗地烧你的带宽。

讽刺的是，真正让 Twitch 服务器推进 drops 进度的，只是每几十秒一次"我正在看这个频道"的信号——画面和声音从头到尾都不需要。TwitchDropsMiner（社区里常缩写为 TDM）就是围绕这一点设计的：它替你完成整套挖矿流程，你只需偶尔瞄一眼。

三分钟看懂它到底做了什么

一句话概括：TwitchDropsMiner 通过周期性拉取直播元数据来伪装观看行为，以此推进 timed Twitch drops 的进度，并自动完成领取与换台，带宽消耗几乎可以忽略。

具体机制分两条线并行：

• 进度线：每约 59 秒（源码中WATCH_INTERVAL）向当前频道发一次观看事件，只涉及元数据请求，不触碰任何音视频数据，这就是 README 里说的 "stream-less drop mining"。
• 状态线：建立 WebSocket 连接实时接收频道上线/下线事件和观众数变化。连接采用分片式设计（最多 8 条 WebSocket，每条挂 50 个 topic，每个频道占 2 个 topic），算下来同时跟踪的上限是 199 个频道——够覆盖一场大型活动里所有能挖的直播。

其他值得知道的行为：

• 自动发现活动：基于你账号已关联（account linking）的游戏，自动拉取当前可挖的 campaigns；
• 双重校验：对直播的 stream tags 和活动资格都做了校验，避免把时间浪费在"看了也白看"的频道上；
• 自动启停：新活动出现就自动开始挖，最后一个 drop 领完就自动停下；
• 会话持久化：登录态存在cookies.jar里，之后每次启动免登录。

五分钟跑起来：最快的安装路径

路径一：预编译版（推荐新手）

1. 从项目的 releases 页下载对应平台的最新版本，解压后建议保留在原有的文件夹里；
2. 双击运行，在应用内的登录表单里连上你的 Twitch 账号；
3. 登录成功后，应用会自动拉取所有可挖的活动和游戏列表。

整个过程不需要本机装 Python，图形界面、托盘图标开箱即用。

路径二：源码运行（需要 Python 3.10+）

对预编译版不放心、或者想跟踪最新代码的用户，可以直接从源码跑，依赖很轻：

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

核心依赖就是aiohttp（网络层）、Pillow（图片处理）、pystray（系统托盘），外加平台相关的PyGObject（Linux 托盘）和pywin32（Windows），完整清单见 requirements.txt。仓库里还备有 setup_env.sh 和 setup_env.bat 两个环境初始化脚本。

一个前提动作：先去 Twitch 的 drops campaigns 页面，把你的 Twitch 账号与目标游戏账号关联好。应用只能挖"已关联"的活动，这一步必须人工完成。

核心玩法：优先级、排除列表与自动换台

游戏优先级列表怎么配

登录后的第一次操作基本就是"选游戏 + 按 Reload"：

1. 进入Settings标签页，从可挖游戏列表里把目标游戏加入Priority List，可以上下移动调整顺序；
2. 不想挖的游戏加进exclude（排除列表），会被彻底忽略；
3. 点击Reload，应用会拉取一批符合条件的直播并开始挖矿；
4. 之后需要时也可以手动指定切换到某个频道。

优先级列表之外剩下的游戏怎么办？由Priority Mode决定，共三种策略（定义在 constants.py 的PriorityMode枚举里）：

• Priority Only（默认）：只按优先级列表处理，列表之外一律不碰；
• Ending Soonest：剩余结束时间最早的活动优先，适合怕活动过期的人；
• Low Availability First：可观看频道数最少的游戏优先，先把"机会窗口小"的挖掉。

自动切换什么时候发生

两条触发规则覆盖了绝大多数场景：

• 被动切换：正在看的频道下播了，WebSocket 事件一到，立刻切到另一个可用频道，中间不用你介入；
• 主动切换：有更高优先级游戏的频道上线时，系统会主动切过去，确保挖矿资源始终花在排最前面的游戏上。

进度显示方面要降低预期：界面上的剩余时间计时器是估算值——它按分钟倒计，到零后最多等 20 秒重新向 Twitch 查询实际进度再重启。真实进度永远以 Twitch 服务器为准，计时快慢不影响挖矿速度本身。

进阶配置：settings.json 与命令行参数

所有 GUI 里的设置最终都落在应用目录的settings.json中，字段不多，逐个都能说清（默认值见 settings.py）：

命令行层面（完整说明见 manual.txt），几个常用项：

• --tray：启动即最小化到系统托盘，配合开机自启就是典型的"挂着过夜"用法；
• -v/-vv/-vvv：逐级提高日志详细程度，排错时很有用；
• --log：把日志同步写入log.txt；
• --dump：数据转储模式，启动后导出一份匿名的 Twitch API 原始数据到dump.dat，方便反馈问题时定位；
• --version：查看版本。

退出码也值得记一下：0正常退出，1遇到 CAPTCHA 或致命异常，2参数错误，3检测到已有实例在跑（lock.file互斥），4设置文件加载失败。看到退出码 1 或 3，基本就知道该往哪个方向查了。

语言方面，lang/ 目录内置了 20 份翻译文件，覆盖简体中文、繁體中文、日本語、Deutsch、Français、Русский 等，在设置页切换即可生效。

多平台落地要点：Windows、Linux、macOS 各自注意什么

Windows：

• 部分杀毒引擎（包括 Windows Defender）会把 EXE 报成木马——原因是 PyInstaller 历史上被用于打包恶意 Python 代码，属于误报；如果你完全不信任，就走源码路线自己跑；
• 自启动功能写在当前用户的注册表自启项（HKCU）里。注意：移动应用目录后自启会失效，需要把开关关掉再打开一次重新写入路径。

Linux：

• AppImage 和 PyInstaller 两种格式功能无差异，官方推荐用AppImage；
• 只要系统glibc>=2.35且有正常显示服务器，理论上开箱即用；
• 体积明显比 Windows 版大，因为打进了gtk3（PyGObject）及其依赖，这是托盘和系统通知所必需的；
• 备选方案：用 Wine 跑 Windows 版，官方说法是效果很好。

macOS：

• .app没有使用付费的 Apple 开发者证书签名，首次运行会被 Gatekeeper 拦下（提示"应用已损坏，无法打开"）。在应用所在目录的终端里执行一次即可解除：

xattr -cr "Twitch Drops Miner (by DevilXD).app"

• 持久文件（cookies.jar、settings.json、lock.file和cache/目录）都放在应用包内部的Contents/MacOS目录里，右键应用选 "Show Package Contents" 可以访问。

避坑与排错：这些"不工作"大多有明确原因

1. 别用同一账号在浏览器里同时看直播。这是最大的坑：Twitch 端的进度核算机制会让两个"观看者"互相干扰，典型症状是矿工报告错误进度、卡死在当前的 drop 上。挖矿期间请把这个账号的浏览器标签关掉。
2. cookies.jar等于你的账号凭证。文件里保存的授权信息可以让别人不用密码直接进你的账号，务必妥善保管、不要外传。
3. 收到 "New Login" 通知邮件是正常的。登录时应用向 Twitch 服务器呈现的浏览器身份是 Chrome，所以邮件里会显示 Chrome 登录；核对来源 IP 是自己的就可以忽略。
4. 计时器到零停一下也正常。剩余时间每分钟重新确定一次，最长 20 秒的"空窗"是设计行为，不是卡死。
5. 标准排错顺序：确认网络通畅、无防火墙拦截 → 在应用内重新登录验证账号授权 → 清理cache/目录后重试 → 备份并删除settings.json恢复默认设置 → 仍不行再用--dump导出数据反馈。
6. 验证码（CAPTCHA）会直接终止进程（退出码 1），应用本身不会绕过它，按提示手动处理即可。相关异常类型都定义在 exceptions.py 中，报错信息可以对着看。

它适合谁，又明确不做什么

适合：手头有想领的 drops 活动、希望工具随电脑开机、全天挂后台、一天看一两眼就够用的普通用户。项目的设计目标就是"随 PC 启动、挂一天、随关机而止"，24 小时内不报错就算合格。

不适合（作者在 README 里划了明确边界，这些功能大概率永远不会做）：

• 挖 channel points 或任何 Twitch drops 之外的奖励；
• 管理多个账号、挖未关联到该账号的活动；
• 部署到远程服务器 7×24 无人值守运行、Docker 化；
• 无 GUI / 纯命令行模式、错误后自动重启。

下一步建议

1. 先装预编译版，按"下载 → 登录 → 选游戏 → Reload"四步跑通第一次挖矿，大概五件事，五分钟。
2. 跑通之后再读源码，按职责对号入座：twitch.py 负责 API 交互与主循环，websocket.py 是分片连接池，channel.py 和 inventory.py 是频道与活动数据模型，cache.py 做资源缓存，gui.py 是界面，registry.py 只服务于 Windows 自启动项。
3. 保持克制，遵守 Twitch 平台条款。应用本身已与站点的交互控制在最低必要水平，但多账号、刷量类玩法不在它的范围内，也不被鼓励。

【免费下载链接】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