# 抖音自动化助手 - 数据看板版使用说明 这是打包成 exe 后给普通用户使用的说明。正常使用时不需要安装 Python,也不需要打开源码文件。 ## 文件说明 解压或安装后,主要会看到这些文件: ```text DouyinGuajiGUI.exe 数据看板版主程序,优先打开这个 web_gui.exe Web 控制台服务,一般不用手动打开 run_cli.exe 后台运行程序,由主程序自动调用 assets/ 识别模板资源,不要删除 config/ 配置目录 logs/ 日志目录 pic/ 截图目录 state/ 运行状态目录 ``` 日常只需要双击: ```text 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. 回到软件,点击“刷新设备”。 如果找不到入口,可以在手机设置顶部搜索: ```text 开发者选项 USB 调试 ``` ### 常见品牌路径 - 小米/红米:设置 -> 我的设备 -> 全部参数 -> 连点 MIUI 版本;然后设置 -> 更多设置 -> 开发者选项 -> USB 调试。 - 华为/荣耀:设置 -> 关于手机 -> 连点版本号;然后设置 -> 系统和更新 -> 开发人员选项 -> USB 调试。 - OPPO/一加:设置 -> 关于本机 -> 版本信息 -> 连点版本号;然后设置 -> 系统设置 -> 开发者选项 -> USB 调试。 - vivo/iQOO:设置 -> 系统管理 -> 关于手机 -> 连点软件版本号;然后设置 -> 系统管理 -> 开发者选项 -> USB 调试。 ### 安卓模拟器 1. 打开模拟器。 2. 进入模拟器的“设置中心”或右上角菜单。 3. 找到“ADB 调试”“Android 调试”或“开发者模式”。 4. 选择“开启”或“本地连接”。 5. 保存设置后重启模拟器。 6. 回到软件,点击“刷新设备”。 不同模拟器入口名字会略有不同,可以优先在模拟器设置里搜索: ```text 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. 需要临时停一下时点“暂停/继续”,结束时点“停止”。 ## 日志和截图位置 如果需要排查问题,可以打开这些文件: ```text 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. 仍失败请联系发卡方。 ## 不要删除的文件夹 这些目录不要删除: ```text assets/ config/ webui/ ``` 这些目录可以清理旧内容,但不建议删除目录本身: ```text logs/ pic/ state/ ``` ## 更新版本 如果你拿到新的安装包: 1. 先关闭正在运行的程序。 2. 备份旧目录里的 `config/` 和 `state/`。 3. 安装或解压新版本。 4. 如需保留旧配置,把备份的 `config/` 和 `state/` 放回新目录。 5. 重新打开 `DouyinGuajiGUI.exe`。 ## 注意事项 - 自动化运行期间不要手动频繁操作手机。 - 账号风控风险自行承担。 - 运行异常时先保存日志和截图,再重启程序。 - 如果杀毒软件提示拦截,请把程序目录加入信任后再试。