diff --git a/.vitepress/config/en.ts b/.vitepress/config/en.ts index e3f273e..9294bb7 100644 --- a/.vitepress/config/en.ts +++ b/.vitepress/config/en.ts @@ -30,6 +30,7 @@ export const enThemeConfig: DefaultTheme.Config = { { text: "M9A", link: "/en/docs/script-guide/m9a" }, { text: "OK-WW", link: "/en/docs/script-guide/okww" }, { text: "HSR", link: "/en/docs/script-guide/hsr" }, + { text: "BetterGI", link: "/en/docs/script-guide/bettergi" }, { text: "General Scripts", link: "/en/docs/script-guide/general" }, { text: "SRA", link: "/en/docs/script-guide/sra" }, { text: "March 7th", link: "/en/docs/script-guide/march7th" }, diff --git a/.vitepress/config/zh.ts b/.vitepress/config/zh.ts index 3bcf61e..6161ffd 100644 --- a/.vitepress/config/zh.ts +++ b/.vitepress/config/zh.ts @@ -30,6 +30,7 @@ export const zhThemeConfig: DefaultTheme.Config = { { text: "M9A", link: "/docs/script-guide/m9a" }, { text: "OK-WW", link: "/docs/script-guide/okww" }, { text: "HSR", link: "/docs/script-guide/hsr" }, + { text: "BetterGI", link: "/docs/script-guide/bettergi" }, { text: "通用脚本", link: "/docs/script-guide/general" }, { text: "SRA", link: "/docs/script-guide/sra" }, { text: "三月七", link: "/docs/script-guide/march7th" }, diff --git a/docs/script-guide/bettergi.md b/docs/script-guide/bettergi.md new file mode 100644 index 0000000..f0fe6da --- /dev/null +++ b/docs/script-guide/bettergi.md @@ -0,0 +1,128 @@ +--- +title: BetterGI 配置方法 +description: 原神 - BetterGI 专项适配配置指南 +date: 2026-08-23 +--- + +# BetterGI 配置方法 + +## 先了解两件事 + +**BetterGI** 是原神的第三方辅助工具，能执行一条龙（每日委托、清体力、地脉花、秘境、首领讨伐等）与多种进阶功能。它是**原生 GUI 直控**模式：账号由 BetterGI 原生管理，复杂设置在 BetterGI 自己的界面里完成。 + +AUTO-MAS 的专项适配为每个用户单独管理其**「一条龙」任务配置、自定义配置组、账号切换归档与通知**。运行前按该用户的独立配置加载到 BetterGI，结束时按任务策略回写保存。BetterGI 不需要保留在 MAS 里的一份完整配置。 + + + +## 快速开始 + +1. 从 [BetterGI 官方仓库](https://github.com/babalae/better-genshin-impact)下载并解压。建议放在不含中文字符的路径中，并先在 BetterGI 中完成一次基础配置。 +2. 打开 **脚本管理** → **新建脚本**，选择 **BetterGI 脚本**，设置 BetterGI 的 `RootPath` 路径。 +3. 添加用户，在用户编辑页选择**配置管理方式**，并按需配置一条龙任务。 +4. 点击右上角 **配置 BetterGI**，打开 BetterGI 原生界面完成一次保存；复杂设置也在这里完成。 +5. 保存后把脚本加入调度队列即可。 + +## 配置管理方式 + +每个用户可选择一条龙配置的来源： + +| 配置管理方式 | 适合谁 | 实际含义 | +| --- | --- | --- | +| **用户独立配置** | 大多数用户 | 为该用户保存一份独立的一条龙配置，运行前加载、结束时按任务策略回写。同一脚本下不同用户可不同。 | +| **脚本直控配置** | 想让 BetterGI 自己管理配置 | 直接使用脚本当前的配置，不加载、也不回写该用户的独立配置；由直控用户共享。 | + +> 选择「脚本直控配置」时，下方「任务配置」与「自定义配置组」区块会整体置灰、不可编辑，由 BetterGI 原生配置决定。 + +## 任务配置（一条龙） + +BetterGI 的一条龙配置以独立 JSON 文件保存于 `{RootPath}/User/OneDragon/{名称}.json`（`Name` 字段等于文件名）。 + +### 一条龙名称 + +对应 BetterGI「一条龙」页面中已保存的配置名称。**留空则使用「默认配置」**。 + +### 内置配置组（8 个开关） + +下方 8 个按钮控制一条龙内置配置组的**开启 / 关闭**，可多选： + +| # | 配置组 | +| --- | --- | +| 1 | 领取邮件 | +| 2 | 合成树脂 | +| 3 | 自动地脉花 | +| 4 | 自动秘境 | +| 5 | 自动首领讨伐 | +| 6 | 自动幽境危战 | +| 7 | 领取每日奖励 | +| 8 | 领取尘歌壶奖励 | + +**语义说明**： + +- 这些按钮是**开关，而不是删减**：关闭某组只是把该组置为关闭，**组定义会保留**，日后可随时重新打开（可逆操作）。 +- 若某组当前为「开」但在配置中缺失，会自动补建并启用。 +- 本系统只管理这 8 个内置组；其余设置字段（队伍、秘境、地脉花、首领讨伐等）一律原样保留、不覆盖。 + +### 领取奖励队伍 + +填写领取奖励时使用的队伍名。**留空则不覆盖** BetterGI 现有设置。 + +### 通用战斗队伍 + +通用战斗场景使用的队伍名。留空则不覆盖 BetterGI 现有设置。 + +### 通用战斗策略 + +自动战斗策略下拉框。选项为 **「根据队伍自动选择」** + `{RootPath}/User/AutoFight/*.txt` 目录下已放置的战斗脚本文件名（每次实时扫描，可自行放入 `.txt` 脚本增加选项）。**留空默认为「根据队伍自动选择」**。 + +## 自定义配置组 + +自定义配置组 = 你自行创建、不属于上面 8 个内置组的配置组。 + +### 总开关「启用」 + +控制本系统是否接管自定义组的开启 / 关闭： + +- **关闭（默认）**：自定义组一律**原样保留**其启用状态与顺序，启用与否由 BetterGI 内部配置决定，本系统不干预。 +- **开启**：本系统按下方表格接管自定义组的启用状态。已列入表格的组按表格状态执行；已存在于 BetterGI 配置但未列入表格的组**默认开启**；已列入且启用但配置中缺失的组会自动补建。 + +> 首次开启且表格为空时，会**自动从 BetterGI 现有一条龙配置加载已有的自定义组**填入表格。 + +### 添加配置组 + +点击「添加配置组」，输入名称后确定即可添加，**添加后默认启用**（名称不能与已有组重复）。 + +### 表格管理 + +表格列出各自定义配置组，包含「配置组名称」与「是否启用」（可点击开关切换）。可通过复选框选中若干组，再点击「删除选中」批量移除。 + +## 配置 BetterGI（原生设置会话） + +点击右上角「配置 BetterGI」按钮，会在 BetterGI 原生界面打开一次设置会话，页面出现遮罩提示：请用户在 BetterGI 界面完成设置，完成后点击「**保存设置**」结束本次会话（默认 30 分钟无操作自动超时）。保存时会**回读 BetterGI 当前的一条龙配置**，并快照为该用户的独立副本。 + +## 用户一条龙副本 + +每个用户持有一份一条龙配置副本，保存在 `data/{脚本ID}/{用户ID}/OneDragon/{名称}.json`。写入时的种子优先级为： + +1. 该用户的副本（存在则优先） +2. BetterGI 现有一条龙配置 +3. 内置模板 + +## 常见问题 + +### 关闭了某个内置组，以后还能找回吗？ + +能。按钮是开关语义，关闭只置为关闭、不删除组定义；重新打开即可，可用状态会恢复。 + +### 「脚本直控配置」为什么不能编辑任务配置？ + +直控模式下，一条龙配置完全由 BetterGI 原生配置决定，MAS 不加载也不回写该用户的独立配置，因此相关字段整体置灰。想用 MAS 管理就切回「用户独立配置」。 + +### 自定义配置组关了，我在 BetterGI 里建的组会丢吗？ + +不会。总开关关闭时，自定义组原样保留其启用状态与顺序，本系统不干预；只有开启总开关后，才按表格接管其启用状态。 + +### 战斗策略为什么有我没建过的选项？ + +「根据队伍自动选择」是 BetterGI 内置默认策略，其余选项来自 `{RootPath}/User/AutoFight/` 下的 `.txt` 战斗脚本文件名，由系统实时扫描得出。 \ No newline at end of file diff --git a/docs/script-guide/index.md b/docs/script-guide/index.md index 0212ccc..27bdcf9 100644 --- a/docs/script-guide/index.md +++ b/docs/script-guide/index.md @@ -55,6 +55,17 @@ AUTO-MAS 支持多种游戏脚本的管理与调度。本节将介绍如何在 A --- +### [BetterGI](/docs/script-guide/bettergi) + +原神 - BetterGI + +- 原生 GUI 直控，账号由 BetterGI 原生管理，复杂设置在 BetterGI 界面完成 +- 为每个用户独立管理「一条龙」内置配置组（8 个可开关）与自定义配置组 +- 支持填写领取奖励队伍、通用战斗队伍与自动战斗策略，自动读取 `User/AutoFight` 下的战斗脚本 +- 切换账号、通知、额外脚本均可独立配置 + +--- + ### [通用调度](/docs/script-guide/general) 适用于所有支持启动时运行任务且能够打印日志的脚本 @@ -80,5 +91,6 @@ AUTO-MAS 支持多种游戏脚本的管理与调度。本节将介绍如何在 A - **鸣潮玩家**：查看 [OK-WW 配置方法](/docs/script-guide/okww) 快速上手 - **1999 玩家**：查看 [M9A 配置方法](/docs/script-guide/m9a) 快速上手 - **星穹铁道玩家**：查看 [HSR 配置方法](/docs/script-guide/hsr) 快速上手 +- **原神玩家**：查看 [BetterGI 配置方法](/docs/script-guide/bettergi) 快速上手 - **其他游戏**：查看 [通用调度](/docs/script-guide/general) 并使用现成模板 - **高级用户**：深入了解[通用调度](/docs/script-guide/general)的配置管理逻辑，自定义您的调度方案 diff --git a/en/docs/script-guide/bettergi.md b/en/docs/script-guide/bettergi.md new file mode 100644 index 0000000..e1fa54e --- /dev/null +++ b/en/docs/script-guide/bettergi.md @@ -0,0 +1,128 @@ +--- +title: BetterGI Configuration Guide +description: Genshin Impact - BetterGI specialization configuration guide +date: 2026-08-23 +--- + +# BetterGI Configuration Guide + +## Two things to know first + +**BetterGI** is a third-party tool for Genshin Impact. It can run One Dragon (daily commissions, resin clearing, Ley Line Outcrops, domains, world boss kills, etc.) and many advanced features. It works in a **native GUI direct-control** mode: accounts are managed natively by BetterGI, and complex settings are configured inside BetterGI's own interface. + +The AUTO-MAS specialization manages, for each user independently, the **One Dragon** task configuration, **custom config groups**, account switching records, and notifications. Before a run, AUTO-MAS loads that user's independent configuration into BetterGI; when the run ends, it writes it back according to the task strategy. AUTO-MAS does not maintain a full copy of the BetterGI configuration. + + + +## Quick start + +1. Download and extract [BetterGI](https://github.com/babalae/better-genshin-impact) from its official repository. It is recommended to use a path without non-ASCII characters, and complete a basic configuration in BetterGI first. +2. Open **Script Management** → **New Script**, choose the **BetterGI script**, and set the BetterGI `RootPath`. +3. Add a user, choose the **Configuration Management Mode** on the user edit page, and configure the One Dragon tasks as needed. +4. Click **Configure BetterGI** in the top-right corner, open the BetterGI native interface and save once; complex settings are also done here. +5. Save, then add the script to the scheduling queue. + +## Configuration management mode + +Each user can choose a source for their One Dragon configuration: + +| Configuration mode | Best for | What it means | +| --- | --- | --- | +| **User-specific config** | Most users | Saves an independent One Dragon configuration per user, loaded before a run and written back after. Different users under the same script can differ. | +| **Script direct control** | Letting BetterGI manage the config | Uses the script's current configuration directly, neither loading nor writing back the user's independent configuration; shared by direct-control users. | + +> When **Script direct control** is chosen, the **Task Configuration** and **Custom Config Groups** sections below are greyed out and not editable; BetterGI's native configuration decides. + +## Task configuration (One Dragon) + +BetterGI stores each One Dragon configuration as an independent JSON file at `{RootPath}/User/OneDragon/{Name}.json` (the `Name` field equals the file name). + +### One Dragon config name + +The name of a configuration saved in BetterGI's One Dragon page. **Leaving it empty uses "Default Configuration"**. + +### Built-in config groups (8 toggles) + +The 8 buttons below turn the One Dragon built-in config groups **on / off** and are multi-selectable: + +| # | Config group | +| --- | --- | +| 1 | Mail claim | +| 2 | Resin synthesis | +| 3 | Auto Ley Line Outcrop | +| 4 | Auto Domain | +| 5 | Auto world boss hunting | +| 6 | Auto Arcalanos crisis war | +| 7 | Claim daily rewards | +| 8 | Claim Serenitea Pot rewards | + +**Important semantics**: + +- These buttons are **toggles, not removals**: turning a group off only disables it; **its definition is preserved** and can be turned back on anytime (reversible). +- If a group is "on" but missing from the configuration, it is automatically created and enabled. +- AUTO-MAS only manages these 8 built-in groups; all other settings fields (parties, domains, Ley Line Outcrops, world boss hunting, etc.) are left untouched. + +### Daily reward party + +The party name used when collecting rewards. **Leaving it empty does not override** BetterGI's existing settings. + +### Combat party + +The party name used in general combat. Leaving it empty does not override BetterGI's existing settings. + +### Combat strategy + +Dropdown for the auto-battle strategy. Options are **"Auto-select based on party"** plus the `.txt` combat script file names under `{RootPath}/User/AutoFight/` (scanned in real time; you can drop in `.txt` scripts to add options). **Leaving it empty defaults to "Auto-select based on party"**. + +## Custom config groups + +Custom config groups are groups you create yourself, beyond the 8 built-in groups above. + +### Master toggle "Enable" + +Controls whether AUTO-MAS manages the on / off state of custom groups: + +- **Off (default)**: custom groups are **left as-is** (their enabled state and order preserved); whether they run is decided by BetterGI's internal configuration. +- **On**: AUTO-MAS manages custom group states through the table below. Groups listed in the table follow their table state; groups present in the BetterGI configuration but not listed default to **enabled**; groups listed as enabled but missing from the configuration are automatically recreated. + +> When toggled on for the first time with an empty table, existing custom groups are **auto-loaded from the current BetterGI One Dragon configuration** into the table. + +### Add config group + +Click **Add Config Group**, enter a name and confirm. New groups are **enabled by default** (names must not duplicate existing groups). + +### Table management + +The table lists each custom config group, with "Config group name" and "Enabled" columns (click the toggle to switch). You can select several rows with the checkboxes, then click **Delete Selected** to remove them in batch. + +## Configure BetterGI (native settings session) + +Click the **Configure BetterGI** button in the top-right corner to open a settings session in BetterGI's native interface. A mask appears prompting you to finish configuration in BetterGI, then click **Save Settings** to end the session (the session times out automatically after 30 minutes of no interaction). On save, AUTO-MAS **reads back the current BetterGI One Dragon configuration** and snapshots it as that user's independent copy. + +## Per-user One Dragon copy + +Each user holds a copy of the One Dragon configuration at `data/{ScriptID}/{UserID}/OneDragon/{Name}.json`. The seed priority when writing is: + +1. This user's copy (used first if present) +2. BetterGI's current One Dragon configuration +3. Built-in template + +## FAQ + +### If I turn off a built-in group, can I get it back later? + +Yes. The buttons are toggles: turning off only disables a group without deleting its definition. Turn it back on and its enabled state is restored. + +### Why can't I edit task configuration in "Script direct control" mode? + +In direct-control mode, the One Dragon configuration is fully decided by BetterGI's native configuration; AUTO-MAS neither loads nor writes back the user's independent configuration, so the related fields are greyed out. Switch back to "User-specific config" to have AUTO-MAS manage it. + +### Will my groups created in BetterGI be lost if I turn off the custom groups toggle? + +No. When the master toggle is off, custom groups keep their enabled state and order untouched. Only after you turn it on does AUTO-MAS manage their states through the table. + +### Why do I see strategy options I did not create? + +"Auto-select based on party" is BetterGI's built-in default strategy. The rest come from `.txt` combat scripts under `{RootPath}/User/AutoFight/`, scanned in real time by the system. \ No newline at end of file diff --git a/en/docs/script-guide/index.md b/en/docs/script-guide/index.md index cb85005..f9e93f5 100644 --- a/en/docs/script-guide/index.md +++ b/en/docs/script-guide/index.md @@ -55,6 +55,17 @@ Honkai: Star Rail - HSR specialization, with M7A and SRA dual engines --- +### [BetterGI](/en/docs/script-guide/bettergi) + +Genshin Impact - BetterGI + +- Native GUI direct control; accounts are managed natively by BetterGI, complex settings are done in BetterGI's interface +- Manages the One Dragon built-in config groups (8 toggles) and custom config groups independently per user +- Supports reward party, combat party, and auto-battle strategy fields, auto-reading combat scripts under `User/AutoFight` +- Account switching, notifications, and extra scripts can each be configured independently + +--- + ### [General Scheduling](/en/docs/script-guide/general) For scripts that can run tasks on startup and print logs @@ -80,5 +91,6 @@ Honkai: Star Rail - March7thAssistant - **Wuthering Waves players**: read the [OK-WW guide](/en/docs/script-guide/okww) - **Reverse: 1999 players**: read the [M9A guide](/en/docs/script-guide/m9a) - **Honkai: Star Rail players**: read the [HSR guide](/en/docs/script-guide/hsr) +- **Genshin Impact players**: read the [BetterGI guide](/en/docs/script-guide/bettergi) - **Other games**: read [General Scheduling](/en/docs/script-guide/general) and use an existing template - **Advanced users**: learn the configuration management model in [General Scheduling](/en/docs/script-guide/general) and customize your scheduling plan