三月七小助手实战指南：10 分钟跑通星穹铁道全自动托管

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

三月七小助手是一款面向《崩坏：星穹铁道》的开源自动化助手，基于纯图像识别（只认屏幕、再模拟点击操作），自动完成星穹铁道清体力、每日实训、领奖励与周常挑战的全流程。它适合想拿回重复上线时间的玩家，也能以无窗口方式跑在云游戏、Docker、安卓 Termux 上。

下文按"装好→懂原理→用顺→排错→进阶"的顺序展开。

三月七小助手安装：两条路径与最小验证步骤

装好只需两条路：下载完整包双击即可，或克隆源码用 Python 启动，全程约 10 分钟，新手建议走前者。

路径一：完整包（新手推荐）。前往项目 Releases 页面，下载March7thAssistant_full.zip或.7z命名的完整包，解压后双击March7th Launcher.exe打开图形界面，同意免责声明即可，不需要任何命令行。

路径二：源码运行（进阶）。要求 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 main.py daily # 或直接在命令行执行"每日实训"

如果你习惯用uv管理依赖，uv sync一次即可，之后用uv run python app.py启动。

首次运行最小验证：先跑一次每日实训

不要一上来就放完整流程。先在首页任务卡片里选"每日实训"，确认程序能正确识别实训界面并跑完，说明识别链路已经打通，再逐步放开清体力、周常等任务。

纯图像识别凭什么可靠：不碰游戏文件的运行原理

三月七小助手只做两件事：截取游戏画面，模拟键鼠输入。它不读取游戏内存、不向进程注入任何代码，风险等级等同于真人在屏幕上点鼠标。

它的感知层由两部分构成：OCR（光学字符识别，把画面里的文字读成字符的技术，这里由 RapidOCR 提供并配合 ONNX Runtime / OpenVINO 加速）负责读取屏幕上的动态文字，比如剩余挑战次数、奖励状态；模板匹配（把当前画面和内置参照图比对、输出相似度分数）负责定位固定按钮。两者配合决定"下一步点哪里"。下图是它在安卓 Termux 中实际运行时的日志，可以看到每一步匹配给出的相似度：

这套原理的另一面是：凡是会改变画面的东西都会影响识别——分辨率、语言、悬浮窗。这一点在排错时非常关键。

星穹铁道清体力与自动领奖：一份 YAML 看懂全部玩法

图形界面几乎覆盖所有设置，想精确控制每个细节时，直接编辑 assets/config/config.example.yaml。这份文件每行都带中文注释，本身就是最好的说明书。一段有代表性的配置：

power_enable: true # 清体力总开关 power_plan: [["拟造花萼（金）", "回忆之蕾", 10], ["侵蚀隧洞", "睿治之径", 5]] # 副本类型、名称、次数 daily_enable: true # 启用每日实训 reward_mail_enable: true # 领取邮件奖励 reward_dispatch_enable: true # 领取委托 after_finish: Shutdown # 全部任务结束后自动关机

翻译成大白话就是：每天 4 点游戏刷新后，自动清 10 次回忆之蕾、5 次睿治之径，做完每日实训，领完邮件和委托奖励，然后直接关机。power_plan列表支持拟造花萼（金）、拟造花萼（赤）、凝滞虚影、侵蚀隧洞、饰品提取五类副本按你的优先级任意排列，默认还会按剩余次数自动更新并删除已完成计划，不用你每天手动维护清单。

日常入口推荐用完整运行：它会按顺序处理已启用且已刷新的兑换码、每日实训、清体力、混沌回忆、虚构叙事、末日幻影等任务，最后统一领取奖励，未开启或未刷新的自动跳过，是无人值守最省心的模式。只想跑单项任务时，直接用子命令，比如python main.py power单独清体力。

高频问题排查清单：新手最容易踩的 5 个坑

识别失败大多是环境问题，按下面 5 条顺序自查能解决多数问题：

1. 现象：提示"窗口找不到"或界面始终不识别。原因：游戏语言不是简体中文，或分辨率不是 1920×1080。解法：游戏语言改简体中文，窗口化切到 1920×1080；窗口被其他软件遮挡时先挪开。
2. 现象：日志出现"检测到疑似监控悬浮窗文字"，或频繁切换界面失败。原因：帧率监控、RTSS、游戏加加、N 卡滤镜、护眼模式等叠加或滤镜软件改变了画面。解法：全部关闭，再用"工具箱 → 游戏截图"确认程序抓到的画面干净。
3. 现象：角色乱跑、不自动战斗、不交互。原因：游戏内按键设置与小助手默认假设不一致。解法：把自动战斗、交互（F）、角色详细（C）、移动（WASD）恢复默认，F 和 C 不能改；改过其他键就到"设置 → 杂项 → 修改按键"同步。
4. 现象：运行中内存持续升高、游戏闪退。原因：默认 DirectML GPU 加速与当前环境不兼容。解法：把 OCR 加速模式切到CPU (ONNXRuntime)再跑一遍，问题消失就保持该模式。
5. 现象：双击 exe 窗口一闪而过，或文件被安全软件删除。原因：杀软误报。解法：把助手文件夹加入白名单/信任区后重新解压覆盖；要看具体报错就用管理员权限的 PowerShell 启动。

进阶玩法：定时跑之外的 5 个能力

如果"定时跑一轮"已经够用，下面 5 项值得逐个看：

• 🕐多个定时任务：scheduled_tasks列表可叠加多个任务，每个任务独立配置时间、参数、超时和完成后动作（关机/睡眠/运行脚本），冲突时可选"跳过"或"停止当前任务"。
• 📱多渠道消息推送：支持 Windows 原生通知、Telegram、Matrix、Server酱、Bark 等渠道，可附运行截图，任务完成、体力回满第一时间推送到手机。
• 随处可跑：云·星穹铁道支持无窗口后台运行，可用 Docker 部署在服务器上，也能在安卓 Termux 跑通；macOS / Linux 均可托管云游戏。
• 抽卡记录导出：按 UIGF / SRGF 标准导出到本地文件，数据随时带走。
• 工具箱：自动对话（自动跳过剧情、自动选择选项）、F9 一键切换、F10 停止任务、F8 暂停，外加每周分解四星及以下遗器，防止背包爆仓。

常见答疑：社区问得最多的 5 个问题

以下是社区出现频率最高的 5 个问题，答案都控制在 3 行以内。

Q1：用这种工具会封号吗？纯图像识别加模拟输入，不改内存、不注入进程，原理与真人操作一致。但任何自动化都有不确定性，建议频率适度、大型活动期间谨慎使用。

Q2：支持哪些系统？本地游戏模式仅支持 Windows（1920×1080 窗口）；云游戏模式支持 macOS、Linux、Docker 与安卓 Termux。

Q3：需要一直开着电脑守着吗？不需要。支持定时任务、体力回满自动启动，以及完成后关机/睡眠/关显示器，设好人走即可。

Q4：日志在哪里看，问题怎么反馈？图形界面内有日志页签，本地日志默认保留 30 天；反馈问题时附上问题当天的日志，维护者可直接定位。

Q5：运行中能切到后台干别的事吗？本地模式不建议运行中抢占键鼠或切后台；需要后台就走云游戏模式，清体力、每日实训、货币战争、差分宇宙等任务均支持后台运行。

下一步：从 Releases 下载最新完整包解压，在图形界面填入游戏路径保存，先试跑"每日实训"，确认识别无误后再放开完整运行。

延伸阅读：使用教程 ｜ 常见问题 ｜ 完整配置示例 ｜ Docker 部署 ｜ Termux 部署

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