43 KiB
牧羊人之心牧场辅助
原生 PySide6 窗口,使用 Qt 默认控件。双击项目根目录的
Start_Ranch_Helper.cmd 启动。当前开发版本为 1.2.0.dev1,资料基线为游戏 1.9.68;最近正式版本为 1.1.1。497项常规回归已检查并完成失败项复测,原版运行时最终集成与真实账号验证仍待完成,自动原版开战准入保持关闭。
首次运行请先执行 python -m pip install -r ranch_assistant/requirements.txt。
完整功能与版本摘要见项目README。
底部日志区可拖动与页面之间的分隔条来调大或调小;顶部“隐藏日志 / 显示日志”切换显隐。 隐藏期间仍继续记录日志,重新显示恢复上次高度;高度和显隐状态随账号/角色配置保存。 孵蛋优先级、补货下限/目标和魔物喂养优先级均可直接输入数字,没有上下箭头。 横向、纵向滚动条均加宽为22个逻辑像素;仅调整滚动条,窗口与按钮保持原样。 下拉框默认加宽,表格中的操作、市场和难度列同步留足宽度;弹出列表按最长选项展开,并为滚动条预留宽度。 超过屏幕宽度的文字可横向滚动。 下拉框收起时悬停可查看完整选项,动态加载的区服、市场和魔物名称会重新计算宽度。 规则修改后自动保存并应用,无需点击保存按钮;连续输入会合并保存,尚未完整的输入不会覆盖已保存配置。 数字输入框仅在点击或键盘切换获得焦点后响应滚轮;未聚焦时滚动页面,不修改数字。 主窗口使用原生菜单栏:“账号”管理页签和保存会话,“策略”提供全部账号策略的开启/关闭,“策略配置”操作当前选中账号,“帮助 → 关于”显示版本号。 “保存当前账号策略”(Ctrl+S)可立即保存并应用当前配置,自动保存仍然有效。 勾选状态、优先级、孵出后的处理方式及保留数量都支持点击表头排序;刷新后保留排序,排序不改变策略优先级。 表格中的编号和名称靠左,星级、数量、优先级等内容及勾选框居中显示。
当前功能
- 登录与顶部信息:显示角色名、等级、累计经验/下一级经验、金币、氪金和体力。 “退出登录”保留登录记录;“退出登录并清除登录记录”经确认后只清除当前账号页签的凭据和会话。
- 培育室:已开启、未开启和VIP坑位分别显示;支持金币/氪金开普通坑位,先显示费用再确认。
- 背包:按“魔物蛋、可使用、消耗品、材料、其他、装备”分别显示子标签。魔物蛋逐种勾选孵化、设置优先级、选择孵出后派遣/喂养/保留,设置补货下限、目标和市场。 数量归零后保留规则;可添加当前无库存的蛋。未勾选的蛋不会自动孵化或触发补货。 各物品分类支持名称筛选,显示数量、品质和售价;可为物品设置赠礼开关及至少保留数量。只刷新当前打开的分类表格。
- 牧场:默认显示全部魔物,可手动切换为按牧场分组;按钮或右键可新建金币/氪金牧场,提交前确认费用。 “按牧场分组”使用可折叠树形:牧场标题显示数量、容量和空位,下方直接列出所属魔物;空牧场也保留显示,培育室魔物单独分组。 勾选喂养/赠礼目标并分别设置优先级;显示突破、当前等级上限、成长资质、参考属性、当前好感上限和喜欢的物品。 双击查看详情;右键可锁定、解锁、派遣、喂给指定魔物。
- 每个页面的表格和空白处可右键“刷新本页”;刷新会同步到期的成长状态,不执行派遣、喂养等消耗类策略。
- 多账号:同一程序内多个独立账号页签,登录后各自自动刷新状态,策略分别开启或关闭;切换页签不停止其他账号。
- 会话保存:成功读取角色后自动加密保存 Token、账号/区服/角色和请求编号,重启后可恢复。
- 自动孵蛋:按手动规则执行,使用顶部统一的“开启 / 停止”开关;默认关闭单抽,只十连,遵守金币保留和每日购蛋额度。 可选随机30秒、60秒、2分钟或5分钟,每轮刷新完成后从0到所选上限重新取间隔;喂养遵守普通等级上限,满级后转到下一喂养目标。 空坑装填单独计时:有可用蛋时随机等待1~2秒装填一个坑位,确认成功后继续下一坑,不受整体刷新间隔影响。 每次装填前重新读取坑位和库存;无可用蛋、坑位已满或关闭策略时暂停。此快速计时不会执行购蛋、派遣或其他操作。 子页分为“孵蛋策略”“牧场策略”“喂养策略”,内容超出高度时滚动显示,修改后自动保存并应用。 “牧场策略”新增独立开关“保留资质高于牧场同种培养代表的新魔物”,与S/A/B/C、4S及星级保护分别生效。 新魔物与牧场已保留的同种最高资质比较,依次按S项数、A项数、B项数、四项成长各自归一化后的平均值排序,严格更高才额外保留。 同分不额外保留;已有锁定、队伍及保留种类保护继续生效。
- 统一策略配置:通过主窗口菜单“策略配置”,保存、导入或导出当前账号的全部孵蛋、牧场、喂养、赠礼、委托、每日事务、扫荡、主线推进、战斗模式及监控间隔设置,包含自定义收益资料。 跨账号按魔物种类匹配喂养、赠礼和突破目标;探险队伍按队序重新绑定,手动队员按种类匹配且不复用原账号实例ID。探险总开关导入后关闭,顶部策略执行开关保持关闭,其余功能按原导入保留勾选。隐藏页不会裁剪规则,兼容旧版培养策略文件。
- 牧场保留与自动突破:“背包 → 魔物蛋”中每种蛋的“牧场保留”默认1,是最低保留数量,0关闭数量保护;同种数量跨牧场及孵化批次统一保底。锁定、星级/资质保护仍可超过数量,“更好资质额外保留”会额外保留,不自动解锁旧只或强行派遣。普通等级上限、同种突破(最高4级、每只同种素材+1突破经验)与潜能阶段是三种独立进度。 勾选“自动突破目标”即授权先补满四项潜能、再提升潜能阶段,消耗对应元素材料并沿用物品/委托保留量,不购买材料、不花金币或氪金。未勾选目标时不规划或输出突破提示。
- 自动探险:独立页签,默认关闭,每队配置开关、地区、三只手动队员或自动选人及保留体力;先领奖再出发,不花钱开队或召回。未解锁只显示原因,不阻断牧场等其他自动化;未确认的请求保留在角色本地状态中,新快照确认前禁止重发,停止后的刷新只读不写。 导入保留功能勾选和规则,策略开关保持关闭,核对后手动开启;文件不包含账号、密码、Token、会话或本机路径。
- 自动赠礼:独立页签,在背包勾选可用物品,在牧场勾选目标并设置优先级,再到“自动赠礼”启用。
每次消耗一件物品,默认只使用目标喜欢的物品;遵守当前羁绊好感上限、赠礼间隔、物品保留数量及委托保留。
勾选“每种魔物只培养一只,自动选择培养代表”后,自动为牧场中的每种魔物选一只,按等级 → 好感 → 综合成长资质排序,无需逐只勾选。
综合资质相同再比较四项成长;各项均相同时随机选定并按账号/角色记住。列表显示代表的ID、等级、好感和资质,“刷新 / 预览培养对象”可更新预览。
同种代表满好感或冷却时不改喂同种其他魔物;可继续处理其他种类。自动模式下代表会受自动派遣/喂养保护,手动模式保留原有目标优先级。
手动目标也会逐只判断,前一只冷却不会挡住后面的可赠礼目标;可送目标按账号顺序连续处理,无需等待整体随机刷新。
成功赠礼后以响应中的
feel / giftDate更新好感及冷却,短暂滞后的查询结果不会覆盖已确认状态。 请求的itemId使用背包物品实例编号,按物品种类设置的规则会在发送前匹配到实际库存;旧版误用了种类编号,已修正。 全部进入冷却后在本地倒计时,到期重新核对状态再赠礼;没有允许物品、库存不足或已达当前好感上限时不发送赠礼请求。 勾选自动培养代表或同种资质提升保护时,先在本地后台按已有快照重算,不为筛选单独请求服务器;实际赠礼前仍读取状态。 两个新开关均默认关闭,修改后自动保存并纳入统一策略导入/导出;选定实例保存在角色目录的cultivation_choices.json,不跨账号复制。 - 收益资料:749 种魔物数据来自用户提供的 APK 1.9.68,支持名称搜索和1–5星分别筛选, 可导入 CSV/XLSX 覆盖价格、经验和时间。
- 账号密码登录:第一弹渠道密码验证 → 官方区服列表 → 选择区服并读取角色。 区服数量和游戏服地址采用官方响应,不写死两个区。
- 记住密码:默认启用,保存账号和密码,重启自动填回,登录失败不清空输入框。 密码使用当前 Windows 账户的 DPAPI 加密;可取消勾选移除保存内容。
- 调试窗口:逐条查看请求地址、参数、HTTP 状态、耗时、解密响应和错误阶段, 支持复制/导出,自动保存本地脱敏日志。
- 自动主线:查看任务、NPC、位置、需求、对话和下一步,推进已支持的任务链;材料、蛋和击杀缺口可按已知普通地图来源自动收集,能力或条件不足时显示原因。详见下方设置。
- 自动委托:按每日剩余接取次数、解锁城市和库存,接取、推进已支持的步骤、 领取奖励;列表显示奖励金币和氪金数量。提交金币、道具、魔物分别受策略限制。实战步骤已接入任务战斗编排,仍须通过能力检查。
- 自动扫荡:按地区分组,默认折叠显示关卡、难度、掉落及账号解锁/通关记录。 首次读取后按账号/角色保存本地地图缓存,重启、切换页面或普通监控刷新均复用缓存,仅“刷新关卡”(或本页右键刷新)更新列表。 每关可勾选、选择已解锁难度和本日上限;满足游戏原有条件的普通关卡可接口扫荡, “未满星时自动挑战”默认开启,勾选已解锁普通关卡后可模拟首次挑战;符合三个难度全部通关条件后使用扫荡。打不过会暂停同一队伍的重复尝试,换队或提升属性后再试;未支持的规则显示中文原因。
- 战斗记录:按上下文筛选普通地图、主线、任务与委托战斗、扫荡和地图奖励事件;实验模型结果标明“实验近似”,未知结果保留待核对原因。
- 扫荡奖励:普通扫荡读取
battleEnd.reward,奖励事件读取stageEvent.result,日志列出本次实际获得的物品、魔物蛋、金币和经验。 - 数据分析:紧邻“自动扫荡”的独立页签。左侧按地区选择关卡和难度,右侧显示条形图与掉落明细;关卡和可能掉落来自本地静态配置。
可分别查看普通扫荡、奖励事件或合计,显示样本数、出现次数、获得总数量、实测掉落率、每次平均数量及95%区间。
“每点体力数量”按已知消耗样本的获得数量除以实际扣除体力计算,图表可切换到该指标;未知消耗样本不参与,体力奖励返还单独列出。
无样本显示“—”;同次获得多件物品只计一次出现,实测掉落率为出现次数除以已确认样本数。
数据按账号/角色保存在本地
sweep_rewards.sqlite3,重启保留;首次后台补录现有调试日志中能匹配角色、关卡和成功结算的记录,重复响应不重复计数。 “刷新本地统计”仅读取本机数据;统计与图表不额外请求服务器,不上传数据。实测概率随样本变化,不代表官方掉率。 - 每日事务:集中查看每日签到礼包、七日签到、累计奖励、VIP日奖和邮件附件; 可立即领取勾选项目,或开启顶部策略开关后自动领取;手动刷新不领奖。
- 离线演示:不连接游戏服务器即可查看数据、策略和模拟操作。
- 等级与体力:经验达到下一等级门槛时自动请求官方升级结算;按客户端150秒恢复周期请求体力结算并显示服务器返回值。 到期检查独立于随机刷新间隔,在账号后台线程串行执行;未开启消耗类策略时也会同步,退出登录或连接出错后停止。
v1.2 自动主线与战斗设置
本节对应 1.2.0.dev1 开发版。任务调度和界面已实现,原版与实验模式均有局部能力限制;完整集成 QA、实际阵容的原 AIR 输入桥接和真实账号验收尚未完成。
-
登录或恢复当前角色后,进入“自动主线”,点击“刷新任务 / 预览”。“任务状态”显示类别、步骤、目标位置、需求、下一步和支持状态;选择一行可查看 NPC、对话与阻塞原因。刷新用于同步与预览,不执行任务交付或开战。
-
打开“推进策略”,选择主线或支线、自动接取、已支持对话和补链选项。需要补齐材料、蛋或击杀时,勾选“自动收集任务材料 / 击杀目标”;来源必须符合当前位置、地图解锁、资源保护及运行时能力。
-
任务和委托统一使用内置模拟,无需选择运行时;保留原始属性,计算战斗过程并等待相应时长后再提交。选择推进战斗队伍,设置保留体力、单次交付金币上限、物品保留量和连续失败停止次数。物品、魔物交付默认关闭,金币上限默认 0。
-
委托仍在“自动委托”单独配置启用、接取、城市、交付限制及“也接取需要实战的委托”。按奖励氪金20→15→10优先接取可处理的委托,已有委托优先完成,委托步骤及材料补缺优先于普通孵蛋、赠礼、主线和刷图。缺少材料时自动选择已支持的扫荡/挑战来源,并遵守保留设置;已有足够库存则直接交付。按委托缺口买蛋、孵化、交付的完整联动尚待实现。
委托自动执行只需启用“自动委托”及顶部绿色“开启”,下一轮状态刷新会检查接取和完成条件,无需启用自动主线。接取前会逐份检查实际战斗能力;高奖励委托无法完成时继续检查其他同奖励或较低奖励的委托。表格“需求 / 进度”以中文显示暂不接取或等待条件的原因。勾选允许提交道具、魔物及实战表示允许这些操作,不能使尚未实现的战斗机制或买蛋孵化联动自动变为可用。
-
勾选“启用自动主线策略”,再点击顶部绿色“开启”。修改规则会自动保存并应用;菜单“策略配置”可立即保存、导入或导出当前账号规则,包含任务策略与战斗模式。重启、恢复会话和导入后,顶部策略开关保持关闭,核对后再开启。
-
在“战斗记录”查看上下文、队伍、胜负和原因;“刷新本地记录”只读取本机记录。点击顶部红色“停止”可取消后续推进和可取消的运行/时钟等待;已经发出的请求仍须等待确认,开战后的未知状态会保留待核对记录。
有待核对记录时,后台最长每2分钟刷新服务器状态,无需手动核对。若是模型已完成、仅等待战斗时长时被中断,开启对应策略后会自动续交原先保存的胜利结果,保持同一任务实例与步骤,不重新发起入场请求或模拟;旧版记录也可恢复。关闭策略时只查询状态,不续交。结算请求已发出但结果未知时只自动查询,不重复发送;没有足够服务器证据时仍会显示等待原因。
| 能力 | 当前开发版行为与边界 |
|---|---|
| 任务与对话 | 已实现接取、已支持线性对话、满足条件后的交付、领奖、后继接取与任务补链。服务器确认步骤后,才完成后续剧情和本地步骤收尾;本地检查点按账号/角色保存。 |
| 开图与收集 | 随任务目标和地图前置推进,缺少材料、蛋或已识别的成年目标击杀时规划普通地图;可能掉落只用于选择来源,实际库存与击杀仍需结算后刷新。扫荡不计作击杀来源。 |
| 扫荡 | 普通、非特殊、无当前任务截获的关卡,三个难度全部通关后才可扫荡。“允许用扫荡完成已通关目标”受此条件限制;任务专属战斗和任务通关战斗仍走各自任务路线。逐关次数与难度在“自动扫荡”配置。 |
| 地图奖励事件 | 普通地图开始时若已经发放探索奖励,单独记录奖励并刷新;该分支不运行战斗,也不重复提交战斗奖励。隐藏战斗重新检查能力,未知事件保留待处理。 |
| 原版内核研究工具 | 保留原 AIR 离线验证工具,不再要求桌面用户选择;最终原版集成尚待完成。 |
| 内置模拟 | 独立进程使用原始数值资料计算 AP、出场、移动、攻击及技能 3、5、7、9、38 的部分机制,保留轨迹、胜负和异常,并等待计算出的战斗时长。物理、随机、时序、装备及其他技能存在近似或遗漏,结果可能与原版不同。任务1002002所需的纯显示 buffMovie 控制器已支持。 |
任务资料包含 1165 个任务、1178 个关卡、337 个 NPC 和 4269 份脚本;4239 份属于已支持的线性脚本,主线引用中为 718/720。这些是资料与脚本分类数量,不是整条主线通关率。30 份特殊选择等脚本(含 2 份主线)、4 类特殊接取入口、任务1001006第4步的特殊抽蛋钩子尚不支持;活动、羁绊和未知任务类别也不承诺自动推进。
实验模型当前拒绝未支持的控制器、触发器、保护/破坏目标及活动场地区域;未实现的技能与属性效果会在诊断中列出。941/2512 份地图战斗配置和 106/199 份任务内嵌战斗配置通过结构准入,12 场合成阵容地图实验自然胜利;这些数量不证明全部关卡可过、完整原版机制或真实账号验证。原 APK 资料与线上热更新资源的一致性、全部实际角色加成仍需核对。详细机制与遗漏见实验模型说明,原引擎实验见运行时说明。
离线演示和独立实验可以加速计算模型时钟,不预测服务器奖励或任务进度。已接入的实验战斗编排在开战确认后,以真实经过时间补足模型战斗耗时,等待可取消;自然战斗时间耗尽与工作进程超时分别记录。离线计算快不代表可以提前完成在线结算,服务器是否接受结果尚未验证。
看到“待核对”“不支持”或资源不足时,先查看任务详情和战斗记录中的具体原因。请求结果不明时,本账号的牧场、赠礼及任务等冲突写操作会暂停;重启不会清除待核对状态。恢复角色后点击“刷新任务 / 预览”,程序只在新的角色/任务状态足以证明结果时解除阻塞,随后可继续已保存的普通剧情检查点;证据不足时仍等待用户在游戏内核实。不要通过删除记录或反复开启来重发未知请求,策略导入也不能覆盖服务器通关进度或解除未知结算。
任务与战斗记录保存在本账号、区服和角色的本地工作区;规则导出不含凭据、任务执行记录、待核对日志或服务器进度。实现边界、验证记录和接口分流另见v1.2 实施与阶段交接。
连接真实角色
默认未登录,使用本地示例数据。顶部账号页签用于切换账号,菜单“账号 → 新增账号页签”用于登录另一账号。
- 在“登录”页填写第一弹渠道账号和密码,点击“账号密码登录并获取区服”。
默认勾选“记住账号和密码”;编辑完、点击登录或关闭窗口时自动保存。
密码保存在本机加密文件
local_state/ranch_helper/credentials.json,重启自动填回,不再自动清空。 - 从“官方返回的区服 / 已有角色”选择区服,点击“进入选中区服”。
登录中心取自 APK,游戏服务器地址取自选中区服的
gameServerAddress。 - 确认角色名称、培育室和背包数量。成功后 Token 自动保存到该账号工作区的
sessions/,并开始自动刷新状态,无需另开监控。 - 在“背包魔物蛋”逐种配置:勾选“孵化”,设置优先级(1最高),选择“孵出后”派遣、喂养或保留。 “低于补货”是可用蛋少于多少开始购买,0表示关闭;“补至”是希望补充到的可用蛋数量。 每行可选包含该蛋的金币市场;蛋用完后这一行仍会保留。规则自动保存。
- 到“自动孵蛋”启用需要的买蛋、孵蛋、派遣、收取或喂养开关。 点“刷新 / 预览”查看下一步,再点击顶部绿色“开启”。各页面只配置功能和规则,不再分别开始或停止。 点击红色“停止”后仍会刷新状态、同步到期成长,但不再自动派遣、喂养、购蛋或领奖。手动刷新只更新状态。 已经发送的请求会正常返回,关闭后不发送下一项自动操作。重启或恢复会话后自动刷新,策略开关默认关闭。
- 需要经验时,在“牧场”勾选接收经验的喂养目标并设置优先级。优先级数字小的先喂,达到当前突破上限后换下一个; “自动孵蛋 → 喂养策略”只显示当前喂养状态,不重复选择魔物或设置停止等级;目标统一采用牧场中的勾选和优先级。在“牧场策略”设置星级/资质保护和保留蛋数量。“收益资料”的星级勾选只筛选表格显示。
- 需要提升好感时,在“背包”的对应物品分类中勾选物品并设置保留数量,在“牧场”勾选目标并设置赠礼优先级; 在独立的“自动赠礼”页启用。达到当前好感上限或仍在赠礼间隔时不会继续消耗物品。 菜单“策略配置”可导出全部策略供其他账号导入;导入后需逐项核对并开启顶部策略开关。
可用“绿色史莱姆金币预设(仅孵此蛋)”快速设置:只勾选绿色史莱姆、优先级1、孵出后派遣、低于1补至10、 莉莉托斯市场。这个预设关闭喂养,保留4星以上/A资质魔物,仍需开启顶部策略开关。 “登录”页不再展示服务器地址、Token、密钥和请求编号,也不自动弹出调试窗;这些信息由程序内部处理。
莉莉托斯市场单次价格为100金币(本地客户端表),买到的蛋随机,不能指定全部为绿色史莱姆。
绿色史莱姆总培育时间10分钟,成熟派遣150金币;这不代表整个随机蛋池都固定净赚50金币。
购蛋默认关闭,需要勾选或应用预设。“允许单抽”默认关闭,旧配置未包含此开关时也默认关闭;保留1000金币、每日额度5000金币。
单抽关闭时,购买数量始终为10的倍数;补货缺口、可用金币或每日额度不足十连就等待,无蛋时也不单抽。请将魔物蛋规则的“补至”至少设为10。开启“允许单抽”后,可按“优先十连”和单抽每批上限配置补货。此开关修改后自动保存,支持策略导入/导出。
十连的赠蛋数量以服务端实际返回为准,“最近抽蛋”显示收到的蛋种类和数量。
只购买已解锁城市的金币市场蛋,不使用氪金、抽蛋券或酒馆抽蛋。
额度按北京时间自然日、账号区服角色分别累计,保存在角色目录的 purchase_budget.json;
发送前记账,超时不重试也不自动退回额度,以免重复购买。切换账号、重启不会重置当天额度。
离线演示的购买和成熟仅用于流程演示,不预测真实抽蛋结果,额度不写入真实角色记录。
该密码流程来自此 APK 内第一弹 SDK 的普通账号接口,不是游戏开发者登录。
官方要求短信验证(407)或限制登录(408)时会停止,目前未实现验证码界面。
其他渠道或接口格式变化时需调整登录实现。旧会话导入函数仍保留为内部工具,不在登录页展示。
区服编号兼容 id 和 serverId,包含数字字符串;
角色条目中的 id 单独作为角色编号,不与区服编号混用。用户已确认真实登录和角色数据读取成功。
区服列表里的 {"$ref":"$.servers[0]"} 是对同一数组条目的引用,程序会还原引用并按编号去重,
将对应的角色名显示在区服下拉框中。已用用户本地的实际响应验证两区、两个角色均能正确关联。
无法识别的区服条目会停止并在界面日志列出字段名;调试窗口保留解析前收到的响应,令牌已遮盖。
真实会话过期后会停止,需要重新登录或导入会话。游戏 Token 和协议密钥在 sessions/ 中使用 Windows DPAPI 加密,
策略设置和调试日志不保存令牌原文;SDK Token 和 HAR 原文不持久化。密码由独立的本机加密文件保存。实际服务器如
更新了协议密钥,需要更新客户端配置;登录页不展示协议参数。
多账号与恢复会话
- 每个账号使用独立页签。菜单“账号 → 新增账号页签”添加账号,用页签或“打开已保存账号”切换。
- 每个账号首次在本版本正常登录一次;此前版本只保存在内存的 Token 不能从脱敏日志补回。
- 重启后在“登录”页点击“恢复选中会话”,或使用菜单“账号 → 恢复各页签的保存会话”。 恢复会先读取角色并核对角色编号,成功后才显示为真实数据;不会自动开启消耗类策略。
- 登录或恢复会话成功后自动刷新状态,各账号只有一个顶部策略开关。 菜单“策略 → 开启全部账号策略 / 关闭全部账号策略”批量控制已连接账号;关闭策略后仍继续刷新。
- 关闭页签会停止该账号,并立即保存关闭状态;重启后不再自动打开。账号记录仍可用“账号 → 打开已保存账号”重新打开。 退出整个程序时,会保留当时仍打开的页签;关闭所有页签后,下次启动保持空白。
- 彻底删除本地账号记录:右键账号页签选“移除此账号…”,或用“账号 → 移除当前账号…”。 已关闭的账号可用“账号 → 移除已保存账号…”选择。确认后删除所选账号的本地密码、会话、策略、地图缓存和运行记录,不会注销游戏账号。 若有请求正在执行,先停止调度,待当前请求结束再移除;其他账号继续运行且记录保留。移除后重启也不会恢复该账号。
账号工作区各自保存凭据、会话和日志;区服/角色各自保存策略、喂养目标和扫荡次数。 切换区服时不沿用其他角色的策略。相同账号区服不会在两个页签重复运行。 会话的请求编号在发送前保存,包括超时未确认的请求;写请求不会自动重发。 删除保存会话需先退出登录,再点击“删除选中保存会话”;也可使用“退出登录并清除登录记录”一次清理当前账号页签。 “记住账号和密码”只控制密码,独立于会话保存。
正常会话心跳按客户端的 240 秒周期运行;成长状态按阶段到期触发同步。需要实际战斗的关卡在游戏内手动进行。
页面数据与刷新
“培育室”“背包”“牧场”可直接查看状态,顶部显示坑位、蛋数量、物品、魔物、牧场数量和更新时间。 表格或页面空白处右键选择“刷新本页”,保持当前页面;请求进行中再次刷新会排队。 收益资料页刷新本地资料;已移至最后。状态轮询支持随机30秒、60秒、2分钟和5分钟,每轮完成后从0到所选上限取间隔。 当前客户端代码可确认240秒会话心跳和成长阶段到期结算,未找到统一的全量状态轮询周期;阶段同步独立于随机轮询,不必等下一轮。
已修复实际响应里 activityHistory.vipInfo=null 导致策略报错、阻止数据显示的问题。
已用实际角色响应回放验证 4 个坑位、4 类蛋、4 只魔物和 1 个牧场能显示。
策略计算或配置出错时,基础数据仍可读取,自动操作会停止。
调试登录
点击顶部“调试窗口”手动打开。账号登录及选择区服时不自动弹窗,后台仍保存脱敏记录。 按顺序可看到:渠道账号验证、获取官方区服、选择区服、进入选中区服、读取角色。 账号验证和获取区服完成后停下来等你选服,选中后才会发送进入区服请求。 区服整理是本地将 JSON 字段转换成界面选项;“本地错误”不表示发送了额外请求。 同一个错误在网络/数据层和界面层传递时只记录一次。
进入区服前会增加“进入参数检查”本地记录,显示签名日期、规则和渠道,不包含 Token 或签名原文。
原客户端虽然写 yyMMdd,其格式函数实际使用四位年份,签名日期必须为八位 yyyyMMdd。
channel=DYD 与 APK 里的 tjChannel=taptap 分别读取和传递,不混用。
选中一条记录可看完整 JSON;游戏加密接口显示解密后的字段。HTTP 错误、连接超时、
响应解码失败和区服解析失败都记录,密码、Token、Cookie、Authorization 会遮盖。
界面显示本次运行最近 300 条记录,日志自动追加到:
首账号为 local_state/ranch_helper/network_debug.jsonl;新增账号位于其 profiles/<账号页签编号>/ 目录。
窗口顶部会显示该账号的实际日志路径;超过约 8 MiB 会保留一份上一段日志。
重新尝试登录后,告诉助手“日志好了”,助手即可读取这个工作区内的调试文件; 不用发送账号密码。也可以用窗口里的复制、导出按钮取得脱敏记录。 接口静态清单见 API_INVENTORY.md,包含用途、参数、回调字段和证据位置。
手动规则与保护
算法参考 BWIKI 魔物收益表, 原页面作者 Monster-SCAG,页面标示更新于 2020-12-05。没有把旧攻略表的 所有数值直接套入当前游戏;本版使用 APK 中的事实数据计算。
- 金币/小时 = 派遣金币 / 总培育小时数。
- 经验/小时 = 强化经验 / 总培育小时数。
- 自动操作按各行手选的去向执行,不按收益表自动决定派遣还是喂养。优先级相同时先孵时间较短的蛋。
- 单体喂养经验按客户端公式计算:基础经验 + 截断(已获得经验 × 配置倍率)。 默认内置倍率从客户端数据提取为 0.2。
- 收益页的每小时金币是毛收益,不是购蛋净利润;实际购蛋金币会单独从余额和每日额度扣除。
- 默认保留三星及以上、综合 A 资质及以上,以及锁定、系统锁定、羁绊、 在队、探索中、携带装备和资质数据不完整的魔物。
- 自动派遣/喂养只处理本次运行在培育室观察到的魔物,不扫描并消耗已有 牧场魔物。未指定可用喂养目标时不消耗素材;手动右键操作可选择已有牧场魔物。
- 非 VIP 不使用客户端标识的第 4 个 VIP 坑。牧场满了停止收取;喂养到当前突破上限后,
按牧场中设置的优先级继续喂下一只。客户端上限公式为
potentialLevel × 10, 例如突破等级2的上限是20;上限未知或经验已经达到上限的目标会跳过。 “牧场”魔物列表显示等级/当前上限,未勾选目标时不自动喂养。每轮执行一项计划操作,随后重新读取状态; 成熟计时结束时会先结算成长并重新读取,再决定收取或派遣。 - 游戏对蛋的
feedLock存在手机本地存档中,服务器会话看不到这项本地 偏好。需要保留某类蛋时,在策略页填写“编号:保留数量”。
手动管理与扩建
孵化与幼体成长阶段显示“待成熟后生成”,不把服务端的零值算成 C 资质。
登录后在两个阶段到期时自动请求成长结算,并使用结算响应中的阶段和四项成长值更新界面;
成熟、资质确定后才决定派遣、喂养或保留,旧查询结果不会覆盖尚未确认回写的结算数据。
培育室无需手动同步;登录后阶段到期会在后台同步,关闭策略后仍会检查。服务器暂未确认时会限频等待,避免连续发送。
派遣、喂养等自动操作由顶部策略开关统一控制。
资质保留条件新增“四项全S(4S)才保留”,要求攻、防、生命、敏捷分别为S;综合评级为S不等于4S。
锁定、队伍、保留星级、资料不完整等保护独立生效;若希望低星魔物仅按4S保留,请同时检查保留星级设置。
保留原因会显示在培育室建议和日志中。
培育室与牧场派遣都使用 monsterService/monsterSell 的 monsterIds 数组参数,
不需要先收取到牧场。旧版培育室误用了遗留包装的 monsterId 字段,会触发服务端997
“网络错误”;现已统一修正自动派遣和右键手动派遣。
培育室魔物的 roomId=null 已兼容,统计牧场容量时不会再因空字段中断整轮策略。
- 魔物表可多选,使用按钮或右键锁定/解锁。派遣、指定喂养会列出将消耗的魔物并要求确认; 这些手动操作会关闭策略,状态刷新继续。锁定、系统锁、羁绊、在队、探索、建筑中及已装备的魔物不能作为素材。
- 喂养素材需已收取到牧场,目标不能是素材本身,且不能已满当前突破等级上限。
- 参考属性按基础值、成长、等级、潜能、好感及升星计算,不含装备、羁绊和全局加成;完整实战面板以游戏为准。
- 培育室按本地表列出11个坑位,并兼容服务器返回的更多位置。第4个为VIP专用,不走普通扩建接口。 选择未开启的普通坑位后可用金币或氪金开通。VIP资格需在游戏内处理。
- 牧场页的“新建牧场”支持金币或氪金。金币建牧场还要求账号已解锁相应建设功能。
- 金币建设解锁按已完成任务
1001011判断,与客户端一致。 - 费用按客户端价格表与设施
openType统计的扩建次数计算,提交前重读角色、检查等级和余额; 费用变化会要求重新确认。取消确认不会发送请求,超时不会自动重复购买。 - 实测日志里的空坑是
monsterId=-1,已按客户端<=0规则修复;此前买到蛋却不孵化的原因就是误判空坑。
文件与验证
- 工作区:首账号使用
local_state/ranch_helper/,新增账号使用其profiles/<编号>/。sessions/是加密会话;roles/<角色标识>/是各角色的策略和本日次数。 catalog.json是本地数据;游戏热更新后的新魔物/新售价需要更新资料。 未知魔物和不完整资质不会自动派遣或喂养。- 自定义表:
typeId, sell_money, sell_exp, time_total(秒),可只提供部分 覆盖列;中文列名“编号、派遣金币、强化经验、孵化秒数”也支持。 - 测试:
python -B -m unittest discover -s ranch_assistant/tests -v。 - 1.1.1 阶段记录为 209 项本地测试;v1.2 的数据/规划、编排、模型和界面定向验证见实施验证记录,完整集成 QA 仍在进行,各组数量不能直接相加作为全量结果。原有回归覆盖登录、会话隔离、账号关闭与移除、菜单账号路由、数字框滚轮、地图缓存、请求计数、等级与体力结算、成长同步、孵蛋与补货、同种魔物培养与资质提升保护、批量喂养、派遣、赠礼、统一策略配置、委托、扫荡、奖励统计与体力效率和每日奖励。 赠礼覆盖手动目标冷却跳过、连续赠礼、独立到期调度、成功响应回写、滞后查询及本地培养筛选不发请求的回归测试;本地策略与页面异常写入调试日志并标记为本地错误。 登录后自动刷新、顶部统一策略开关、关闭策略后继续刷新及多账号批量开关均有回归覆盖。 新增牧场树形/平铺切换、分组数量与空位、刷新保留折叠和控件、4S保留条件、随机刷新间隔及到期独立同步的回归测试。 双账号与大量库存的界面响应继续通过测试;测试使用本地模拟数据和模拟服务,不操作真实账号库存。
- 网络写请求发生异常后不会直接重试,以免重复消耗魔物或物品。
委托和扫荡的范围
“自动委托”需单独启用;可先关闭“自动孵蛋”的自动管理,只运行委托。 道具和魔物提交默认关闭,金币提交上限默认 0;锁定、队伍、高星和高资质保护继续生效。 已接委托需要的魔物种类和蛋会纳入牧场保留。 “也接取需要实战的委托”允许经检查后接取实战委托;已支持的剧情、交付和专用战斗通过任务调度继续推进。战斗模式与队伍在“自动主线 → 推进策略”选择,委托资源限制仍由本页配置。当前默认原版模式的实际阵容桥接尚待完成,不应把这个开关视为所有委托均已可用。
普通、非剧情定位关卡的三个难度全部通关后才开放扫荡,无需本地战斗演算或手机截图。首次挑战、任务专属战斗与扫荡分别处理,当前可执行范围见上方能力表。客户端调用链与字段证据见地图及每日事务研究和战斗路线说明。
在“自动扫荡”展开地区,每关勾选“刷图”、选择已解锁的难度、输入“本日上限”,勾选该页功能,再开启顶部策略开关。需要挑战未通关普通关卡时保留“未满星时自动挑战”勾选;关闭后只执行符合条件的扫荡,无需开启自动主线。
挑战沿用原始属性和内置模拟,等待计算出的战斗时长后按普通关卡流程结算,战果与奖励在“战斗记录”查看。实际战败显示“打不过”,本日内相同阵容及属性不会反复尝试该难度;更换战队、升级或属性变化后允许再试。每日次数与扫荡共用,开战前占用次数,确定未发送的取消会退回次数;未知回包不重复请求。暂停或重启后可续交已完成并保存的模型结果,保持原始开战和每日计数。地图列表保存在本地,普通轮询不重建;挑战已确认结束后同步账号实际通关进度。 星级是服务器通关进度计算出来的,只读。未解锁难度不能选;特殊关卡、未全通关、剧情任务、 体力/金币/门票不足的关卡会显示原因并跳过。次数按角色、日期、关卡和难度保存, 是本地已开始次数,不冒充服务器每日限制。 一次扫荡内部的几个请求顺序执行,完成后重读账号状态;开启其他策略时与孵蛋/委托逐轮串行。 探索奖励事件已由地图开始响应直接发放,刷新角色后可继续下一轮,不再提交普通战斗结算。 旧版将此类奖励事件误记为未完成时,只在本地日志能匹配当前角色、关卡和成功响应的情况下自动解除阻塞,不重发请求。 隐藏关卡单独检查运行时能力;不支持、缺失事件状态或请求结果不明确时保持待处理,避免重复扣体力。恢复前先刷新并在游戏内核实,未知写请求不会自动重发。
“每日事务”选择要处理的奖励类别,点“领取勾选项目”可立即领取; 勾选“启用每日奖励领取”并开启顶部策略开关后,只自动处理符合状态的项目。 VIP奖励只对已有资格领取;不会购买VIP或升级礼包。邮件仅领取附件,不删除邮件。 启动/重启默认关闭策略,登录后自动刷新并同步到期成长;自动操作由顶部策略开关统一开启。勾选项、战队、保留体力及刷图规则按角色保存。 网络写请求发送前保存本地记录,异常不直接重试;本日已提交但服务器仍返回旧状态的奖励会明确提示。
资料包含此APK的1178个关卡、各难度奖励和2079种道具名称。 这些是安装包配置中的可能掉落,并非实时掉落概率保证;后续热更新新增数据需要重新提取。 这些流程有本地模拟验证;本轮开发验证未执行真实游戏请求,v1.2 的任务与战斗服务器验收仍待用户手动验证。软件在用户开启策略后,可按配置和能力检查自动执行已支持操作。 静态证据与字段规则见地图及每日事务研究。
刷新响应与批量喂养
网络和属性/关卡资料计算在各账号的后台线程执行,账号之间并行;同一账号的请求与库存操作保持顺序。 只更新当前账号正在查看的页面,其他账号保存最新快照,切过去时再显示。 魔物、蛋和地图的大列表分成约8ms的小批次更新;未变化的控件复用,不再每轮重建整页。 魔物表、蛋表的列宽可手动拖动,避免每次更新都扫描所有单元格计算宽度。 调试窗关闭时不排版完整响应JSON;请求日志仍照常保存。
本地模拟两个账号:一个80只魔物、4000枚蛋(200类),另一个500只魔物,各有700ms网络等待。 本次测得回包界面回调约2~11ms,界面事件最大间隔30.75ms。这个数字来自测试环境, 不是所有电脑的耗时承诺。调试记录新增“刷新耗时”,分别记录后台总时间、资料整理时间和界面回调时间。
自动收取会按牧场剩余容量合并提交;自动喂养把同一目标的合格素材放入一次foods数组请求,
按照牧场中勾选的喂养目标优先级执行,数字越小越优先。当前目标达到突破上限后换下一个目标;旧版停止等级配置不再影响自动喂养。
批量素材按升级经验表计算,达到需要的经验后停止添加;最后一只素材可能有少量溢出。
锁定、在队、高星、资质保护及委托保留仍参与每只素材的筛选。
有连续动作时自动推进;设置的监控间隔用于等待新状态,不再要求每收取或喂养一只都等待完整间隔。
每次写操作后仍重新读取状态,喂养已返回但素材仍在旧快照中时暂停核对,避免重复提交。
喂养日志同时列出目标和全部素材的实例ID、魔物名称、素材数量;有昵称时也会显示。
本轮没有向真实账号执行收取、派遣或喂养。性能记录见analysis/REFRESH_PERFORMANCE.json。