企业官网建设流程全解析

星穹铁道自动跑图不用读内存：三月七小助手完整上手指南

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

三月七小助手（March7thAssistant）是一款开源的《崩坏：星穹铁道》游戏自动化工具，它不碰游戏内存、不拦截网络封包，而是通过截图加文字识别"看懂"游戏画面，再模拟键鼠完成操作。清体力、每日实训、周常挑战、奖励领取这些重复劳动都可以交给它，你只需要配好开关，剩下的一键或定时执行即可。

📦 快速上手：把小助手跑起来的 3 步

安装本身很直接。项目依赖 Python 3.12 及以上版本，推荐用uv管理环境（uv sync会按 pyproject.toml 自动装齐全部依赖），普通玩家也可以直接去 Releases 下载完整包，双击March7th Launcher.exe使用图形界面。

源码方式只需下面一组命令，克隆仓库、装依赖、启动图形界面：

git clone --recurse-submodules https://gitcode.com/gh_mirrors/ma/March7thAssistant cd March7thAssistant uv sync uv run python app.py # 启动图形界面

装好之后有两个硬性的使用前提，使用教程 里也反复强调：

• 本地游戏模式只支持 Windows，游戏用 PC 客户端，以 1920×1080 窗口模式运行（窗口不可用时再选全屏）；
• 游戏内语言设为简体中文，并关掉帧率监控、游戏滤镜、HDR 增强这类会在画面上叠加内容或改变画面的软件——否则图像识别会直接失灵，日志里出现"检测到疑似监控悬浮窗文字"就是典型信号。

另外，Windows 下通过终端启动时建议用管理员模式打开终端，否则输入模拟可能不生效。跑通这一步后，后面所有任务都建立在同一套配置之上，下面先看它到底能替你做什么。

⚡ 核心能力：它替你做完了一天的哪些事

"看懂"画面而不是读内存

小助手感知游戏状态的途径和我们平时肉眼看到的一致：module/automation/screenshot.py 负责截屏（本地模式支持后台截图，云游戏模式从浏览器画面取帧），再把画面交给两类识别手段——固定界面元素（按钮、图标）用模板匹配比对 assets/images/ 下的素材图，动态文字（按钮标签、任务提示、副本名称）则走 module/ocr/ocr.py 的 OCR，底层是本地 ONNX 模型，支持 GPU / CPU 多档加速，DML 加速持续偏慢时会自动降级回 CPU，不需要你手动干预。这个路线的代价是对画面"干净程度"比较敏感，也是上一条使用前提的原因；换来的是不依赖内存布局，游戏版本更新后通常改一下识别素材就能继续工作。

一个入口串起整日流程

首页的「完整运行」是最省心的入口：程序会按你当前开启的任务清单串行处理兑换码、每日实训、活动、历战余响、清体力、货币战争、差分宇宙、锄大地、混沌回忆、虚构叙事、末日幻影，最后统一领奖励。关键在于它只执行"已启用且已刷新"的内容——没开的任务自动跳过，已经完成的也不重复跑，日常默认每天凌晨 4 点刷新、周常每周一凌晨 4 点刷新。也就是说你可以只把它当成一个"到点全办"的托管入口，细节想调时再单独开对应任务（任务实现分布在 tasks/daily/、tasks/challenge/、tasks/weekly/ 这些目录）。

不装游戏客户端也能跑

不想占用本地机器的人可以把游戏放在云上：开启云·星穹铁道后，小助手通过浏览器接管网页版游戏，支持后台运行、无窗口（headless）运行，macOS、Linux、Docker 乃至安卓 Termux 都能用云游戏模式。注意清体力、每日实训、货币战争、差分宇宙支持后台，锄大地和模拟宇宙仍需保持前台全屏。没有云游戏资源、又想让机器 7×24 挂着的人，则走下一节的 Docker 路线。

无人值守：循环、定时与通知

真正"睡觉时它在干活"靠的是三组机制配合：循环模式（按开拓力阈值或定点定时触发）、日志页的多任务定时计划（scheduled_tasks支持多条任务、指定星期、超时强停、完成后推送和关机/睡眠等后置动作），以及消息推送——任务完成或出错的时刻可以把结果发到 Telegram、钉钉、企业微信、Server酱、Bark 等二十多个渠道，出错了还会附带一张错误截图，你不在电脑前也能知道它卡在哪。任务跑完还能自动退出游戏、关机或执行自定义脚本（after_finish）。

现成任务覆盖不到的边角需求，不用改代码：界面里的「流程编排」提供了一个可视化步骤编辑器，可以把点击图片、点击文字、坐标点击、按键、等待、通知这些步骤拼成带if/for/while分支的小流程，流程编排教程 里有完整说明。能力边界清楚了，接下来把最常动手的几组配置过一遍。

🔧 常用配置详解：只动这几组就够

所有配置集中在 assets/config/config.example.yaml（700 多行，带中文注释），图形界面能改的项和它一一对应，不需要手写。新手最常碰到的就是下面三组，先给一份最小示例：

locales: zh_CN game_title_name: 崩坏：星穹铁道 power_enable: true # 清体力总开关 power_limit: 160 # 循环模式下要求的最低开拓力 loop_mode: scheduled # power（按开拓力）或 scheduled（按时间） scheduled_time: 4:00 # 定时运行时间 after_finish: None # 任务完成后：无操作 / 退出 / 关机 / 睡眠 / 循环... notification_enable: true # 消息推送总开关

体力、副本与日常

power_enable是清体力总开关，它同时管着完整运行和日常里的历战余响与清体力；单独执行「清体力」不受这个开关影响。刷什么副本由副本类型加副本名称决定，程序会按当前开拓力自动算挑战次数。想按角色培养刷特定素材就开build_target_enable，它会按目标自动匹配行迹或遗器副本；use_reserved_trailblaze_power（后备开拓力）和use_fuel（燃料）控制是否额外烧掉这两类资源；borrow_enable开启后打本时会尝试使用支援角色。日常实训则可以通过材料合成、姬子试用或回忆副本来完成，对应daily_*几个开关。

通知、定时与完成后动作

notify_level选all推送所有事件，选error只推异常；notify_merge开启后完整运行结束会把所有通知合并成一条，避免刷屏。scheduled_tasks里的每条任务可以单独设时间、星期、超时、完成通知和后处理（比如跑完kill_processes杀掉游戏进程再睡眠）。注意定时以系统分钟的跳变触发，GUI 所在分钟不补跑，计划时间之前把程序开着即可。

周常：货币战争与差分宇宙

每周积分类任务各有一个总开关：currencywars_enable（货币战争）和weekly_divergent_enable（差分宇宙），开启后完整运行会在周常刷新时检查积分是否拿满，没拿满就自动进入对应流程。货币战争可选标准/超频博弈、职级难度、速通模式和"遇到特定词条接受重开"；差分宇宙可选常规/周期演算、难度等级、站点优先级和低性能兼容模式（云游戏会强制走低性能模式）。混沌回忆、虚构叙事、末日幻影三项各自独立开关，并分别支持配置关卡范围和两队阵容（角色用英文名，见 assets/images/character/）。

配置能覆盖绝大多数场景，如果你希望把它放到一台不常开机的机器上长期运行，下面这节讲部署选项。

🐧 部署与进阶：Docker 长期挂机与流程编排

Dockerfile 和 docker-compose.yml 直接放在仓库根目录，容器化部署只支持云游戏模式，支持 amd64 和 arm64（部署教程 里有完整步骤）：

cp assets/config/config.example.yaml config.yaml # 编辑 config.yaml：开启云游戏、填好任务开关 docker compose build docker compose up -d

首次启动会自动进入二维码登录，二维码图片落在./logs/qrcode_login.png，用手机米游社 APP 扫码完成。之后容器默认每天凌晨 4 点自动执行完整运行并在循环中等待下一个时间点，不会自动退出。想只跑单个子任务，在 compose 里覆盖command即可，例如["python", "main.py", "power"]只清体力、["python", "main.py", "daily"]只跑每日实训；环境变量（如MARCH7TH_LOG_LEVEL=DEBUG）可覆盖配置文件。安卓设备也可以通过 Termux 跑云游戏模式，官方安卓部署教程 走 proot-distro 拉镜像的方式，适合愿意折腾的人：

想扩展功能有两条路：一是在「流程编排」里用现成步骤拼自定义小流程，适合重复点击、简单分支判断这类需求；二是参考 tasks/ 下现有任务的写法贡献新任务——基础框架 tasks/base/base.py 已定义任务生命周期，具体任务只需实现自己的游戏逻辑。最后说说它的适用范围。

⚖️ 适合谁，以及使用边界

它适合三类人：每天被清体力、实训、领奖励占据固定时间的日常玩家（本地 Windows 窗口模式）；没有 Windows 或不想开本地客户端的玩家（云游戏 + macOS/Linux/Docker）；希望机器 7×24 自动循环的人（Docker + 定时任务）。不适合的：期望"全自动零维护"的场景——图像识别方案对画面干扰敏感，滤镜、监控悬浮窗、改过的游戏按键（F交互、C角色详看必须保持默认）都会导致识别失败；以及锄大地、模拟宇宙这类需要前台全屏保持的任务，不适合塞进无窗口方案里跑。

使用上请保持克制：它本质是模拟人工点击，技术上与手动操作无异，但执行频率和时长由你的配置决定，建议贴近正常玩家节奏（比如一天完整运行一次），避免长期多开高频刷取，账号风险由使用者自担。遇到问题先按 FAQ 自查环境，再查项目 Issue。

日常交给三月七，开拓留给你。配置、部署、边界都过了一遍之后，回到「完整运行」点一下，就是它最典型的使用方式。

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