March7thAssistant 入门与实践：崩坏：星穹铁道全自动助手的安装、CLI 任务与配置体系全解析

March7thAssistant 入门与实践崩坏星穹铁道全自动助手的安装、CLI 任务与配置体系全解析【免费下载链接】March7thAssistant崩坏星穹铁道全自动 三月七小助手项目地址: https://gitcode.com/gh_mirrors/ma/March7thAssistant本文基于仓库根目录的 README_JA.md 整理编写。它原本是面向日语用户的介绍性 README最终更新 2026-04-24以简体中文版为准本文以它为骨架结合仓库内的 CLI 入口、配置样例、Docker 与依赖代码进行深度扩充帮助中文读者系统掌握 March7thAssistant 的下载安装、源码运行、任务调用与配置调优。一、这是什么一个围绕全自动展开的星穹铁道辅助工具March7thAssistant三月七小助手是一个针对《崩坏星穹铁道》的全自动辅助工具覆盖日常、周常、跃迁记录导出、消息推送与定时任务等场景。需要特别说明的是游戏内语言目前仅支持简体中文这一点在 README 中被明确标注使用前请确认你的游戏语言环境。本文的实践目标是让读者掌握三件事如何用发行版或源码含uv方式把工具跑起来如何通过main.py/app.py的命令行参数精确调度任意任务如何通过 config.example.yaml 理解并配置清体力、模拟宇宙、差分宇宙、通知推送等核心能力。上图来自 README 的画面イメージ章节展示了工具的整体界面布局。二、功能全景README 承诺的能力清单README 的機能紹介章节给出了完整的八项能力逐条展开如下类别能力仓库中的对应实现日常开拓力消化清体力、每日实训、奖励领取、委托、锄大地フィールド探索tasks/daily、tasks/power/power.py、tasks/reward、tasks/base/tasks.py周常历战余响、货币战争、差分宇宙、混沌的回忆、虚构叙事、末日幻影tasks/weekly、tasks/challenge云・星穹铁道支持后台运行、无头headless运行与 Docker 运行module/game/cloud.py、Dockerfile、docker-compose.yml跃迁记录导出支持 UIGF工具箱自动对话auto plot、FPS 解锁、兑换码tasks/tool/autoplot、tasks/base/genshin_starRail_fps_unlocker.py、tasks/daily/redemption.py通知按每日实训等任务完成情况发送通知module/notification 下的十余种渠道实现自动启动任务更新时、开拓力恢复到指定值时自动运行module/schedule.pyloop_mode: power/scheduled完成后操作语音通知、自动关闭游戏、关机等assets/config/config.example.yaml 中的after_finish字段从源码结构看这些能力被组织成tasks/任务实现、module/配置、日志、通知、OCR、自动化等底层模块、app/PySide6 GUI与utils/通用工具四大部分README 中所列的每一项都能在目录树中找到对应实现。三、下载与安装两种官方路径3.1 发行版推荐新手README 给出的最快路径是从项目的 Releases 页面下载最新版压缩包并解压双击三月七图标对应的March7th Launcher.exe打开 GUI 即可。对应到源码这个 Launcher 的入口就是仓库根目录的 app.py它负责创建 PySide6 应用窗口、加载界面语言、请求管理员权限并通过本地 Socket 实现单实例重复启动会把参数转交给已运行实例见 app.py。3.2 从源码运行进阶/开发者README 强调完全新手请直接使用发行版源码方式面向有 Python 基础的用户推荐Python 3.12 及以上pyproject.toml 中同样声明requires-python 3.12。在 Windows 下建议用管理员权限打开 PowerShell、Windows Terminal 或 CMDWindows 11 24H2 之后也可使用 Sudo for Windows。安装与更新命令venv 方式如下# 安装推荐使用 venv 虚拟环境 git clone --recurse-submodules https://gitcode.com/gh_mirrors/ma/March7thAssistant cd March7thAssistant pip install -r requirements.txt python app.py python main.py # 更新 git pull git submodule update --init --recursive注意--recurse-submodules是必选项——仓库依赖3rdparty/下的子模块如 Auto_Simulated_Universe、Fhoe-Rail没有拉取子模块会导致模拟宇宙、锄大地等功能缺失。四、用 uv 管理依赖与启动官方推荐流程README 建议使用uv的用户直接利用项目自带的pyproject.toml工作流即直接执行uv sync无需另行pip install# 安装uv 方式 git clone --recurse-submodules https://gitcode.com/gh_mirrors/ma/March7thAssistant cd March7thAssistant uv sync # 启动 GUI uv run python app.py # 查看 CLI 帮助 uv run python main.py -h # 开始完整运行 uv run python main.py # 执行每日实训 uv run python main.py daily从 pyproject.toml 可以看到项目依赖采用固定版本锁定的策略例如PySide66.11.1、opencv-python4.13.0.92、rapidocr3.8.1、onnxruntime1.26.0、selenium4.44.0等保证不同机器上行为一致同时通过[dependency-groups]划分了docker排除 GUI 与 Windows 专属包、buildPyInstaller 打包和devpytest 测试三组依赖其中uv.lock锁定了整棵依赖树。五、CLI 任务调度从main.py看全部可用命令README 只演示了daily一个子命令但仓库的 main.py 是真正的任务调度中枢值得完整展开。5.1 任务总览-l/--listmain.py内部通过 utils/tasks.py 的AVAILABLE_TASKS字典维护任务 ID 与显示名的映射。运行python main.py -l或python main.py --list会打印完整任务清单main 完整运行 routine 日常 daily 每日实训 power 清体力 game_update 更新游戏 game_pre_download 预下载游戏 app_update 更新三月七小助手 currencywars 货币战争 divergent 差分宇宙 fight 锄大地 universe 模拟宇宙 forgottenhall 混沌回忆 purefiction 虚构叙事 apocalyptic 末日幻影 currencywarsloop 货币战争循环 currencywarstemp 货币战争中途接管 divergentloop 差分宇宙循环 divergenttemp 差分宇宙中途接管 universe_gui 模拟宇宙原生界面 fight_gui 锄大地原生界面 universe_update 模拟宇宙更新 fight_update 锄大地更新 mobileui_update 触屏模式更新 game 启动游戏 notify 测试消息推送 redemption 兑换码 screen_test 界面可切换性测试这些任务 ID 与 main.py 中run_sub_task的分发逻辑一一对应例如forgottenhall/purefiction/apocalyptic都会进入challenge.start(...)挑战类任务currencywarsloop/divergentloop会进入循环模式循环执行直至手动停止。5.2 常用命令行参数参数含义说明TASK位置参数要执行的任务 ID不指定时默认执行完整运行即main-h/--help显示帮助—-l/--list列出所有任务—--no-run-immediately禁用立即运行仅启动流程框架不立即执行任务--workflow-name NAME按名称运行自定义流程对应config/workflows/下的 workflow.yaml--workflow-step-path PATH只执行指定步骤路径格式如0/1/2必须与--workflow-name搭配使用其中工作流参数对接的是 module/workflow/init.py 中的WorkflowRunner与load_workflow_execution_payload。工作流系统支持click_image点击图片、click_text点击文字、find_image、if/for/while分支循环、send_message消息推送等 15 种步骤类型与 6 种条件类型官方示例位于 assets/config/workflows如cosmic_data_roaming、sample_auto_upgrade用户流程则放在config/workflows/。5.3 错误处理与通知联动从 main.py 可以看到无论何种任务异常时程序都会通过telemetry.track_error上报错误类型调用save_error_screenshot保存错误截图使用notif.notify按配置的渠道推送包含错误信息的通知附带截图若有根据配置决定暂停还是退出。这解释了 README 中任务完成后通知能力的底层链路module/notification模块提供统一接口覆盖 Telegram、Matrix、Server酱、Bark、SMTP、OneBot、企业微信、Discord、飞书、KOOK、Webhook 等十余种渠道具体启用方式见 config.example.yaml。六、配置体系一份 YAML 读懂全部行为README 提示详细设置请参阅 GUI 或配置文件仓库根目录的 assets/config/config.example.yaml669 行就是配置的权威来源。程序启动时module/config/config.py 会以该文件为默认值模板加载用户目录下的config.yaml并递归合并_update_config方法缺失字段自动补齐。以下按功能域讲解关键配置。6.1 语言与日志locales: zh_CN # 语言设置 ui_language: auto # UI 语言可选 auto/zh_CN/zh_TW/ja_JP/ko_KR/en_US log_level: INFO # 日志等级INFO 或 DEBUG log_retention_days: 30 # 日志保留天数超期自动删除 log_overlay_enable: true # 游戏界面实时日志浮窗仅 Windows6.2 游戏路径与云游戏game_title_name: 崩坏星穹铁道 # 游戏窗口标题 game_process_name: StarRail # 游戏进程名 game_path: C:\Program Files\Star Rail\Game\StarRail.exe # 游戏安装路径 launcher_title_name: 米哈游启动器 launcher_path: C:\Program Files\miHoYo Launcher\launcher.exe update_via_launcher: False # 是否通过启动器更新游戏 start_game_timeout: 10 # 启动游戏超时分钟 # 云崩铁配置 cloud_game_enable: False cloud_game_use_paid_time: False cloud_game_max_queue_time: 60 # 最大排队等待时间分钟 cloud_game_login_timeout: 20 # 登录超时分钟超时终止 browser_type: integrated # 浏览器类型integrated / edge / chrome browser_headless_enable: False # 无头模式 browser_debug_port: 9222 # 浏览器调试端口云游戏模式是 README 强调的三大特性之一后台 / 无头 / Docker它通过 Selenium 驱动浏览器登录云·星穹铁道网页版支持画质选择、排队等待、小浮球位置调整等。Docker 场景下这些参数会通过环境变量覆盖见下文 6.6。6.3 清体力与副本power_enable: true # 清体力总开关 power_plan: [] # 体力计划[[副本类型, 副本名, 次数], ...] instance_type: 拟造花萼金 # 副本类型金花萼/赤花萼/凝滞虚影/侵蚀隧洞/饰品提取 instance_names: 拟造花萼金: 回忆之蕾 侵蚀隧洞: 睿治之径 instance_names_challenge_count: # 各副本连续挑战次数 拟造花萼金: 24 侵蚀隧洞: 6 use_reserved_trailblaze_power: False # 是否使用后备开拓力 use_fuel: False # 是否使用燃料6.4 周常挑战混沌回忆 / 虚构叙事 / 末日幻影三者结构一致均配置关卡范围 双队伍每队 4 个角色数字代表秘技使用次数-1表示最后一个放秘技和普攻的角色forgottenhall_enable: false forgottenhall_level: [9, 12] # 尝试的关卡范围 forgottenhall_team1: - - Asta - -1 - - JingYuan - 1 - - Tingyun - 2 - - Huohuo - 1 forgottenhall_team2: - - FuXuan - 1 - - Bronya - 1 - - Pela - -1 - - Qingque - 1角色英文名与 assets/images/character 目录下的图片文件名一一对应配置前可先核对。purefiction_*与apocalyptic_*的格式完全相同。6.5 模拟宇宙 / 差分宇宙 / 锄大地universe_enable: false universe_operation_mode: exe # source源码或 exe集成 universe_category: divergent # divergent差分宇宙或 universe模拟宇宙 universe_enable_gpu: false # GPU 加速异常时请关闭 universe_frequency: weekly # weekly 或 daily universe_count: 34 # 每次启动尝试运行次数 universe_path: .\3rdparty\Auto_Simulated_Universe # 模拟宇宙脚本/程序路径 universe_timeout: 20 # 最长运行时间小时 weekly_divergent_enable: false weekly_divergent_type: cycle # normal常规演算或 cycle周期演算 weekly_divergent_level: 5 # 难度 1-66 对应星阶模式 divergent_station_priority: # 差分宇宙站点优先级战斗/精英1 最优先 战斗: 1 事件: 2 空白: 3 fight_enable: false # 锄大地 fight_operation_mode: exe fight_path: .\3rdparty\Fhoe-Rail fight_timeout: 12 # 最长运行时间小时6.6 任务调度、环境变量覆盖与 DockerREADME 提到的定时自动启动对应以下配置loop_mode: scheduled # power按开拓力或 scheduled定时任务 scheduled_time: 4:00 power_limit: 160 # 循环运行所需最低开拓力 scheduled_tasks: [] # 新版多任务定时配置示例见配置注释 scheduled_on_conflict: skip # 任务冲突策略skip / stop除 YAML 之外module/config/config.py 还提供了一组MARCH7TH_*环境变量用于覆盖配置这对 Docker/无头场景至关重要例如MARCH7TH_CLOUD_GAME_ENABLEtrueMARCH7TH_BROWSER_HEADLESS_ENABLEtrueMARCH7TH_BROWSER_TYPEintegratedMARCH7TH_AFTER_FINISHLoopMARCH7TH_LOG_LEVELDEBUGDockerfile 正是利用这一机制构建云游戏镜像基于python:3.14.5-slim-bookworm安装 headless Chrome 所需的系统库通过uv sync --only-group docker安装无 GUI 依赖组默认入口为python main.pydocker-compose.yml 则提供了编排示例。注意 Docker 镜像默认设置MARCH7TH_AFTER_FINISHLoop任务完成后循环执行并标记MARCH7TH_DOCKER_STARTEDtrue以跳过控制台阻塞。6.7 任务完成后动作与快捷键after_finish: None # None/Exit/Loop/Shutdown/Sleep/Hibernate/Restart/Logoff/TurnOffDisplay/RunScript play_audio: false # 完成后是否播放提示音 script_path: C:\Path\to\your\Script.bat # after_finishRunScript 时的脚本路径 hotkey_technique: e # 游戏内秘技键 hotkey_map: m # 游戏内地图键 hotkey_warp: f3 # 游戏内跃迁键 hotkey_auto_battle: v # 游戏内自动战斗键 hotkey_stop_task: f10 # GUI 停止任务全局快捷键支持后台 hotkey_toggle_autoplot: f9 # GUI 切换自动对话全局快捷键七、开发相关调试与测试README 的开发関連提示中有一句容易被忽略的要点crop参数所需的截图坐标可通过工具箱的截图功能获取。对应源码为 tasks/tool/screenshot.py 与 module/automation/screenshot.py——在设置工作流步骤click_crop点击坐标或自定义识别区域时先截图再取坐标是最可靠的实践。仓库还附带完整的测试套件tests覆盖配置加载、通知渠道、更新下载器、OCR、工作流、GUI 组件等模块例如 tests/test_module/test_config.py、tests/test_module/test_workflow.py。开发者修改代码后可运行uv run pytest测试配置见 pyproject.toml验证改动。八、更多资料与相关依赖完整图文教程简体中文版 assets/docs/Tutorial.md另有 Tutorial_en.md、Tutorial_ja.md、Tutorial_ko.md 等语言版本常见问题简体中文版 assets/docs/FAQ.md以及 FAQ_en.md、FAQ_ja.md、FAQ_ko.md工作流编写指南assets/docs/Workflow.md其他运行方式assets/docs/Docker.mdDocker、assets/docs/Termux.md移动端。README 的関連プロジェクト章节声明了工具依赖的开源生态这些依赖在仓库结构中均能看到落点依赖项目提供的功能仓库内位置Auto_Simulated_Universe模拟宇宙自动化3rdparty/Auto_Simulated_UniverseFhoe-Rail锄大地野外探索自动化3rdparty/Fhoe-RailRapidOCR游戏内文字识别rapidocr见 pyproject.toml、module/ocr/ocr.pyPyQt-Fluent-Widgets主要 UI 组件与交互体验PySide6-Fluent-Widgets依赖、appMirror 酱更新检查、分发、CDN 加速update_source: MirrorChyan配置config.example.yamlOpenCV / PyAutoGUI截图、图像处理与基础自动化opencv-python、pyautogui、module/automationONNX Runtime / OpenVINOOCR 与模型推理 CPU/GPU 加速module/ocr/ocr.py 中ocr_gpu_acceleration配置此外README 提到遇到问题建议通过 Issue 反馈、通过 Discussions 讨论提交 PR 前请先阅读 CONTRIBUTING.md。九、快速上手检查清单最后给出一份可直接对照的实践清单确认游戏语言为简体中文硬性前提新手直接下载发行版解压运行March7th Launcher.exe开发者选择 venv 或uv sync方式从源码运行首次运行建议先打开 GUIpython app.py完成基础配置——main.py 中的first_run()会检查是否配置过自动更新否则会提示首次使用请先打开图形界面 March7th Launcher用python main.py -l查看全部任务先跑daily或power这类小任务验证环境再跑main完整运行按需编辑 assets/config/config.example.yaml 对应的config.yaml先开power_plan清体力再逐步启用挑战类周常与模拟宇宙/差分宇宙需要无人值守时配置loop_mode定时任务与notify_*通知渠道或直接使用 Docker 镜像 MARCH7TH_*环境变量。【免费下载链接】March7thAssistant崩坏星穹铁道全自动 三月七小助手项目地址: https://gitcode.com/gh_mirrors/ma/March7thAssistant创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考