# 使用说明 ## 启动与连接 从 [Releases](https://github.com/h0ll0w-AkuZr0guY/MiaoTask/releases/latest) 的 Assets 下载 Windows x64 ZIP,完整解压后运行 `MiaoTask.exe`,不要移走 `_internal/`。`Source code` 是源码包。 v0.1.4 发布 ZIP 预装淘宝五项活动与支付宝月月赚,更新可在「活动中心」从所选官方分支获取。框架包含设备控制、网页与运行环境;活动源码与框架分开保存,后续可独立更新。 手机保持解锁,开启 USB 调试、连接数据线,并在手机上允许这台电脑调试。点击左侧设备卡片的齿轮,或虚线「添加设备」,在连接弹窗中选择已发现设备或填写地址,再点击「连接设备 / 创建并连接」。设备名称也在同一弹窗修改,原有的第一台设备同样可以改名。 默认地址为 `http://127.0.0.1:8765`,被其他程序占用时会选择空闲端口。首次未发现 USB 手机时会尝试兼容 ADB 后端;未授权时等待本人确认,无法代替手机授权。始终无法发现设备时,请检查数据线、调试开关及厂商 USB 驱动。 ### Wi-Fi 无线连接(Android 11 及以上) 手机和电脑连接同一 Wi-Fi,在左侧设备连接弹窗切换「Wi-Fi 无线」。 1. 手机打开「开发者选项 → 无线调试」,开启后点击「使用配对码配对设备」。在网页「首次配对」填写弹窗中的 **IP:端口** 和 **六位配对码**,点击「配对手机」,保持手机弹窗打开直到配对成功。 2. 关闭手机配对弹窗,在网页「连接手机」沿用配对 IP,填写无线调试**主页面**的**连接端口**,点击「无线连接」。配对端口和连接端口通常不同。 3. 设备就绪后照常开始任务。之后可选择「已经配对」直接连接;手机端撤销配对后需要重新配对。无线调试重开或换网后,地址可能改变。 无线配对默认使用四个 IP 框和一个端口框,输入三位自动前进,空框退格返回上一段。配对成功后连接 IP 自动复用,只填写无线调试主页面的连接端口;换网时修改 IP。也可粘贴完整 IPv4 地址,IPv6 在“完整地址 / IPv6”中填写。无线区域顶部只有一个「使用完整地址 / IPv6」切换,统一控制配对和连接两项地址的输入样式;两项地址的端口仍各自独立。地址仅在当前页面的设备工作区间保留,配对码不保存。 「查找无线设备」可列出广播地址,需要本人核对选择;发现失败也可手填。校园网、企业网可能阻止设备互访,可改连同一个个人热点。不会扫描校园网地址段、修改防火墙或开启无认证 TCP 调试。配对码不写入日志或配置;ADB 按系统机制保留电脑配对身份。使用结束后可在手机关闭无线调试、撤销不再使用的电脑授权。USB 与无线连接共用同一手机、实例和日期的统计。 ## 多设备与模拟器 左侧虚线「添加设备」打开名称与连接窗口,支持 USB、模拟器和 Wi-Fi。直接连接会先创建工作区,再将连接提交给该工作区;也可点「仅创建设备」,稍后再连。添加后显示为设备卡片,下方继续保留新增入口。齿轮打开已有设备的名称与连接设置,可保存名称、重连或移除;执行期间仅允许改名,重连和移除需先停止。 卡片以灰色表示未连接、绿色表示已连接、红色表示连接异常,连接中使用当前主题的强调色;状态文字同时显示。连续三次预览失败也会提示异常,后续成功取图恢复,不把一次慢截图当成设备断开,不中断任务。没有额外取图时不进行独立网络探活,颜色反映最近观察结果。 点击卡片切换活动、任务、日志和预览,其他设备继续运行;卡片前的复选框用于批量选择,不改变当前展示设备。每台设备可分别开始、暂停、继续或停止;工作区、名称与连接只保留在本次服务期间,重开后重新添加和连接,日累计记录继续保留。窄窗口下设备栏改为页面顶部的横向列表。 勾选多个设备后,点击设备栏底部固定的「一键启动」,将当前页面的活动计划与公共设置发送给这些设备;每台独立执行,单台异常不停止其他设备。未连接、忙碌或配置不兼容的设备会单独反馈原因。批量操作使用各设备自己选定的应用实例,不把当前设备的分身选择复制过去。「唤醒」「停止」也作用于已勾选设备。默认最多 8 个工作区,实际容量取决于电脑、网络和 OCR 负载。 「唤醒」仅打开各设备选定的应用,适合未登录的模拟器进行接入检查,不会执行任务或代办登录。空闲设备可移除,正在操作的设备需先停止;移除不删除日记录。退出助手会停止全部设备。 模拟器先在 MuMu 中启动,再点击添加面板的「查找 MuMu 模拟器」,读取厂商提供的实际端口。未发现时,可手动填入模拟器诊断页的 ADB 地址。不会猜端口、修改模拟器配置或启动未运行的实例。连接后自动按实际横竖屏和应用所在显示屏识别,预览保留比例;遇到登录或受保护页面会暂停,需要本人处理。 ## 活动中心 顶部保留活动中心、公共设置、排行榜、画面与提示、外观等全局入口。当前设备的「活动计划」中先切换应用,再勾选其下活动;不同应用的活动可以加入同一个设备计划,由执行顺序统一排序。 下载的活动源码默认位于 `MiaoTask.exe` 旁的 `activities/apps/<应用>/activities/<活动>/`;安装记录和目录缓存也保存在 `activities/` 中。「活动中心」显示实际路径,点击「打开文件夹」即可查看。请通过活动中心更新或卸载,修改源码前先停止全部设备。安装目录只读时会改用用户数据根下的 `activities/`,界面显示回退后的实际位置。旧版 `%LOCALAPPDATA%/MiaoTask/plugins` 在首次使用空的新目录时复制迁移,原文件保留,已有预装活动不会被覆盖。 在「活动中心」刷新官方仓库 main 的应用与活动列表,安装需要的项目,再在当前设备的活动标签上勾选。活动按应用分组紧凑展示;保存位置默认折叠,需要时展开查看。点击弹窗外侧、按 Esc 或点击右上角「关闭」均可关闭,关闭界面不会取消已经提交的安装操作。 只下载所选活动及其应用共享源码,不下载其他应用的活动或额外环境。展开「执行顺序」,用箭头调整顺序;移除仅从当前计划取消,不卸载活动。每台设备最多选择 16 个不同活动,计划保留在本次服务期间。 点击「开始自动执行」后,该设备依次执行已选活动;同一应用沿用本设备明确选择的实例,不同应用分别保存实例选择。新连接设备会重新核定实例,不复用上一台手机的分身队列。切换到没有主实例的应用时,需要先明确选择分身。先核定当前页面,有任务列表时直接读取,否则自动进入对应活动。 活动显示「已结束」表示本次运行正常返回,具体任务成功仍以进度核验和统计为准。人工认证、身份不符、未处理异常或用户停止会中断当前设备的后续活动;其他设备不受影响。 安装、更新或卸载活动前,请停止所有设备的任务、识别与连接操作;暂停的任务仍占用执行线程,也需要停止。目录切换期间不能启动设备操作。卸载保留设备、实例与日期的任务记录;当前活动被卸载时,相应设备需重新选择活动并连接。 活动包是可执行 Python 代码,使用当前进程的权限。官方地址约束、文件摘要、路径检查和兼容校验用于核对来源及完整性,不构成隔离执行环境。活动包不自动安装 Python 依赖;缺少框架运行库时需升级框架。 首次安装与更新需要电脑能够访问 GitHub。已安装源码保留在本机,断网时仍可运行;目录缓存用于展示上次获取的信息,不能代表已经获取最新提交。活动更新从官方 main 获取,不需要发布新的框架或独立的活动 Release;界面提示兼容性问题时先更新框架。下载安装失败会保留原有可用活动和本地任务记录。 ## 执行与设置 保持「自动进入活动」,点击「开始自动执行」。助手按所选活动进入对应页面,确认任务列表后执行;每次返回和重新开始都会更新列表。多个活动可在同一设备的计划中排序执行,记录彼此独立。 ### 淘宝活动 | 活动 | ID | 入口与执行范围 | | --- | --- | --- | | 双11赚能量 | `double11` | 首页「领淘金币」→「赚能量 / 去赚能量」;保留原有浏览、搜索、跳转和累计奖励流程 | | 淘金币日常 | `coins` | 「领淘金币 / 淘金币」→优先「去赚金币 / 赚更多金币」,必要时才切日常版;识别任务进度、奖励圆钮、清单卡片、搜索和可领取奖励 | | 芭芭农场 | `farm` | 首页或「全部频道」中的「芭芭农场」→「集肥料」;处理浏览、访问和明确的签到领取,答题、施肥、浇水等留给本人 | | 红包签到 | `cash-signin` | 首页「红包签到」;仅处理每日签到及带明确金额的定时奖励,必要时按奖励页提示浏览;本轮已核验的奖励不会反复领取 | | 淘宝成就中心 | `achievements` | 「成就中心」或搜索结果中的官方「开启我的淘宝成就 → 点击进入」;必要时切到「我的成就 → 做任务领成就」,处理每日签到、成就点领取与可识别任务。不要求为成就点任务开启商城的实物打卡;遇到强制地址设置页仍停止,由本人决定是否参与 | 以上日常活动目前仅声明 Android 驱动。入口优先使用可读控件,画布菜单和弹窗以本地 OCR 复核;坐标来自当前页面,不按个人设备分辨率换算预设点击点。未找到官方搜索卡片时不会进入同名商品。 支付宝「月月赚」通过首页全局搜索填写活动名,再打开官方入口。当前停在快递等小程序的局部搜索时,先有界返回再进入全局搜索;仅解析浏览、逛类任务,其他商业任务不自动操作。 现金签到的提现推广优先点击可确认的关闭按钮,已确认推广而关闭图标不可读时尝试一次返回,不点击「开」「提现」「点击参与」或修改收货地址。领取后核对完成文案、任务进度或对应余额变化,按钮文字拆分、点击和停留本身不算成功。各账号的任务和资格不同,未开启活动可能需要本人先处理。 普通浏览搜索使用固定数字检索词,避免原输入法将字母留在候选区而未实际填入;查找活动入口仍使用活动名称。助手不安装或切换系统输入法。部分设备的可读控件失效时会改用可见搜索框与系统输入能力;这类驱动修复需更新框架,单独更新活动无法改变旧 exe 的底层请求超时。 淘金币和农场中断后重新自动执行,会先有界地回到任务列表顶部,再按当天记录继续检查。任务执行后的返回保留当前列表位置;安全验证仍停止等待本人处理,不会靠重启绕过。 同一应用的多个已安装活动共用应用工具源码。更新提示共享文件冲突时,停止所有设备,卸载该应用旧活动后,从同一仓库提交重新安装所需活动;卸载保留日记录,不要手动混合不同提交的共享 Python 文件。 | 入口 | 可调整内容 | | --- | --- | | 任务设置 | 基础浏览时长、补滑复查次数、今日失败及本轮上限、任务类型、累计领奖 | | 滚动节奏 | 距离、时长、同方向连续次数和额外间隔的最小/最大值 | | 高级选项 | 跨应用访问与返回、OCR、截图质量及设备运行选项 | | 设备连接弹窗 | 自动执行全部应用分身,默认关闭 | 顶部导航「公共设置」集中提供任务、滚动和高级三个分类,作用于当前设备的活动计划;批量启动时发送给已勾选设备。新增淘宝活动复用这些参数,入口和识别词表随活动提供,目前不需要额外的应用或活动设置。分身开关在设备连接弹窗中配置。高级选项中的「开始前清空设备剪贴板」默认开启,用于减少残留助力链接弹窗,可关闭并随公共配置保存;只清空设备端,不读取、上传或恢复旧内容,也不更换输入法。设备限制导致清空失败时显示提示并继续执行。 修改后点击「应用设置」,也可关闭弹窗后直接开始;点击外侧或按 Esc 不会清除本页修改。切换设备会读取目标设备设置。配置保存到系统用户目录,升级保留。淘宝标准浏览首轮按公共基础时长(默认17秒)与任务要求的较大值持续滑动,期间不插入截图和OCR,到时返回列表核验;页面出现明确完成提示后,按「完成后随机返回延时」设定随机等待0~设定值毫秒再返回(默认0~1000毫秒;CPU识别较慢可设为0);实际使用CUDA时首轮结束也检查页面,未完成则有界补滑。CPU任务失败后才停1秒检查并有界补滑。补滑复查默认3次,同一任务今日失败上限默认3次,本轮最多80次。旧额外时长、结束缓冲与持续检查选项已退出标准浏览流程,不再影响首轮计时。 设备连接弹窗提供「自动执行全部应用分身」开关,默认关闭。开启后按当前应用实际识别顺序串行执行主应用与全部分身,无需手选或排序;活动流水线切换应用后重新读取该应用的实例。每个实例独立使用本轮上限、核验与日记录。关闭后使用主应用;异常、人工认证、实例失效或手动停止会中断该设备后续队列。开关按当前服务中的设备工作区分别保存,批量启动不复制其他设备的分身开关。 暂停后可继续,停止后可重新开始。自动进入失败时,可手动打开任务列表后直接再次开始,助手会读取当前页,无需再切换入口模式。普通异常会逐层返回并重读页面,键盘收起后继续返回;确认任务列表即继续执行。返回达到上限时先回到桌面,确认后最多重启恢复一次,始终使用所选实例。认证、登录、账号授权或支付提示由本人处理。普通应用跳转先确认页面语义,再匹配“允许 / 本次允许 / 确认”等按钮;无法完成时返回并跳过当前任务,不将其他任务一起封禁。 淘宝启动动画或活动弹窗可能遮挡入口,助手会先尝试返回再重新定位;无法覆盖的弹窗或入口变化仍需手动处理。 任务行的“执行 / 跳过”是队列选择,点击执行不会立即开始操作。先由识别结果给出默认选择,可实时调整尚未完成的任务;开始自动执行后按正常流程处理已选任务。正在进行的步骤先安全结束,下一次选择任务时应用调整;本轮已结束时需再次开始。右侧继续显示运行、完成或失败状态。已完成及必须人工处理的任务不能强制加入。 ## 画面与日志 顶部导航「画面与提示」显示或收起右侧栏,浏览器会记住该偏好。桌面宽度下,手机画面与折叠的小提示随页面滚动保持可见;窄窗口下改为普通纵向布局。「画面宽度」滑条调整侧栏预览大小,浏览器会记住该偏好;「放大」打开当前设备的实时大图,点击外侧或按 Esc 可关闭。切换设备会关闭大图,等待新设备画面,避免混淆。 「外观」提供暖橙、湖蓝、午夜三种主题,点击立即生效并保存在当前浏览器,同一浏览器的其他打开页面同步变化。主题只调整界面颜色和外观,保留设备状态颜色含义,不修改任务参数、应用选择或运行记录。 这些控制不改变任务识别或执行节奏;收起右栏时不再额外请求网页预览。截图由任务与预览调度自动更新,需要时可点击「刷新」主动读取。下方「运行日志」与任务列表共用切换栏,内容随当前设备切换。 ## 统计与反馈 记录按 **设备 + 应用 + 活动 + 实例 + 自然日**保存,同日重开延续,次日重新判断缺失应用和不可用任务;不同活动和分身独立,同一实例内手动切换账号仍共用当天记录。任务是否完成以返回后的进度为准,访问次数不等于成功次数。 Windows 便携版的累计与诊断默认保存在 `%LOCALAPPDATA%/MiaoTask`,独立于解压目录;更新时删除旧程序文件夹不会清空这些记录。显式配置数据目录时使用对应位置。 顶部「排行榜」按匿名设备标识+应用汇总,也可切到设备+应用+活动;同设备的分身合并统计。支持全部日期或今日,点击运行时长、核验完成、跳过、失败表头切换降序。当前在线设备同时显示工作区名称,历史设备以匿名代号区分;不会展示原始设备码。点击刷新读取最新日记录,不另建计数、不上传。运行时长沿用任务累计用时;诊断截图数量与人工验证次数不直接计入失败。统计读取当前框架的活动日记录,未迁移的旧版根目录记录不重复加入;无效记录保留原文件并提示未计入。 失败次数与手动跳过按设备、应用、活动、实例、日期保存在本地,重启不清零。普通失败达到设置中的上限后当天跳过,第二天重新判断;点击执行会重置该任务的失败预算并加入队列,但不会绕过应用缺失、安全认证和任务类型设置。任务标题或执行规则更换后作为新任务识别,位置变化不会清除原选择。 「失败现场与反馈」显示当前实例当天的固定目录,可导出诊断 ZIP。反馈建议包含版本、机型、系统、任务名称、起始页面和复现步骤。原始截图不会自动打码,请先遮挡设备码、昵称、头像、金额和搜索历史。数据位置及边界见[风险与隐私](SAFETY.md)。 ## 退出与升级 关闭浏览器后任务继续,额外预览随后停止。双击 Windows 托盘图标可打开控制台,右键「停止任务并退出助手」结束服务;网页不再提供底部退出按钮。 升级前退出旧助手,将新 ZIP 完整解压到新目录后启动,不混用新旧 exe 和运行库。刷新网页后可在页脚查看版本;用户数据不随解压目录清空。新版本的活动源码单独保存在 exe 旁;升级时可在活动中心重新安装,或在退出助手后将旧包的整个 `activities/` 复制到新目录,不要只复制其中某个 Python 文件。 ## 操作演示 [横版视频](https://github.com/h0ll0w-AkuZr0guY/MiaoTask/releases/download/v20261019-double11.4/MiaoTask-Guide-PC-1920x1080.mp4) · [竖版视频](https://github.com/h0ll0w-AkuZr0guY/MiaoTask/releases/download/v20261019-double11.4/MiaoTask-Guide-Phone-1080x1920.mp4) 视频为历史版本实录,含 AI 配音、字幕和隐私遮挡;不同轮次经过剪辑,等待部分加速,按钮布局以当前程序为准。源码运行请看[开发文档](https://github.com/h0ll0w-AkuZr0guY/MiaoTask/blob/main/docs/DEVELOPMENT.md)。 ## 活动分支与更新 活动中心打开时重新检查官方仓库目录;「查找分支」可读取官方仓库所有分支,默认 main,选择其他分支后显示对应提交。开发分支可能未完成验收,切换只改变下载来源,不自动替换已安装活动;点击下载/更新才安装固定提交的源码。跨分支不复用旧目录缓存,离线时仅允许同一分支的缓存。分支选择保存在用户目录。 公共设置的「高级选项」可开启执行期间最低媒体音量、最低亮度,均默认关闭。音量开关在开始执行时生效,直接修改设备的媒体音量(通常为0),不调整铃声和闹钟;优先使用 `cmd media_session volume --stream 3`,兼容旧 `media volume`;若命令返回成功但读数未改变,再回退 `cmd audio set-volume 3`,设置和恢复均读回核验。运行日志会明确显示成功、未生效或恢复失败。支持的 Android 设备会在结束或中断时恢复原值;断联或强制结束进程可能需要本人恢复。设置应用或开始运行时保存到系统用户目录的 MiaoTask/preferences.json,升级保留;不包含设备地址和账号。每个已打开工作区仍使用自己的配置快照,后续新启动会读取最近保存的公共设置。 流水线按设备、实例、活动和日期记录正常结束且已无可执行任务的完成状态。后续重新开始时跳过这些活动并继续下一项。次数上限、失败未核验、认证和主动停止不标为完成;更新任务选择或显式扫描可解除完成状态。新的一天重新执行。 小标题明确要求浏览且标题仅含宣传性质的答题/考试词时,可按浏览执行;有时长按时长,无时长今日尝试一次,仍按页面反馈核验。支付、邀请、真正答题等要求保持人工处理。通用执行循环结束前有一次有界重扫,并避免重复执行本轮已核验的同一任务进度。 从托盘退出时清理本次启动、路径属于当前安装的 ADB 进程;已有或归属不明的其他工具 ADB 保持运行。 目录刷新失败会继续显示错误与同分支缓存,直到一次远端刷新成功。遇到 GitHub 限流可稍后重试,预装或已安装的活动仍可离线使用。 ### 下载容灾与离线恢复 活动中心每次打开只自动检查一次目录;之后仅手动刷新。空闲时不轮询远端,安装期间只查询本机进度。GitHub API 返回限流时遵守响应中的等待时间,不继续重试 API;尝试已配置的静态资源源,再尝试官方 Git 源码归档。后者可能读取完整仓库归档,但只安装所选活动及该应用共用文件,不需要本机 Git 或 GitHub Token。 「离线恢复」使用随包或本机保留的已校验活动 ZIP,不联网;卸载活动会保留恢复包和日记录。即使在线目录不可用,仍列出可恢复活动。预装基线在 _internal/activity-recovery,本机后来下载的活动缓存在 activities/recovery;请保留这两个目录。完整删除活动目录后,可从随包基线恢复预装项;后来新增活动的备份请一并保留。 恢复旧版本时仍检查应用共享文件冲突,不静默降级其他活动。没有任何缓存且所有下载源都不可达时,需重新解压原始 ZIP 或恢复网络。官方 [Pages 活动资源](https://h0ll0w-akuzr0guy.github.io/MiaoTask/activities/) 提供备用目录与源码包;客户端在 GitHub API 不可用时自动尝试,用户无需手动配置。 有说明的已安装活动旁会显示「!」按钮,点击可查看基本介绍;没有说明则不显示按钮。点击外侧、关闭按钮或 Esc 可退出,阅读不会勾选活动或执行任务。 ## 在线预览 [在线工作台](https://h0ll0w-akuzr0guy.github.io/MiaoTask/) 自动同步 main 的前端,可体验多设备管理、活动选择、任务选择、公共设置和主题。设备、画面与任务均为明确标记的演示数据,修改只在当前页面有效;不会连接手机、执行任务或把输入上传。实际使用请下载桌面版。 ## 重新识别与任务标记 「公共设置 → 公共词表」可维护两份列表,词之间使用中文/英文分号、空格或换行: * **任务搜索输入词**:例如 `手机壳;雨伞;2026`,普通任务搜索随机使用;留空保留活动默认值。进入淘金币、月月赚等活动需要的专用词不受影响。输入框不支持原生设置文字时会使用数字备用输入,不安装或替换输入法。 * **常驻跳过关键词**:例如 `微博;快手;头条`,标题或说明包含任一词就跳过。按普通文本匹配,无需正则;英文不区分大小写。任务列表上的执行按钮不能绕过此规则,删除词后重新开始可恢复,活动自身的安全限制仍有效。 点击应用设置或开始执行时保存到系统用户目录,升级保留;清空当天任务标记不会删除词表。运行中的设备仍使用本次配置快照,修改后在下次开始时生效;批量启动按现有公共配置规则发送到勾选设备。 点击开始会重新读取当前活动页面,旧的“已处理”标记不会阻止本次启动。同一应用内手动换登录账号无法可靠自动识别,请先停止,再点击执行按钮旁的「清空任务标记」;仅清理当前设备、活动、实例的执行选择、失败预算和不可用任务判断,保留今日累计、诊断和其他实例记录。 公共设置新增「活动结束后清理标记并复查一次」,默认关闭。开启后正常收尾再复查一轮,不无限重复;认证、停止、异常或次数上限不会触发自动复查。「执行期间保持亮屏」默认关闭,下次框架更新后,开启时会在开始执行时唤醒 Android 主屏,并在空页面时有界重试;密码锁屏需手动解锁。通过 ADB 临时延长系统息屏超时,USB/Wi-Fi 均可使用,不发送保活点击;正常结束或中断后恢复原值。程序被强制结束时请检查设备息屏设置。 月月赚入口修复兼容 0.1.5:在活动中心刷新后更新支付宝月月赚即可使用,无需重新下载框架。0.1.5 用户执行前请先手动亮屏并解锁;公共设置的自动唤醒及无任务结束提示优化随下次框架打包提供。 公共设置「高级选项」提供「浏览时使用压缩截图」,默认关闭,Android主屏观察优先使用全分辨率PNG。常规截图或物理映射不可用时,自动重新核定主屏并尝试同尺寸JPEG质量95的兼容接口。开启压缩截图后直接使用同尺寸JPEG,减少Wi-Fi传输量,可能损失细小文字清晰度。坐标尺寸不变,非主屏及其他驱动仍使用原截图方式。网页缩略预览本来就会压缩,与此识别截图选项独立。 公共设置的默认值、调用位置和各活动适用范围见 [配置核验表](CONFIGURATION.md)。累计领奖统一使用任务类型中的一个开关。JPEG质量默认70、允许整数30~95,表示编码质量而不是固定压缩比例;压缩始终保持设备原始尺寸,不论手机或平板分辨率都不改变坐标。活动切换保留已应用公共配置,任务入口规则仍由对应活动提供。 活动中心打开先读取本地缓存、已安装列表和离线恢复项目,再后台检查一次更新;后台刷新未结束时也能展示已有列表。目录优先读取Pages静态JSON,失败再尝试GitHub源码元数据;浏览目录不安装代码,只有点击安装/更新才替换活动。刷新不保证网络速度,但不会让本地列表等待远端。分支列表仅点击「查找分支」时查询。 ### 按需读屏与串行浏览 淘宝标准浏览首轮只在进入时确认页面,按基础时长(默认17秒,不低于任务要求)持续滑动,CPU然后返回列表核验,实际CUDA在首轮末尾也做有界检查与补滑;不叠加旧的额外浏览/结束缓冲,也不持续截图和OCR。失败的任务再次进入后,完成基础浏览、停1秒读取页面,必要时补滑1秒再检查;任务设置的“重试时补滑复查次数”默认3。返回列表的进度才是最终成功依据。 公共设置保留任务、滚动和高级三类;压缩截图与JPEG质量(默认70,范围30~95)移到高级选项,只影响必要截图的传输。执行时手机预览保持最近观察画面,连续滑动期间不会实时更新;空闲时可刷新。试验性的截图间隔、计算核心/占用目标、原试验性的GPU资源调度入口已删除,独立运行环境通过高级OCR后端选择,多设备仍可并行运行,活动和分身仍串行。 默认跳过词现在直接显示在公共词表中,可增删;标题和说明按同一词表匹配。搜索每次随机抽取一个词,可连续重复;入口搜索不改词。旧空词表只迁移一次,之后手动清空会保留。默认值、兼容和运行边界见[配置核验表](CONFIGURATION.md)。 ### 可选GPU识别与下载代理 公共设置的高级选项支持auto、CPU、CUDA、DirectML。先停止所有设备任务再更换OCR后端。CPU便携包不带GPU运行库,即使选择CUDA或DirectML也会使用CPU;安装对应运行环境后才可能使用GPU,驱动/DLL缺失或GPU初始化失败仍回退CPU。日志中的实际模型执行器比下拉选择更能说明当前使用情况。auto优先尝试CUDA扩展,AMD / Intel用户需显式选择DirectML。 活动下载代理可填HTTP(S)地址或off(直连),留空跟随系统代理。该偏好作用于整个控制台,保存在用户配置中;任务词表、活动分支和每日记录不受保存操作影响。不应在公开截图或日志中暴露代理凭据。 ### 安装可选CUDA扩展 下载 [CUDA扩展 v1.0](https://github.com/h0ll0w-AkuZr0guY/MiaoTask/releases/tag/MiaoTask-CUDA-v1.0) 中的 `MiaoTask-CUDA-v1.0-windows-x64.zip`。扩展独立于主程序版本维护,不含exe;先安装MiaoTask基础包。当前已验证与MiaoTask v0.2.0配合使用。 | 条件 | CUDA扩展 v1.0 | | --- | --- | | 系统与框架运行时 | Windows x64、Python 3.13 ABI、ONNX Runtime 1.31.0;基础ZIP已提供对应CPU环境 | | 硬件与驱动 | 支持所附CUDA 13/cuDNN 9运行库的NVIDIA显卡和驱动;AMD/Intel显卡使用CPU | | 安装体积 | ZIP约1.26 GiB,解压约1.80 GiB,另预留解压临时空间 | | 额外安装 | 无需安装Torch、CUDA Toolkit或修改系统Python;显卡驱动仍需由用户安装 | 先退出右下角托盘服务。解压CUDA扩展ZIP,将其中的 `runtime_plugins/` 放到 `MiaoTask.exe` 同级,再启动服务,在高级选项选择自动或CUDA。扩展源码与NVIDIA运行库集中在 `runtime_plugins/cuda/python/`,不覆盖 `_internal/`,不需要安装Torch或切换系统Python。只安装可信来源的扩展;它与活动包一样含有可执行代码。 ```text MiaoTask/ ├── MiaoTask.exe ├── _internal/ ├── activities/ └── runtime_plugins/ └── cuda/ ├── manifest.json # 扩展版本与兼容条件 ├── README.txt └── python/ ``` 升级MiaoTask时,先退出旧服务;新包仍使用匹配的Python ABI与ORT版本时,可将原 `runtime_plugins/` 目录迁移到新exe同级,无需重复下载。框架Release会链接到匹配的独立扩展版本,不在每次框架发布中重复附带CUDA运行库。 扩展仅支持清单注明的Windows x64、Python ABI与ORT版本;不匹配或加载失败时保留基础CPU运行时。硬件、驱动或GPU推理不可用时回退CPU。卸载只需退出服务后删除 `runtime_plugins/cuda/`。普通CPU包可独立使用。此扩展只补充OCR运行时,尚不包含自动更新框架源码、原地重编译的启动器。 实际CUDA浏览在基础时长结束后读取一次完成状态,若尚未完成则按既有上限补滑1秒并复查;连续滑动期间仍不并发截图。返回任务列表的真实进度是最终成功依据。 截图提示无法核定前台时,框架会先在8秒总预算内复读显示摘要和窗口详情;跳转动画短暂没有焦点时不发送输入,身份重新核定后继续。预算耗尽、真实分身不一致或切到另一显示屏仍会停止。诊断记录中的capture_diagnostics区分焦点缺失、读取超时和查询失败;不要通过关闭身份检查规避。 ### 安装可选DirectML扩展(AMD / Intel) DirectML扩展独立于主程序版本维护,不含exe;先安装MiaoTask v0.2.2或更新的基础包。运行库为 `onnxruntime-directml 1.24.4`,与基础包CPU ORT 1.31.0属于不同版本线,清单以 `runtime_version` 单独校验,不要求版本号一致。 先退出右下角托盘服务,解压扩展ZIP,将其中的 `runtime_plugins/` 放到 `MiaoTask.exe` 同级,再启动服务,在高级选项选择「强制 DirectML(AMD / Intel 显卡)」。扩展内容集中在 `runtime_plugins/dml/python/`,不覆盖 `_internal/`。同时装有CUDA扩展时必须显式选择DirectML:`auto` 会优先加载 `runtime_plugins/cuda/`。不建议混装两种ORT扩展。 需要在支持DirectX 12的显卡与较新驱动上使用;AMD Radeon RX 6750 GRE(驱动32.0.21045.16010)由贡献者报告实机验证,检测与识别模型均使用 `DmlExecutionProvider`,Intel核显尚未实机验证,不宣称可用或加速收益。硬件、驱动或GPU推理不可用时回退CPU;卸载只需退出服务后删除 `runtime_plugins/dml/`。安装、移除或切换扩展种类后从托盘退出再重启,已有ORT加载后不能在线换库。 消息通知临时占用前台时,助手暂停输入并等待恢复,不打开消息。持续无法读取窗口时会自动恢复同一设备的所选实例并重新进入任务列表,不清空今日统计;恢复次数有界。真正断联、持续遮挡或验证页面仍需本人检查,不能保证所有ROM通知行为一致。 ### 启动流水线时出现屏幕映射错误 v0.2.0 包含 #36 的修订包至 v0.2.2,部分普通设备可能在预览正常时,点击开始或执行活动流水线立即报“无法映射当前应用屏幕”。v0.2.3 修复了物理屏映射被强制设为通用截图前提的问题,恢复普通截图优先,并保留特殊设备的兼容回退。请更新完整基础包后重新连接设备,无需清空每日记录或重新安装活动。CUDA 用户可迁移兼容的 `runtime_plugins/`。 持续出现异常时,导出脱敏诊断,附版本、机型、系统、USB/Wi-Fi 连接方式与起始活动。实际跨实例、显示屏歧义或安全认证仍需要按提示处理。