2026-06-18 16:49:38 +08:00
2026-06-23 02:38:08 +08:00

抖音自动化助手 - 数据看板版使用说明

这是打包成 exe 后给普通用户使用的说明。正常使用时不需要安装 Python,也不需要打开源码文件。

文件说明

解压或安装后,主要会看到这些文件:

DouyinGuajiGUI.exe    数据看板版主程序,优先打开这个
web_gui.exe           Web 控制台服务,一般不用手动打开
run_cli.exe           后台运行程序,由主程序自动调用
assets/               识别模板资源,不要删除
config/               配置目录
logs/                 日志目录
pic/                  截图目录
state/                运行状态目录

日常只需要双击:

DouyinGuajiGUI.exe

第一次使用

  1. 手机或模拟器开启 USB 调试,具体方法见下面“开启 ADB 调试”。
  2. 用数据线连接电脑,手机弹出授权时选择允许。
  3. 先在手机或模拟器里调出底部导航栏,具体方法见下面“调出底部导航栏”。
  4. 双击 DouyinGuajiGUI.exe。
  5. 在顶部设备下拉框选择设备。
  6. 如果没有设备,点击“刷新设备”。
  7. 进入“授权”页面,输入卡密并验证。
  8. 回到“运行设置”“筛选设置”填写参数。
  9. 点击底部“开始运行”。

开启 ADB 调试

安卓手机

  1. 打开手机“设置”。
  2. 进入“关于手机”。
  3. 连续点击“版本号”或“软件版本号”7 次,直到提示已进入开发者模式。
  4. 返回设置首页,进入“系统”“更多设置”或“其他设置”。
  5. 打开“开发者选项”。
  6. 开启“USB 调试”。
  7. 用数据线连接电脑。
  8. 手机弹出“允许 USB 调试”时,勾选“始终允许使用这台计算机进行调试”,再点“允许”。
  9. 回到软件,点击“刷新设备”。

如果找不到入口,可以在手机设置顶部搜索:

开发者选项
USB 调试

常见品牌路径

  • 小米/红米:设置 -> 我的设备 -> 全部参数 -> 连点 MIUI 版本;然后设置 -> 更多设置 -> 开发者选项 -> USB 调试。
  • 华为/荣耀:设置 -> 关于手机 -> 连点版本号;然后设置 -> 系统和更新 -> 开发人员选项 -> USB 调试。
  • OPPO/一加:设置 -> 关于本机 -> 版本信息 -> 连点版本号;然后设置 -> 系统设置 -> 开发者选项 -> USB 调试。
  • vivo/iQOO:设置 -> 系统管理 -> 关于手机 -> 连点软件版本号;然后设置 -> 系统管理 -> 开发者选项 -> USB 调试。

安卓模拟器

  1. 打开模拟器。
  2. 进入模拟器的“设置中心”或右上角菜单。
  3. 找到“ADB 调试”“Android 调试”或“开发者模式”。
  4. 选择“开启”或“本地连接”。
  5. 保存设置后重启模拟器。
  6. 回到软件,点击“刷新设备”。

不同模拟器入口名字会略有不同,可以优先在模拟器设置里搜索:

ADB
调试
开发者

调出底部导航栏

自动化运行必须能看到底部返回、主页、多任务按钮。不要使用隐藏导航条或纯手势导航。

安卓手机

  1. 打开手机“设置”。
  2. 搜索“系统导航方式”或“导航方式”。
  3. 进入后选择“三键导航”“经典导航键”或“屏幕内三键导航”。
  4. 回到桌面或抖音页面,确认屏幕底部能看到返回、主页、多任务按钮。

常见品牌路径:

  • 小米/红米:设置 -> 桌面 -> 系统导航方式 -> 经典导航键。
  • 华为/荣耀:设置 -> 系统和更新 -> 系统导航方式 -> 屏幕内三键导航。
  • OPPO/一加:设置 -> 系统设置 -> 系统导航方式 -> 虚拟按键。
  • vivo/iQOO:设置 -> 系统导航 -> 导航键。

安卓模拟器

  1. 打开模拟器设置。
  2. 找到“导航栏”“虚拟按键”“系统导航”或“显示底部导航栏”。
  3. 开启底部导航栏。
  4. 如果模拟器底部按钮被隐藏,先把鼠标移到窗口底部,或在侧边工具栏里点“返回”“主页”按钮确认可用。
  5. 回到抖音画面,确认底部能看到返回、主页、多任务按钮。

主界面怎么用

顶部区域

  • 设备:选择当前要控制的手机或模拟器。
  • 刷新设备:重新检测 ADB 设备。
  • 扫描 WiFi:用于 WiFi ADB 连接。
  • WiFi ADB:打开 WiFi 连接工具。
  • Y偏移:点击位置有偏差时填写,普通文本输入即可。
  • 截图+OCR:手动截图并识别当前画面。
  • 保存配置:保存当前界面参数。

底部按钮

  • 开始运行:启动自动化流程。
  • 暂停/继续:临时暂停或恢复当前运行。
  • 停止:正常停止。
  • 强制停止:进程卡住时使用。
  • 发送返回键:向手机发送一次返回键。

常用页面

数据看板

默认首页,主要看:

  • 本次运行时间
  • 总运行时间
  • 中奖截图数量
  • 预约队列
  • 实时截图

运行设置

设置运行方式,例如:

  • 是否允许切换直播间
  • 运行时长
  • 倒计时大于多少秒时跳过
  • 连续无福袋退出阈值

筛选设置

设置福袋筛选条件,例如:

  • 最低价值
  • 参与人数最小
  • 参与人数最大
  • 倒计时太短时跳过
  • 粉丝团失败策略

高价值预约

用于价值较高、开奖时间较晚的福袋。

常用项:

  • 启用预约
  • 价值阈值
  • 提前参与秒数
  • 最多记录数量
  • 预约回退校验

运行日志

显示完整运行输出。运行异常时优先看这里。

行为日志

显示更简洁的关键动作,例如:

  • 进入直播间
  • 识别福袋
  • 点击参与
  • 切换直播间
  • 预约记录
  • 中奖结果

截图预览

显示当前截图。识别不准时先看这里确认画面是否正常。

预约队列

显示已记录的预约福袋。该页面会自动刷新,首页里的预约队列也会自动更新。

统计信息

显示本次运行的数据统计,比日志更方便查看。

映射表

显示运行过程中记录的直播间位置和标题映射。可开启自动刷新。

推荐使用流程

  1. 打开 DouyinGuajiGUI.exe。
  2. 先把手机或模拟器底部导航栏调出来。
  3. 刷新并选择设备。
  4. 点击“截图+OCR”,确认截图能正常显示。
  5. 在“筛选设置”填好最低价值、人数范围。
  6. 如果要切换直播间,在“运行设置”开启允许切换直播间。
  7. 如需高价值预约,在“高价值预约”开启预约并设置价值阈值。
  8. 点击“保存配置”。
  9. 点击“开始运行”。
  10. 运行中观察“数据看板”“运行日志”“行为日志”。
  11. 需要临时停一下时点“暂停/继续”,结束时点“停止”。

日志和截图位置

如果需要排查问题,可以打开这些文件:

logs/unified.log      完整运行日志
logs/actions.log      关键行为日志
pic/screenshot.png    当前截图
pic/lottery/          中奖截图
state/                运行状态

常见问题

检测不到设备

  1. 确认手机开启 USB 调试。
  2. 重新插拔数据线。
  3. 手机授权弹窗选择允许。
  4. 点击主界面“刷新设备”。

截图为空或不更新

  1. 先确认设备已连接。
  2. 确认手机或模拟器底部导航栏已经调出。
  3. 点击“截图+OCR”手动刷新。
  4. 检查 pic/screenshot.png 是否生成。
  5. 仍不正常时重启程序和设备。

点击位置不准

先确认底部导航栏已经调出,再在顶部 Y偏移 输入框调整数值,然后再次截图确认。

运行卡住

  1. 先点“停止”。
  2. 如果没有反应,再点“强制停止”。
  3. 查看 logs/unified.log 和 logs/actions.log。

预约队列没有内容

只有识别到符合高价值预约条件的福袋后才会出现内容。请检查:

  1. 是否启用预约。
  2. 价值阈值是否过高。
  3. 是否允许切换直播间。
  4. 运行日志里是否出现预约相关记录。

授权失败

  1. 检查网络是否正常。
  2. 确认卡密没有复制多余空格。
  3. 点击“刷新状态”后再验证。
  4. 仍失败请联系发卡方。

不要删除的文件夹

这些目录不要删除:

assets/
config/
webui/

这些目录可以清理旧内容,但不建议删除目录本身:

logs/
pic/
state/

更新版本

如果你拿到新的安装包:

  1. 先关闭正在运行的程序。
  2. 备份旧目录里的 config/ 和 state/。
  3. 安装或解压新版本。
  4. 如需保留旧配置,把备份的 config/ 和 state/ 放回新目录。
  5. 重新打开 DouyinGuajiGUI.exe。

注意事项

  • 自动化运行期间不要手动频繁操作手机。
  • 账号风控风险自行承担。
  • 运行异常时先保存日志和截图,再重启程序。
  • 如果杀毒软件提示拦截,请把程序目录加入信任后再试。
S
Description
No description provided
Readme
54 MiB
0 Stars 8 Watchers 0 Forks
Languages
Python 89.1%
CSS 5%
JavaScript 3.4%
HTML 1.3%
PowerShell 1%
Other 0.2%