8e8a14cf6996fedb0f7eab28381daff0663e4b4e
抖音自动化助手 - 数据看板版使用说明
这是打包成 exe 后给普通用户使用的说明。正常使用时不需要安装 Python,也不需要打开源码文件。
文件说明
解压或安装后,主要会看到这些文件:
DouyinGuajiGUI.exe 数据看板版主程序,优先打开这个
web_gui.exe Web 控制台服务,一般不用手动打开
run_cli.exe 后台运行程序,由主程序自动调用
assets/ 识别模板资源,不要删除
config/ 配置目录
logs/ 日志目录
pic/ 截图目录
state/ 运行状态目录
日常只需要双击:
DouyinGuajiGUI.exe
第一次使用
- 手机或模拟器开启 USB 调试,具体方法见下面“开启 ADB 调试”。
- 用数据线连接电脑,手机弹出授权时选择允许。
- 先在手机或模拟器里调出底部导航栏,具体方法见下面“调出底部导航栏”。
- 双击
DouyinGuajiGUI.exe。 - 在顶部设备下拉框选择设备。
- 如果没有设备,点击“刷新设备”。
- 进入“授权”页面,输入卡密并验证。
- 回到“运行设置”“筛选设置”填写参数。
- 点击底部“开始运行”。
开启 ADB 调试
安卓手机
- 打开手机“设置”。
- 进入“关于手机”。
- 连续点击“版本号”或“软件版本号”7 次,直到提示已进入开发者模式。
- 返回设置首页,进入“系统”“更多设置”或“其他设置”。
- 打开“开发者选项”。
- 开启“USB 调试”。
- 用数据线连接电脑。
- 手机弹出“允许 USB 调试”时,勾选“始终允许使用这台计算机进行调试”,再点“允许”。
- 回到软件,点击“刷新设备”。
如果找不到入口,可以在手机设置顶部搜索:
开发者选项
USB 调试
常见品牌路径
- 小米/红米:设置 -> 我的设备 -> 全部参数 -> 连点 MIUI 版本;然后设置 -> 更多设置 -> 开发者选项 -> USB 调试。
- 华为/荣耀:设置 -> 关于手机 -> 连点版本号;然后设置 -> 系统和更新 -> 开发人员选项 -> USB 调试。
- OPPO/一加:设置 -> 关于本机 -> 版本信息 -> 连点版本号;然后设置 -> 系统设置 -> 开发者选项 -> USB 调试。
- vivo/iQOO:设置 -> 系统管理 -> 关于手机 -> 连点软件版本号;然后设置 -> 系统管理 -> 开发者选项 -> USB 调试。
安卓模拟器
- 打开模拟器。
- 进入模拟器的“设置中心”或右上角菜单。
- 找到“ADB 调试”“Android 调试”或“开发者模式”。
- 选择“开启”或“本地连接”。
- 保存设置后重启模拟器。
- 回到软件,点击“刷新设备”。
不同模拟器入口名字会略有不同,可以优先在模拟器设置里搜索:
ADB
调试
开发者
调出底部导航栏
自动化运行必须能看到底部返回、主页、多任务按钮。不要使用隐藏导航条或纯手势导航。
安卓手机
- 打开手机“设置”。
- 搜索“系统导航方式”或“导航方式”。
- 进入后选择“三键导航”“经典导航键”或“屏幕内三键导航”。
- 回到桌面或抖音页面,确认屏幕底部能看到返回、主页、多任务按钮。
常见品牌路径:
- 小米/红米:设置 -> 桌面 -> 系统导航方式 -> 经典导航键。
- 华为/荣耀:设置 -> 系统和更新 -> 系统导航方式 -> 屏幕内三键导航。
- OPPO/一加:设置 -> 系统设置 -> 系统导航方式 -> 虚拟按键。
- vivo/iQOO:设置 -> 系统导航 -> 导航键。
安卓模拟器
- 打开模拟器设置。
- 找到“导航栏”“虚拟按键”“系统导航”或“显示底部导航栏”。
- 开启底部导航栏。
- 如果模拟器底部按钮被隐藏,先把鼠标移到窗口底部,或在侧边工具栏里点“返回”“主页”按钮确认可用。
- 回到抖音画面,确认底部能看到返回、主页、多任务按钮。
主界面怎么用
顶部区域
- 设备:选择当前要控制的手机或模拟器。
- 刷新设备:重新检测 ADB 设备。
- 扫描 WiFi:用于 WiFi ADB 连接。
- WiFi ADB:打开 WiFi 连接工具。
- Y偏移:点击位置有偏差时填写,普通文本输入即可。
- 截图+OCR:手动截图并识别当前画面。
- 保存配置:保存当前界面参数。
底部按钮
- 开始运行:启动自动化流程。
- 暂停/继续:临时暂停或恢复当前运行。
- 停止:正常停止。
- 强制停止:进程卡住时使用。
- 发送返回键:向手机发送一次返回键。
常用页面
数据看板
默认首页,主要看:
- 本次运行时间
- 总运行时间
- 中奖截图数量
- 预约队列
- 实时截图
运行设置
设置运行方式,例如:
- 是否允许切换直播间
- 运行时长
- 倒计时大于多少秒时跳过
- 连续无福袋退出阈值
筛选设置
设置福袋筛选条件,例如:
- 最低价值
- 参与人数最小
- 参与人数最大
- 倒计时太短时跳过
- 粉丝团失败策略
高价值预约
用于价值较高、开奖时间较晚的福袋。
常用项:
- 启用预约
- 价值阈值
- 提前参与秒数
- 最多记录数量
- 预约回退校验
运行日志
显示完整运行输出。运行异常时优先看这里。
行为日志
显示更简洁的关键动作,例如:
- 进入直播间
- 识别福袋
- 点击参与
- 切换直播间
- 预约记录
- 中奖结果
截图预览
显示当前截图。识别不准时先看这里确认画面是否正常。
预约队列
显示已记录的预约福袋。该页面会自动刷新,首页里的预约队列也会自动更新。
统计信息
显示本次运行的数据统计,比日志更方便查看。
映射表
显示运行过程中记录的直播间位置和标题映射。可开启自动刷新。
推荐使用流程
- 打开
DouyinGuajiGUI.exe。 - 先把手机或模拟器底部导航栏调出来。
- 刷新并选择设备。
- 点击“截图+OCR”,确认截图能正常显示。
- 在“筛选设置”填好最低价值、人数范围。
- 如果要切换直播间,在“运行设置”开启允许切换直播间。
- 如需高价值预约,在“高价值预约”开启预约并设置价值阈值。
- 点击“保存配置”。
- 点击“开始运行”。
- 运行中观察“数据看板”“运行日志”“行为日志”。
- 需要临时停一下时点“暂停/继续”,结束时点“停止”。
日志和截图位置
如果需要排查问题,可以打开这些文件:
logs/unified.log 完整运行日志
logs/actions.log 关键行为日志
pic/screenshot.png 当前截图
pic/lottery/ 中奖截图
state/ 运行状态
常见问题
检测不到设备
- 确认手机开启 USB 调试。
- 重新插拔数据线。
- 手机授权弹窗选择允许。
- 点击主界面“刷新设备”。
截图为空或不更新
- 先确认设备已连接。
- 确认手机或模拟器底部导航栏已经调出。
- 点击“截图+OCR”手动刷新。
- 检查
pic/screenshot.png是否生成。 - 仍不正常时重启程序和设备。
点击位置不准
先确认底部导航栏已经调出,再在顶部 Y偏移 输入框调整数值,然后再次截图确认。
运行卡住
- 先点“停止”。
- 如果没有反应,再点“强制停止”。
- 查看
logs/unified.log和logs/actions.log。
预约队列没有内容
只有识别到符合高价值预约条件的福袋后才会出现内容。请检查:
- 是否启用预约。
- 价值阈值是否过高。
- 是否允许切换直播间。
- 运行日志里是否出现预约相关记录。
授权失败
- 检查网络是否正常。
- 确认卡密没有复制多余空格。
- 点击“刷新状态”后再验证。
- 仍失败请联系发卡方。
不要删除的文件夹
这些目录不要删除:
assets/
config/
webui/
这些目录可以清理旧内容,但不建议删除目录本身:
logs/
pic/
state/
更新版本
如果你拿到新的安装包:
- 先关闭正在运行的程序。
- 备份旧目录里的
config/和state/。 - 安装或解压新版本。
- 如需保留旧配置,把备份的
config/和state/放回新目录。 - 重新打开
DouyinGuajiGUI.exe。
注意事项
- 自动化运行期间不要手动频繁操作手机。
- 账号风控风险自行承担。
- 运行异常时先保存日志和截图,再重启程序。
- 如果杀毒软件提示拦截,请把程序目录加入信任后再试。
Languages
Python
89.1%
CSS
5%
JavaScript
3.4%
HTML
1.3%
PowerShell
1%
Other
0.2%