March7thAssistant 使用指南：5 分钟让星穹铁道日常自动跑起来

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

March7thAssistant 是一个《崩坏：星穹铁道》的开源自动化助手，把清体力、每日实训、兑换码、历战余响、混沌回忆、差分宇宙、货币战争这类重复劳动交给程序完成，完成后还能把结果推送到 Telegram、邮箱或企业微信。作者给它的定位一句话就能说清：日常交给三月七，开拓留给你。

先交代两个前提，方便你判断自己能不能用：本地游戏模式目前仅支持 Windows，游戏需以 1920×1080 窗口模式运行、语言为简体中文；如果你用的是 macOS、Linux 甚至安卓（Termux），可以走云·星穹铁道模式。本文按「它是谁 → 怎么跑起来 → 它怎么工作 → 卡住了怎么办」的顺序讲，跟着走完大约 5 分钟。

重复的体力与周常：它替你做的那件事

想象一下每个凌晨 4 点：开拓力回满，日常任务刷新，接下来是领奖励、打副本耗体力、刷历战余响；周一早上还要叠加混沌回忆、虚构叙事、末日幻影和模拟宇宙、差分宇宙、货币战争的积分奖励。手动做，每次流程基本不变，但你得坐在屏幕前点完全程，人还会累、会走神、会卡在某一步不知道点哪。

March7thAssistant 的处理方式是把流程固定成程序。首页的「完整运行」是最推荐的入口：它按你勾选的开关，串行处理兑换码、每日实训、清体力、历战余响、周常挑战和奖励领取；已经完成的、还没刷新的内容会自动跳过。清体力时它会按你的开拓力自动计算挑战次数，配合后备开拓力、燃料和支援角色一起生效。跑完之后你可以设置退出游戏、关机、睡眠，或者只推一条通知过来。你只需要偶尔看一眼推送。

5 分钟从源码跑起来

不想折腾的话，直接去 Releases 下载完整包，解压后双击March7th Launcher.exe就行。下面是源码运行路线，需要 Python 3.12 或更高版本，推荐在 Windows 上做。

git clone --recurse-submodules https://gitcode.com/gh_mirrors/ma/March7thAssistant cd March7thAssistant pip install -r requirements.txt python app.py

如果已经装了uv，可以改用项目自带的pyproject.toml工作流：

uv sync uv run python app.py

图形界面起来之后，再补三件事：确认游戏语言是简体中文；确认游戏以 1920×1080 窗口模式运行；关掉帧率监控 HUD、微星小飞机这类会在画面上叠加文字的悬浮窗。满足这三点，绝大多数识别问题都会消失。

它如何认出按钮和文字

理解了下面三点，基本就理解了这个项目的所有机制。

看屏幕，不碰游戏。它全程不注入游戏进程，工作方式就三步：高频截屏拿画面，用 OpenCV（一个开源的图像处理库）做模板匹配——把画面裁出一小块，和项目里预存的按钮截图比对，就能定位「跳过」「开始战斗」这类按钮；再用 RapidOCR（一个本地运行的文字识别工具）读懂画面上的数字和文本，比如当前剩多少开拓力。所有裁剪坐标都以 1920×1080 为基准存成比例值，分辨率变化时按比例换算，这也是为什么官方强调按这个分辨率跑。

动作靠模拟键鼠。识别到目标后，它通过键盘、鼠标库发出点击和按键事件，相当于替你动手，游戏本身没有任何改动。每个输入动作外面还包了一层暂停卡点，你按下暂停，所有按键会停在发出之前，方便中途接管。

状态机决定什么时候点。自动对话是最典型的例子：引擎有「未启动 → 监控中 → 对话中 → 等待选项」四个状态，只有进入剧情界面才开始循环点击，一旦检测到右侧出现对话选项就停下，等你手动选择。本地模式直接操作桌面键鼠，云·星穹铁道模式则通过浏览器控制云游戏画面，因此清体力、每日实训等任务可以后台无窗口运行；锄大地和模拟宇宙仍需前台全屏。

跑不动时的排查清单

🔧 这三个是官方 FAQ 里最高频的卡点，按顺序查基本能解决。

1. 识别失败、提示切换界面失败。先处理所有会改变画面的东西：N 卡游戏滤镜、HDR、帧率监控、游戏加加，以及部分笔记本自带的面板色彩优化——它们哪怕没有明显悬浮窗，也会改变画面的颜色和对比度。然后打开小助手「工具箱 → 游戏截图」，直接看程序实际采到的画面干不干净。日志里如果出现了「检测到疑似监控悬浮窗文字」，问题基本就坐实了。另外游戏语言不是简体中文也会导致窗口找不到。

2. 内存持续升高、游戏无响应或闪退。优先怀疑 OCR 加速模式。默认是「自动」：Windows 10 18362 及以上走 ONNXRuntime DirectML 的 GPU 加速，其余环境回落到 OpenVINO 或 ONNXRuntime CPU。出问题时把它手动切成「CPU (ONNXRuntime)」（设置 → 杂项 → OCR 加速模式），这是兼容性最好的一档，切完重跑观察是否好转。

3. 运行时不能动键盘鼠标、不能切后台。这是本地模式的特性：它依赖当前桌面的画面和输入状态，运行期间抢占键鼠会直接打断任务。有后台挂机需求就走云·星穹铁道模式，清体力、每日实训、货币战争、差分宇宙都支持后台运行。

更多细节建议翻仓库里的 assets/docs/FAQ.md，更新缓慢或窗口一闪而过的情况也有对应条目。

反馈与参与

遇到问题，先看 FAQ，再到仓库的 Issue 区反馈；讨论可以进项目 README 里给出的 QQ 群、Telegram 群或 GitHub Discussions。想动代码的话，请先读一遍 CONTRIBUTING.md——它对「一个 PR 只做一件事」和多语言规范有明确要求，提交前用uv run pytest跑一遍测试。锄大地和模拟宇宙分别调用的是 3rdparty/Fhoe-Rail 与 3rdparty/Auto_Simulated_Universe，改到这两块时先去看它们自己的文档。当前版本 v2026.10.16 的完整改动记录在 assets/docs/Changelog.md。

如果你也被每天的体力刷新闹钟支配，不妨按上面的步骤试一次「完整运行」。有 bug 去提 Issue，有想法去开 PR，哪怕只是补一张新副本的截图配置，对维护者都是实打实的帮助。

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