March7thAssistant 完整指南：10 分钟上手的星穹铁道日常自动化工具

March7thAssistant 完整指南：10 分钟上手的星穹铁道日常自动化工具

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

March7thAssistant（三月七小助手）是一款面向《崩坏：星穹铁道》的开源自动化助手，口号是"日常交给三月七，开拓留给你"。它通过截图识别游戏画面、模拟真实鼠标键盘点击来完成操作，本质就是"看屏幕 + 点屏幕"，不修改游戏内存、不注入进程。项目覆盖清体力、每日实训、周常挑战、锄大地等重复内容，还支持云游戏后台运行、消息推送和定时启动，帮你把每天 1 小时以上的固定任务交给程序。

📌 能力一览

先用一句话概括每个模块能做什么：

• 日常自动化：清体力、每日实训、兑换码、委托、领取奖励、锄大地
• 周常挑战：历战余响、模拟宇宙、差分宇宙、货币战争、混沌回忆、虚构叙事、末日幻影
• 完整运行：一个入口按当前开关串行处理上述内容，已完成或未到刷新时间的自动跳过
• 云游戏模式：走浏览器控制云·星穹铁道，支持后台、无窗口甚至 Docker 运行
• 消息推送：任务完成或出错时推送到 Telegram、企业微信、钉钉、Bark 等二十多种渠道
• 工具箱：游戏截图检查、自动对话、解锁帧率、兑换码批量执行、触屏模式

差异化卖点在于本地与云游戏双模式：Windows 上可以直接驱动本地客户端，而 macOS、Linux、Docker、Android（Termux）用户也能通过云游戏模式用上全套功能。所有任务逻辑集中在 tasks/ 目录，按日常、周常、挑战、活动分类，代码可读性好，方便二次开发。

⚙️ 使用前的准备

运行前先确认三件事：系统平台、游戏环境、获取方式。

运行模式	Windows	macOS	Linux	Docker	Android (Termux)
本地游戏	支持	不支持	不支持	不支持	不支持
云游戏	支持	支持	支持	支持	支持

游戏环境方面，本地模式有硬性要求：

1. 使用 PC 客户端，以1920×1080 窗口模式运行，窗口不可用再选全屏
2. 游戏内语言必须为简体中文，其他语言会直接导致"窗口找不到"
3. 关闭帧率监控 HUD、微星小飞机、N 卡滤镜、HDR 等一切会叠加文字或改变画面的软件

获取方式有两种：新手建议去 Releases 下载March7thAssistant_full.zip完整包解压使用；想体验源码运行或参与开发的，再走克隆路线（见下一节）。

🚀 安装与首次运行

方式一：下载完整包（推荐新手）

1. 下载名称类似March7thAssistant_full.zip或.7z的完整包
2. 右键选择"全部解压缩"，解压后应能看到March7th Launcher.exe、March7th Assistant.exe、March7th Updater.exe、assets、libraries等文件
3. 双击March7th Launcher.exe，同意《免责声明》

方式二：源码运行

需要Python 3.12 或更高版本。Windows 下建议用管理员模式打开 PowerShell 或 CMD。

# 安装依赖（建议使用虚拟环境） git clone --recurse-submodules https://gitcode.com/gh_mirrors/ma/March7thAssistant cd March7thAssistant pip install -r requirements.txt

然后分别启动图形界面和命令行：

# 启动图形界面 python app.py # 执行完整运行（查看全部子命令：python main.py -h） python main.py

成功的标志：图形界面正常打开、首页出现"完整运行、每日实训、清体力"等任务卡片，并在日志中看到 OCR 引擎初始化成功的输出。命令行首次直接跑main.py会提示"首次使用请先打开图形界面"，这是正常流程，先配好 GUI 再跑任务。配置示例可参考 assets/config/config.example.yaml，所有配置项都有中文注释。

🎯 按场景的功能讲解

场景一：日常无人值守

什么时候用：你希望每天固定时间自动把日常清完，人不用盯着。

怎么配置：在首页勾选需要启用的任务（如"完整运行"），在设置 → 日志页定时任务中配置每天凌晨 4 点（日常默认刷新时间）启动"完整运行"，并设置完成后操作（退出游戏、关机等）。完整运行会自动跳过已完成和未到刷新周期的内容，日常 4 点刷新、周常周一 4 点刷新。

达到什么效果：开机挂机即可，任务结束后按配置自动退出游戏，并通过module/notification/里集成的推送渠道把结果发到你的手机。

场景二：周常挑战自动化

什么时候用：每周的混沌回忆、虚构叙事、末日幻影（统称"逐光捡金"）、差分宇宙、货币战争需要打。

怎么配置：先在设置 → 逐光捡金为每个挑战配置关卡范围和两队阵容；差分宇宙、货币战争只需在设置页开启"积分奖励"开关，完整运行就会按周常逻辑检查并补打。建议先把游戏内队伍配好——模拟宇宙、差分宇宙等会沿用游戏内记忆的配队。

达到什么效果：周一周常刷新后一次完整运行即可把周常内容按开关顺序处理完，积分奖励自动领取。

场景三：云游戏后台与多环境部署

什么时候用：没有 Windows 本地客户端，或者想 7×24 小时挂机、后台运行不打扰日常工作。

怎么配置：在设置 → 云·星穹铁道开启后，小助手改为浏览器控制云游戏执行任务；开启"无窗口模式"可实现后台运行（注意锄大地和模拟宇宙仍需前台全屏）。Docker 部署仅支持云游戏模式，拉取镜像后：

docker compose up -d

达到什么效果：清体力、每日实训、货币战争、差分宇宙等可在后台持续跑；macOS、Linux、树莓派乃至安卓手机（Termux）都能部署，部署细节见 assets/docs/Docker.md。

场景四：流程编排自定义自动化

现成任务覆盖不了的需求（比如某活动界面的固定连点、简单分支判断），可以用左侧导航栏的"流程编排"：把图片点击、文字点击、等待、按键、界面切换、消息推送等步骤拼起来，支持if、for、while等控制逻辑。建议先从"识别按钮 → 点击 → 等待 1 秒"这种短流程练手，用"执行选中步骤"逐节点调试。

💡 实用技巧与常见坑

几条能少踩坑的建议：

1. 遇到识别异常，先开工具箱 → 游戏截图，看程序实际采到的画面是否干净，这能排除一半问题
2. 异常排查时把日志等级从"简洁"切到"详细"
3. OCR 加速模式建议保持"自动"；只有内存异常或闪退时才手动切到CPU (ONNXRuntime)
4. 定时任务以系统分钟变化为触发点，GUI 启动所在的分钟不补跑，请提前启动程序

高频问题的排查路径：

现象	原因	解决办法
提示"窗口找不到"	游戏语言不是简体中文	把游戏内语言切回简体中文
识别失败 / 切换界面失败	滤镜、性能监控悬浮窗遮挡或改变画面	关闭 N 卡滤镜、HDR、小飞机、护眼模式等
内存持续升高、闪退	OCR 加速模式与当前环境不兼容	切到CPU (ONNXRuntime)重跑
运行时键盘鼠标被占用	本地模式依赖当前桌面输入	改用云游戏后台模式
启动失败、文件被删	杀毒软件误删	将小助手文件夹加入排除项/信任区

更完整的问题清单见 assets/docs/FAQ.md。

❓ FAQ

Q：这种模拟操作安全吗，会被封号吗？

项目走纯图像识别加模拟点击路线，不碰游戏内存和客户端文件，代码完全开源可自查。但任何自动化工具都无法承诺零风险，建议控制每日使用时长，避免在活动高峰期长时间运行。

Q：完整运行到底会做哪些事？

按当前设置只执行"已启用且已刷新"的内容，通常包括兑换码、每日实训、活动、历战余响、清体力、货币战争/差分宇宙积分奖励、锄大地、模拟宇宙/差分宇宙、混沌回忆、虚构叙事、末日幻影和领取奖励。

Q：后台运行支持哪些任务？

云游戏模式下，清体力、每日实训、货币战争、差分宇宙等支持后台运行；锄大地和模拟宇宙仍需要前台全屏。

Q：游戏更新后缺少新副本或新角色怎么办？

先更新到最新版本；仍缺副本可编辑assets/config/instance_names.json手动添加，缺角色头像则用工具箱截图功能保存到assets/images/share/character并更新assets/config/character_names.json。

Q：支持多账号吗？

Windows 本地模式有"账号管理"页，支持导出/导入/切换本地账号（不支持云游戏）；注意要完整进入大地图后再导出，否则会读到上一个账号的 UID。

📚 小结

March7thAssistant 把星穹铁道的日常和周常收进了一个图形界面里，本地、云游戏、Docker 多环境都能跑，配合消息推送和定时任务基本可以做到无人值守。想深入细节，可以从仓库内的使用教程、FAQ 和 assets/docs/Docker.md 入手，也欢迎到项目社区讨论或提交 PR。

使用提示：本地模式运行时请勿抢占键盘鼠标或切换窗口；第一次使用建议先跑 10 分钟"完整运行"观察日志，确认识别正常后再交给定时任务。

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