三月七小助手使用指南：星穹铁道日常清体力一键搞定，从安装到深度定制
【免费下载链接】March7thAssistant日常交给三月七，开拓留给你。《崩坏：星穹铁道》开源自动化助手。项目地址: https://gitcode.com/gh_mirrors/ma/March7thAssistant
每天下班回家打开《崩坏：星穹铁道》，清体力、收邮件、打每日实训、领委托奖励……这些重复操作一天下来要吃掉你二十分钟。March7thAssistant（三月七小助手）就是为此而生的开源挂机助手：把"日常交给三月七"这句话变成现实——它自动启动游戏、清空开拓力、领取奖励、跑周常挑战，还能在完成后把结果推送到你的手机。本文面向两种读者：只想点两下就跑起来的普通玩家，以及想搞懂它怎么自动化的进阶用户。
能力全景：哪些事可以彻底交给它
不看代码，只按使用场景分三档：
日常档：每天自动做的杂活
- 清体力（拟造花萼、侵蚀隧洞、凝滞虚影、饰品提取，支持自定义副本顺序与连续挑战次数）
- 每日实训、历战余响、邮件与委托奖励、成就奖励、支援奖励、兑换码兑换
- 锄大地（调用 Fhoe-Rail 子项目，按地图自动刷材料）
进阶档：每周/每周期的大活
- 混沌回忆、虚构叙事、末日幻影：配置关卡范围 + 双队伍模板，自动打满
- 差分宇宙、模拟宇宙：模拟宇宙调用 Auto_Simulated_Universe 子项目
- 货币战争：支持标准/超频模式、职级难度、速通策略与特殊词条重开
- 每周遗器清理与分解（含可选的智能弃置）
生态档：让它变成一个"服务"而不是一个脚本
- 云·星穹铁道支持：后台运行、无窗口（Headless）运行，甚至塞进 Docker 常驻
- 任务完成后推送通知：Telegram、Server 酱、钉钉、企业微信、Bark、SMTP 邮箱等十余种渠道
- 体力回满或每日刷新后自动启动，跑完可播放提示音、关游戏、关机/休眠/重启
- 工具箱：自动对话（跳剧情、选选项、战斗检测）、解锁帧率、抽卡记录导出（UIGF / SRGF 标准）
一张速览表方便你对照自己的需求：
| 你的需求 | 对应能力 | 大致入口 |
|---|---|---|
| 每天清完体力收奖励 | power/routine/daily任务 | 图形界面一键，或python main.py |
| 每周三副本打满 | forgottenhall/purefiction/apocalyptic | 设置中开开关 + 配队伍 |
| 差分宇宙/模拟宇宙刷积分 | divergent/universe | 3rdparty 子模块 + 周常开关 |
| 人在手机不在电脑前 | 云游戏 + Docker 常驻 | cloud_game_enable或容器化部署 |
| 跑完想收到通知 | notify_*系列 | 任选一个渠道填 token 即可 |
| 自定义操作序列 | 流程编排（Workflow） | --workflow-name运行 |
30 秒上手：最快跑起来的那条路
不折腾 Python 环境的话，走发布包：
- 到项目 Releases 页下载最新压缩包，解压；
- 双击三月七图标的
March7th Launcher.exe； - 在设置页填好游戏路径，回到任务页点"完整运行"。
就这么三步。界面是 PySide6 搭建的图形界面，设置项全部可视化，新手 90% 的需求不用碰配置文件。
如果你手边只有命令行环境（比如已经 clone 了仓库），最简执行路径是：
:: 先启动一次图形界面完成初始化 python app.py :: 然后执行完整运行（清体力 + 每日实训 + 领奖励） python main.py :: 只看每日实训 python main.py daily一个小提醒：从源码运行时，main.py检测到"从未初始化"会直接拒绝执行并提示你先打开图形界面，这是它自己的保护逻辑，照着做即可。
两种玩法：桌面党 vs 极客党
桌面党（发布包）：适合"我只要它每天帮我干活"的人。
- 优点：解压即用，自带更新器（
March7th Updater.exe），界面引导完整，出问题先看 FAQ 基本都能找到答案。 - 代价：版本更新依赖发布节奏；想魔改内部行为时不方便。
极客党（源码版）：适合想加自定义逻辑、跑 Docker、或者贡献代码的人。
- 环境要求 Python 3.12+，
pyproject.toml里有完整声明；仓库还内置了uv工作流，依赖锁定在uv.lock。 - 装好后两条命令分别对应界面与命令行：
python app.py与python main.py。 - 更新方式：
git pull之后别忘了git submodule update --init --recursive，模拟宇宙和锄大地是两个 git submodule，漏掉这一步这两个功能就废了。
用uv的极客党可以把安装压缩成一条：
git clone --recurse-submodules https://gitcode.com/gh_mirrors/ma/March7thAssistant cd March7thAssistant uv sync之后所有命令都加uv run前缀，例如uv run python main.py daily。
还有一个隐藏身份：Android 上的 Termux。官方专门写了 Termux 部署文档（assets/docs/Termux.md），手机上也能跑起来挂机，效果类似这样：
深度定制：你想改什么，就改哪里
所有开关都收敛在根目录的config.yaml（首次启动从assets/config/config.example.yaml生成）。下面按"改什么 → 改哪里 → 为什么"讲几个高频项。
改"跑完之后的行为"
after_finish: None # None/Exit/Loop/Shutdown/Sleep/Hibernate/Restart/Logoff/TurnOffDisplay/RunScript play_audio: false # 跑完响个铃想让它"跑完自己关机去睡觉"，把after_finish改成Shutdown。
改"什么时候自动醒来"
loop_mode: scheduled # power=按开拓力判断 / scheduled=定时 scheduled_time: 4:00 # 每天 4 点起 refresh_hour: 4 # 游戏内每日刷新时间loop_mode是power时它盯着开拓力，到power_limit（默认 160）再开跑；scheduled则纯粹按时间。定时挂机用户选后者最省心。
改"体力怎么花"
power_plan: [["拟造花萼（金）", "回忆之蕾", 10], ["侵蚀隧洞", "睿治之径", 5]]这是个列表，按顺序消耗。默认power_plan_keep: false，跑完会按剩余次数更新列表、删掉打满的条目——也就是说体力计划会被"消费掉"，不用手动清。
改"周常怎么打"：混沌回忆、虚构叙事、末日幻影三组配置同构，各带一个关卡范围（如forgottenhall_level: [9, 12]）和两个队伍模板，队伍里-1表示"用最后一位角色放秘技"。差分宇宙还能配站点优先级（divergent_station_priority，数值越小越先走）和禁用站点列表。
改"跑什么自定义操作"（Workflow）：图形界面里有流程编排器，产物是config/workflows/下的workflow.yaml，支持click_image/click_text/find_image/if/for/while/press_key/wait等步骤类型。仓库自带一份可运行的示例（自动升级角色和光锥），位于 assets/config/workflows/。命令行侧对应三个参数：
python main.py --list-workflows python main.py --workflow-name "流程名" python main.py --workflow-name "流程名" --workflow-step-path 0/1/2 # 只调试其中一步crop参数是归一化裁剪坐标（x/宽, y/高, 宽/宽, 高/高），不知道值就从工具箱"捕获截图"里拿。
改"环境变量覆盖 + Docker 常驻"：配置加载层（module/config/config.py）里有一张_ENV_OVERRIDE_MAP，环境变量优先于 YAML。这是容器化部署的钥匙——仓库的 Dockerfile 正是靠它强制开启云游戏与无头浏览器（MARCH7TH_CLOUD_GAME_ENABLE=true、MARCH7TH_BROWSER_HEADLESS_ENABLE=true），并用MARCH7TH_AFTER_FINISH=Loop让容器内循环执行。配套 docker-compose.yml 把config.yaml和日志挂进容器，首次启动会生成二维码登录图（logs/qrcode_login.png），用米游社扫码即可。注意 Docker 形态只支持云游戏模式，内存建议 1G 以上。
技术亮点速览
- 视觉驱动而非内存读写：靠截图 + 模板匹配 + OCR（RapidOCR）认界面，模型文件内置在
assets/model/，识别"稳不稳"主要取决于你的分辨率和窗口状态，screen_test任务可以提前体检。 - OCR 加速可选：
ocr_gpu_acceleration支持 auto / gpu / onnx_dml / cpu / openvino_cpu 等档位，DML 太慢会自动降级回 CPU，普通核显机器不用纠结。 - 云游戏走 CDP：module/automation/cdp_input.py 基于 Chrome DevTools Protocol 直接驱动浏览器输入，这是"无窗口 + Docker"形态能成立的技术底座。
- 任务体系即插件位：
utils/tasks.py的AVAILABLE_TASKS把每个任务 ID 映射到实现类，main.py只做分派，想加新任务就是"实现类 + 注册一行"。 - 可暂停的长任务：内置任务大多支持暂停/继续（见
PAUSABLE_TASKS），挂机中途接电话不用杀进程。
避坑与延伸
- 首次初始化顺序：源码/Docker 之外，先开一次图形界面再跑
main.py，否则会被first_run()拦下。 - Windows 权限：终端启动建议管理员模式（PowerShell / Windows Terminal）；程序在需要时也会自行请求提权。
- 子模块不能漏：clone 时
--recurse-submodules和更新时的submodule update二选一都会导致模拟宇宙/锄大地不可用。 - OCR 慢：先跑
screen_test确认界面可识别，再考虑把ocr_gpu_acceleration手动指到合适的档位。 - 合规提醒：辅助工具的使用风险请自行评估，账号相关后果与本项目无关；云游戏形态同样受游戏官方条款约束。
- 官方文档成体系地放在 assets/docs/ 下：使用教程、常见问题、Docker 部署、流程编排；参与开发前请先读 CONTRIBUTING.md，遇到 bug 直接提 Issue。
把每天重复的二十分钟收进一条python main.py，把"记得今天有没有清体力"这件事从你的大脑里删掉——这就是三月七小助手想给你买断的东西。剩下的开拓，留给你自己。
【免费下载链接】March7thAssistant日常交给三月七，开拓留给你。《崩坏：星穹铁道》开源自动化助手。项目地址: https://gitcode.com/gh_mirrors/ma/March7thAssistant
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
