Skip to content

About

用于获取农场code,只适用于windows

Resources

Stars

26 stars

Watchers

0 watching

Forks

Latest commit

 

History

46 Commits

Folders and files

Repository files navigation

农场 Code 获取助手

本分支提供 农场助手 Android,支持 Android 10 及以上。请下载 Android 0.1.3 APK, 并阅读 Android 使用与构建说明 和 更新日志。 Android 标签为 android-vX.Y.Z,与下述 Windows 桌面版本独立发布。

同一仓库的 ios/ 目录提供 iOS 版本,标签为 ios-vX.Y.Z;构建、GitHub Actions 编译与发布说明见 iOS 说明 和 iOS 更新日志。

一个面向 Windows 桌面客户端的小型 Rust/Tauri 应用。它会在本机临时启用定向代理,仅处理目标农场网关:透明转发同一次 /prod/ws 官方登录,在内存中保留 code 并读取官方 SyncAll 响应中的好友 GID,随后一起同步到远程服务器。

获取后可以:

  • 读取 Windows 客户端主界面当前昵称,并以只读方式查询本地登录列表,唯一匹配账号和头像;
  • 自动调用服务端项目的账号接口;同一服务器用户下,相同账号会复用原账号 ID 并更新 Code,只有首次同步才新增账号;同步成功后还会调用启动接口,使已停止的账号无需再手动启动;
  • “同步官方好友”默认开启:先完成官方登录并读取好友 GID,随后通过服务器现有批量新增接口写入对应远程账号;
  • 或者仅保存在内存中,由用户点击复制。

参考项目与关系说明

  • 参考并配套使用:liyangpengs 的农场机器人项目
  • 本项目围绕该仓库提供的账号管理接口和农场登录场景开发,用于在 Windows 客户端本地获取一次性 Code 并同步到服务器。
  • 本项目是独立的第三方辅助工具,不属于上游项目的官方组件,不要求修改或覆盖原作者仓库代码。
  • 参考项目的代码、名称及相关权利归原作者所有;使用时请同时遵守对应仓库的许可说明和相关服务条款。

使用流程

  1. 在服务器设置中填写上游管理页面地址。
  2. 在管理页面左侧边栏底部复制当前登录 Token,填入工具。
  3. 点击「测试连接」,确认 /api/user/me 可以正常返回当前用户。
  4. “同步官方好友”默认开启;如只需要 Code,可在服务器设置中关闭该开关。保存设置。
  5. “本机账号”列表会列出所有已登录的账号。可直接点击某个账号的「同步」,在代理未启动时自动安装临时证书并接管系统代理;也可先点击上方网络接管栏的「启动代理」准备网络,再选择账号同步。然后在该客户端中打开农场。
  6. 取得 Code 与好友 GID 后,工具会同步 Code、启动远程账号并批量写入好友 GID,账号行显示“已同步”或“同步失败”。代理保持运行,可直接点击下一个账号的「同步」,无需重新启动或再次确认证书;已同步或失败的账号都可以「重新同步」。
  7. 全部完成后点击「停止并恢复网络」,恢复系统代理并移除临时根证书。

普通模式下,代理只在有同步目标时拦截新建的农场连接。等待期间可取消或直接切换目标。已取得 Code 的账号继续在后台同步,可以同时选择下一个账号。只打开一个 QQ 登录窗口时,切号后会自动准备同步。

连续点击版本号五次进入开发者设置。代理运行时,打开“协议模式”即可在原端口监听切换后的新连接,日志目录会显示在状态栏。关闭开关即可继续选择账号同步。

开启好友同步时,本次连接会先透明转发到官方网关,农场可正常完成登录初始化;随后远程账号使用同一个 Code 登录时,本地会话可能收到同账号登录提醒或被下线。关闭好友同步时仍保持仅拦截 Code 的原流程。

同步官方好友

开启服务器设置中的“同步官方好友”后,Helper 会透明转发官方 WebSocket 登录,并从成功的 FriendService.SyncAll 响应中提取、去重好友 GID。若客户端在规定时间内没有触发 SyncAll,Helper 会通过当前已认证的官方连接补发一次空 open_ids 的 SyncAll;官方返回 0 位好友或超时时会明确降级,不会伪报成功。

自身 GID 和 OpenID 来自同一次成功的 UserService.PlayerLogin 或旧版 UserService.Login 响应;仅保存在内存中用于账号卡片显示和排除自身 GID,不依赖远程账号回填。失败登录、场景登录或无效 GID 不会作为自身身份。

Code 成功同步并启动远程账号后,Helper 使用同一服务器 Token 和账号 ID 调用 /api/friend-known-gids/batch-add,把本次官方响应中的 GID 写入远程已知好友配置。若没有捕获到好友 GID,Code 同步仍会照常完成,并在结果中说明好友同步被跳过。

应用更新

  • 应用启动后会检查本项目最新稳定版,也可以在“应用更新”面板中手动检查。
  • 应用更新中可填写 GitHub 加速地址,默认 https://ghproxy.net/;修改后自动保存,留空恢复默认值。地址作为前缀拼接在 GitHub 下载链接前,支持路径前缀;关闭“使用 GitHub 加速”后直接下载。
  • 下载完成后必须通过发布接口返回的 SHA-256 校验,校验失败不会执行更新包。
  • 使用安装版时,会将新版静默安装到当前 EXE 所在目录;例如当前位于 D:\Tools\FarmHelper,更新仍安装到该目录。
  • 使用便携版时,会在程序退出后原地替换当前 EXE。安装前会停止同路径残留进程,完成后自动重新启动。

本地身份识别

  • 工具通过 Windows UI Automation 读取新版客户端主窗口左上角当前昵称,再与本地登录索引中的 uin、nickName 和 faceUrl 做唯一匹配,不读取聊天数据库。
  • isUserLogin 和最近活动分区可能指向后台主会话,不能代表界面当前切换的账号,因此不再用于自动绑定。
  • 界面每 2 秒自动检测一次切号,并要求连续两次结果一致;切换过程中、昵称同名、主窗口不可读或登录列表尚未刷新时会立即清空旧身份。
  • 等待农场登录期间,后端会持续确认所选账号仍处于登录状态;在列表中点击其他账号即可切换目标。
  • 捕获 Code 后还会再次确认;若捕获前后的账号仍不一致,则停止自动同步并保留 Code。
  • 可先点击“启动代理”准备网络,无需提前选择账号;开始获取前需要先登录 Windows QQ,并在“本机账号”列表中选择目标账号。捕获 Code 前后都会核对目标身份,身份无法确认时只在内存中保留 Code,不会请求服务器。
  • 若只需要 Code,可关闭自动同步后在账号行点击“获取 Code”,工具不会自动在服务器创建账号;同样需要先确认本机账号身份。
  • 农场 WebSocket 请求本身不包含 UIN、昵称或头像,身份信息不是从 Code 中解码得到的。

Token 说明

  • 请使用上游管理网页侧边栏中的当前登录 Token。
  • 工具通过 x-admin-token 请求头访问服务器。
  • Token 保存在 Windows 凭据管理器,不会写入 settings.json。
  • 上游服务器重启或 Token 失效时,需要从网页重新登录并复制新 Token。

配置与运行文件位置

  • settings.json、system-proxy-backup.json、temporary-ca.cer 和 traffic-diagnostics.log 均存放在应用 EXE 所在目录,不使用 %APPDATA% 默认目录。
  • 首次运行新版时,会自动把旧版本默认应用数据目录中的上述文件迁移到 EXE 所在目录。
  • 便携版可直接放到任意有写入权限的目录;配置和恢复文件会跟随 EXE,移动时可一并迁移。
  • 安装版同样将运行文件放在安装目录。若自行选择安装位置,请确保当前 Windows 用户对该目录具有写入权限。
  • 服务器 Token 仍由 Windows 凭据管理器加密保存,不会以明文文件放在应用目录。

版本发布

推送 v* 格式的 Tag(例如 v0.1.5)会触发发布工作流,并在对应版本中自动提供:

  • 单文件便携版;
  • Windows NSIS 安装包。

安全边界

  • 代理只监听 127.0.0.1,不向局域网开放。
  • 非目标农场 HTTPS 连接只做 TCP 直通,不解密内容。
  • 只有目标农场网关的 /prod/ws 登录请求可以触发 Code 提取。
  • Code 不写日志、不写配置文件。
  • 好友同步只解析官方网关返回的 SyncAll/GetGameFriends 好友 GID;好友姓名、头像和 OpenID 不写日志、不写配置文件,也不会上传。
  • 正常退出会恢复原系统代理并移除临时根证书。
  • 异常崩溃时会保留代理备份;下次启动会先自动恢复,也可点击「清理代理与证书」。

开发与构建

需要 Windows 10/11、Microsoft Edge WebView2 Runtime 和 Rust stable MSVC toolchain。

# 开发运行
.\scripts\dev.ps1

# 构建 release EXE
.\scripts\build.ps1

产物位于 release 目录。Tauri 不内置 WebView2 Runtime,因此程序本体保持较小。

测试

cd src-tauri
cargo test
cargo clippy --all-targets -- -D warnings

代理集成测试会在本机启动随机端口,通过模拟 HTTPS 代理请求验证 Code 提取和 451 阻断,不会连接上游。

About

用于获取农场code,只适用于windows

Resources

Stars

26 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages