Appearance
⚙️ 全局控制中枢 (settings) 操作指南
1. 功能整体描述与核心价值
- 功能概述：
settings是全套营销系统的底层中枢，控制全局网络代理转发、并发线程池容量、Anti-Bot 智能防机器人拦截、Telegram 限频退避（FloodWait）容忍度以及系统运行环境。 - 实现功能：对所有业务模块提供统一的全局参数兜底，支持实时保存与热重载。
- 核心优点：
- 集中化风控保护：一次设置，全局 40+ 模块统一生效防封策略；
- 动态热重载：修改配置后后端通过
_reload_config即时刷新内存，无需频繁重启软件； - 双写防丢机制：根目录与
settings/目录双写镜像，杜绝异常断电或环境迁移导致的配置丢失。
2. 界面功能全景图
3. 参数字典与控制开关深度说明
表 1：输入参数清单
| 字段 ID | 界面标签 | 默认值 | 推荐配置 | 字段深度业务说明 |
|---|---|---|---|---|
timeout | 连接超时 (秒) | 10 | 建议 10~15 | 网络握手和 Telegram 云端交互的超时时效，网络延迟较高时建议放大至 15s |
proxy_change | 代理轮换时限 | 12 | 建议 10~30 | 同一个动态代理 IP 在保持多少秒或多少次请求后请求换绑新 IP |
proxy_connect | 代理重连次数 | 1 | 建议 2 | 代理偶发断流时的重试容忍次数 |
thread_count | 线程数量 | 100 | 批量 30~50 | 全局默认并发 Worker 线程池基数，机器性能不足时适当调低 |
flood_wait | 限频最大等待 (秒) | 80 | 建议 60~120 | Telegram 提示需冷却等待（FloodWait）时，若等待秒数小于此值，账号将休眠等待；超出则立即跳过该账号，避免线程无限挂起 |
peer_flood | PeerFlood 限制次数 | 1 | 建议 1 | 当账号发信遭遇官方风控提示限制时，触发达到此次数立即停止该号当天发信，保护账号不被永久注销 |
antibot_wait | 防机器人等待 (秒) | 5 | 建议 5~8 | 加入群组后，静默观察并等待群内 Shield/Captcha 机器人触发的时长 |
entry_wait | 申请入群等待 (秒) | 300 | 默认 300 | 遇到管理员审批群时的最大挂起等待秒数 |
表 2：开关与下拉策略选项
| 字段 ID | 开关名称 | 默认状态 | 开启/关闭影响与风控建议 |
|---|---|---|---|
antibot | 智能防机器人开关 | 开启 | 强烈建议开启。拉人进群前自动规避群内 Anti-Bot 机器人，避免被秒封 |
proxy | 代理源选择模式 | s-w | s-w 使用内置代理池，settings 使用手动自定义代理，absent 直连 |
proxy_match | 代理匹配机制 | phone | phone 严格保证美国号走美国代理、印尼号走印尼代理；random 则随机轮询 |
browser | 开机调起浏览器 | 关闭 | 开启后启动软件将自动在系统默认浏览器中打开 Web 操控面板 |
control_tweb | 网页端控制 | 开启 | 控制是否允许通过 Telegram Web 网页端逆向协议执行部分免风控操作 |
gpt | 全局 GPT 智能重写 | 关闭 | 开启后，发信文案将自动调用 AI 大模型进行语义去重改写 |
4. 推荐配置 SOP 与执行流程
- 网络预备：确保在代理池（
proxy页面）导入了充足的 Socks5/HTTP 代理，将proxy选为s-w，proxy_match选为phone； - 安全基线：确认
antibot保持开启，flood_wait设置为80，peer_flood设为1； - 确认提交：点击底部绿色 “保存配置” 按钮。
5. 执行结果与预期反馈对照
- 成功反馈：页面右侧弹出 Fancybox 绿色提示弹窗
Settings is save（配置保存成功）； - 后台结果：根目录
config.json与settings/config.json实时更新，后端日志打印Config reloaded successfully。