2026-06-23 11:15:57 +08:00
2026-06-18 16:49:38 +08:00
2026-06-23 13:52:51 +08:00
2026-06-19 01:11:10 +08:00
2026-06-23 02:38:08 +08:00
2026-06-23 13:52:51 +08:00

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

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

文件说明

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

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

日常只需要双击:

DouyinGuajiGUI.exe

第一次使用

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

主界面怎么用

顶部区域

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

底部按钮

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

常用页面

数据看板

默认首页,主要看:

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

运行设置

设置运行方式,例如:

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

筛选设置

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

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

高价值预约

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

常用项:

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

运行日志

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

行为日志

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

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

截图预览

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

预约队列

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

统计信息

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

映射表

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

推荐使用流程

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

日志和截图位置

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

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

常见问题

检测不到设备

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

截图为空或不更新

  1. 先确认设备已连接。
  2. 点击“截图+OCR”手动刷新。
  3. 检查 pic/screenshot.png 是否生成。
  4. 仍不正常时重启程序和设备。

点击位置不准

在顶部 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%