三月七小助手快速上手教程：3步跑通星穹铁道自动清体力与日常任务
【免费下载链接】March7thAssistant日常交给三月七，开拓留给你。《崩坏：星穹铁道》开源自动化助手。项目地址: https://gitcode.com/gh_mirrors/ma/March7thAssistant
March7thAssistant（三月七小助手）是一款《崩坏：星穹铁道》的开源自动化助手，把清体力、领奖励、周常挑战这些重复劳动交给程序，你只管收菜。适合想省出每日 20 分钟日常时间的星穹玩家，尤其是多账号、想挂机定时运行的用户。
两个真实场景，先看看它能干什么
场景一：下班前你顺手点了一下"完整运行"，程序自动清完开拓力、领完邮件和委托奖励，手机上的 Server酱 推送了一条"日常完成"。到家打开游戏，体力是 0，奖励一个不少。
场景二：你配置了定时任务，每天凌晨 4 点游戏刷新后程序自动启动，清完体力自动关闭游戏，甚至自动休眠。第二天早上起来，日常已经做完了。
环境要求与3步启动
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10/11（64位）；云游戏模式也支持 macOS / Linux / Android |
| Python | 3.12 及以上 |
| 游戏 | PC 客户端，1920×1080分辨率，游戏内语言为简体中文 |
启动只需 3 步，打开终端依次执行：
- 克隆项目（注意
--recurse-submodules，模拟宇宙依赖子模块）：git clone --recurse-submodules https://gitcode.com/gh_mirrors/ma/March7thAssistant && cd March7thAssistant - 安装依赖：
pip install -r requirements.txt - 启动图形界面：
python app.py；不想开界面直接跑完整运行就用python main.py
首次运行会生成配置文件，跟着图形界面的引导把游戏路径填好即可。如果你用的是发行版安装包，解压后双击March7th Launcher.exe就是同样的效果。
按目标来：用它自动化什么
清体力：一天最值钱的 10 分钟
这是小助手最核心的能力。它在配置里对应power_enable（日常任务模块），可以设置副本类型（拟造花萼（金）/赤、凝滞虚影、侵蚀隧洞、饰品提取）、偏好地区（如雅利洛-VI 出遗器），打之前还会自动合成浸沉器。默认行为是把开拓力刷到 0，刷完自动收工。
收奖励：委托、邮件、实训一个不漏
reward_*系列开关默认全部开启：每日实训、委托、邮件、支援、无名勋礼、兑换码都会被自动领取。如果你常用好友的支援角色，把borrow_enable打开即可。建议保持reward_enable: true不动，这一层基本是纯收益。
周常自动化：模拟宇宙与差分宇宙
- 模拟宇宙 / 差分宇宙：开启
universe_enable，可选手动周期演算或常规演算，程序会记录上次运行时间，避免一周内重复刷。 - 历战余响：
echo_of_war_enable: true后，每周优先打满 3 次历战再清体力。 - 这些功能复用游戏内记忆的配队，所以进游戏前先手动把队伍摆好，能少省很多事。
进阶玩法：云游戏把 PC 解放出来 🌤️
没有 PC、或者想让任务跑在另一台机器上？开启cloud_game_enable走"云·星穹铁道"，清体力、实训、差分宇宙都支持后台运行，甚至无窗口运行。在 Android 手机上通过 Termux 也能部署，参考 Termux 部署文档：
值得调的 3 个参数
不用翻遍几百行配置，先动这几个，收益最大（均在 config.example.yaml 中）：
| 参数 | 默认值 | 建议值 | 效果 |
|---|---|---|---|
after_finish | None | "Sleep"或"Shutdown" | 跑完自动休眠/关机，配合定时任务实现"睡一觉起来日常已清" |
use_fuel/use_reserved_trailblaze_power | false | true | 清体力时优先烧燃料和后备开拓力，省下的开拓力留给手动玩的副本 |
break_down_level_four_relicset | false | true | 每周自动分解四星及以下遗器，背包不再爆仓 |
避坑指南：4 个高频问题
1. 现象：提示"未找到游戏窗口" → 原因 → 解法终端没用管理员模式打开，或游戏路径没填对。用管理员权限打开终端，把配置里的game_path手动指向StarRail.exe的绝对路径，游戏以 1920×1080 窗口模式运行。
2. 现象：任务中途识别失败、反复"切换界面失败" → 原因 → 解法N 卡滤镜、微星小飞机、RTSS、游戏加加这类悬浮窗会遮挡或改变画面，OCR 直接失灵。全部关闭后重试；日志里若出现"检测到疑似监控悬浮窗文字"，基本就是这个原因。
3. 现象：模拟宇宙不启动、报缺少依赖 → 原因 → 解法克隆时漏了子模块。执行git submodule update --init --recursive，然后在图形界面里确认模拟宇宙依赖已安装（对应配置项universe_requirements）。
4. 现象：不会自动战斗、角色乱跑 → 原因 → 解法你的按键设置和程序默认假设不一致。到"设置 → 热键"里把自动战斗、地图、跃迁按键调成和实际按键一致，默认假设是v/m/f3。
适合谁，去哪找帮助
如果你每天愿意花 20 分钟做日常，或者手里有多个账号，这套流程跑起来后这部分时间基本归零。遇到具体问题，建议先翻 使用教程 和 FAQ，覆盖绝大多数报错；想玩 Docker 或远程桌面挂机可以看 Docker 部署文档。跑通之后，把after_finish设成休眠，剩下的就交给三月七了。
【免费下载链接】March7thAssistant日常交给三月七，开拓留给你。《崩坏：星穹铁道》开源自动化助手。项目地址: https://gitcode.com/gh_mirrors/ma/March7thAssistant
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
