三月七小助手:星穹铁道游戏自动挂机辅助,从 0 到全自动清体力的 5 分钟上手指南
【免费下载链接】March7thAssistant日常交给三月七,开拓留给你。《崩坏:星穹铁道》开源自动化助手。项目地址: https://gitcode.com/gh_mirrors/ma/March7thAssistant
March7thAssistant(三月七小助手)是一款星穹铁道开源游戏辅助,靠截图识别画面再替你点击,把清体力、每日实训、周常挑战变成自动挂机。读完整篇,5 分钟跑通第一个自动任务。
先确认你能不能跑:星穹铁道助手的平台支持矩阵
这一节只回答一个问题:你现在的机器能不能跑,以及该选「本地」还是「云游戏」两条路径里的哪一条。本地模式依赖在你电脑的游戏窗口上截图、识别、点击;云游戏模式则用浏览器去操控云端的《云·星穹铁道》客户端,两者平台要求完全不同:
| 平台 | 本地游戏(画面识别) | 云游戏(浏览器操控) |
|---|---|---|
| Windows | ✅ | ✅ |
| macOS | ❌ | ✅ |
| Linux | ❌ | ✅ |
| Docker | ❌ | ✅ |
| Android (Termux) | ❌ | ✅ |
Windows 用户选本地模式最省事,但有三个硬性条件:窗口化 1920×1080(窗口模式不可用时改全屏)、游戏内语言为简体中文、关掉帧率监控、微星小飞机、HDR 等一切会遮挡画面的东西——它的识别精度完全建立在「看到的画面就是游戏画面」之上。macOS / Linux / Docker / 安卓用户直接走云游戏:清体力、每日实训这类任务不再要求固定窗口,可以后台跑,只有锄大地和模拟宇宙仍需前台全屏。
确定模式后,最短启动路径就三步:
- 去最新版 Releases 下载页,下载名称类似
March7thAssistant_full.zip的完整包并解压; - 双击
March7th Launcher.exe打开图形界面,同意免责声明; - 看一眼游戏路径是否已自动填好(先完整进一次游戏,通常就能自动配好)。
第一次跑通:三步跑通第一个游戏自动挂机任务
这一节的目标是让你第一次看到助手无人值守地把日常跑完,全程不需要背任何配置项。
先以管理员模式打开 PowerShell 或 CMD,跑两条命令:
March7th Launcher.exe -l March7th Launcher.exe main第一条列出最新任务清单(daily、power、currencywars等都在里面),忘了名字随时查它;第二条就是「完整运行」,也是新手最推荐的入口。不想碰命令行的话,直接在首页点完整运行卡片效果相同。
完整运行到底帮你做了什么?它按当前设置串行处理:兑换码、每日实训、活动、历战余响、清体力、货币战争与差分宇宙的积分奖励、锄大地、模拟宇宙 / 差分宇宙、混沌回忆等周常,最后统一领取可领奖励。未开启的任务自动跳过,已判定完成、还没刷新到下一周期的内容不重复跑——每天默认凌晨 4 点刷新,周常周一凌晨 4 点刷新。跑一次完整运行约等于把当天该做的日常周常一次收尾,再配合日志页的定时任务,就接近 7×24 无人值守。
只跑单项时:daily只管每日实训,power只清体力,routine则无视刷新状态把日常内容一口气过一遍。注意清体力总开关关掉后完整运行和日常会跳过体力环节,但单独执行清体力任务不受影响。
进阶玩法:把任务编排成你自己的流程
内置任务没覆盖的小需求——比如某个固定界面要反复点、要循环检测一个按钮——就用左侧导航栏的流程编排。能被首页任务满足的优先用首页任务,流程编排只用来补个性化逻辑。
拿官方示例「自动升级角色和强化光锥」来搭一遍,文件结构可翻 sample_auto_upgrade/workflow.yaml。第一步点「新建流程」并起名;第二步在顶层加一个「点击文字」步骤,让流程先找到并点击「升级」按钮;第三步在它下面挂一个for循环,循环里依次放三个子步骤:点「自动置入」、点「升级」、点「确认」。流程就是一棵步骤树:普通步骤按顺序执行,控制步骤可以把子步骤挂在自己下面。示例里循环次数填 0,表示无限循环,靠循环内条件和停止按钮收尾;如果希望「满足某条件就一直做」,改用条件循环并设一个合理的最大次数兜底。break和continue只能放在循环里:前者结束当前循环,后者跳过本轮剩余步骤直接进下一轮。
最高频的五个步骤:
| 步骤 | 什么时候用 |
|---|---|
| 点击图片 | 界面上有稳定按钮、图标、提示框,按模板找并点击 |
| 点击文字 | 文字稳定、图标样式易变时优先用它 |
| 查找图片 / 查找文字 | 不点击,只判断目标在不在,常作条件判断 |
| 等待 | 界面切换、动画播放、按钮出现前的缓冲 |
for/while | 固定次数或条件循环,for填 0 即无限循环 |
调试时先右键步骤树选「执行选中步骤」验证单个节点,确认稳定后再「运行流程」整体跑,全程盯日志页:执行到第几步、条件命中没有、有没有撞最大循环次数。需要框一张图当模板时,点「采集图像模板」,框选完存进流程自己的素材目录,保存和导出都会跟着流程走。把截图工具生成的坐标表达式贴进「检测区域」能缩小查找范围,比全屏搜索稳得多。
流程做完也能从命令行触发:
March7th Assistant.exe --workflow-name "流程名称"流程的存储、导入导出与步骤类型定义都在 module/workflow/ 目录,想抠细节可以翻。
调参数:只讲影响出活率最大的四项
配置模板有七百多行,但真正决定「出活多少」的只有下面四组,每组按「现象→配置项→建议值」来看。
一、清体力刷什么本。现象:清体力总刷你不想要的副本。配置项:instance_type(副本类型)和instance_names(副本名称)共同决定进哪个本,次数按开拓力自动算。建议值:先把你常刷的四星本填进去,燃料有富余再打开消耗燃料开关。
二、培养目标。现象:想给角色补材料,清体力却只刷通用本。配置项:build_target_enable。建议值:开启后程序按培养目标自动匹配行迹或遗器副本,识别不到目标才回退到你手配的本。
三、自动战斗与二倍速。现象:战斗偶尔变手动,清体力速度肉眼可见变慢。配置项:auto_battle_detect_enable。建议值:保持开启,打本前它会尝试把自动战斗和二倍速开起来并维持状态。
四、OCR 加速。现象:识别慢、内存占用飙高。配置项:ocr_gpu_acceleration。建议值:先用「自动」——有 GPU 的 Windows 走 GPU 加速,否则自动选 CPU,单次识别过慢还会自动降级;真遇到闪退再手动切到 CPU (ONNXRuntime)。引擎的选型与降级逻辑可以翻翻 module/ocr/ 目录。
其余项最常被碰到的只有after_finish(任务完成后关机 / 睡眠 / 退出)和log_level(日志等级)两个,完整清单见 assets/config/config.example.yaml。
出问题了怎么排查:先查截图,再调引擎
大部分异常都源于同一件事——程序看到的画面和你看到的不一样——按这个顺序查就能解决大部分问题。
识别异常(按钮没点到、文字找不到):先打开「工具箱 → 游戏截图」,确认采到的画面对不对,这一步能最快区分「画面被挡」还是「识别坏了」。再查微星小飞机、帧率监控、HDR 滤镜是否盖在了游戏窗口上。还不行就把ocr_gpu_acceleration手动切到 CPU (ONNXRuntime) 复跑,问题消失说明是加速引擎的锅。
卡死、闪退、无响应:先把log_level调到 DEBUG 复跑,拿到详细日志;出错时程序还会保存一张出错瞬间的截图,对照日志定位卡在第几步。
游戏没启动、启动到了错的窗口:game_path必须指向游戏本体StarRail.exe,别误选启动器launcher.exe;进过一次游戏再开小助手,路径通常会自动配好。
云游戏登录不上:先在有窗口模式下登录一次,并确保「保存浏览器数据」是开的,登录态才会保留;无窗口模式检测到未登录会自动切回有窗口模式让你补登录。
写在最后
记住三件事:识别异常先查截图,完整运行交给刷新周期自己调度,个性化需求才动流程编排。想尝鲜新版本,留意首页的更新弹窗,或手动双击March7th Updater.exe覆盖更新。日常交给三月七,开拓留给你。
【免费下载链接】March7thAssistant日常交给三月七,开拓留给你。《崩坏:星穹铁道》开源自动化助手。项目地址: https://gitcode.com/gh_mirrors/ma/March7thAssistant
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考