4 步跑通星穹铁道自动化助手：March7thAssistant 完整使用教程

4 步跑通星穹铁道自动化助手：March7thAssistant 完整使用教程

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

每晚花 40 分钟清体力、领委托、收邮件，一周下来就是大半天。March7thAssistant（三月七小助手）是《崩坏：星穹铁道》的免费开源自动化助手：模拟键鼠替你跑掉这些重复操作，你只负责开拓。它不改内存、不注入进程，后文统一说明原理与边界。

🛡️ 原理与安全保障

它的工作方式：

  1. 以独立进程运行在游戏之外，截屏采集画面；
  2. 用 OCR（RapidOCR）加图像模板匹配定位按钮与文字；
  3. 通过pyautogui等发出真实鼠标键盘事件；云游戏模式下经浏览器 CDP 事件驱动云端画面（见 module/automation/）。

它不修改游戏内存、不注入进程、不改写客户端文件，输入之间有固定等待（按键默认wait_time=0.2秒，见 module/automation/local_input.py）。对账号而言，操作节奏接近真人；安全声明集中在此，全文不再重复。

🖥️ 运行环境准备

系统要求：本地游戏模式仅支持 Windows，且以 PC 客户端 1920×1080 窗口运行；macOS、Linux、Docker、Android 均走云游戏模式。

获取项目（任选其一）：

  1. Windows 从 Releases 下载完整包（March7thAssistant_full.zip/.7z），右键"全部解压缩"。
  2. 源码运行：需要 Python 3.12+，git clone --recurse-submodules https://gitcode.com/gh_mirrors/ma/March7thAssistant，然后pip install -r requirements.txt。
  3. Docker：仓库自带 docker-compose.yml 与 Dockerfile，仅支持云游戏模式，文档见 assets/docs/Docker.md。

首次启动：

  1. 游戏设为 1920×1080、语言简体中文；
  2. 关闭帧率监控 HUD、微星小飞机、游戏加加、HDR、N 卡滤镜等一切叠加画面的软件；
  3. 双击March7th Launcher.exe打开图形界面，同意免责声明；
  4. 源码方式则python app.py启动图形界面。

移动端 / Docker 分支：Android 可装 Termux 运行云游戏模式，见 assets/docs/Termux.md；Docker 镜像默认每天凌晨 4:00 自动完整运行并循环等待。

🎯 功能全景：按你的目标找入口

把日常清完

  • 清体力：按副本类型自动算次数，支持后备开拓力、燃料、培养目标（tasks/daily/）
  • 每日实训：先识别未完成的实训项再逐个完成
  • 锄大地：集成 Fhoe-Rail 自动跑图收材料
  • 领取奖励：委托、邮件、支援、每日实训、无名勋礼、兑换码等分别开关（tasks/reward/）

把周常打满

  • 历战余响 / 货币战争 / 差分宇宙：按周刷新自动处理积分奖励（tasks/weekly/）
  • 模拟宇宙 / 差分宇宙：支持"运行一次、循环运行、中途接管"（tasks/challenge/）
  • 逐光捡金：混沌回忆、虚构叙事、末日幻影，各自配关卡范围与两队阵容

把抽卡数据管起来

  • 抽卡记录：导入导出 UIGF / SRGF 标准 JSON，可对接 StarRail Warp Export 等工具（app/tools/warp_export.py）

多账号轮转

  • 账号页（仅 Windows）：导出/导入账号、更名、自动登录
  • 消息推送：30 余种渠道（Telegram、Bark、企业微信、Webhook……）（module/notification/）
  • 定时任务：按星期、超时、完成后推送与关机（app/schedule_dialog.py）

⚙️ 按你的情况定制

场景一：无人值守清日常

  1. 首页跑一次完整运行（默认只执行"已启用且已刷新"的内容，日常刷新为凌晨 4 点）；
  2. 在"日志"页配置定时任务，program填self、args填main；
  3. 该条任务设超时与"任务完成后"操作（如Shutdown）。

场景二：定点刷材料

  1. "体力与日常设置"里选副本类型、副本名称；
  2. 打开"启用清体力"，按需勾选后备开拓力与燃料；
  3. 开启支援角色（tasks/power/ 相关字段在 assets/config/ 的borrow_enable）；
  4. 需要时单独跑power，不触发其他任务。

场景三：云游戏后台挂机

  1. "杂项"中开启"使用 云·星穹铁道"；
  2. 打开"无窗口模式"，清体力、每日实训等任务即可后台跑；
  3. 注意：锄大地与模拟宇宙仍需前台全屏。

🚀 进阶与扩展

配置文件关键字段（完整示例见 assets/config/config.example.yaml）：

power_enable: true power_plan: [["拟造花萼（金）", "回忆之蕾", 10]] instance_type: 拟造花萼（金） borrow_enable: true reward_enable: true reward_dispatch_enable: true reward_mail_enable: true loop_mode: scheduled

命令行常用参数（-h查全量，-l列任务）：

March7th Launcher.exe -l March7th Launcher.exe main March7th Launcher.exe daily March7th Launcher.exe power

任务逻辑按目标分目录：tasks/daily/、tasks/weekly/、tasks/challenge/、tasks/power/、tasks/reward/。

🔧 问题排查手册

启动失败（窗口一闪而过 / 打不开界面）：改用管理员模式的 PowerShell 或 CMD 启动，先看真实报错；把整个目录加入杀毒软件排除项后重新解压覆盖；确认游戏路径指向StarRail.exe本体而不是启动器launcher.exe。

任务卡住 / 识别失败：关掉一切悬浮窗与滤镜，用"工具箱 → 游戏截图"检查实际采集到的画面；确认游戏语言为简体中文；不要改动交互（F）与角色详细（C）两个默认按键；打开"启用自动战斗和二倍速检测"。

内存升高 / 闪退：把"OCR 加速模式"从自动改为CPU (ONNXRuntime)重试；日志等级调为DEBUG便于定位。

操作权限：本地模式运行中不要抢占键鼠、不要切后台——自动化依赖桌面画面；需要挂机就切云游戏模式，或改用远程多用户桌面。

系统兼容：macOS / Linux 本地跑不了，走云游戏 + Docker；Docker 环境可用内存 1GB 起，浏览器报错可删3rdparty/WebBrowser/UserProfile后重启容器（详见 assets/docs/Docker.md）。

📋 使用守则

  • 操作间隔：保持默认节奏（按键wait_time=0.2秒、输入interval=0.1秒），不要通过改代码提频。
  • 配置备份：升级前备份 assets/config/ 下你的config.yaml；新副本可手动补instance_names.json。
  • 版本更新：游戏大版本会改界面，小助手要同步升级——设置页底部"检查更新"或双击March7th Updater.exe。
  • 合规边界：仅用于自己账号的日常代打，不商用、不违反游戏服务条款。本项目免费开源，若有人向你收费，那是倒卖，请举报。

重复的交给三月七，开拓留给你。

获取渠道：Windows 从 Releases 下载完整包；源码运行git clone https://gitcode.com/gh_mirrors/ma/March7thAssistant；服务器与 mac/Linux 走 Docker 部署。

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考