HSR 星穹铁道配置方法
HSR 专项是什么
星穹铁道有两款常用的第三方脚本，各有所长：
- 三月七小助手（M7A）：体力副本和周常跑得好。
- StarRailAssistant（SRA）：日常奖励领取、差分宇宙跑得好。
HSR 专项的意义就在这儿：你不用二选一。在一个脚本里同时挂上两款，哪个任务交给哪个，由你决定。AUTO-MAS 负责启动游戏、按顺序调用脚本、失败了重跑，以及记住周常这周做没做过。
能跑的内容（具体以你装的脚本版本为准）：
- 体力副本：拟造花萼（金）、拟造花萼（赤）、侵蚀隧洞、饰品提取
- 历战余响（每周重置）
- 日常与奖励：兑换码、邮件、委托、勋礼、每日实训等
- 周常：差分宇宙、货币战争
详情信息请查阅：
准备工作
开始前先完成以下准备，可以避开大部分常见问题。
- 装好你要用的脚本（M7A 和 SRA 至少装一个，两个都装才能混用）。
- 每个脚本都手动打开一次。 脚本第一次启动才会生成自己的配置文件（三月七是
config.yaml，SRA 是%APPDATA%\SRA\configs下的档案），AUTO-MAS 要读它才能显示「MAS 管控任务」右边那一堆配置项；原生配置更是缺了它就过不了任务开始前的检查。SRA 那边如果打开后没生成，在里面随便保存一次设置即可。 - 装好星穹铁道 PC 端，国服官方客户端。
- 全部加进杀软白名单：AUTO-MAS、M7A、SRA、游戏这四个目录都要加，不然脚本会被拦下来，任务莫名失败。
- 路径别用中文和空格，例如
D:\M7A、D:\SRA。中文路径历来容易引发图像识别和路径解析问题。
路径要选文件夹，不是选 exe
保存时 AUTO-MAS 会检查你选的文件夹里有没有对应的 exe，选错会直接弹窗拦下来：
| 填这个 | 文件夹里得有 |
|---|---|
| 三月七路径 | March7th Assistant.exe |
| SRA 路径 | SRA-cli.exe |
| 游戏路径 | StarRail.exe |
创建 HSR 脚本
1. 新建托管
进入 托管管理 → 新建托管 → 选择 HSR 脚本 → 确定。软件会跳到脚本配置页。
2. 脚本与游戏配置
| 配置项 | 填什么 |
|---|---|
| 脚本名称 | 随便起个你认得出的名字，比如「主号星穹」 |
| 三月七路径 | M7A 所在文件夹 |
| SRA 路径 | SRA 所在文件夹 |
| SRA 配置档案 | SRA 可以存多份配置档案，这里选用哪一份。默认「自动」，见下 |
| MAS 管理游戏 | 由 AUTO-MAS 负责启动游戏、切脚本时重启、以及盯着游戏进程。默认「是」，游戏已经在跑时会自动跳过启动，不用为此关掉它。建议只在「原生配置 + 云游戏」时选「否」；关掉后上面三件事一起失效 |
| 游戏路径 | 星穹铁道所在文件夹。「MAS 管理游戏」选「是」时必填 |
| 游戏最大启动等待时间 | 启动游戏后等待客户端可操作的秒数，默认 60 秒，可按机器性能调大 |
| 运行时设为 1920×1080 窗口模式 | 打开后任务开始前临时改写注册表把游戏设成 1920×1080 窗口模式，任务结束后还原。脚本的图像识别按这个分辨率调校，画面比例不对时打开它 |
| 兑换码仅在变化时执行 | 默认打开。兑换码没变就跳过这一步，避免每天白跑一遍 |
只装了一个脚本也能用
M7A 和 SRA 填一个就行，另一个留空。留空的那个不会出现在账号页的执行引擎选项里。
关于 SRA 配置档案
SRA 把设置保存成 %APPDATA%\SRA\configs 下的多份档案。选哪一份决定三件事：MAS 管控任务的配置项显示的是哪份内容、原生配置按哪份运行、固定快照时抄的是哪份。
留「自动」的话优先用 Default，没有就用文件名排序的第一份——这也是以前唯一的行为。如果你选的档案后来被删了或改了名，AUTO-MAS 会退回自动模式并在脚本页和账号页都给出提示，不会闷声换掉。
改分辨率要在游戏关着的时候
「运行时设为 1920×1080 窗口模式」是通过改注册表生效的，游戏已经在运行时改不动。AUTO-MAS 会在日志里提示你关掉游戏后重新执行，本轮仍会照常跑，只是分辨率没改成。
3. 设置重试和超时
这几项决定任务的超时与重试行为，默认值适用于大多数情况，可按机器性能调整。
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 失败任务最大尝试次数 | 一个任务总共尝试几次，含第一次。默认 3 ＝ 首轮 + 最多 2 次补跑 | 3 |
| 日常任务超时限制（分钟） | 日常 / 体力 / 奖励类任务最多跑多久 | 20 |
| 周常任务超时限制（分钟） | 差分宇宙 / 货币战争最多跑多久 | 60 |
| 启用低性能兼容模式 | 只影响 M7A 跑差分宇宙。M7A 差分跑得不稳就打开 | 关闭 |
任务分配不在这一页
「哪个任务交给哪个脚本」现在是每个账号各自决定的，在账号页设置，不在脚本页。同一个托管下的两个账号可以一个用 SRA、一个用 M7A。
创建 HSR 账号
在 托管管理 表格里点 添加账号，然后填基本信息：
| 字段 | 填什么 |
|---|---|
| 账号名称 | 显示名称。跑货币战争时会作为「开拓者名称」写给脚本 |
| 启用 | 关掉的账号会被跳过 |
| 账号 | 手机号等登录账号，只在需要 SRA 自动切号时才要填 |
| 密码 | 登录密码，同上 |
| 服务器 | 目前只有官服 |
| 剩余天数 | 还能代理几天。-1 是不限制；每天最多减一次，而且要当天日常阶段至少有一个模块成功才减；减到 0 就跳过这个账号。原生配置的账号不递减，但一样会在 0 时被跳过 |
| 备注 | 随便写 |
关于账号密码
账号密码保存在本地并自动加密，不会上传。
脚本页填了 SRA 路径、且这个账号是「MAS 管控」模式时，这两栏才会出现。 但真正会拿去登录 / 切号，还要看你确实把某个开启的模块交给了 SRA；没有的话填了也用不上。
另外，别把你的 data/ 目录或脚本配置 JSON 发给别人，里面有加密后的凭据。
运行模式：MAS 管控还是原生配置
每个账号都要选一个 运行模式，这决定了「谁说了算」：
| 模式 | 谁决定跑什么 | 适合谁 |
|---|---|---|
| MAS 管控（默认） | AUTO-MAS。任务开关、执行引擎、副本、各项配置都在这个页面上设 | 想在一个界面里管完所有号 |
| 原生配置 | M7A / SRA 自己。AUTO-MAS 只负责按时把它拉起来 | 已经在脚本里配得很顺手，只想要个定时器 |
原生配置
原生配置不需要在 AUTO-MAS 里做任何配置。你在 M7A / SRA 自己的界面里怎么设的，跑的就是什么，改完立刻生效，不用回来同步一次。
用法就两步：选好运行模式，把要跑的脚本开关打开。
原生配置会忽略这个页面上的其它设置
任务开关、账号密码、体力副本、MAS 管控任务里的配置项，在原生配置模式下一个都不会生效——那些是 MAS 管控模式才用的。下面的「进度与重置」区也只在 MAS 管控模式下出现。
另外原生配置没有失败补跑（脚本自己怎么跑就怎么算），单次运行上限固定 2 小时，而且只能走自动代理，不支持在调度中心单独运行某个账号。
什么时候才需要「固定为快照」
只有一种情况：同一个 HSR 脚本下挂了多个游戏账号，而且你希望每个账号跑不一样的计划。
原生配置跑的是脚本当前生效的那一份配置，多个账号选择原生配置就会共用它。这时可以在某个账号上点 固定当前配置为快照（可选），AUTO-MAS 会把脚本此刻的配置抄一份存到这个账号名下，之后这个账号就跑这份，和别的用户互不影响。
快照是冻结的
快照存下来之后不会跟着脚本里的后续改动走。你在 SRA 里改了设置，固定过快照的用户还是跑老的那份。想更新就点 重新固定为当前配置，不想要了就点 改回使用脚本当前配置。
只有一个用户的话，别用快照，默认的活配置更省心。
配置体力副本
体力配置 区有四个下拉框，对应四类副本。不想刷的留空就行：
| 下拉框 | 刷的是 |
|---|---|
| 拟造花萼（金） | 角色经验 / 光锥经验 / 信用点 |
| 拟造花萼（赤） | 行迹材料 |
| 侵蚀隧洞 | 遗器 |
| 饰品提取 | 位面饰品 |
金和赤的选择互不影响，可以同时存着。
下面还有几项：
- 刷取副本：从上面四类里挑本次实际要刷的那一类。
- 当前生效关卡：显示你选中的关卡，只是给你确认用的。
- 历战余响：从脚本读出来的关卡里挑一个，不刷就留空。
- 历战余响开始日：设成周几，到了那天本周还没刷就去刷。刷完这周就不再重复。
副本选项跟着执行引擎走
这些副本选项不是 AUTO-MAS 自己编的，而是从你的 M7A / SRA 里读出来的——体力交给谁，就读谁的配置。两边的副本列表不一样，所以每个引擎各存一份你选的关卡，换引擎后要重新选一次，换回去原来的选择还在。
MAS 管控任务
这是 MAS 管控模式的主区域，左边是四个任务模块，右边是选中模块的详细配置。
| 模块 | 包含什么 | 开关默认 |
|---|---|---|
| 体力与培养目标 | 开拓力刷副本、历战余响 | 开 |
| 日常与奖励 | 兑换码、邮件、委托、勋礼、每日实训等 | 开 |
| 差分宇宙 | 差分宇宙 | 关 |
| 货币战争 | 货币战争 | 关 |
差分宇宙和货币战争是两个独立开关，想都跑就都打开。
每个模块可以单独指定 执行引擎（SRA 或三月七助手）。只填了一个脚本路径时就只有那一个可选。
详细配置是从哪来的
右边那一堆配置项不是 AUTO-MAS 自己定义的，而是实时从你的 SRA / 三月七助手配置文件里读出来的，读的就是脚本此刻保存的值。你在这里改动某一项，AUTO-MAS 只记下你改过的那几项（叫「覆盖值」），其余仍跟着脚本走。
所以有几个直接的后果：
- 脚本升级后多了新选项，这里会自动出现，不用等 AUTO-MAS 更新。
- 切换执行引擎等于换一整套配置项，两个引擎的字段名根本不一样。当前引擎下改过的值不会带过去，但会保留着，切回来还在。
- 有些东西 AUTO-MAS 故意不接管，比如 SRA 的兑换码列表，那些只能在脚本自己的界面里填。
有两类设置会被 AUTO-MAS 强制关掉
托管模式下，AUTO-MAS 会在临时配置里强制关掉脚本自己的通知推送和任务完成后动作（三月七的 after_finish、SRA 的 missionAccomplished）。
原因是这些动作会把游戏甚至整台电脑关掉——三月七只要 after_finish 不是「无操作」，收尾时就会先把游戏关掉，本阶段剩下的模块只能中止并进入补跑；设成「关机」时还会在 60 秒后真的关机。通知则由 AUTO-MAS 自己统一发。
这只影响托管模式下 AUTO-MAS 跑的那一轮，你在脚本里的原设置跑完会还原。原生配置不改这两项，你设了什么就是什么；唯一的例外是 SRA 的 Windows 弹窗通知——只要填了 SRA 路径，整轮运行期间都会被临时关掉，跑完还原。
重置为源配置
模块列表右上角的 重置为源配置 会删掉这个账号在 MAS 里改过的全部覆盖值（所有模块、所有字段），之后各项都按脚本当前配置显示和运行。源配置文件本身不会被改动。
这个操作不可撤销，点了会先弹确认。
「N 项失效覆盖」是什么意思
脚本升级、换了 SRA 配置档案之后，你之前改过的某个字段可能已经不存在了，或者类型对不上。这时该项会标成失效：
- 运行时直接忽略它，按源配置执行，不会因此报错或中断任务。
- 详情面板里会列出是哪几项、为什么失效、你当初存的是什么值。
- 点 清除无效覆盖 可以把它们从这个账号的配置里删掉。同样只动 AUTO-MAS 这边，不碰源配置文件。
周常进度不用你操心
这类任务 AUTO-MAS 会自己记账：
- 历战余响：单独按周记录。
- 差分宇宙、货币战争：这两个共用同一条「周常」记录。任意一个被日志确认完成，整个周常就算做过了，本周另一个也不会再跑——两个都开的话要留意这一点。
都按 ISO 周重置，下周一自动解锁（按游戏服务器时区的周一 0 点，不是游戏内 4 点换日）。
手动改进度
账号页底部的 进度与重置 区（只在 MAS 管控模式下出现）可以看到历战余响和周常各自「本周做没做过」，每项都能手动 标记完成 或 重置。
两种情况用得上：你已经自己进游戏做完了，标记一下让 AUTO-MAS 别再跑；或者你想强制重跑一次，点重置。
这几个按钮只改记录
它们只改 AUTO-MAS 自己的记账，不会真的去驱动脚本执行任务。
运行与日志
配好之后，把脚本加进 调度队列 就能自动跑了。三件事值得知道：
- 游戏可能被反复重启：三种情况会重启——同一用户的任务在两个脚本之间切换、同一用户从日常阶段进入周常阶段（与用哪个脚本无关）、以及每轮补跑之前。都是故意的，为了防止脚本状态互相干扰。三者都只在「MAS 管理游戏」为「是」时才发生。
- 你的 M7A / SRA 配置不会被弄坏：AUTO-MAS 跑之前先备份，跑完自动还原。
- 失败会自动重跑：按你设的「失败任务最大尝试次数」重试，重试前先重启游戏。
出问题要交哪些日志
debug/app.log—— AUTO-MAS 主程序日志debug/frontend.log—— 界面日志
如果看起来是某个脚本本身的问题，再附上 M7A / SRA 自己的日志（位置见各脚本文档）。
发日志前先看一眼
AUTO-MAS 会把 M7A / SRA 的输出原样转进自己的日志，所以里面可能有你的游戏 UID（脚本做 OCR 时会读到）。账号密码是脱敏过的，UID 不是。发到公开 issue 前建议先搜一下自己的 UID 打码。
另外 M7A 的日志级别设成 DEBUG 时，转进来的量会非常大（一次运行上千行很正常）。想让日志清爽点，把 M7A 自己的 log_level 调回 INFO。
常见问题
新建托管时没有 HSR 这个选项
你的 AUTO-MAS 版本太老，还没有 HSR 专项，去 下载页 更新。更新后重启一次软件。
路径怎么填都提示不对
你可能选到了 exe 本身。这里要选的是文件夹。 确认文件夹里直接放着对应的 exe：三月七是 March7th Assistant.exe、SRA 是 SRA-cli.exe、游戏是 StarRail.exe。也别选到子目录里去。
副本列表是空的
副本选项读的是脚本安装包里自带的清单（三月七 assets\config\instance_names.json，SRA tasks\config railblaze_power.toml），解压就有，跟你有没有打开过脚本无关。所以基本只有两个原因：路径没填到脚本根目录（最常见，里面得能看到上面那两个目录），或者刚换过体力的执行引擎——两边副本列表不一样，换了要重选，页面上会有提示。
任务状态不对，该跑的没跑 / 跑过了又跑
- 先看账号页的任务开关是不是你想的那样。
- 周常按周重置，跨周会自动清零。
- 在 进度与重置 区手动标记或重置，可以立刻纠正状态。
- 还是不对就看
debug/app.log，里面有脚本退出情况的记录。
M7A 跑差分宇宙不太稳
打开脚本页的 启用低性能兼容模式。另外球队、赐福、演算策略这些 AUTO-MAS 管不到，得你提前在 M7A 里配好。
SRA 跑完货币战争没积分
已知行为，SRA 不会自动领，自己进游戏领一下。想省这一步就把货币战争改交给 M7A。
游戏被反复重启
三个来源：脚本之间切换、日常阶段跑完进周常、以及补跑之前。都是故意的，防止脚本状态互相干扰。
把任务都交给同一个脚本能少掉第一种，但只要开了差分宇宙或货币战争，日常跑完那次重启躲不掉。完全不想让 AUTO-MAS 碰游戏，就把脚本页的「MAS 管理游戏」关掉——代价是启动、切换和进程监测都得你自己管。
任务失败了，但日志里没有脚本的输出
说明脚本压根没跑起来，基本是被杀软拦了。把 M7A、SRA、游戏三个目录都加进杀软信任区再试。也顺便确认路径里没有中文、空格或符号链接。
反馈与帮助
- AUTO-MAS 问题反馈：GitHub Issues
- 三月七小助手：m7a.top / GitHub
- StarRailAssistant：starrailassistant.top / GitHub