14 定时内容与配置文件任务：ServerSettings.ini 自动修改
定时内容分两类：
- 定时发送游戏内容或命令。
- 定时修改服务器配置文件，例如
ServerSettings.ini。
配置文件任务适合需要在固定时间调整服务器设置的场景，例如倍率、活动参数或服务器规则。
示例视频预留
这里后续可放“定时修改 ServerSettings.ini 并上传”的视频，例如：/mp4/newwebdoc/14-config-file-task.mp4
一、后台入口
后台 -> 定时内容页面通常有两个选项：
- 定时内容
- 配置文件任务
二、普通定时内容
普通定时内容会按设定时间写入队列，由 RCON 发送。
如果内容以 # 开头，会按命令发送。
如果内容不是 # 开头，会按聊天提示发送。
聊天频道可在程序设置的 RCON chatType 中配置。
不建议把查询类命令放进普通定时内容，例如：
ListPlayers
ListFlags
QueryTarget这类查询由后台数据获取循环统一处理，放进定时内容可能干扰正常发货和回执识别。
星期设置通常按以下方式理解：
| 数字 | 星期 |
|---|---|
| 1 | 周日 |
| 2 | 周一 |
| 3 | 周二 |
| 4 | 周三 |
| 5 | 周四 |
| 6 | 周五 |
| 7 | 周六 |
重复分钟为 0 时，表示不启用按分钟重复。
三、配置文件任务是什么
配置文件任务会：
- 通过 SFTP/FTP 找到远程配置文件。
- 下载配置文件。
- 修改指定分组和键名。
- 保存备份。
- 上传回远程服务器。
- 写入执行日志。
当前主要面向：
ServerSettings.ini当前配置文件任务只建议管理 ServerSettings.ini。其他 INI 文件虽然也可能存在，但不同服务器版本差异较大，应确认格式后再扩展。
四、远程路径发现
不同服务器目录层级可能不一样，因此系统会尝试遍历远程目录寻找 ServerSettings.ini。
常见路径类似：
SCUM/Saved/Config/WindowsServer/ServerSettings.ini
Saved/Config/WindowsServer/ServerSettings.ini如果自动发现失败，管理可以手动填写远程路径。
自动发现会遍历远程目录。服务器目录层级越深、SFTP/FTP 越慢，查找耗时越长。建议给 SFTP/FTP 账号限定到 SCUM 服务器目录附近，减少无关目录扫描。
五、任务字段
| 字段 | 说明 |
|---|---|
| 任务名称 | 管理识别用 |
| 文件类型 | 通常为 ServerSettings.ini |
| 远程路径 | 目标文件路径 |
| 分组 | INI section，例如 General |
| 键名 | 要修改的参数名 |
| 目标值 | 要写入的新值 |
| 执行时/分 | 每天执行时间 |
| 执行条件 | 星期几执行 |
| 重复执行 | 是否允许重复执行 |
| 允许新增 | 文件中没有该键时是否新增 |
| 上传后公告 | 上传完成后发送的提示 |
六、参数翻译
系统会对已知 ServerSettings.ini 参数做中文翻译，方便管理理解。
翻译只是帮助理解，不改变原始键名。
保存时仍应写入原始 INI 键名。
如果遇到未翻译参数，建议先查服务器设置文档，再决定是否加入任务。
七、备份与恢复
每次任务执行应保留修改前内容或备份路径。
如果上传后服务器行为异常，应先查看配置文件任务日志，找到对应备份，再恢复原值。
真实服务器测试时，建议：
- 先创建一个低风险参数任务。
- 执行后确认文件变化。
- 再恢复原值。
- 最后再用于正式活动。
部分服务器参数需要重启服务器或重新加载配置才会生效。商城只负责修改和上传文件，不会默认重启游戏服务器。
如果任务执行失败，系统可能在同一分钟内重试。管理看到重复失败日志时，应先修正连接、路径或权限问题，再重新执行。
SFTP/FTP 密码属于高风险配置。建议使用专门账号，并只授予 Saved/Config/WindowsServer 等必要目录权限。
八、常见问题
问：为什么发现不到 ServerSettings.ini？
答：可能远程目录填错、SFTP/FTP 权限不足、目录层级过深，或服务器配置文件不在常见路径。
问：为什么上传成功但服务器没变化？
答：有些服务器设置需要重启服务器或重新加载配置后才生效。
问：为什么参数看不懂？
答：只翻译了已知参数。未知参数应先查 SCUM 服务器设置文档，不建议盲目修改。
问：任务执行失败会影响发货吗？
答：配置文件任务走文件上传流程。RCON 发货是另一条队列，但 SFTP/FTP 带宽和连接异常可能影响同一远程服务的其他文件操作。
九、管理排障检查表
- SFTP/FTP 是否可连接。
- 远程路径是否正确。
- 是否有上传权限。
- 分组和键名是否存在。
- 是否允许新增不存在的键。
- 目标值格式是否符合服务器要求。
- 执行时间是否到达。
- 重复执行是否关闭导致今天已执行过。
- 执行日志是否成功。
- 是否需要重启服务器才生效。
- 是否使用了 SFTP，尽量避免公网 FTP 明文传输。
- 是否正在执行 AdminUsers.ini 权限上传。权限上传优先级更高，配置任务可能稍后执行。