March7thAssistant/assets/docs/Tutorial.md

使用教程

运行前准备

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

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

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

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

开启 云·星穹铁道 后，清体力、每日实训、差分宇宙等任务不再要求固定窗口，

支持后台运行；锄大地和模拟宇宙仍需要保持前台全屏。

如果有后台运行或多开桌面的需求，也可以使用 远程本地多用户桌面。

下载安装

点击 Releases 打开下载页面，滚动到底部。

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

March7thAssistant 接入了第三方服务 Mirror酱。

如果中国大陆下载缓慢，可以尝试 点我前往 Mirror酱 高速下载。

下载完成后，右键选择 “全部解压缩” 或使用 第三方压缩软件 解压。

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

• 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

常用示例：

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 项目，目前处于维护停滞的状态，如遇到问题建议改用差分宇宙。

锄大地

锄大地调用的是 Fhoe-Rail 项目。首页菜单提供 快速启动、原版运行、更新锄大地、重置配置文件、打开程序目录、打开项目主页。

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

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

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

帧数要求 60 帧，其余画质设置一般影响不大。

锄大地跑图路线均为人工公益录制，若您有兴趣的话欢迎上传一些优化后的路线/新版本地图路线，减轻一下维护人员的负担~

逐光捡金

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

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

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

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

工具箱

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

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

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

流程编排

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

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

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

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

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

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

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

详细说明请查看 流程编排使用教程。

配置说明

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

程序设置

日志等级

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

游戏路径 / 启动器路径

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

注意不要误选启动器 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 的完整包，

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