HSR 星穹铁道专项用户指南

本页适用范围

HSR 专项用于在 AUTO-MAS 中调度崩坏：星穹铁道相关外部脚本。当前随 AUTO-MAS PR #249 引入，对应 AUTO-MAS 内脚本类型 HSR。

什么是 HSR 专项？

HSR 专项是 AUTO-MAS 内置的一类脚本适配，同时挂接两款主流的星穹铁道 PC 端第三方工具：

• 三月七小助手（March7th Assistant，M7A）：M7A 路线，擅长体力脚本与周常执行。
• StarRailAssistant（SRA）：SRA 路线，擅长日常奖励领取、差分宇宙等任务。

通过 HSR 专项，AUTO-MAS 可以在一份脚本下混合使用两款引擎，并自动管理游戏启动、脚本调用、失败补跑与周常/月常进度。

支持覆盖的玩法（以你使用的脚本版本为准）：

• 体力副本：拟造花萼（金）、拟造花萼（赤）、侵蚀隧洞、饰品提取
• 历战余响（按周重置）
• 日常与奖励（兑换码、邮件、委托、勋礼、每日实训等）
• 周常：差分宇宙（PVE 玩法）、货币战争（PVP 玩法）
• 月常：三深渊（混沌回忆 / 虚构叙事 / 末日幻影）

⚠️ 关于三深渊：AUTO-MAS 已预留三深渊配置入口与快照导入能力，但 PR #249 阶段在用户页将三深渊开关临时禁用，并标注「前面的功能，以后再来探索吧~」。是否可用、稳定性如何，请以你当前 AUTO-MAS 版本的实际界面为准，不建议将其作为稳定功能使用。

详情信息请查阅：

三月七小助手 官网

三月七小助手 GitHub

SRA 官网

SRA GitHub

准备工作

在 AUTO-MAS 中创建第一个 HSR 脚本前，请完成以下准备：

1. 安装 AUTO-MAS：使用包含 HSR 专项的版本（即合并 PR #249 之后的版本）。
2. 安装三月七小助手（M7A）：解压后请至少手动打开一次，等待其完成初始化（首次启动会创建 config.yaml 等配置文件）。确认目录下存在 March7th Assistant.exe。
3. 安装 StarRailAssistant（SRA）：解压后请至少手动打开一次，让 SRA 生成 settings.json、configs 等目录。确认目录下存在 SRA-cli.exe。
4. 安装星穹铁道 PC 端：国服官方客户端即可，确认目录下存在 StarRail.exe。
5. 杀软/Defender 信任：将 AUTO-MAS、M7A、SRA、星穹铁道游戏目录加入 Windows Defender 或第三方杀软的信任区，避免外部脚本被拦截导致执行失败。
6. 避免中文路径：上述所有目录建议放在纯英文路径下，例如 D:\AUTO-MAS、D:\M7A、D:\SRA、D:\StarRail。中文路径与空格路径历史上容易引发图像识别与路径解析问题。

温馨提醒

AUTO-MAS 会在保存路径时自动校验所选目录里是否包含期望的 exe：

• 三月七路径：必须包含 March7th Assistant.exe
• SRA 路径：必须包含 SRA-cli.exe
• 游戏路径：必须包含 StarRail.exe

选错目录会被前端弹窗拦截并要求重选。

创建 HSR 脚本

1. 新建脚本

1. 进入 脚本管理 页面。
2. 单击 新建脚本。
3. 在弹出的脚本类型列表中选择 HSR 脚本（类型标识：HSR）。
4. 单击确定，AUTO-MAS 会创建一个 HSR 脚本实例并跳转到脚本配置页。

2. 配置脚本基本信息

在 HSR 脚本配置 页填写：

配置项	说明	备注
脚本名称	给此脚本实例起一个易识别的名称	例如「主号星穹」「官服日常」
三月七路径	M7A 安装目录（含 March7th Assistant.exe）	校验 exe；可一键清空
SRA 路径	SRA 安装目录（含 SRA-cli.exe）	校验 exe；可一键清空
游戏路径	星穹铁道安装目录（含 StarRail.exe）	校验 exe
游戏最大启动等待时间	AUTO-MAS 启动游戏后等待客户端可操作的秒数	默认 60 秒，可按机器性能调高
游戏启动参数	启动 StarRail.exe 时附加的命令行参数	一般留空

小贴士

• M7A / SRA 两个路径至少要填一个，另一个留空也允许；留空那一侧在「模块脚本分配」中不会出现。
• 修改完任意路径，模块脚本分配（TaskMapping）会自动按当前已配置路径重新洗牌。

3. 配置执行限制

配置项	说明	默认值
失败任务最大尝试次数	任务失败时自动重试的上限	3
日常任务超时限制（分钟）	日常 / 体力 / 奖励类任务单次最大耗时	20
周常任务超时限制（分钟）	差分宇宙 / 货币战争等周常任务单次最大耗时	60
月常任务超时限制（分钟）	三深渊等月常任务单次最大耗时	60
启用低性能兼容模式	仅对三月七差分宇宙生效（映射到 weekly_divergent_stable_mode）	关闭

4. 模块脚本分配（TaskMapping）

HSR 专项支持把四个模块分别交给 M7A 或 SRA 执行：

模块	含义	默认引擎
体力	开拓力刷取、历战余响等	SRA
日常与奖励	兑换码、邮件、委托、勋礼、每日实训等	SRA
差分宇宙	差分宇宙 PVE 玩法	SRA
货币战争	货币战争 PVP 玩法	SRA

TaskMapping 实际选项会随你已配置的 M7A / SRA 路径动态变化：两个路径都填了才能二选一；只填一个则只能选那一个。

选择不同引擎时，下方「周常任务执行策略」区会显示对应引擎的具体执行参数，用户页不再需要填写这些参数：

• 差分宇宙
  • SRA：差分宇宙乐园漫记 / 模式刷第一关 / 次数 20 / 启用积分奖励
  • 三月七：启用积分奖励 / 周期演算 / 低性能兼容（跟随脚本页开关）；球队 / 赐福 / 演算策略由 M7A 客户端自行决定
• 货币战争
  • SRA：标准博弈 / 最低难度 / SRA 保存的第一套攻略 / 运行次数 2
  • 三月七：启用积分奖励 / 标准博弈 / 最低职级 / 阿格莱雅策略 / 特定词条接受重开

SRA 货币战争特别说明

SRA 在执行完货币战争后，不会自动领取积分奖励，请在游戏内手动领取。其他引擎会按其客户端规则自动处理。

创建 HSR 用户

在 HSR 脚本下添加用户：

1. 在 脚本管理 表格内，单击 添加用户，或直接进入已创建的 HSR 脚本点击「添加用户」。
2. 填写 基本信息：

字段	说明
用户名	用户显示名称；同时会作为货币战争的「开拓者名称」写入 M7A / SRA
启用	是否参与自动代理；关闭后该用户会被跳过
账号	登录账号（如手机号），仅在需要自动登录/切号时使用
密码	登录密码，仅在需要自动登录/切号时使用
服务器	当前仅支持「官服（CN-Official）」
剩余天数	剩余有效代理天数；-1 表示不限制，0 表示今日到期，正数为剩余天数
备注	自由备注信息

账号与密码安全

• 账号、密码保存在本地，保存时由 AUTO-MAS 自动加密。
• 没有配置 SRA 路径，或者 TaskMapping 没有把模块交给 SRA 时，账号密码不会用于切号，仅作为预留字段。
• 请勿公开分享你的 data/ 目录或脚本配置 JSON 文件，其中包含加密凭据。

任务开关

在用户页配置该用户要执行哪些模块：

开关	说明	默认
体力	是否执行体力副本 + 历战余响	关闭
日常与奖励	是否执行兑换码、邮件、委托、勋礼、每日实训等	关闭
三深渊（每月一次，三个一起执行）	当前 UI 禁用，是否启用以你实际版本界面为准	关闭
差分 / 货币	三选一：关闭 / 差分宇宙 / 货币战争	关闭

按你 TaskMapping 中选择的引擎，UI 会显示对应的执行策略（与脚本页一致）。

配置体力副本

进入 体力配置 区，可以看到四个独立的下拉框：

通道	对应副本类型
拟造花萼（金）	角色经验 / 光锥经验 / 信用点
拟造花萼（赤）	行迹材料（金/赤互不覆盖，可同时保存）
侵蚀隧洞	遗器副本
饰品提取	位面饰品副本

每个通道都是独立可选项；不刷的副本可以不选。

接着是：

• 刷取副本：选择本次要刷的通道（金/赤/遗器/饰品），会写入 Stage.Channel。
• 当前生效关卡：UI 展示当前 Stage.ScriptStage 对应的关卡名/关卡 ID。
• 历战余响：从外部脚本读取的历战余响关卡中选一个；不刷可以留空。
• 历战余响开始日：周一 ~ 周日。到达开始日且本周未完成时，AUTO-MAS 会交给 M7A / SRA 尝试完成；日志确认完成后本周不再执行。

副本选项从哪里来？

体力副本选项只来自外部脚本暴露的副本配置，按你 TaskMapping 中「体力」模块选择的引擎动态读取：

• M7A：从 instance_names.json 读取
• SRA：从 trailblaze_power.toml 读取

如果下拉框为空，常见原因：

1. 外部脚本（M7A / SRA）还没初始化过；请先手动打开一次。
2. 外部脚本路径填错，导致 AUTO-MAS 找不到配置文件。
3. 切换了 TaskMapping 中的体力执行引擎（例如从 SRA 切到 M7A），需要重新选择副本。

切换体力执行引擎时，体力配置区会出现黄色提示「体力执行脚本已切换，请重新选择副本。」

周常 / 月常说明

HSR 专项的周常 / 月常进度由 AUTO-MAS 自动记录，用户页不要求手动选择「差分宇宙 1 / 差分宇宙 2」等：

• 差分宇宙、货币战争：属于周常类任务；完成状态按 ISO 周（形如 2025-W23）自动记录。本周已完成的周常，下次执行会被跳过。
• 三深渊：属于月常类任务；每月执行一次，由三份快照（混沌回忆 / 虚构叙事 / 末日幻影）组成。完成状态按自然月（形如 2025-06）自动记录。
• 历战余响：按 ISO 周重置；用户可以指定「历战余响开始日」，到达后才尝试执行，本周完成后不再重复。

进度与重置

用户页底部「进度与重置」区提供三个手动控制项：

• 历战余响：显示「本周已完成 / 未完成」与最近完成日期。提供「标记完成 / 重置」按钮。
• 周常：同上，按 ISO 周判定。
• 三深渊：按自然月判定，提供「标记本月完成 / 重置」按钮。

这三个按钮只修改本地的 Data 字段，不会实际驱动外部脚本；它们用于在外部脚本已确认完成、或你希望强制重跑某项时快速同步状态。

关于三深渊

AUTO-MAS 准备了完整的三深渊流水线，包括：

• 用户页：可开关 ForgottenHall 并在 UI 导入三份快照
• 脚本页：可从 M7A 的 config.yaml 一键导入「混沌回忆 / 虚构叙事 / 末日幻影」三份快照

但当前 PR #249 阶段在用户页将三深渊开关禁用，以避免在不充分的测试下被误用。后续会随版本逐步开放，请以你 AUTO-MAS 实际界面为准。

运行与日志

配好脚本和用户后，可把脚本加入任务调度队列执行。日常使用要点：

• M7A / SRA 切换时 AUTO-MAS 会重启游戏：这是为了避免外部脚本状态互相污染；属于预期行为。
• M7A / SRA 各自的配置 AUTO-MAS 不会破坏：运行前会备份 config.yaml / settings.json / cache.json / configs，运行后自动恢复。
• 失败自动补跑：模块内单条任务失败时，会按「失败任务最大尝试次数」自动补跑；补跑前 AUTO-MAS 会先重启游戏。

日志位置

排查问题请提供：

• debug/app.log：AUTO-MAS 主程序日志
• debug/frontend.log：前端日志

如果问题与某个外部脚本相关，请同时附上 M7A / SRA 的运行日志目录（路径请参见各脚本的官方文档）。

常见问题

找不到 HSR 脚本类型

• 确认你使用的 AUTO-MAS 版本已合并 PR #249。
• 重新启动 AUTO-MAS 让前端 OpenAPI 客户端重新生成。

路径校验失败

• 「三月七路径」选错目录：必须包含 March7th Assistant.exe。
• 「SRA 路径」选错目录：必须包含 SRA-cli.exe。
• 「游戏路径」选错目录：必须包含 StarRail.exe。
• 注意：是选 目录（文件夹），不是选 exe 本身。

副本列表为空

• 确认 M7A / SRA 已经手动打开过一次，初始化了 config.yaml / settings.json。
• 确认脚本路径填的是外部脚本根目录，不是某个子目录。
• 若你刚切换了「体力」模块的执行引擎，请按页面提示重新选择副本。

任务完成状态不符合预期

• 检查「每日任务」「周常/月常」开关是否符合预期。
• 周常按 ISO 周重置，月常按自然月重置；跨周/跨月后状态会自动重置。
• 查看 debug/app.log 中关于 M7A / SRA 子进程退出码与判定 marker 的日志。
• 在「进度与重置」区可以手动标记完成或重置来同步状态。

M7A 差分宇宙看起来跑得不太稳

• 启用脚本页的「启用低性能兼容模式」开关。
• 球队 / 赐福 / 演算策略由 M7A 客户端自行决定，请提前在 M7A 本体中配置好。

SRA 货币战争完成后没有积分

• 这是已知行为。SRA 货币战争完成后不会自动领取积分奖励，请在游戏内手动领取。

调度过程中游戏被反复重启

• 当同一用户的不同模块由不同引擎（一个 M7A、一个 SRA）执行时，AUTO-MAS 会在切换时重启游戏以避免脚本状态污染，属于预期行为。
• 如希望减少重启，可以在 TaskMapping 中把多模块统一交给同一个引擎。

任务失败但日志里看不到 M7A / SRA 输出

• 确认 Windows Defender / 杀软没有拦截子进程。
• 确认外部脚本路径没有中文、空格或符号链接。
• 把 M7A / SRA / 星穹铁道安装目录加入杀软信任区后再试。

反馈与帮助

• AUTO-MAS 问题反馈：GitHub Issues
• 三月七小助手：m7a.top / GitHub
• StarRailAssistant：starrailassistant.top / GitHub