March7thAssistant 三月七小助手：每天 3 分钟，让星穹铁道的清体力与周常全自动跑完

【免费下载链接】March7thAssistant日常交给三月七，开拓留给你。《崩坏：星穹铁道》开源自动化助手。项目地址: https://gitcode.com/gh_mirrors/ma/March7thAssistant

凌晨 04:00，游戏任务准时刷新；04:30，计划任务把《崩坏：星穹铁道》拉起来，三月七小助手（March7thAssistant）接着跑完清体力、每日实训和奖励领取。等早上起床，手机里已经躺着一条「每日实训已完成」的通知。这就是这个星穹铁道自动化助手日常干的事。

项目定位：它和别的自动化工具差在哪

March7thAssistant 是一个开源的《崩坏：星穹铁道》自动化助手，由 moesnow 发起、社区持续维护。与改内存、注入进程的工具不同，它的全部动作来自对游戏画面的图像识别加上模拟鼠标键盘的点击（底层依赖 PyAutoGUI、OpenCV 和 RapidOCR），不读写游戏内存。模拟宇宙部分复用 Auto_Simulated_Universe、锄大地复用 Fhoe-Rail，两者以子模块形式挂在3rdparty/下。

装完就能跑：从解压到第一次完整运行

我按教程试了一遍：从 Releases 下载完整包，解压后双击March7th Launcher.exe，同意免责声明，图形界面就起来了。整个过程中没有装任何 Python 环境，也没有要管理员权限的提示（管理员权限只在你走终端方式时才需要）。

真正卡人的是游戏侧的三个前提，我第一次运行时就踩了：

• 分辨率必须是1920×1080窗口模式（全屏是备选），游戏内语言设为简体中文；
• 关掉一切会改变画面的东西：HDR、N 卡游戏滤镜、微星小飞机、游戏加加这类悬浮窗；
• 游戏窗口不能最小化，放第二显示器或后台标签页都行。

设置页里把游戏安装路径填对（默认指向C:\Program Files\Star Rail\Game\StarRail.exe，可自动探测），首页点「完整运行」，程序会按顺序处理兑换码、历战余响、清体力、每日实训到最后的奖励领取，已完成或还没刷新的内容直接跳过。跑通一次后，这台机器上它基本就是"开机挂着"的状态了。macOS、Linux、Android 没有本地游戏，但都能走云游戏模式，甚至 Docker，后面会讲。

它替你做了什么：一天与一周的时间线

体力上限 300，日常刷新时间是每天凌晨 4 点，周常在周一 4 点刷新——程序的调度就围着这两个时钟转。

每一天：定时任务触发后，程序先领兑换码，检查历战余响和当日实训，然后按你在设置里配好的副本刷体力——默认配置是「拟造花萼（金）×24 次」，一次把 300 开拓力花干净，随后完成每日实训、处理委托、收取全部待领奖励。整个循环从启动到结束大约十几分钟。

每一周：周一刷新后，完整运行会接着补周常——混沌回忆、虚构叙事、末日幻影，以及模拟宇宙 / 差分宇宙、货币战争。刷到体力上限或全部通关为止，差分宇宙和模拟宇宙还能配成循环模式反复刷遗器经验（每周上限 100 只精英怪）。

粗算一下时间账（参考社区实测数据）：

调一调，更好用：几个场景化配置

以下都能在设置页或 config.example.yaml 里找到对应项。

定时启动 + 跑完就睡。把loop_mode设为scheduled，在「定时任务」里加一条 04:30 的完整运行；任务冲突策略建议留skip（已有任务在跑就不重复触发）。再把after_finish设成Sleep或Shutdown，程序干完活自己把机器睡了，全程不用碰。旧版单一定时字段会自动迁移成新的scheduled_tasks结构，不用手动改。

多账号轮换。Windows 本地模式下「账号」页支持导出/导入账号：先进到角色站立的过场画面再点「导出当前游戏账户」，以后切换就选中目标点「导入」。配合定时任务，可以做到白天跑 A 号、凌晨跑 B 号。注意自动登录会保存密码，官方文档明确提示了这项的风险，自己掂量。

抽卡记录导出。设置里开启后按 SRGF / UIGF 标准导出（导出逻辑），可以直接喂给第三方抽卡统计站，不用手抄卡池。

跑完告诉我。module/notification/ 内置了 Telegram、钉钉、企业微信、PushPlus、Gotify 等二十多个渠道，任务完成或报错时推一条消息，报错还会附带现场截图——排查问题很省事。

没有 Windows 客户端。开启云游戏模式（cloud_game_enable）后，清体力、每日实训、差分宇宙都支持后台无窗口运行；锄大地和模拟宇宙仍要求前台全屏。

开发者视角：CLI、计划任务与目录结构

March7th Assistant.exe（以及March7th Launcher.exe）本身是个完整 CLI，常见用法：

March7th Assistant.exe -h # 查看帮助 March7th Assistant.exe -l # 列出全部任务 ID 与名称 March7th Assistant.exe main # 完整运行 March7th Assistant.exe daily # 只跑每日实训 March7th Assistant.exe --workflow-name "流程名" # 运行图形界面里编排的自定义流程

想接 Windows 任务计划程序的话：新建任务 → 操作选「启动程序」→ 程序填March7th Assistant.exe的完整路径，参数填main或任意任务 ID，触发器按天设置即可。图形界面「设置 → 杂项」里的「在用户登录时启动」本质也是注册计划任务实现的，且是静默提权、不弹 UAC。

代码结构按"任务 / 能力 / 支撑"分层，看源码时可以从这几个入口进：

• tasks/：任务实现，按daily/、weekly/、challenge/、reward/划分，main的执行顺序就在 main.py 的run_main_actions里，一目了然；
• module/automation/：截图采集、模板匹配与点击动作的底层，module/ocr/ 是文字识别；
• module/notification/：各推送渠道，继承同一个 notifier 基类，加新渠道成本很低；
• assets/config/workflows/：流程编排的 YAML 定义，配合--workflow-name使用；
• utils/：日志、定时、版本等通用工具，测试都在 tests/ 下，pytest可直接跑。

踩坑与排查：常见故障现象与修复

提示「窗口找不到」或整局识别失败→ 原因基本是游戏侧环境不达标：游戏内语言不是简体中文，或分辨率不是 1920×1080，或开着会改变画面的东西。先改语言、锁分辨率，再逐一关掉 HDR、游戏滤镜和悬浮窗。日志里出现「检测到疑似监控悬浮窗文字」时，几乎可以确定是后者，用工具箱「游戏截图」能看到程序实际拿到的画面。

杀毒软件把文件删了、启动一闪而过→ 小助手会被 Windows Defender 等误报。把整个目录加入排除项（Defender 路径：病毒和威胁防护 → 管理设置 → 添加排除项），重新解压覆盖；如果开了「智能应用控制」，需要一并关掉。想定位具体报错就改用管理员终端启动，能看到完整的异常输出。

长时间运行后内存持续上涨、游戏无响应→ 多数与 OCR 加速模式有关。默认在 Windows 上走 DirectML GPU 加速，遇到这类症状就把「设置 → 杂项 → OCR 加速模式」手动切到CPU (ONNXRuntime)再试；问题消失就保持该模式，属于环境兼容性差异，不是程序 bug。

导出的账号 UID 和实际账号对不上→ 导出时机太早，读到了上一个账号的残留数据。务必等角色完全出现在大世界中再执行导出；切号后行为怪异时用账号页的「清除注册表」清一遍本机残留。

更多情况可以先翻 FAQ 和 使用教程，里面覆盖的条目比上面多得多。

安全与合规：原理与边界

回到开头那句话：它看到的是画面，动的是"鼠标和键盘"，不接触游戏进程的内存与数据，这是它和注入类工具在原理上的分界线。即便如此，边界还是存在的——操作间隔、执行频率请保持在合理范围内；游戏大版本更新后 UI 坐标和识别模板可能失效，需要把工具更新到跟上的版本；至于使用自动化是否违反你所在渠道的服务条款，最终以官方规则为准，风险自担。把它当成"帮你省时间"的工具，而不是绕开游戏设计的手段，这个度就比较好把握。

获取方式：下载、源码与 Docker

• 直接下载：到项目 Releases 页下载March7thAssistant_full.zip/.7z完整包，解压双击March7th Launcher.exe即可。
• 源码运行：需要 Python 3.12+，git clone --recurse-submodules https://gitcode.com/gh_mirrors/ma/March7thAssistant之后pip install -r requirements.txt，图形界面用python app.py，命令行用python main.py；也支持uv sync工作流。
• Docker 部署：仅支持云游戏模式，amd64/arm64 均可，1G 内存起步。docker compose up -d首启登录一次云游戏账号即可，详见 Docker 教程。Android 上还有 Termux 方案，参考 Termux 文档。

结语

日常交给三月七，开拓留给你——这就是 March7thAssistant 想做的事。遇到问题可以直接提 Issue，想加功能的话先读一遍 CONTRIBUTING.md，社区对 PR 的态度一直是欢迎的。

【免费下载链接】March7thAssistant日常交给三月七，开拓留给你。《崩坏：星穹铁道》开源自动化助手。项目地址: https://gitcode.com/gh_mirrors/ma/March7thAssistant