技术解读

以下内容由 GitRead 中文社区 编辑团队基于项目 README 与官方资料整理, 结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

砂糖代理 (SGA) 技术深度分析

项目背景与痛点

砂糖代理(SGA)是一个用于游戏自动化执行的脚本工具,可以支持如“原神”、“绝区零”等多款游戏的自动化操作。项目背后的痛点是游戏陪护助手及多任务执行的能效。玩家在多平台、多任务操作中需要手动管理和安排执行,SGA通过自动化执行脚本提供了需求上的解决方案。

核心技术揭秘

砂糖代理的技术核心在于其自动化触发、可靠的任务调度和多模块集成。这里以一个简化的数据流图来介绍系统的核心架构,展示其处理过程:

graph TD A[用户请求] --> B{"参数校验"} B -->|"通过"| C[执行业务] C --> D[模块分布] D --> E[游戏检测] E --> F{"任务调度"} F -->|"调度成功"| G[模块执行] F -->|"失败"| H[返回错误] G --> I[结果汇总] I --> J[结果返回]

在数据流图中,用户请求到达后会被参数校验模块处理,如果校验通过则会被调度到对应的游戏检测和任务调度,最终执行具体模块。这一过程较为复杂,包括自动检测游戏类型,并根据游戏规则选择最适合的执行方式。

功能亮点与差异

砂糖代理的独特之处在于高度的可定制化和模块化设计。通过对不同游戏的模块化实现,它能够支持多种游戏的自动化执行,同时具备执行效率和调度能力。此外,SGA还支持多种自动化任务,如环行旅舍、原神等,这种灵活性是在同类产品中鲜有的。

应用场景与落地建议

在生产环境中使用砂糖代理时,需特别注意系统监控和错误处理。自动化执行过程中可能会遇到各类异常,如游戏更新带来的模块不兼容问题,需要配置灵活且容错性强的异常处理方案。适合的业务场景包括但不限于游戏陪护和自动化任务调度,可以在提高任务执行效率的同时,减少人力成本。

综合评价

砂糖代理在自动化任务执行领域显示出强大的适应性和灵活性,其模块化设计和高度的定制化功能为其在竞争激烈的市场中赢得了独特的优势。然而,系统异常处理的健壮性和模块间的兼容性问题仍需进一步优化。通过不断迭代和完善,砂糖代理有潜力成为游戏陪护及自动化执行领域的领军者。

简要分析

热度分
297
价值分
164
活跃状态
活跃

语言占比

Batchfile
Python
VBScript

Release

贡献者

README

SGA-SucroseGameAssistant

介绍
  1. 砂糖代理(SGA),用于游戏等软件,SGA主体的功能是设置定时唤醒电脑,并定时执行各模块的相关功能,完成后睡眠,从而完成任务循环。

    目前SGA最佳推荐环境为win10,游戏窗口分辨率1920*1080。其他系统win11,win7可能出现我无法解决的bug。其他分辨率的识别能力下降,可能遇到功能异常。

目前作者只更新尘白禁区模块和SGA主体已经新功能的开发,其余模块若无合作者接手将无限期停更。
原神模块暂交由@yuhui437,并感谢其对于崩铁助手与绝区零助手的贡献
欢迎新的合作者参与对其他模块进行更新适配。
  1. 目前已有功能模块:
    环行旅舍(功能停止更新)
    原神(交由合作者@yuhui437不定期更新中)
    MAA(明日方舟)(适配停止更新)
    三月七助手(崩坏:星穹铁道)(适配停止更新)
    尘白禁区(不定期更新中)
    通用执行(测试阶段,功能不稳定) 连点器(不定期更新中)
    绝区零助手(由合作者@yuhui437完成)

  2. SGA视频演示/介绍,SGA使用说明,项目说明文档完善中。

  3. SGA2.0项目开源免费,源代码将同时更新于:
    github(https://github.com/Kin-L/SucroseGameAssistant)
    gitee(https://gitee.com/huixinghen/SucroseGameAssistant)

  4. 完整版下载链接,手动更新包链接:
    完整版: 蓝奏云: https://wwrv.lanzn.com/b033h9z0d 密码:bm32
    gitee: https://gitee.com/huixinghen/SucroseGameAssistant/releases
    123云盘(推荐):https://www.123pan.com/s/PjLbVv-9kEuA.html提取码:stdl
    更新包:https://gitee.com/huixinghen/SucroseGameAssistant/releases
    手动更新方法:下载替换更新包,解压后将SGA文件夹与原SGA文件夹中同名文件夹进行合并并替换。

OCR组件手动下载链接:
gitee: https://gitee.com/huixinghen/SucroseGameAssistant/releases/tag/ocr
蓝奏云(推荐): https://wwp.lanzn.com/b033h9ybi 密码:1siv

邮箱: [email protected]  
bilibili站账号: 绘星痕(406315493)  
抖音:绘星痕(54796280232)  
https://space.bilibili.com/406315493  
QQ群聊仅作bug反馈和交流使用,不完全公开。可以B站私信我或邮件联系我索要群聊号。  
安装教程

从网盘链接获取压缩包,解压可用,需要管理员权限,第一次使用时会自动下载OCR组件
视频教程:https://www.bilibili.com/video/BV18kKAeYE2t
详细使用说明见压缩包中“Instructions.docx”文件,该文件可能不是最新版本,部分内容仅供参考。

使用说明
  1. 建议给予SGA管理员权限启动
  2. 首次执行任务需要自动下载OCR组件,部分机型会下载rapidOCR,可能出现识别错误的情况,暂时无力优化
  3. 使用SGA请善用安装包内的使用说明,和我的bilibili账号上的SGA使用演示
  4. 遇到bug可尝试更新,或反馈在我的 github/gitee/bilibili账号/邮箱。
  5. SGA功能中使用了三月七助手/BGI/MAA的功能,需要自行安装对应项目并设置,之后对SGA进行设置,才能正常使用。
  6. 反馈bug建议附上自己的环境(win10/win11/win7, 官服/B服),触发bug的流程/停留的界面/bug触发的录屏、截图,附加SGA的“personal”文件夹压缩发给我。以上条件越完善,越能帮助我定位问题所在,修复bug,请根据自己的情况尽量提供给我比较完善的信息。
  7. SGA卸载删除前请 清除定时 ,否则您的电脑可能遇到仍在您原来设定过的时间 睡眠中自行唤醒 的情况。如果您已经卸载删除且遇到该情况,可在按照百度教程找到 任务计划程序 ,找到 SGA-awake 的条目,禁用/删除即可解决该问题。
  8. SGA为绿色免安装版,无联网功能,运行需要管理员权限,用于软件启动、设置定时等。若出现报毒和添加信任事件,信则用,本人没有心情也没有能力写病毒和盗号功能。添加信任可参考:https://zhuanlan.zhihu.com/p/645089615
  9. SGA快速上手【金山文档】 https://kdocs.cn/l/ctEJIsik2lSQ
特别感谢
  1. SGA用户界面使用了PyQt-Fluent-Widgets
    https://github.com/zhiyiYo/PyQt-Fluent-Widgets
  2. SGA部分代码和学习过程中参考了三月七助手,并组合使用了三月七助手
    https://moesnow.github.io/March7thAssistant
  3. SGA原神模块的自动秘境功能组合使用了BGI的自动秘境功能
    https://github.com/babalae/better-genshin-impact
  4. SGA组合使用了MAA的功能
    https://github.com/MaaAssistantArknights/MaaAssistantArknights

评论

暂无评论