SGA-SucroseGameAssistant-v3

该分支为SGAv3，若需SGAv2版本请切换分支

功能简介

砂糖代理（SGA）需要运行在win10系统，用于定时循环执行各模块的相关功能。可设置完成后睡眠和从睡眠中唤醒，从而避免电脑在非必要时长期运行。
目前SGA已适配尘白禁区，原神，MAA，三月七助手等游戏，并支持使用通用执行模块启用其他第三方自动化软件。

SGA开源免费，源代码将同时更新于: github / gitee

SGA介绍 readme网页版

目前作者只更新尘白禁区模块和SGA主体，欢迎新的合作者参与对其他模块进行更新适配

联系方式

邮箱: 2805137028@qq.com  
bilibili站账号: 绘星痕（406315493）  
https://space.bilibili.com/406315493  
抖音：绘星痕（54796280232）  
QQ群聊仅作bug反馈和交流使用，不完全公开。可以B站私信我或邮件联系我索要群聊号。  

建议运行环境

• SGA推荐环境为win10 专业版
• 游戏窗口最佳分辨率1920×1080(最低1600×900)

已有功能模块

• 环行旅舍(已关服)
• 原神
• MAA（明日方舟）
• 三月七助手
• 尘白禁区
• 连点器
• 绝区零助手
• 鸣潮助手

下载、安装与更新指南

视频教程

SGAv3介绍
SGAv3快速上手指南

1. 从网盘下载带"full"后缀的最新安装包。蓝奏云有最大包体限制，需要额外下载OCR组件（大多数电脑使用“PaddleOCR-json”），请参考快速上手教程放置OCR组件
   1. SGA-full包体
      1. 蓝奏云下载 密码:faml
      2. 123云盘下载 提取码:stdl
      3. 百度云盘下载 提取码: 33vp
   2. OCR-json
      1. 蓝奏云下载 密码:1siv
      2. 123云盘下载 提取码:ICSl
      3. 百度云盘下载 提取码: xrvx
2. SGA为绿色免安装版，解压后可用，需要管理员权限
3. 更新方案(每个更新包有最低适用版本的限制，无法在低于版本限制的版本上应用该更新包)：
   1. 在全局设置页面可选自动更新，和立即检查更新。
   2. 手动更新，在gitee的release中找到对应版本号，下载带有"replace"后缀的压缩包，解压后将SGA文件夹与原SGA文件夹中同名文件夹进行合并并替换。

尘白禁区可尝试自主适配新版本：

• 在SGA文件夹下list.json文件中，根据指示修改对应信息：resources\snow\list.json
• 将新版本适配分享给其他人

快速上手

1. 使用管理员权限打开SGA.exe文件
2. 点击左侧“连续任务”下拉选框，选择要执行的模块
3. 点击右侧齿轮样图标进入模块设置页面，选择服务器并输入启动器绝对路径
4. 勾选左侧要执行的任务
5. 点击对应齿轮样图标进入子设置页面，选择要执行的任务
6. 如果从蓝奏云下载，需要额外指定OCR组件路径。 点击上方齿轮按钮，切换到全局设置界面，输入或指定OCR.exe的绝对路径。 或参考图片将OCR组件的文件置于如下两图的目录结构 <img src="./mdpic/ocr-json1.png" style="width:30%;" />

<img src="./mdpic/ocr-json2.png" style="width:30%;" /> 7. 点击上方“开始”按钮，开始执行任务 8. 使用快捷键（默认为“ctrl+/”）快捷中止运行中的任务

命令行与参数

1. 使用SGA-c.exe启动，允许SGA启动时自带命令行窗口，该窗口只显示SGA实时日志信息，没有其他命令行参数可用于控制SGA。可通过UI界面上的按钮隐藏该窗口。
2. SGA支持参数启动，参数启动方式如下：

current 参数

启动后自动执行当前页面的任务，相当于启动SGA后直接点击开始按钮。例：

SGA.exe -current

subconfig 参数

启动后自动执行指定的子任务，后面需要追加子任务设置信息的识别码(四位数字的编号)，可在"personal\config"文件夹下查看对应关系。
例：在"personal\config"文件夹下有一个配置文件"9815默认配置1.json"，"默认配置1"为自拟名，"9815"为识别码，则启动命令为：

SGA.exe -subconfig 9815

hideui 参数

启动后隐藏SGA界面，使用该参数启动将无法对SGA进行任何操作，关闭cmd窗口可结束SGA。
该模式配合SGA-c.exe和current/subconfig参数使用，或启动后在后台等待定时执行。例如：

SGA-c.exe -hideui

back 参数

使用该参数时，启动SGA后不激活界面窗口；否则SGA将在启动后尝试将窗口激活到前台一次。
例如：

SGA.exe -back

BUG反馈 / 问题解决

1. 遇到bug可尝试更新，确认是否为最新版本
2. 若SGA主体部分出现问题(如闪退，卡死等)，确认自己系统是否为win10。 SGA在win10 专业版上开发和测试，在 win7/win11/win10其他精简版 可能遇到未知问题， 作者暂时没有条件解决（意思是非win10环境中遇到的bug可能无法解决）
3. 如果在执行任务过程中遇到问题
   1. 如果是SGA自带的功能模块，出现点击不到位的，无效点击， 超时等问题，可以尝试将游戏窗口调至1920*1080分辨率。 （该类问题可能是SGA多分辨率逻辑适配不到位导致的）
   2. 如果是SGA启动第三方自动化软件的模块，如果已经将第三方软件启动成功， 开始执行，则可能是第三方自动化软件的问题
   3. 如果第三方软件启动过程报错，可能是SGA的BUG
4. SGA卸载删除前请 清除定时 ，否则您的电脑可能遇到仍在您原来设定过的时间 睡眠中自行唤醒 的情况。 如果您已经卸载删除且遇到该情况，可在按照百度教程找到 任务计划程序 ,找到 SGA-awake 的条目，禁用/删除即可解决该问题。
5. SGA为绿色免安装版，无联网功能，运行需要管理员权限，用于软件启动、设置定时等。 若出现报毒和添加信任事件，信则用，本人没有心情也没有能力写病毒和盗号功能。 添加信任可参考：知乎帖子
6. 如果以上说明不能解决你遇到的问题，可以通过以下方式联系/反馈， 如果问题较复杂我可以私信Q群聊号，群聊仅作反馈bug和交流开发SGA用
   1. bilibili账号(推荐)
   2. 邮箱(推荐)
   3. github / Gitee issues (不常看issue，可能回复较慢)
7. 反馈BUG建议说明以下信息，越详细越能助我快速定位和解决问题
   1. 自己的环境（win10/win11/win7, 官服/B服）
   2. 触发bug的流程/停留的界面/bug触发的录屏、截图
   3. SGA文件夹中“personal”文件夹中的“errorsc”，“logs”（重要）文件夹， 压缩打包发给我，如果可能请将整个“personal”文件夹打包

部分资源链接

尘白禁区启动器
OCR-json 密码:1siv

用户界面展示

全局设置页面

<img src="./mdpic/overall.png" alt="全局设置" style="width:50%;" />

连续执行 模块页面

<img src="./mdpic/mix.png" alt="连续执行" style="width:50%;" />

尘白禁区 模块页面

<img src="./mdpic/snow.png" alt="尘白禁区" style="width:50%;" />

特别感谢

1. SGA用户界面使用了PyQt-Fluent-Widgets

2. SGA部分代码和学习过程中参考了三月七助手，并组合使用了三月七助手

3. SGA原神模块的自动秘境功能组合使用了BGI的自动秘境功能

4. SGA组合使用了MAA