三月七小助手安装配置完整教程：星穹铁道日常自动化从跑通到稳定运行

三月七小助手安装配置完整教程：星穹铁道日常自动化从跑通到稳定运行

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

三月七小助手是一款《崩坏：星穹铁道》的开源自动化助手，把清体力、每日实训、领奖励、周常这些重复劳动接走，让你只花时间玩真正想玩的内容。它的原理一句话就能说清：用图像和 OCR 认出屏幕上的按钮与文字，再模拟鼠标键盘去操作游戏。本文只解决两件事：怎么把它跑起来，怎么让它长期跑得稳。

图：三月七小助手主界面，左侧任务区与右侧设置面板，即本文涉及的全部日常自动化入口。

适合谁用

• 时间碎片化的玩家：把完整运行排进凌晨 4 点的定时任务，加班也不会漏掉当天的日常；
• 多账号管理者：几个号按顺序批量跑完，节奏统一，减少漏领和误点；
• 把时间花在配装与战斗上的玩家：资源收集交出去，精力留给构建与攻略。

收益可以核对：三月七小助手的「完整运行」一次串行覆盖日常、体力、周常、奖励四类任务，配合凌晨 4 点的定时触发，一天的固定流程全部无人值守完成。

环境检查

动手前逐条核对，缺任何一条后面都会直接报错：

• Windows 系统：本地游戏模式仅支持 Windows，macOS、Linux、Android 只能跑云游戏模式；
• 游戏处于 1920×1080 窗口模式、游戏内语言为简体中文：任何一项不满足，程序会直接报"窗口找不到"；
• Python 3.12 或更高版本：仅源码运行需要，用发布包可忽略；
• 滤镜、帧率监控、护眼模式等悬浮类软件全部关闭：它们会在画面上叠字，让识别失败；
• 杀毒软件不盯安装目录：否则文件会被删、启动变慢。

三步跑通

第一步，安装。依次执行这四行：

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

python app.py会直接拉起图形界面。

第二步，只改几个关键字段。示例配置在 assets/config/config.example.yaml，看这 5 项就够：

• game_title_name：游戏窗口标题，默认"崩坏：星穹铁道"；
• game_process_name：游戏进程名，默认 StarRail；
• game_path：StarRail.exe 的完整路径，别选成启动器；
• power_plan：清体力要刷的副本列表，格式为[副本类型, 副本名称, 剩余次数]；
• after_finish：任务完成后做什么，None 表示无操作。

不想手改文件的话，图形界面设置页里可以等价配置。

第三步，手动触发一次最小任务。在首页点「日常」，看着它依次走完清体力、每日实训、领奖励这条链路，日志浮窗跑到结尾无报错，就算通了。

能力一览

分类	覆盖内容	什么时候用
日常	清体力、每日实训、领奖励、委托、锄大地	每天触发一次，或挂凌晨 4 点定时
体力	按power_plan批量刷副本，可选分解四星及以下遗器	体力刷新后一次耗完
周常	历战余响、货币战争、差分宇宙、混沌回忆、虚构叙事、末日幻影	周一凌晨 4 点周常刷新后
奖励	邮件、成就、派遣、无名勋礼、活动奖励	完整运行收尾时自动领取

两个容易被忽略的机制：每次运行前程序都会自动判断，已完成或未刷新的内容直接跳过（日常每天凌晨 4 点刷新，周常每周一凌晨 4 点刷新），所以一天内重复触发是安全的；云·星穹铁道和 Docker 方式支持无窗口后台执行，跑完的结果能推到 Telegram、邮件等渠道。

图：三月七小助手在终端环境跑通并领取奖励的日志，对应上文"后台运行＋推送"的说法。

它是怎么工作的

核心代码在 module/ocr/ 和 module/automation/，拆成两件事：

• 先识别再点击：不记固定坐标，而是持续截取画面，用 OCR 和图像匹配认出按钮、文字，再决定点哪里；
• 重试而不是硬点：元素查找支持多次重试，两次重试之间默认等 1.0 秒，遇到加载画面会先等完再动。

真正翻车的场合基本只剩两种：游戏大改版面，或者屏幕被别的软件盖住。前者靠更新工具解决，后者靠关掉悬浮层解决。

稳定运行的 5 个习惯

1. 窗口与语言保持默认：1920×1080 窗口模式＋简体中文，这是硬性条件，动了识别直接报错。
2. F 键和 C 键别改：交互 F、角色详细 C 必须保持游戏默认；其他按键若改过，去"设置 → 杂项 → 修改按键"里同步。
3. 画面保持干净：帧率显示、滤镜、性能监控、护眼模式全关，叠字是识别失败的头号来源。
4. 运行期间不碰键鼠：本地模式依赖当前桌面画面，确实要后台就换云·星穹铁道方案。
5. 首跑全程盯一遍：开着日志浮窗完整跑一轮，确认每一步识别都正常，再交给凌晨 4 点的定时；大版本更新前备份一份配置。

故障速查表

症状	可能原因	处理动作
提示"窗口找不到"	游戏内语言非简体中文，或不是 1920×1080 窗口模式	把游戏内语言切到简体中文，窗口设为 1920×1080
识别一直失败，日志出现"检测到疑似监控悬浮窗文字"	Afterburner、游戏加加、护眼模式等在画面上叠层	彻底关掉这类软件，再用"工具箱 → 游戏截图"核对拿到的画面
不自动战斗、角色乱走	游戏内按键设定与工具假设不一致	在"设置 → 杂项 → 修改按键"同步键位，并确认"自动战斗和二倍速检测"开关已打开
新副本、新角色列表里没有	工具版本未更新	先更新到最新版；仍缺失时手动往assets/config/instance_names.json里补
启动慢、文件被杀毒删掉	安装目录被杀毒软件隔离	把三月七小助手文件夹加入信任区，重新解压覆盖一次

不想碰命令行的话，拿最新 Release 包解压、双击March7th Launcher.exe，先把「日常」这一个任务试跑通。流程一跑通，每天凌晨 4 点刷新之后的固定链路就都归它了，你手里留下的只有开荒的时间。

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