mirror of
https://github.com/babalae/bettergi-scripts-list.git
synced 2026-11-17 04:17:45 +00:00
* feat(SwitchParty): 添加BgiTools版切换队伍功能 - 新增BgiTools工具类,支持通过API获取团队信息 - 实现OCR识别长期训练点数功能 - 添加队伍切换主逻辑,支持输入加载和BgiTools加载两种模式 - 集成HTTP请求工具,支持GET/POST/PUT/DELETE方法 - 实现UI操作工具类,包含返回主界面等功能 - 添加红框绘制工具用于调试显示 - 集成日志、格式化、找图找文本等通用工具 - 配置项目清单文件和设置界面选项 docs(SwitchParty): 添加切换队伍脚本的详细文档 - 新增 README.md 文件,包含脚本简介和功能特点说明 - 详细描述输入加载和 bgi_tools 加载两种模式的使用方法 - 提供完整的目录结构和配置说明表格 - 添加使用示例和 API 请求格式说明 - 包含切换队伍逻辑流程和常见问题解答 - 记录版本历史和注意事项 docs(switchparty): 更新 README 添加演示图片 - 在文档中添加了 bgi_tools_init.jpg 演示图片 - 在文档中添加了 bgi_tools_js.jpg 演示图片 - 丰富了脚本初始化和 JS 配置的视觉说明 * refactor(bgi_tools): 重构接口响应处理逻辑 - 新增 Result 类用于统一接口响应结构封装 - 添加状态码、消息、时间戳和数据字段的标准响应格式 - 实现 isSuccess 方法用于判断响应成功状态 - 添加 fromJson 静态方法支持 JSON 字符串或对象解析 - 修改 getTeamInfo 方法使用 Result 统一处理响应数据 - 移除原有的手动 JSON 解析和格式验证逻辑 - 优化错误处理和日志记录机制 fix(bgi_tools): 统一处理响应数据格式解析 - 移除原有的 isJson 函数判断逻辑 - 添加字符串类型的 JSON 解析处理 - 增加对象类型的直接使用逻辑 - 添加错误处理以应对无效 JSON 响应 - 统一响应数据的解析方式确保格式一致性 fix(bgi_tools): 修复JSON解析错误处理 - 添加isJson函数验证响应体是否为有效JSON字符串 - 防止非JSON格式响应导致的解析异常 - 确保只有有效的JSON字符串才进行解析操作 - 提高请求响应处理的健壮性 fix(utils): 解决响应体解析错误问题 - 添加了安全的JSON解析函数safeParse - 当JSON解析失败时返回原始字符串 - 避免因响应体格式异常导致的程序崩溃 - 提高了代码的容错性和稳定性 refactor(SwitchParty): 优化团队信息获取逻辑 - 移除未使用的代码注释和变量声明 - 直接解析HTTP响应体为JSON格式 - 重命名变量以提高代码可读性 - 统一错误处理机制 fix(utils): 修复URL参数拼接逻辑 - 在get方法中避免空查询字符串时添加多余的问号 - 在delete方法中避免空查询字符串时添加多余的问号 - 确保只有在查询字符串非空时才添加问号分隔符 fix(utils): 修复查询字符串处理逻辑 - 添加了对空字符串的检查,避免无效的切片操作 - 当查询字符串为空时返回空字符串而不是执行切片 - 防止了潜在的字符串索引越界问题 fix(bgi_tools): 修复团队信息获取功能 - 移除未使用的查询字符串构造逻辑 - 更新Http.get调用方式以支持参数传递 - 添加请求成功日志记录 - 统一错误处理机制为抛出异常 - 在main.js中添加团队信息获取日志 - 完善HTTP工具类的异步处理和日志记录 refactor(SwitchParty): 优化队伍切换逻辑并改进变量命名 - 将 team 变量重命名为 team_name 以提高可读性 - 统一代码风格,移除不必要的分号和空行 - 优化 BgiTools 集成中的团队数据提取逻辑 - 改进错误处理和日志记录的一致性 - 简化条件判断和团队切换流程 feat(SwitchParty): 添加BGI版本信息到清单文件 - 在manifest.json中添加bgi_version字段 - 设置BGI版本为0.64.0以匹配当前依赖版本
135 lines
4.4 KiB
Markdown
135 lines
4.4 KiB
Markdown
# 切换队伍(BgiTools版)
|
||
|
||
## 简介
|
||
|
||
该脚本用于 BetterGI 中自动切换原神队伍。支持两种加载模式:
|
||
|
||
- **输入加载**:手动在设置中填写队伍名称,脚本直接切换。
|
||
- **bgi_tools加载**:通过 BgiTools HTTP 接口查询当前 UID 对应的队伍信息,再自动完成切换。(需要JS HTTP权限支持)
|
||
|
||
## 功能特点
|
||
|
||
- 支持输入加载和 bgi_tools 加载两种模式
|
||
- 自动获取当前游戏 UID,并通过 HTTP 接口查询目标队伍
|
||
- 切换队伍失败时自动传送至七天神像并重试
|
||
- 支持自定义 Token 名称和值
|
||
- 完善的日志记录和错误通知
|
||
|
||
## 目录结构
|
||
|
||
```text
|
||
SwitchParty/
|
||
├── main.js # 脚本入口
|
||
├── manifest.json # BetterGI 插件清单
|
||
├── settings.json # 设置界面定义
|
||
├── assets/
|
||
│ └── ui/main_ui.png # 主界面识别模板图
|
||
└── utils/
|
||
├── tools.js # 通用工具类
|
||
└── bgi_tools.js # BgiTools API 请求封装
|
||
```
|
||
|
||
## 配置说明
|
||
|
||
| 设置项 | 类型 | 默认值 | 说明 |
|
||
|--------|------|--------|------|
|
||
| `auto_load` | 下拉选择 | `输入加载` | 加载模式,可选“输入加载”或“bgi_tools加载” |
|
||
| `team` | 文本框 | 空 | 队伍名称,适用于“输入加载”模式;留空表示不切换队伍 |
|
||
| `type` | 文本框 | 空 | 分组类型,适用于“bgi_tools加载”模式,会作为请求参数传给接口 |
|
||
| `bgi_tools_uid_team_api` | 文本框 | `http://127.0.0.1:8081/bgi/uid/team` | BgiTools HTTP API 地址 |
|
||
| `bgi_tools_token` | 文本框 | `Authorization= ` | BgiTools 鉴权 Token,格式为 `Token名=Token值` |
|
||
|
||
### 输入加载使用示例
|
||
|
||
- 加载模式:`输入加载`
|
||
- 队伍名称:`1`(请填写游戏内实际的队伍名称)
|
||
- 其他字段可留空
|
||
|
||
脚本会直接使用 `team` 作为目标队伍名称,调用 `genshin.switchParty(team)` 切换。
|
||
|
||
### bgi_tools 加载使用示例
|
||
|
||
- 加载模式:`bgi_tools加载`
|
||
- 分组类型:`独立`(可按需填写,用于在 BgiTools 侧分组)
|
||
- BgiTools HTTP API:`http://127.0.0.1:8081/bgi/uid/team` 请部署[bettergi-scripts-tools](https://github.com/Kirito520Asuna/bettergi-scripts-tools)(点击前往部署) v0.1.9以上版本
|
||
- Token 示例:`Authorization=你的Token值`
|
||
### bettergi-scripts-tools 使用演示
|
||

|
||

|
||
|
||
脚本运行逻辑如下:
|
||
|
||
1. 通过 `genshin.uid()` 获取当前游戏 UID。
|
||
2. 将 `uid` 和 `type` 作为查询参数请求配置的 API。
|
||
3. 从返回结果中取出 `team` 字段作为目标队伍名称。
|
||
4. 执行队伍切换。
|
||
|
||
请求格式:
|
||
|
||
```text
|
||
GET {bgi_tools_uid_team_api}?uid={uid}&type={type}
|
||
Headers:
|
||
{Token名}: {Token值}
|
||
```
|
||
|
||
期望接口返回格式示例:
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"id": "记录ID",
|
||
"uid": "玩家UID",
|
||
"team": "目标队伍名称",
|
||
"type": "分组类型"
|
||
}
|
||
}
|
||
```
|
||
|
||
> 注意:如果接口返回的 `code` 不是 `200`,脚本会记录错误日志并放弃切换。如果请求本身失败(网络异常、非 200 状态码等),同样会记录错误信息。
|
||
|
||
## 切换队伍逻辑
|
||
|
||
1. 根据配置的加载模式确定“目标队伍名称”。
|
||
2. 如果队伍名称非空,尝试调用 `genshin.switchParty(team)` 切换队伍。
|
||
3. 若切换失败,自动传送至七天神像,再次尝试切换。
|
||
4. 若依然失败或发生异常,会弹出错误通知,并返回游戏主界面,避免影响后续操作。
|
||
|
||
## 常见问题
|
||
|
||
### 1. 为什么提示“切换队伍失败”?
|
||
|
||
可能原因包括:
|
||
|
||
- 当前处于联机模式。
|
||
- 当前游戏场景不允许切换队伍,例如战斗状态或禁用区域。
|
||
- 队伍名称与游戏内实际配置不一致。
|
||
- 切换冷却时间未结束。
|
||
|
||
### 2. Token 应该怎么填?
|
||
|
||
如果 BgiTools 接口要求的鉴权头是:
|
||
|
||
```text
|
||
Authorization: xxxxx
|
||
```
|
||
|
||
则在设置中填写:
|
||
|
||
```text
|
||
Authorization=xxxxx
|
||
```
|
||
|
||
脚本会以等号分隔,将前半部分作为 Header 名称,后半部分作为 Header 值。
|
||
|
||
### 3. 接口返回正常但切换成功后又失败了?
|
||
|
||
请检查返回 JSON 中 `team` 字段是否与游戏内队伍名称完全一致,包括空格、大小写和特殊字符。
|
||
|
||
## 版本历史
|
||
|
||
- **v1.0.0**
|
||
- 首个版本
|
||
- 支持“输入加载”和“bgi_tools加载”两种队伍获取方式
|
||
- 支持队伍切换失败后传送七天神像重试
|