24 KiB
牧羊人之心牧场辅助
原生 PySide6 窗口,使用 Qt 默认控件。双击项目根目录的
Start_Ranch_Helper.cmd 启动。这台机器所需依赖已经存在。
其他环境可先运行 python -m pip install -r ranch_assistant/requirements.txt。
底部日志区可拖动与页面之间的分隔条来调大或调小;顶部“隐藏日志 / 显示日志”切换显隐。 隐藏期间仍继续记录日志,重新显示恢复上次高度;高度和显隐状态随账号/角色配置保存。 孵蛋优先级、补货下限/目标和魔物喂养优先级均可直接输入数字,没有上下箭头。 横向、纵向滚动条均加宽为22个逻辑像素;仅调整滚动条,窗口与按钮保持原样。
当前功能
- 登录与顶部信息:显示角色名、等级、累计经验/下一级经验、金币、氪金和体力。 “退出登录”保留登录记录;“退出登录并清除登录记录”经确认后只清除当前账号页签的凭据和会话。
- 培育室:已开启、未开启和VIP坑位分别显示;支持金币/氪金开普通坑位,先显示费用再确认。
- 背包:按“魔物蛋、可使用、消耗品、材料、其他、装备”分别显示子标签。魔物蛋逐种勾选孵化、设置优先级、选择孵出后派遣/喂养/保留,设置补货下限、目标和市场。 数量归零后保留规则;可添加当前无库存的蛋。未勾选的蛋不会自动孵化或触发补货。 各物品分类支持名称筛选,显示数量、品质和售价;可为物品设置赠礼开关及至少保留数量。只刷新当前打开的分类表格。
- 牧场:合并魔物与牧场列表,可按牧场筛选或查看全部魔物;按钮或右键可新建金币/氪金牧场,提交前确认费用。 “按牧场分组”使用可折叠树形:牧场标题显示数量、容量和空位,下方直接列出所属魔物;空牧场也保留显示,培育室魔物单独分组。 勾选喂养/赠礼目标并分别设置优先级;显示突破、当前等级上限、成长资质、参考属性、当前好感上限和喜欢的物品。 双击查看详情;右键可锁定、解锁、派遣、喂给指定魔物。
- 每个页面的表格和空白处可右键“刷新本页”;刷新会同步到期的成长状态,不执行派遣、喂养等消耗类策略。
- 多账号:同一程序内多个独立账号页签,各自监控、自动执行、记录日志;切换页签不停止其他账号。
- 会话保存:成功读取角色后自动加密保存 Token、账号/区服/角色和请求编号,重启后可恢复。
- 自动孵蛋:按手动规则执行,提供开始执行、仅监控、停止按钮;支持十连优先、金币保留和每日购蛋额度。 可选随机30秒、60秒、2分钟或5分钟,每轮刷新完成后从0到所选上限重新取间隔;喂养遵守当前突破上限,满级后转到下一喂养目标。 原“牧场策略”并入此页的“牧场与赠礼策略”子页,内容超出高度时滚动显示;可导出、导入培养策略,跨账号按魔物种类匹配目标。 导入后所有自动执行开关保持关闭,文件不包含账号、密码、Token、会话或本机路径。
- 自动赠礼:在背包勾选可用物品,在牧场勾选目标并设置优先级,再到“牧场与赠礼策略”启用。 每次消耗一件物品,默认只使用目标喜欢的物品;遵守当前羁绊好感上限、赠礼间隔、物品保留数量及委托保留。
- 收益资料:749 种魔物数据来自用户提供的 APK 1.9.68,支持名称搜索和1–5星分别筛选, 可导入 CSV/XLSX 覆盖价格、经验和时间。
- 账号密码登录:第一弹渠道密码验证 → 官方区服列表 → 选择区服并读取角色。 区服数量和游戏服地址采用官方响应,不写死两个区。
- 记住密码:默认启用,保存账号和密码,重启自动填回,登录失败不清空输入框。 密码使用当前 Windows 账户的 DPAPI 加密;可取消勾选移除保存内容。
- 调试窗口:逐条查看请求地址、参数、HTTP 状态、耗时、解密响应和错误阶段, 支持复制/导出,自动保存本地脱敏日志。
- 自动委托:按每日剩余接取次数、解锁城市和库存,接取、推进已满足条件的步骤、 领取奖励;列表显示奖励金币和氪金数量。提交金币、道具、魔物分别受策略限制。战斗步骤等待游戏实际完成。
- 自动扫荡:按地区折叠显示安装包内的关卡、难度、掉落及账号解锁/通关记录, 每关可勾选、选择已解锁难度和本日上限;满足游戏原有条件的普通关卡可接口扫荡, 其余请在游戏内手动战斗。
- 每日事务:集中查看每日签到礼包、七日签到、累计奖励、VIP日奖和邮件附件; 可立即领取勾选项目,或开启自动执行时领取;手动刷新不领奖。
- 离线演示:不连接游戏服务器即可查看数据、策略和模拟操作。
连接真实角色
默认未登录,使用本地示例数据。顶部账号页签用于切换账号,“新增账号页签”用于登录另一账号。
- 在“登录”页填写第一弹渠道账号和密码,点击“账号密码登录并获取区服”。
默认勾选“记住账号和密码”;编辑完、点击登录或关闭窗口时自动保存,也可点击“保存登录信息”。
密码保存在本机加密文件
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枚时发送 num=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,即使设置70级也会在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 -m unittest discover -s ranch_assistant/tests -v。 - 127 项本地测试通过,覆盖登录、会话隔离、请求计数、成长同步、孵蛋与补货、批量喂养、派遣、赠礼、委托、扫荡和每日奖励。 新增牧场树形/平铺切换、分组数量与空位、刷新保留折叠和控件、4S保留条件、随机刷新间隔及到期独立同步的回归测试。 双账号与大量库存的界面响应继续通过测试;测试使用本地模拟数据和模拟服务,不操作真实账号库存。
- 网络写请求发生异常后不会直接重试,以免重复消耗魔物或物品。
委托和扫荡的范围
“自动委托”需单独启用;可先关闭“牧场与赠礼策略”的自动管理,只运行委托。 道具和魔物提交默认关闭,金币提交上限默认 0;锁定、队伍、高星和高资质保护继续生效。 已接委托需要的魔物种类和蛋会纳入牧场保留。 “也接取需要实战的委托”只允许接取此类任务,当前不会自动导航到每项委托的专用战斗。
普通关卡首次通关仍需在游戏内实际战斗。客户端有 startSaodang /
doSaodangBattle 扫荡分支:普通、非剧情定位关卡的三个难度全部通关后才开放。
它复用 stageStart → battleEnd → recordBattleResult,无需本地战斗演算或手机截图。
此前只搜索英文 sweep 和中文“扫荡”漏掉了这个拼音方法;现已按该分支实现。
在“自动扫荡”展开地区,每关勾选“刷图”、选择难度、输入“本日上限”,再点击“开始扫荡”。 星级是服务器通关进度计算出来的,只读。未解锁难度不能选;特殊关卡、未全通关、剧情任务、 体力/金币/门票不足的关卡会显示原因并跳过。次数按角色、日期、关卡和难度保存, 是本地已开始次数,不冒充服务器每日限制。 一次扫荡内部的几个请求顺序执行,完成后重读账号状态;开启其他策略时与孵蛋/委托逐轮串行。 触发随机事件或请求结果不明确时停止,不提交后续结算;在游戏内处理后可清除本地待处理记录。
“每日事务”选择要处理的奖励类别,点“领取勾选项目”可立即领取; 点“开始每日事务”会打开统一监控和自动执行,只处理符合状态的项目。 VIP奖励只对已有资格领取;不会购买VIP或升级礼包。邮件仅领取附件,不删除邮件。 启动/重启默认不执行消耗类策略,成长到期自动同步;其他自动化需要手动开始。勾选项、战队、保留体力及刷图规则按角色保存。 网络写请求发送前保存本地记录,异常不直接重试;本日已提交但服务器仍返回旧状态的奖励会明确提示。
资料包含此APK的1178个关卡、各难度奖励和2079种道具名称。
这些是安装包配置中的可能掉落,并非实时掉落概率保证;后续热更新新增数据需要重新提取。
本次签到、领邮件和扫荡均由本地模拟验证,尚未在真实账号上执行验证。
静态证据与字段规则见 analysis/STAGES_DAILY.md。
刷新响应与批量喂养
网络和属性/关卡资料计算在各账号的后台线程执行,账号之间并行;同一账号的请求与库存操作保持顺序。 只更新当前账号正在查看的页面,其他账号保存最新快照,切过去时再显示。 魔物、蛋和地图的大列表分成约8ms的小批次更新;未变化的控件复用,不再每轮重建整页。 魔物表、蛋表的列宽可手动拖动,避免每次更新都扫描所有单元格计算宽度。 调试窗关闭时不排版完整响应JSON;请求日志仍照常保存。
本地模拟两个账号:一个80只魔物、4000枚蛋(200类),另一个500只魔物,各有700ms网络等待。 本次测得回包界面回调约2~11ms,界面事件最大间隔30.75ms。这个数字来自测试环境, 不是所有电脑的耗时承诺。调试记录新增“刷新耗时”,分别记录后台总时间、资料整理时间和界面回调时间。
自动收取会按牧场剩余容量合并提交;自动喂养把同一目标的合格素材放入一次foods数组请求,
按照喂养目标优先级执行,数字越小越优先。当前目标达到停止等级/突破上限后换下一个目标。
批量素材按升级经验表计算,达到需要的经验后停止添加;最后一只素材可能有少量溢出。
锁定、在队、高星、资质保护及委托保留仍参与每只素材的筛选。
有连续动作时自动推进;设置的监控间隔用于等待新状态,不再要求每收取或喂养一只都等待完整间隔。
每次写操作后仍重新读取状态,喂养已返回但素材仍在旧快照中时暂停核对,避免重复提交。
喂养日志同时列出目标和全部素材的实例ID、魔物名称、素材数量;有昵称时也会显示。
本轮没有向真实账号执行收取、派遣或喂养。性能记录见analysis/REFRESH_PERFORMANCE.json。