maa-online/user_config/README.md

# 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-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 分钟，重试次数越多越容易
额度耗尽。断点续跑正是为压缩重试开销而设计的，但仍建议关注额度消耗。