Files
MaaAssistantArknights/docs/zh-cn/protocol/base-scheduling-schema.md
uye 67bbf9aac5 refactor: website docs **translation needed** (#9287)
Co-authored-by: wlwxj <d1ve_wh4le@outlook.com>
Co-authored-by: Rbqwow <55343783+Rbqwow@users.noreply.github.com>
Co-authored-by: Constrat <56174894+Constrat@users.noreply.github.com>
Co-authored-by: HX3N <scarlet7518@gmail.com>
Co-authored-by: Wallsman <63186641+wallsman@users.noreply.github.com>
Co-authored-by: Loong <wangl.cc@outlook.com>
Co-authored-by: 神代綺凛 <i@loli.best>
Co-authored-by: SherkeyXD <57581480+SherkeyXD@users.noreply.github.com>
2024-07-08 01:57:20 +08:00

143 lines
7.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
order: 6
icon: material-symbols:view-quilt-rounded
---
# 基建排班协议
`resource/custom_infrast/*.json` 的使用方法及各字段说明
::: tip
请注意 JSON 文件是不支持注释的,文本中的注释仅用于演示,请勿直接复制使用
:::
[可视化排班生成工具](https://ark.yituliu.cn/tools/schedule)
## 完整字段一览
```json
{
"title": "小号的换班方案", // 作业名,可选
"description": "哈哈哈哈", // 作业描述,可选
"plans": [
{
"name": "早班", // 计划名,可选
"description": "lol", // 计划描述,可选
"description_post": "", // 计划执行完时显示的描述,可选
"period": [
// 换班时间段,可选
// 若当前时间在该区间内,则自动选择该计划(整个 json 文件中可能包含多个计划)
// 如果该字段不存在,则每次换班结束后,自动切换为下一个计划
// core 不处理该字段,若您使用接口集成 maa请自行实现该逻辑
[
"22:00", // 要求格式 hh:mm目前只是简单的比较数字大小如果要跨天请仿照该示例中写法
"23:59"
],
[
"00:00",
"06:00"
]
],
"duration": 360, // 工作持续时长(分钟),保留字段,目前无作用。以后可能到时间了弹窗提醒该换班了,或者直接自动换了
"Fiammetta": {
// “菲亚梅塔” 为哪位干员使用,可选,不填写则不使用
"enable": true, // 是否使用“菲亚梅塔”,可选,默认 true
"target": "巫恋", // 目标干员,使用 OCR 进行,需要传入对应客户端语言的干员名
"order": "pre" // 在整个换班前使用,还是换完班才用,可选,取值范围 "pre" / "post",默认 "pre"
},
"drones": {
// 无人机使用,可选,不填写则不使用无人机
"enable": true, // 是否使用无人机,可选,默认 true
"room": "trading", // 为哪个类型房间使用,取值范围 "trading" / "manufacture"
"index": 1, // 为第几个该类型房间使用,对应左边 tab 栏序号,取值范围 [1, 5]
"rule": "all", // 使用规则,保留字段,目前无作用。以后可能拿来支持插拔等操作
"order": "pre" // 在换干员前使用还是在换完才用,可选,取值范围 "pre" / "post",默认 "pre"
},
"groups": [
// 对于 "control" / "manufacture" / "trading",可以设置干员编组
{
"name": "古+银",
"operators": ["古米", "银灰", "梅"]
},
{
"name": "清流",
"operators": ["清流", "森蚺", "温蒂"]
}
],
"rooms": {
// 房间信息,必选
// 取值范围 "control" / "manufacture" / "trading" / "power" / "meeting" / "hire" / "dormitory" / "processing"
// 缺少某个则该设施使用默认算法进行换班。
// 若想不对某个房间换班请使用 skip 字段,或直接在软件 任务设置 - 基建换班 - 常规设置 中取消改设施的勾选
"control": [
{
"operators": [
"夕", // 使用 OCR 进行,需要传入对应客户端语言的干员名
"令",
"凯尔希",
"阿米娅",
"玛恩纳"
]
}
],
"manufacture": [
{
"operators": ["芬", "稀音", "克洛丝"],
"sort": false // 是否排序(按照上面 operators 的顺序),可选,默认 false
// 例子:当使用稀音、帕拉斯、巫恋、等干员且 "sort": false干员顺序可能会被打乱导致暖机效果丢失。
// 使用 "sort": true可以避免这个问题
},
{
"skip": true // 是否跳过当前房间(数组序号对应),可选,默认 false
// 若为 true其他字段均可为空。仅跳过换干员操作其他如使用无人机、线索交流等仍会正常进行
},
{
"operators": ["Castle-3"],
"autofill": true, // 使用原先的算法,自动填充剩下的位置,可选,默认 false
// 若 operators 为空,则该房间完整的使用原先算法进行排班
// 若 operators 不为空,将仅考虑单干员效率,而不考虑整个组合效率
// 注意可能和后面自定义的干员产生冲突,比如把后面需要的干员拿到这里用了,请谨慎使用,或将 autofill 的房间顺序放到最后
"product": "Battle Record" // 当前制造产物,可选。
// 若识别到当前设施与作业中设置的产物不符合,界面会弹个红色字样提示,以后可能有更多作用
// 取值范围: "Battle Record" | "Pure Gold" | "Dualchip" | "Originium Shard" | "LMD" | "Orundum"
},
{
"operators": ["多萝西"],
"candidates": [
// 备选干员,可选。这里面的有谁用谁,选满为止
// 与 autofill=true 不兼容即该数组不为空时autofill 需要为 false
"星源",
"白面鸮",
"赫默"
]
},
{
"use_operator_groups": true, // 设置为 true 以使用 groups 中的干员编组,默认为 false
"operators": [
// 启用后, operators 中的名字将被解释为编组名
"古+银", // 将按照心情阈值以及设置顺序选择编组
"清流" // 如 古+银 组中有干员心情低于阈值,将使用 清流 组
]
}
],
"meeting": [
{
"autofill": true // 这个房间内整个 autofill
}
]
}
},
{
"name": "晚班"
// ...
}
]
}
```
## 举例
[243 极限效率,一天三换](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)
[153 极限效率,一天三换](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)