RRRosmontis
636ecbd974
- bin/maa-online-memlog: 每分钟采集一次服务 cgroup 匿名内存、swap 占用、进程 RSS、 以及大于 32 MB 的匿名映射数量（glibc arena 膨胀指纹），追加写入 logs/memlog.csv， 超过 5 MB 自动滚动并保留一代；同时输出一行到 journald - systemd/maa-online-memlog.service, maa-online-memlog.timer: 每分钟触发采集， Nice=10 避免影响流媒体负载 - bin/maa-online-install-systemd: 安装并启用观测定时器，安装提示补充内存日志路径 - README.md, user_config/README.md: 补充内存观测说明、字段表与查看命令 - .gitignore: 忽略运行期产生的 logs/
244 lines
8.7 KiB
Markdown
244 lines
8.7 KiB
Markdown
# MAA Online 用户配置
|
||
|
||
`daily.example.toml` 是公开模板。执行 `install.sh` 后会复制为被 Git 忽略的 `daily.toml`，并建立以下链接：
|
||
|
||
```text
|
||
config/tasks/daily.toml
|
||
-> user_config/daily.toml
|
||
```
|
||
|
||
## 使用前必须确认
|
||
|
||
下面这些参数会改变游戏资源或账号行为。首次运行前请逐项确认。
|
||
|
||
### 全局参数
|
||
|
||
| 参数 | 当前值 | 可填写值/作用 |
|
||
|---|---:|---|
|
||
| `client_type` | `Official` | 官服用 `Official`；B服用 `Bilibili` |
|
||
| `startup` | `true` | 运行任务前自动启动并进入游戏 |
|
||
| `closedown` | `true` | 全部任务结束后退出网易云游戏实例 |
|
||
|
||
### 清理理智 `Fight`
|
||
|
||
| 参数 | 当前值 | 说明 |
|
||
|---|---:|---|
|
||
| `stage` | `1-7` | 必填偏好。要刷的关卡，如 `1-7`、`CE-6`、`LS-6`、`AP-5`、活动关卡 |
|
||
| `medicine` | `0` | 最多使用多少瓶普通理智药；`0` 表示不用 |
|
||
| `medicine_expire_days` | `0` | 使用多少天内将过期的理智药；`0` 表示不用 |
|
||
| `stone` | `0` | 最多碎多少颗源石；强烈建议保持 `0` |
|
||
| `times` | `999` | 最大作战次数；理智不足时仍会停止 |
|
||
| `series` | `0` | `0` 自动选择最大代理倍率，`1` 单次代理，其他正数为指定倍率 |
|
||
| `report_to_penguin` | `false` | 是否匿名上报掉落至企鹅物流 |
|
||
| `report_to_yituliu` | `false` | 是否匿名上报至一图流 |
|
||
|
||
修改关卡示例：
|
||
|
||
```toml
|
||
stage = "CE-6"
|
||
```
|
||
|
||
只刷十次：
|
||
|
||
```toml
|
||
times = 10
|
||
```
|
||
|
||
### 自动公招 `Recruit`
|
||
|
||
| 参数 | 当前值 | 说明 |
|
||
|---|---:|---|
|
||
| `refresh` | `true` | 是否刷新低价值三星标签，会消耗游戏内免费刷新次数 |
|
||
| `select` | `[5, 4]` | 允许选择的标签组合等级 |
|
||
| `confirm` | `[4, 3]` | 允许自动确认的标签等级；高价值组合不自动确认 |
|
||
| `first_tags` | `高级资深干员` | 三星组合时优先考虑的标签；通常无需修改 |
|
||
| `extra_tags_mode` | `0` | `0` 默认；`1` 尽量选三个标签；`2` 尽量选择更多高星标签 |
|
||
| `times` | `4` | 本轮最多处理/发起多少次招募，会消耗招聘许可 |
|
||
| `set_time` | `true` | 是否自动设置招募时间 |
|
||
| `expedite` | `false` | 是否使用加急许可；建议保持 `false` |
|
||
| `preserve_tags` | 高资、资深、支援机械 | 识别到任一标签时保留槽位，留给人工确认 |
|
||
| `recruitment_time` | 540 分钟 | 三星和四星组合默认设置为 9 小时 |
|
||
| `server` | `CN` | 国服为 `CN`，国际服可为 `US`、`JP`、`KR` |
|
||
|
||
如果只想识别公招、不自动确认和发起招募：
|
||
|
||
```toml
|
||
confirm = []
|
||
times = 0
|
||
```
|
||
|
||
### 基建换班 `Infrast`
|
||
|
||
| 参数 | 当前值 | 说明 |
|
||
|---|---:|---|
|
||
| `mode` | `20000` | 已启用一键轮换；`0` 为自动计算换班，`10000` 为自定义排班 |
|
||
| `facility` | 七类常用设施 | 要处理的设施及顺序 |
|
||
| `drones` | `_NotUse` | 不使用无人机；也可填 `Money`、`CombatRecord`、`PureGold` 等 |
|
||
| `threshold` | `0.3` | 心情低于此比例时参与换班判断 |
|
||
| `dorm_notstationed_enabled` | `false` | 是否将未进驻干员放入宿舍 |
|
||
| `dorm_trust_enabled` | `false` | 是否优先安排需要提升信赖的干员进宿舍 |
|
||
|
||
设施名称：
|
||
|
||
```text
|
||
Mfg 制造站
|
||
Trade 贸易站
|
||
Power 发电站
|
||
Control 控制中枢
|
||
Reception 会客室
|
||
Office 办公室
|
||
Dorm 宿舍
|
||
Processing 加工站
|
||
Training 训练室
|
||
```
|
||
|
||
### 信用商店 `Mall`
|
||
|
||
| 参数 | 当前值 | 说明 |
|
||
|---|---:|---|
|
||
| `visit_friends` | `true` | 访问好友基建获取信用 |
|
||
| `shopping` | `true` | 是否自动购买信用商店商品 |
|
||
| `buy_first` | 招聘许可、龙门币 | 优先购买列表，按顺序购买 |
|
||
| `blacklist` | 家具零件、加急许可 | 第二轮购物时不购买的商品 |
|
||
| `force_shopping_if_credit_full` | `false` | 信用将溢出时是否无视黑名单；建议保持 `false` |
|
||
| `only_buy_discount` | `false` | 第二轮是否只购买折扣商品 |
|
||
| `reserve_max_credit` | `true` | 信用高于 300 时可继续购买其他非黑名单商品；降至 300 以下后停止第二轮购物 |
|
||
| `credit_fight` | `false` | 是否借助战打一局 OF-1 获取次日信用；会产生额外操作 |
|
||
| `formation_index` | `0` | 信用战使用的编队；`0` 当前编队，`1`～`4` 对应编队栏 |
|
||
|
||
完全禁止自动购物，但仍访问好友：
|
||
|
||
```toml
|
||
visit_friends = true
|
||
shopping = false
|
||
```
|
||
|
||
### 奖励领取 `Award`
|
||
|
||
| 参数 | 当前值 | 说明 |
|
||
|---|---:|---|
|
||
| `award` | `true` | 领取每日和每周任务奖励 |
|
||
| `mail` | `true` | 领取所有邮件奖励 |
|
||
| `recruit` | `false` | 是否领取限定池每日免费单抽 |
|
||
| `orundum` | `false` | 是否领取幸运墙等活动合成玉奖励 |
|
||
|
||
## 交互式编辑
|
||
|
||
运行：
|
||
|
||
```bash
|
||
bin/maa-online-config
|
||
```
|
||
|
||
使用数字选择“全局”或某个任务，再选择具体配置项。字符串可以直接输入；列表既可以输入完整 TOML，也可以用逗号分隔，例如：
|
||
|
||
```text
|
||
1-7
|
||
招聘许可,龙门币
|
||
5,4
|
||
```
|
||
|
||
在主菜单输入 `s` 保存。每次保存前会自动备份到 `user_config/backups/`，随后运行 MAA dry-run；若验证失败会自动回滚。输入 `q` 退出，`Ctrl+C` 会取消未保存的修改。
|
||
|
||
## 检查配置但不执行
|
||
|
||
每次修改后先运行：
|
||
|
||
```bash
|
||
bin/maa-online run daily --dry-run --batch
|
||
```
|
||
|
||
出现任务列表且没有 Error，表示 TOML 格式和参数能够被解析。
|
||
|
||
## 正式执行
|
||
|
||
终端一：
|
||
|
||
```bash
|
||
bin/maa-online-server
|
||
```
|
||
|
||
终端二：
|
||
|
||
```bash
|
||
curl -X POST http://127.0.0.1:22888/start
|
||
bin/maa-online run daily --batch -v \
|
||
--log-file=maa-daily.log
|
||
```
|
||
|
||
## 紧急停止
|
||
|
||
停止当前 MAA：
|
||
|
||
```bash
|
||
pkill -INT -f '/runtime/bin/maa'
|
||
```
|
||
|
||
退出网易云游戏实例：
|
||
|
||
```bash
|
||
curl -X POST http://127.0.0.1:22888/exit
|
||
```
|
||
|
||
## 示例模板设置
|
||
|
||
公开示例模板会：
|
||
|
||
- 使用基建一键轮换模式；
|
||
- 最多处理四次公招，但保留高资、资深和支援机械标签；
|
||
- 刷 `1-7` 直到理智不足；
|
||
- 不吃理智药；
|
||
- 绝不碎石；
|
||
- 不使用加急许可；
|
||
- 访问好友；优先购买指定商品，信用高于 300 时不限折扣购买其他非黑名单商品；
|
||
- 不无视信用商店黑名单；
|
||
- 领取每日/每周任务奖励；
|
||
- 领取所有邮件；
|
||
- 任务结束后退出云游戏。
|
||
|
||
## 自动定时与断点续跑
|
||
|
||
仓库提供 systemd 单元，可让日常任务每天自动执行（安装见根目录 README 的「自动定时执行」一节）：
|
||
|
||
| 单元 | 作用 |
|
||
|---|---|
|
||
| `maa-online-server.service` | 云游戏 API 常驻服务，崩溃自动重启，启动前清除代理环境变量，限制 malloc arena 数量 |
|
||
| `maa-daily.timer` | 每天 04:00 起随机 0–2 小时触发 |
|
||
| `maa-online-recycle.timer` | 每天 03:59（游戏每日刷新前）重启 API 服务以回收内存 |
|
||
| `maa-online-memlog.timer` | 每分钟记录服务内存/swap/arena 指标到 `logs/memlog.csv` |
|
||
| `maa-update.timer` | 每周日 03:20 起随机 30 分钟，更新 maa-cli / MaaCore / 资源 |
|
||
|
||
`bin/maa-online-daily-run` 的流程：等待 API 就绪 → 规划剩余任务 → 启动云游戏 → 在停滞看门狗下
|
||
执行任务 → 失败则释放云会话并重试（默认最多 3 次）。
|
||
|
||
**内存回收**：流媒体会话会在 glibc malloc arena 中留下大量不归还操作系统的冷匿名内存（实测可累积
|
||
到 GB 级并占满 swap）。因此 `maa-daily.service` 结束时会重启 API 服务，另有
|
||
`maa-online-recycle.timer` 每天独立回收一次；回收服务在 `bin/maa-online-can-recycle` 守卫下运行，
|
||
日常任务进行期间会自动跳过，不会打断任务。
|
||
|
||
看门狗会在出现连续 `ScreencapFailed` 或日志中的 `Disconnected` 时中止当前尝试；后端本身也会在信令
|
||
WebSocket 被远端关闭、或视频流停滞超过 `MAA_ONLINE_STALE_LIMIT_SECONDS`（默认 120 秒）时主动拆掉
|
||
会话，避免云实例空挂。
|
||
|
||
**断点续跑**：第 2 次及之后的重试不再重跑整份 `daily.toml`。`bin/maa-resume-tasks.py` 读取前几次尝试
|
||
的日志，跳过已出现 `<任务类型> Completed` 的任务，只把剩余任务写入
|
||
`config/tasks/daily-resume.toml` 后执行。若所有任务都已完成，脚本直接判定成功，不再开新会话。
|
||
`StartUp` 永不跳过：每次连接都是新的云实例，必须先进入游戏。
|
||
|
||
手动补跑（例如某天中断后，用当天剩余额度把没做完的任务补上）：
|
||
|
||
```bash
|
||
MAA_ONLINE_RESUME_FROM="artifacts/maa-daily-20260919-053237.log" bin/maa-online-daily-run
|
||
```
|
||
|
||
查看执行情况：
|
||
|
||
```bash
|
||
systemctl list-timers maa-daily.timer
|
||
journalctl -u maa-daily.service -n 50
|
||
ls -lt artifacts/maa-daily-*.log | head
|
||
```
|
||
|
||
注意：网易云游戏免费额度有限（常见为每天 30 分钟），而一次完整日常约需 24 分钟，重试次数越多越容易
|
||
额度耗尽。断点续跑正是为压缩重试开销而设计的，但仍建议关注额度消耗。
|