## File: README.md

## 功能简介

- **日常**：清体力、每日实训、领取奖励、委托、锄大地
- **周常**：历战余响、货币战争、差分宇宙、混沌回忆、虚构叙事、末日幻影
- **云·星穹铁道**：支持后台运行、无窗口运行和 Docker 运行
- **抽卡记录导出**：支持 [UIGF](https://uigf.org/zh/standards/uigf.html)/[SRGF](https://uigf.org/zh/standards/srgf.html) 标准
- **工具箱**：自动对话、解锁帧率、兑换码
- 每日实训等任务的完成情况支持**消息推送**
- 任务刷新或体力恢复到指定值后**自动启动**
- 任务完成后**声音提示、自动关闭游戏或关机等**

详情见 图形界面设置 或 [配置文件](assets/config/config.example.yaml)｜QQ群 [点击跳转](https://qm.qq.com/q/C3IryUWCQw) TG群 [点击跳转](https://t.me/+ZgH5zpvFS8o0NGI1)  哔哩哔哩 [点击跳转](https://space.bilibili.com/3706960664857075) 

## 界面展示



## 注意事项

- 遇到错误请在 [Issue](https://github.com/moesnow/March7thAssistant/issues) 反馈，提问讨论可以在 [Discussions](https://github.com/moesnow/March7thAssistant/discussions) ，群聊随缘看
- 欢迎 [PR](https://github.com/moesnow/March7thAssistant/pulls)，提交前请先阅读 [贡献指南](CONTRIBUTING.md)

## 下载安装

前往 [Releases](https://github.com/moesnow/March7thAssistant/releases/latest) 下载后解压双击三月七图标的 `March7th Launcher.exe` 打开图形界面

## 源码运行

如果你是完全不懂的小白，请通过上面的方式下载安装，可以不用往下看了。

推荐使用 Python 3.12 或更高版本。

Windows 下如果通过终端启动，建议使用管理员模式打开 PowerShell、Windows Terminal 或 CMD；Windows 11 24H2 及以上也可以按 [Sudo for Windows](https://learn.microsoft.com/zh-cn/windows/advanced-settings/sudo/) 的方式执行。

```cmd
# Installation (using venv is recommended)
git clone --recurse-submodules https://github.com/moesnow/March7thAssistant
cd March7thAssistant
pip install -r requirements.txt
python app.py
python main.py

# Update
git pull
git submodule update --init --recursive
```

如果使用 `uv`，推荐直接使用项目自带的 `pyproject.toml` 工作流：

```cmd
# Installation (using uv)
git clone --recurse-submodules https://github.com/moesnow/March7thAssistant
cd March7thAssistant
uv sync

# 启动图形界面
uv run python app.py

# 查看命令行帮助
uv run python main.py -h

# 执行完整运行
uv run python main.py

# 执行每日实训
uv run python main.py daily
```


开发相关

获取 crop 参数表示的裁剪坐标可以通过小助手工具箱内的捕获截图功能



---

如果喜欢本项目，可以微信赞赏送作者一杯咖啡☕

您的支持就是作者开发和维护项目的动力🚀



---

## 相关项目

March7thAssistant 离不开以下开源项目和运行时依赖的帮助，感谢所有维护者与贡献者：

- 模拟宇宙自动化 [https://github.com/CHNZYX/Auto_Simulated_Universe](https://github.com/CHNZYX/Auto_Simulated_Universe) ：提供模拟宇宙相关能力
- 锄大地自动化 [https://github.com/linruowuyin/Fhoe-Rail](https://github.com/linruowuyin/Fhoe-Rail) ：提供锄大地相关能力
- OCR 文字识别 [https://github.com/RapidAI/RapidOCR](https://github.com/RapidAI/RapidOCR) ：提供游戏内文字识别能力
- 图形界面组件库 [https://github.com/zhiyiYo/PyQt-Fluent-Widgets](https://github.com/zhiyiYo/PyQt-Fluent-Widgets) ：提供主要界面组件与交互体验
- Mirror酱 [https://github.com/MirrorChyan/docs](https://github.com/MirrorChyan/docs) ：提供更新检查与下载分发以及 CDN 加速相关能力
- 图像处理与自动化相关依赖 `OpenCV`、`PyAutoGUI` 等：提供截图采集、图像处理与基础自动化能力
- 推理加速相关依赖 `ONNX Runtime`、`OpenVINO` ：为 OCR 和模型推理提供 CPU / GPU 加速支持

此外，`requirements.txt` 中还包含大量底层依赖，在这里不一一列出；同样感谢这些项目对本项目的支持。


## Contributors
<a href="https://github.com/moesnow/March7thAssistant/graphs/contributors">

  

</a>

## Stargazers over time

[](https://starchart.cc/moesnow/March7thAssistant)

---

## File: assets/docs/_sidebar.md

- [主页](/README.md)
- [使用教程](/assets/docs/Tutorial.md)
- [流程编排](/assets/docs/Workflow.md)
- [常见问题](/assets/docs/FAQ.md)
- [更新日志](/assets/docs/Changelog.md)
- [后台运行](/assets/docs/Background.md)
- [Docker 部署](/assets/docs/Docker.md)
- [Termux 安卓部署](/assets/docs/Termux.md)
- [贡献指南](/CONTRIBUTING.md)

---

## File: assets/docs/Background.md

# 后台运行

> 远程本地多用户桌面（是一台电脑，不需要两台电脑）

 * 模拟器运行拥有卡顿，性能消耗大等诸多缺点
 * 我们推荐您使用 Windows 自带的远程桌面服务进行该程序
 * 在电脑上直接运行的性能消耗要小于模拟器
 * Windows 开启远程桌面多用户教程：
   * [详细教程 by_Rin](https://www.bilibili.com/read/cv24286313/)（⭐推荐⭐）
   * [RDPWrap 方法](https://blog.sena.moe/win10-multiple-RDP/)
   * [修改文件方法](https://www.wyr.me/post/701)
 * [详细教程 by_Rin](https://www.bilibili.com/read/cv24286313/) 中所有相关文件：[下载链接](https://github.com/CHNZYX/asu_version_latest/releases/download/RDP/LocalRemoteDesktop1.191_by_lin.zip)
   * 备用链接
     * [百度网盘](https://pan.baidu.com/s/13aoll4n1gmKlPT9WwNYeEw?pwd=jbha) 提取码：jbha
     * [GitHub镜像](https://github.kotori.top/https://github.com/CHNZYX/asu_version_latest/releases/download/RDP/LocalRemoteDesktop1.191_by_lin.zip)



## 对于 Windows 11 用户

在 [详细教程 by_Rin](https://www.bilibili.com/read/cv24286313/) 中提到的 `SuperRDP` 软件可能已无法使用，建议改用 [TermsrvPatcher](https://github.com/fabianosrc/TermsrvPatcher)。如果你在国内使用，可以通过备用链接下载：[蓝奏云](https://wwsj.lanzout.com/i4V8u2np8dna)。

**注意：** 此方法仅实现了[详细教程 by_Rin](https://www.bilibili.com/read/cv24286313/)中`4. 多用户同时登陆补丁`的功能，其余步骤请继续按照原教程进行。

**使用方法：**

1. 使用 `git clone` 克隆仓库，或直接下载压缩包。
2. 下载完成后，解压压缩包，找到 `TermsrvPatcher.ps1` 文件，右键点击选择“运行”，脚本将自动完成所有操作。

此外，如果你希望手动修改文件，可以参考博客文章：[修改文件方法](https://www.wyr.me/post/701)。不过需要注意的是，该博客中的部分操作在 Windows 11 上可能不适用，具体如下：

- **在 Windows 11 中需搜索的字符串（正则）：**
   `39 81 3C 06 00 00 0F (?:[0-9A-F]{2} ){4}00`（实际操作中，仅需搜索`39 81 3C 06 00 00 0F`即可，剩下的两个16进制数符合正则表达式再进行修改）
- **替换为的字符串：**
   `8B 81 38 06 00 00 39 81 3C 06 00 00 75`

---

## File: assets/docs/FAQ.md

# 常见问题

[欢迎关注我们的B站账号，获取最新动态和教程~](https://space.bilibili.com/3706960664857075)

### Q：小助手总是更新失败/下载速度缓慢 怎么办？

A：March7thAssistant 接入了第三方服务 [Mirror酱](https://mirrorchyan.com/?source=m7a-faq)（一个给开源社区做有偿内容分发的平台）。

它为我们提供了免费的检查更新接口，但它的下载是有偿的，需要用户付费使用。

不过，即使不购买 Mirror 酱的下载服务，你也可以在检测到更新后，在设置里选择从海外源（GitHub）下载~

如果你购买并填写了 CDK，更新时就再也不用和自己的网络环境斗智斗勇咯，下载更快更稳定！

同时 CDK 也可以用于其他接入 Mirror酱 的项目，例如 MAA 等。

[首次下载可点我前往 Mirror酱 高速下载](https://mirrorchyan.com/zh/download?rid=March7thAssistant&os=&arch=&channel=stable&source=m7a-faq)

### Q：小助手启动慢/未找到可执行文件/进程启动失败/总是被杀毒软件删除 怎么办？

A：请将`小助手文件夹`加入杀毒软件排除项/白名单/信任区，然后重新解压覆盖一次。

Windows Defender：`病毒和威胁防护` → `管理设置` → `添加或删除排除项` 可以参考 [#373](https://github.com/moesnow/March7thAssistant/issues/373) 图示操作

（注意：可能还需要将 `应用和浏览器控制` → `智能应用控制设置` → `切换为关闭` ）

火绒安全软件：`主界面` → `右上角菜单` → `信任区` 可以参考 [教程](https://cs.xunyou.com/html/282/15252.shtml) 图示操作

### Q：开了滤镜、帧率显示或性能检测软件后，为什么总是识别失败/提示切换到界面失败？

A：这类软件会在游戏画面上叠加额外文字或特效，导致小助手的图像识别和 OCR 判断失败。

常见影响项包括：`N 卡游戏滤镜`、`HDR`、`帧率监控 HUD`、`微星小飞机 / Afterburner`、`RTSS`、`游戏加加`，

以及各种会显示 `FPS / CPU / GPU` 的悬浮窗。

另外，部分笔记本/主板厂商自带软件也会提供类似的功能，例如 `护眼模式`、`鲜艳模式`、`游戏增强`、`色彩优化`、`场景模式` 等，

这些功能即使没有明显悬浮窗，也可能直接改变画面的颜色、亮度、对比度。

请先完全关闭这些滤镜、硬件监控和性能检测软件后再重试。

有些滤镜或画面增强因为你自己已经看习惯了，反而最不容易发现；

如果没有看到大量其他用户同时报同样的错误，通常优先按你自己电脑上的环境问题排查。

如果日志里出现了类似 `检测到疑似监控悬浮窗文字` 的提示，基本就是这个问题。

你也可以打开小助手 `工具箱 → 游戏截图`，检查程序实际获取到的画面是否干净、是否被悬浮窗遮挡。

### Q：差分宇宙/模拟宇宙/饰品提取怎么不会选择角色/自动选择 XXX 角色，如何更换角色？

A：以上功能使用游戏内自动记忆的配队，如果检测到缺少角色，会自动尝试选择 “队伍1”。

如需更换角色，可以手动配置好队伍后，进入一次对应的界面，随后退出检查游戏内记忆的配队是否更新即可。

### Q：为什么不会自动战斗/不会交互随意门/角色在乱跑？

A：这类问题大多是 `按键设置和小助手默认假设不一致` 导致的，可以按下面顺序排查：

1. 先检查你是否修改过游戏内默认按键，重点看：自动战斗、交互（`F`）、角色详细（`C`）、角色移动（`WASD`）。如果改过自动战斗键，可以在小助手 `设置 → 杂项 → 修改按键` 中同步修改。注意：交互（`F`）和角色详细（`C`）不能修改，必须保持游戏默认设置，否则会导致识别失败。其他按键也建议保持默认。

2. 再检查小助手 `设置 → 杂项 → 启用自动战斗和二倍速检测` 是否已经开启。

3. 如果问题只出在自动战斗，再检查游戏内 `设置 → 战斗功能 → 是否沿用自动战斗设置` 是否为“是”；必要时可以先手动开启一次自动战斗后再试。

### Q：开始运行后就不能移动键盘鼠标和切换到后台了吗

A：本地游戏模式下，大多数自动化仍然依赖当前桌面画面和输入状态，运行时不建议抢占键盘鼠标，也不建议切到后台。

如果你需要后台运行，优先考虑使用 `云·星穹铁道`：目前清体力、每日实训、货币战争、差分宇宙等任务支持后台运行；

锄大地和模拟宇宙仍需要前台全屏。

如果你需要本地模式后台挂机，也可以尝试 [远程本地多用户桌面](https://m7a.top/#/assets/docs/Background)。

### Q：完整运行的作用是什么

A：`完整运行` 会根据你当前的开关和刷新状态，自动处理已启用的内容，通常包括：

兑换码、每日实训、活动、历战余响、清体力、货币战争积分奖励、差分宇宙积分奖励、

锄大地、模拟宇宙 / 差分宇宙、混沌回忆、虚构叙事、末日幻影，以及最后的领取奖励。

已经完成或尚未刷新的内容会自动跳过。默认日常刷新时间为每天凌晨 4 点，周常刷新时间一般为每周一凌晨 4 点。

### Q：提示窗口找不到怎么办

A：请检查是否将游戏内语言设置为简体中文。

### Q：缺少新增加的副本？逐光捡金缺少新角色？

A：首先确保是最新版本，如果仍然缺少副本，编辑 `assets\config\instance_names.json` 文件手动添加。

如果 `混沌回忆 / 虚构叙事 / 末日幻影 / 支援` 中缺少新角色，

可以在对应界面里用小助手工具箱中的`捕获截图`功能，勾选角色头像，点击`保存所选截图`后，

放入 `assets\images\share\character` ，并修改 `assets\config\character_names.json` 文件。

同时欢迎用`未压缩`的方式上传到 [Issue](https://github.com/moesnow/March7thAssistant/issues)，比如压缩包，或者 [PR](https://github.com/moesnow/March7thAssistant/pulls) 也可以。

### Q：运行过程中内存占用持续升高 / 游戏突然无响应或闪退 / 系统崩溃重启怎么办？

A：如果出现内存占用异常偏高、程序无故闪退，或运行途中游戏画面出现异常，优先排查 OCR 加速模式的兼容性。

小助手默认在 Windows 10 18362 及以上使用 ONNXRuntime DirectML GPU 加速；

在不支持 DirectML 的环境（如 Linux、部分 ARM 设备）下，若检测到 OpenVINO 则自动使用 OpenVINO CPU 推理。

**当前版本已针对 OpenVINO CPU runtime cache 问题应用临时规避方案**，一般不再需要通过定期重建引擎来压制内存增长，

并在可用物理内存低于 1GB 时自动切换到 ONNXRuntime CPU；但如果机器本身内存极小或系统负载过高，仍可能出现明显波动。

**建议先将 OCR 加速模式手动切换为 `CPU (ONNXRuntime)`**（设置 → 杂项 → OCR 加速模式），

切换后重新运行，观察内存和稳定性是否改善。如果问题消失，说明原模式与当前环境存在兼容问题，保持 ONNXRuntime CPU 即可。

如果使用 DirectML GPU 加速时出现闪退或识别异常，同样建议先回退到 `CPU (ONNXRuntime)` 排查。

### Q：双击启动后窗口一闪而过 / 图形界面根本打不开 / 终端里运行命令时窗口一闪而过怎么办？

A：这几种现象通常可以放在一起排查。

如果你是直接双击 `March7th Launcher.exe` 或其他可执行文件后，发现终端窗口一闪而过、图形界面根本没有打开，

建议改用终端手动启动，这样更容易看到具体报错信息。

请使用`管理员模式`打开 PowerShell、Windows Terminal 或 CMD 后，再进入小助手目录执行对应命令。

例如可以先尝试：

PowerShell 使用：

```powershell
& '.\March7th Launcher.exe' -S
```

CMD 使用：

```cmd
"March7th Launcher.exe" -S
```

如果你的系统支持 [Sudo for Windows](https://learn.microsoft.com/zh-cn/windows/advanced-settings/sudo/)，也可以直接使用 `sudo`。

根据微软文档，`Sudo for Windows` 仅在 Windows 11 版本 24H2 或更高版本中可用，使用前还需要先在系统设置中启用。

如果改用终端启动后能看到报错，请优先根据报错内容排查；

常见原因仍然是权限不足、杀毒软件误删文件、依赖被拦截，或者工作目录不正确。

---

## File: assets/docs/Tutorial.md

# 使用教程

## 运行前准备

| 平台 | 本地游戏 | 云游戏 |
|------|---------|--------|
| Windows | ✅ | ✅ |
| macOS | ❌ | ✅ |
| Linux | ❌ | ✅ |
| Docker | ❌ | ✅ |
| Android (Termux) | ❌ | ✅ |

本地游戏模式仅支持 Windows，必须使用 PC 客户端，以 1920×1080 分辨率窗口运行游戏；如果窗口模式不可用，再选择全屏。

游戏内语言必须设置为简体中文，并关闭帧率监控 HUD、微星小飞机、游戏加加、HDR、N 卡游戏滤镜等可能遮挡或改变画面的软件。

云游戏模式支持 Windows、macOS、Linux、Android。macOS / Linux 用户可通过源码运行使用云游戏模式，也可以使用 [Docker 部署](/assets/docs/Docker.md)；Android 用户可参考 [Termux 安卓部署](/assets/docs/Termux.md)。

> 开启 `云·星穹铁道` 后，清体力、每日实训、差分宇宙等任务不再要求固定窗口，
>
> 支持后台运行；锄大地和模拟宇宙仍需要保持前台全屏。
>
> 如果有后台运行或多开桌面的需求，也可以使用 [远程本地多用户桌面](/assets/docs/Background.md)。

## 下载安装

点击 [Releases](https://github.com/moesnow/March7thAssistant/releases/latest) 打开下载页面，滚动到底部。

下载名称类似 `March7thAssistant_full.zip` 或 `March7thAssistant_full.7z` 的完整包。

> March7thAssistant 接入了第三方服务 [Mirror酱](https://mirrorchyan.com/?source=m7a-tutorial)。
>
> 如果中国大陆下载缓慢，可以尝试 [点我前往 Mirror酱 高速下载](https://mirrorchyan.com/zh/download?rid=March7thAssistant&os=&arch=&channel=stable&source=m7a-tutorial)。

下载完成后，右键选择 “全部解压缩” 或使用 [第三方压缩软件](https://yasuo.360.cn/) 解压。

解压后的目录中通常至少包含以下文件（夹）：

- `March7th Launcher.exe`
- `March7th Assistant.exe`
- `March7th Updater.exe`
- `assets`
- `libraries`
- `3rdparty`

双击 `March7th Launcher.exe` 打开图形界面，并同意《免责声明》。

如果你需要配合系统任务计划程序定时运行，或希望直接执行完整运行，也可以使用 `March7th Assistant.exe`。

### 命令行启动

`March7th Launcher.exe` 支持命令行参数，可以在启动图形界面的同时自动开始指定任务。

通过终端运行时，请使用 `管理员模式` 打开的 PowerShell、Windows Terminal 或 CMD；

如果你使用的是支持 `Sudo for Windows` 的系统，也可以用 `sudo` 来执行命令。

根据微软文档，`Sudo for Windows` 仅在 Windows 11 版本 24H2 或更高版本中可用，

使用前还需要先在系统设置中启用。详情请参考：[Sudo for Windows](https://learn.microsoft.com/zh-cn/windows/advanced-settings/sudo/)

常用示例：

March7th Launcher.exe -h （查看帮助）

March7th Launcher.exe daily （启动图形界面并执行每日实训）

March7th Launcher.exe main -e （任务正常完成后自动退出程序）

常见任务名称包括：`main`（完整运行）、`routine`（日常）、`daily`（每日实训）、`power`（清体力）、`currencywars`（货币战争）等。

如果你只记得要运行某个任务，但忘了参数名，直接执行 `March7th Launcher.exe -l` 查看最新列表即可。

> 此程序为免费开源项目，如果你付了钱请立刻退款。
>
> 本项目已经因倒卖行为受到严重威胁，请帮助我们举报倒卖行为。

## 首页任务

### 完整运行

`完整运行` 是最推荐的入口，适合日常无人值守。

程序会根据你当前的设置，只执行 `已启用` 且 `已刷新` 的内容。当前版本中，完整运行通常会串行处理以下内容：

兑换码领取、每日实训、活动、历战余响、清体力、货币战争积分奖励、差分宇宙积分奖励、

锄大地、模拟宇宙 / 差分宇宙、混沌回忆、虚构叙事、末日幻影，以及最后的领取奖励。

没有开启的任务会自动跳过；已经判断为完成、尚未刷新到下一周期的任务也不会重复执行。

默认刷新时间为每天凌晨 4 点；周常内容一般在每周一凌晨 4 点刷新。

### 日常

首页 `日常` 菜单包含 `日常`、`每日实训` 和 `清体力`。

`日常` 会忽略这组内容的刷新状态，按当前设置依次处理兑换码、培养目标初始化、活动检测、历战余响、清体力和每日实训，并在最后领取可领取的奖励；只有未开启的内容会自动跳过。

`每日实训` 会先识别尚未完成的实训任务，再尝试自动完成；如果你只想单独刷本耗体力，直接使用 `清体力` 即可。

`清体力` 会根据你在设置中选择的副本类型和副本名称自动计算挑战次数，

也会配合后备开拓力、燃料、支援角色、培养目标等选项一起生效。

如果你在体力设置里关闭了 `启用清体力`，`完整运行` 和 `日常` 会一并跳过历战余响与清体力；单独执行 `清体力` 任务不受这个开关影响。

### 货币战争

当前版本已经支持 `货币战争·零和博弈`。首页入口提供 `运行一次` 和 `循环运行` 两种方式。

如果你在设置里开启了 `货币战争积分奖励`，完整运行会按周常逻辑检查积分奖励是否已经完成；

如果没有完成，就会自动进入货币战争处理本周积分。

设置页中可以进一步配置 `标准博弈 / 超频博弈`、快捷配置、职级难度、策略、速通模式，

以及领取积分奖励后是否自动执行位面饰品快速提取。

### 差分宇宙 / 模拟宇宙

当前版本已经支持 `差分宇宙·乐园漫记`。首页入口提供 `运行一次` 、 `循环运行` 和 `中途接管` 三种方式。

如果你在设置里开启了 `差分宇宙积分奖励`，完整运行会按周常逻辑检查积分奖励是否已经完成；

如果没有完成，就会自动进入差分宇宙处理本周积分。

设置页中可以进一步配置 `常规演算 / 周期演算`、难度等级、站点优先级、低性能兼容模式，以及领取积分奖励后是否自动执行饰品提取。

> `启用模拟宇宙 / 差分宇宙` 配置页通常用于反复刷取遗器经验和灵之珠泪（代替敌方掉落素材）直到每周上限（100只精英怪）。
> 
> 其中模拟宇宙部分调用的是 [Auto_Simulated_Universe](https://github.com/CHNZYX/Auto_Simulated_Universe) 项目，目前处于维护停滞的状态，如遇到问题建议改用差分宇宙。

### 锄大地

锄大地调用的是 [Fhoe-Rail](https://github.com/linruowuyin/Fhoe-Rail) 项目。首页菜单提供 `快速启动`、`原版运行`、`更新锄大地`、`重置配置文件`、`打开程序目录`、`打开项目主页`。

如果需要从中断的地图继续运行，可以使用 `原版运行` 打开锄大地自身界面，再在原项目里选择对应模式继续。

使用前请先开完需要的锚点，并清掉会干扰传送或寻路的任务。

成年女性远程无位移模型通常更稳定，例如艾丝妲、三月七；黄泉等角色可以配合专用地图版本使用。

> 帧数要求 60 帧，其余画质设置一般影响不大。
> 
> 锄大地跑图路线均为人工公益录制，若您有兴趣的话欢迎上传一些优化后的路线/新版本地图路线，减轻一下维护人员的负担~

### 逐光捡金

当前版本中的 `逐光捡金` 分为三类挑战：

- `混沌回忆`
- `虚构叙事`
- `末日幻影`

这三项都可以单独启用，并分别配置关卡范围和两队阵容。完整运行会在周常刷新后按你的开关与配置依次处理；

如果只想单独打其中一种，也可以直接从首页进入对应任务。

### 工具箱

左侧导航栏的 `工具箱` 提供一些常用辅助功能：

- `游戏截图`：检查程序是否正确获取游戏画面，也支持框选 OCR 识别文字。
- `自动对话`：进入剧情界面后自动开始运行，不支持云·星穹铁道。
- `兑换码`：执行当前配置中的兑换码。
- `解锁帧率`：在支持的平台上切换 60 / 120 帧。
- `触屏模式`：按云游戏移动端 UI 方式启动游戏，依赖 [第三方项目](https://github.com/winTEuser/Genshin_StarRail_fps_unlocker) 实现。

如果你遇到画面识别异常，最先应该打开 `工具箱 → 游戏截图` 检查采集到的画面是否正确。

## 流程编排

左侧导航栏中的 `流程编排` 适合制作自定义自动化流程。

它支持把图片点击、文字点击、坐标点击、等待、按键、界面切换、消息推送等步骤拼接起来，

也支持 `if`、`for`、`while`、`break`、`continue` 这类控制逻辑。

如果你的需求已经能被首页现成任务覆盖，优先使用首页任务即可；

如果你需要补充自己的个性化逻辑，例如某个固定界面的重复点击、简单分支判断或循环检测，再使用流程编排会更合适。

首次使用建议先从一个很短的小流程开始，例如：识别按钮、点击按钮、等待 1 秒；

调试时优先使用“执行选中步骤”，确认单个节点稳定后，再逐步扩展完整流程。

详细说明请查看 [流程编排使用教程](/assets/docs/Workflow.md)。

## 配置说明

点击左下角的 `设置` 进入小助手设置界面。

### 程序设置

#### 日志等级

一般保持默认 `简洁` 即可；如果遇到异常，请切换为 `详细` 方便排查问题。

#### 游戏路径 / 启动器路径

启动过游戏后再打开小助手，通常会自动配置 `游戏路径`。如果手动选择，

注意不要误选启动器 `miHoYo Launcher\launcher.exe`，真正的游戏本体是 `Star Rail Game\StarRail.exe`。

如果你希望通过米哈游启动器更新或预下载游戏，还需要额外配置 `米哈游启动器路径`。

#### 任务完成后

当前版本支持 `无`、`退出`、`关机`、`睡眠`、`休眠`、`重启`、`注销`、`关闭显示器`、`运行脚本`、`循环` 等完成后操作。

其中 `退出` 指退出游戏；`运行脚本` 需要额外填写路径；`关机`、`睡眠`等操作会先提示并等待一段时间，方便你取消。

#### 定时运行

`循环模式` 仍然保留用于兼容旧配置，但新版更推荐直接在 `日志` 页面配置 `定时任务`。

定时任务支持：

- 启动内置任务，例如 `完整运行`、`清体力`、`货币战争`。
- 启动外部程序或脚本。
- 为单条任务设置超时强制停止。
- 配置完成后推送通知。
- 配置任务完成后的操作。
- 配置完成后自动终止指定进程。

如果你是 7×24 小时挂机用户，优先考虑 `日志页定时任务`，不要再依赖旧的循环模式。

### 体力与日常设置

#### 副本类型 / 副本名称

清体力时刷什么副本，由这两项共同决定。程序会根据开拓力自动计算次数；

如果检测到例如 `位面分裂` 等双倍活动，也会优先使用这里配置的副本去完成。

#### 使用后备开拓力 / 使用燃料

这两个选项用于清体力时额外消耗后备开拓力或燃料。单次存在上限。

#### 支援角色

开启 `启用使用支援角色` 后，程序会在需要时尝试使用支援；开启 `强制使用支援角色` 后，每次打本都会优先尝试使用支援角色。

#### 培养目标

开启 `培养目标` 后，程序会根据目标自动匹配行迹或遗器副本；如果识别不到培养目标，才会回退到你手动配置的默认副本。

#### 历战余响

开启后，完整运行会优先完成每周三次 `历战余响`，并支持配置从周几开始执行。

### 货币战争设置

如果你只想每周自动拿满货币战争积分奖励，开启 `启用「货币战争」积分奖励` 即可。

常用配置项包括：

- `类别`：标准博弈 / 超频博弈
- `快捷配置`
- `职级难度`
- `货币战争策略`
- `遇到特定词条时接受重开`
- `启用速通模式`

### 差分宇宙 / 模拟宇宙设置

如果你只想每周自动拿满差分宇宙积分奖励，开启 `启用「差分宇宙」积分奖励` 即可。

`差分宇宙` 页面主要负责每周积分奖励、开图鉴、提升等级，

包括常规演算 / 周期演算、难度、低性能兼容模式、奖励后自动饰品提取、站点优先级等。

`模拟宇宙 / 差分宇宙` 页面则负责刷取遗器经验和灵之珠泪直到周上限（100精英怪），配置项包括：

- `运行模式`：集成 / 源码（仅模拟宇宙生效）
- `类别`：差分宇宙 / 模拟宇宙
- `运行频率`：每周 / 每天
- `运行次数`
- `自动领取模拟宇宙沉浸奖励`
- `命途`（仅模拟宇宙生效）
- `难度`（仅模拟宇宙生效）
- `启用模拟宇宙 GPU 加速`（仅模拟宇宙生效）

如果你选择 `源码` 模式，需要保证本机 Python 环境可用。

### 锄大地设置

锄大地页除了启用开关外，还可以配置：

- `运行模式`：集成 / 源码
- `自动切换队伍`
- `地图版本`
- `优先星球`
- `购买秘技零食并合成零食`
- `购买代币与过期邮包`

如果你选择 `源码` 模式，需要保证本机 Python 环境可用。

### 逐光捡金设置

`混沌回忆`、`虚构叙事`、`末日幻影` 都支持分别配置：

- 是否启用
- 关卡范围
- 两队阵容
- 上次运行时间

建议先把队伍配置好，再用完整运行接管周常。

### 云·星穹铁道

开启 `使用“云·星穹铁道”` 后，小助手会改用浏览器控制云游戏来执行清体力等自动化任务。

常用配置包括：

- `全屏运行`
- `最大排队等待时间`
- `浏览器类型`
- `使用国内镜像下载浏览器和驱动`
- `保存浏览器数据`
- `浏览器画面缩放（DPI）`
- `启用无窗口模式（后台运行）`
- `未登录时自动切换为有窗口模式`

其中 `无窗口模式` 不支持模拟宇宙（不包含差分宇宙）和锄大地；如果你需要后台挂机日常和清体力，这一组配置非常关键。

### 杂项设置

`杂项` 页主要是一些增强稳定性和自动化体验的辅助开关，常用的有：

- `启用自动战斗和二倍速检测`：在游戏启动前尝试开启自动战斗和二倍速，并在清体力、货币战争等内置战斗场景中维持状态。
- `启用自动修改分辨率并关闭自动 HDR`：通过小助手启动游戏时自动切到 1920×1080 并关闭自动 HDR，适合本地模式用户。
- `启用自动配置游戏路径`：会尝试从快捷方式、官方启动器或正在运行的游戏进程中自动识别路径。
- `优先使用后台截图`：默认建议开启，可以减少悬浮窗、覆盖层等对截图识别的干扰。
- `在用户登录时启动`：通过任务计划程序在登录后自动启动；如果想完全无人值守，通常还需要你自己配置系统自动登录。

关于 `OCR 加速模式`：建议先保持 `自动`。各模式说明如下：

- `自动`（默认）：Windows 10 18362 及以上优先使用 ONNXRuntime(DirectML) GPU 加速；
- 否则若检测到 OpenVINO 则使用 OpenVINO CPU；都不满足则回退到 ONNXRuntime CPU。
- `GPU (ONNXRuntime DirectML)`：强制使用 DirectML GPU 加速，环境不支持时自动回退。
- `CPU (OpenVINO)`：强制使用 OpenVINO CPU 推理。OpenVINO 在纯 CPU 场景下通常比 ONNXRuntime CPU 更快，
- 当前版本已针对 OpenVINO CPU runtime cache 问题应用临时规避方案；若可用物理内存低于 1GB，会自动降级到 ONNXRuntime CPU。
- `CPU (ONNXRuntime)`：强制使用 ONNXRuntime CPU 推理，兼容性最好、内存行为最稳定。
- 如果遇到识别异常、闪退或内存占用过高，可手动切换为 `CPU (ONNXRuntime)`。

### 消息推送

当前版本支持的推送方式比旧版更多，常见的有：

- Windows 原生通知
- Telegram
- Matrix
- Server酱·Turbo 版
- Server酱³
- Bark
- SMTP（邮箱）
- OneBot
- Go-cqhttp
- 钉钉
- Pushplus
- 企业微信机器人 / 企业微信应用
- Gotify
- Discord
- Pushdeer
- 飞书
- MeoW
- KOOK
- Webhook
- 自定义通知

除了选择推送渠道，还可以设置：

- `通知级别`
- `通知合并`
- `推送图片`
- `消息推送格式`

其中 Telegram、Matrix、SMTP、OneBot、企业微信、飞书、KOOK、Webhook 等方式支持更丰富的通知内容；

实际是否发送图片，以对应渠道能力和你的配置为准。

### 按键设置

按键设置位于 `杂项` 页，只对小助手内置功能生效，可用于配置秘技、地图、跃迁、停止任务等快捷键。

其中 `秘技` 按键主要作用于清体力和逐光捡金等内置任务。

如果你需要修改模拟宇宙或锄大地的按键，请查看对应第三方项目自己的文档和配置文件。

### 账号管理（仅 Windows）

`账号` 页只在 Windows 下显示，主要用于本地游戏模式的多账号导出与切换，不支持 `云·星穹铁道`。

使用时建议按这个顺序：

1. 先完整进入游戏，直到看见角色站在大世界中，再进行导出。
2. 点击 `导出当前游戏账户`，把当前账号保存到本地列表。
3. 以后需要切换时，在列表中选中目标账号，点击 `导入选中的账户`。

账号页还支持这些操作：

- `账户更名`：给本地保存的账号改一个更容易识别的名字。
- `删除账户`：删除本地保存的账号数据。
- `刷新`：重新读取本地账号列表。
- `清除注册表`：清理当前机器上保留的相关账户信息，适合排查切号异常。

`自动登录` 会额外保存你为该账号输入的用户名和密码，并在登录过期时尝试自动回填。

这个功能有一定风险，只建议在你明确知道自己在做什么时使用。

> 重要：如果你在还没完全进入游戏时就导出账号，可能会读取到上一个账号的 UID，导致保存的文件和实际账号不对应。

## 更新

出现新版本弹窗后，点击下载即可；你也可以在设置页最底部点击 `检查更新`，或者手动双击 `March7th Updater.exe`。

如果你手动更新，请下载名称类似 `March7thAssistant.zip` 或 `March7thAssistant.7z` 的完整包，

解压后将全部文件覆盖到旧版本目录即可。