# 牧羊人之心Bot ## 运行指引 1. 在 Windows 中安装 Python 3,并确保 `python` 命令可用。 2. 按照[辅助使用说明](ranch_assistant/README.md)安装 PySide6 等依赖。 3. 双击项目根目录下的 `Start_Ranch_Helper.cmd` 启动辅助。 4. 在“登录”页面输入账号和密码,登录后选择区服;详细功能及配置方法见[辅助使用说明](ranch_assistant/README.md)。 - `ranch_assistant/`:原生 PySide6 界面、登录会话、手动孵蛋规则、牧场管理及测试。 - `analysis/`:接口清单、行为分析、原始反编译源码及部分审计证据。 - `tools/`:本地资料提取、接口清单生成和历史分析工具。 - `backend/`:早期的独立本地接口原型,不是辅助连接的官方服务。 运行测试: ```console python -m unittest discover -s ranch_assistant/tests -v ``` 这是本地 Git 仓库。原始 APK、构建包、第三方工具、签名材料、账号会话、 密码、数据库、截图和运行日志均由 `.gitignore` 排除;账户数据仍保存在本机。 ## 适配版本 | 辅助版本 | 《牧羊人之心》Android 客户端版本 | 状态 | | --- | --- | --- | | 1.1.0(`v1.1.0`) | 1.9.68 | 当前适配版本 | | 1.0.0(`v1.0.0`) | 1.9.68 | 历史版本 | 本表仅记录已经分析、测试的版本对应关系,不代表对其他客户端版本的兼容承诺。 ## 免责声明 本项目及其文档仅用于编程学习、技术研究与交流,不构成任何使用建议、服务承诺或法律依据。项目不提供、不指导也不协助制作、传播或使用游戏修改包、外挂、绕过安全检测、规避反作弊或其他破坏性工具;请勿将本项目用于上述用途。 游戏客户端、接口或规则更新后,相关内容可能失效或不再适用;本项目不承诺兼容其他版本,也不承诺提供后续适配、更新或技术支持。 本项目与相关游戏、厂商、平台及权利方无任何隶属、授权、合作或背书关系。涉及的游戏名称、程序、素材、接口、商标及其他第三方内容,其权利归相应权利人所有。请勿未经许可复制、分发或商用相关内容;如权利方认为本项目存在不妥内容,可联系项目维护者核实处理。 使用者应自行遵守适用的法律法规、平台规则、游戏用户协议及第三方权利要求,并在合法授权范围内使用本项目。因使用、修改、分发或无法使用本项目而产生的账号异常、数据丢失、设备故障、争议、处罚或其他直接或间接损失,由行为人自行承担;在法律允许的最大范围内,项目维护者及贡献者不承担相关责任。任何第三方的行为均不代表项目维护者的立场或授权。 请勿在公开页面、提交记录或 Issue 中上传账号、密码、Token、会话密钥、签名材料、个人身份信息或其他敏感数据。本项目按“现状”提供,不保证持续维护、功能完整、兼容性或适用于任何特定目的。继续使用即表示你已阅读并理解上述内容;如不同意,请停止使用并删除相关副本。