系统设置

系统设置用于配置当前租户下 TG2AI 控制台的全局行为，包括代理、性能、日志与界面个性化。登录 app.tg2ai.com 后，从左侧进入 系统设置（或顶部用户菜单中的设置入口）。

TIP

代理池建议为每个业务线单独配置住宅代理；多账号场景务必开启失败自动换代理，降低风控。

代理设置

配置项	说明	可选值
代理优先级	代理选择策略	单选：「普通代理优先」（默认）、「旋转代理优先」
代理响应超时	代理连接超时时间	数字输入，默认 30，范围 5–300，单位「秒」
最大重连次数	失败后重试次数	数字输入，默认 3，范围 0–10，单位「次」
自动更换失败代理	失败时是否自动切换代理	开关（默认开启）

代理配置详细步骤

进入代理设置
- 1.1 在系统设置页面点击 代理管理 按钮
- 1.2 进入代理配置区域
配置代理参数
- 2.1 代理优先级：选择「普通代理优先」（默认）或「旋转代理优先」
- 2.2 代理响应超时：设置连接超时秒数，默认 30，范围 5–300
- 2.3 最大重连次数：设置失败后重试次数，默认 3，范围 0–10
- 2.4 自动更换失败代理：开启后（默认），代理失败时自动切换到下一个可用代理
代理池管理
- 3.1 在 代理管理 页面添加 SOCKS5 代理
- 3.2 支持批量导入代理列表
- 3.3 系统将按优先级策略从代理池中选择代理
保存配置
- 4.1 点击 保存设置 使代理设置生效

代理建议

多账号场景建议开启 自动更换失败代理，提高任务成功率
网络不稳定时可适当增加 代理响应超时 和 最大重连次数

性能设置

配置项	说明	建议值
默认线程数 (default_threads)	并发任务线程数	根据 CPU 与账号数量调整，通常 5–20
线程延迟 (thread_delay_enabled)	是否启用线程启动延迟	建议开启，降低风控
延迟秒数 (thread_delay_seconds)	每个线程启动间隔（秒）	建议 2–5

性能设置详细步骤

进入性能设置
- 1.1 点击 性能配置 按钮
配置线程与延迟
- 2.1 默认线程数：根据机器配置和账号数量设置，通常 5–20
- 2.2 线程延迟：开启后，每个线程启动间隔一定时间，降低风控风险
- 2.3 延迟秒数：设置线程启动间隔，建议 2–5 秒
保存配置
- 3.1 点击 保存设置 使性能设置生效

风控提示

线程数过高或延迟过短可能触发 Telegram 频率限制，建议保守配置。

日志设置

配置项	说明	可选值
打开方式 (open_mode)	日志窗口打开方式	`new_tab`（新标签页）、`modal`（弹窗）
显示样式 (display_style)	日志展示样式	`terminal`（终端风格）、`plain`（纯文本）
终端主题 (terminal_theme)	终端风格配色	`default`、`monokai`、`dracula`、`nord`、`solarized` 等

日志设置详细步骤

进入日志设置
- 1.1 点击 日志系统 按钮
配置日志展示
- 2.1 打开方式：选择 new_tab（新标签页打开）或 modal（弹窗打开）
- 2.2 显示样式：选择 terminal（终端风格）或 plain（纯文本）
- 2.3 终端主题：若使用终端风格，选择配色主题
可用终端主题

主题	说明
default	经典终端配色
monokai	流行深色主题
github	GitHub 风格浅色
tomorrow	柔和深色
dracula	紫色系主题
nord	北欧冷色调
solarized	护眼配色

保存配置
- 4.1 点击 保存设置 使日志设置生效

界面设置

配置项	说明
头像 (avatar)	系统头像：颜色或自定义图片
系统名称 (system_name)	显示在界面上的系统名称
语言 (system_language)	界面语言：简体中文、English、Русский
主题 (system_theme)	亮色 / 暗色 / 跟随系统

界面设置详细步骤

进入界面设置
- 1.1 点击 界面设置 按钮
配置界面选项
- 2.1 头像：选择颜色头像或上传自定义图片（JPG/PNG/GIF/WebP，最大 2MB）
- 2.2 系统名称：修改显示在界面上的系统名称
- 2.3 语言：选择界面语言（简体中文、English、Русский）
- 2.4 主题：选择亮色、暗色或跟随系统
保存配置
- 3.1 点击 保存设置，主题和语言将立即刷新界面

保存与重置

页面底部提供三个操作按钮：

重新加载：从服务器重新加载当前配置，放弃本地未保存的修改
恢复默认：将所有设置重置为默认值
保存设置：将当前修改持久化到后端

保存设置（详细步骤）

修改配置
- 1.1 在任意标签页（代理管理、性能配置、日志系统、界面设置）中修改需要变更的配置项
应用更改
- 2.1 页面底部显示「当前配置: [标签名]」表示当前激活的标签
- 2.2 点击 保存设置 按钮将配置持久化到后端
- 2.3 部分设置（如主题、语言）会立即刷新界面，无需重新登录
验证
- 3.1 刷新页面或重新进入设置，确认配置已保存

重置设置（详细步骤）

执行重置
- 1.1 点击 恢复默认 按钮
- 1.2 在确认弹窗中再次确认操作
重置结果
- 2.1 所有全局设置（代理管理、性能配置、日志系统、界面设置）将恢复为默认值
- 2.2 界面可能自动刷新以应用默认配置

重置警告

重置将清除所有自定义配置，包括代理管理、性能配置、日志系统、界面设置等，请谨慎操作。

API 调用示例

通过 API 获取或更新全局设置：

bash

# 获取当前设置
curl https://api.tg2ai.com/api/v1/settings/global

# 更新设置（需认证）
curl -X PUT https://api.tg2ai.com/api/v1/settings/global \
  -H "Content-Type: application/json" \
  -d '{
    "proxy": {
      "priority": "rotating",
      "timeout": 45,
      "max_retries": 5,
      "auto_replace": true
    },
    "performance": {
      "default_threads": 10,
      "thread_delay_enabled": true,
      "thread_delay_seconds": 3
    }
  }'

# 重置为默认
curl -X POST https://api.tg2ai.com/api/v1/settings/global/reset

任务管理器

任务管理器集中展示所有正在运行和已完成的自动化任务，支持实时日志查看、暂停/恢复/停止操作。

功能概览

功能	说明
活跃任务	显示当前正在运行的任务列表，包含进度、状态、耗时
历史任务	已完成/已停止的任务归档，可查看执行结果和日志
实时日志	通过 SSE 实时推送任务执行日志
导出结果	支持将任务结果导出为 TXT 或 Excel 格式

操作步骤

进入任务管理器：在左侧导航栏展开 系统设置 → 点击 任务管理器
查看活跃任务：页面上方显示正在运行的任务卡片，包含进度条和实时状态
查看任务日志：点击任务卡片展开实时日志面板
暂停/恢复/停止：使用任务卡片上的操作按钮控制任务执行
查看历史：下方「历史任务」列表显示已完成的任务，可点击查看详情
导出结果：在任务详情中点击 导出 TXT 或 导出 Excel 下载结果

许可证管理

许可证管理用于管理系统 License 密钥，控制用户访问权限。

功能概览

功能	说明
创建许可证	生成新的 License Key，设置类型（月付/试用版）、所有者、过期时间
搜索与筛选	按邮箱搜索，按状态（激活/暂停/撤销）和类型筛选
续费	延长许可证有效期
暂停/恢复	临时挂起或恢复许可证
撤销	永久撤销许可证

操作步骤

进入许可证管理：在左侧导航栏展开 系统设置 → 点击 许可证管理
创建许可证：点击右上角 创建许可证 按钮，填写所有者、邮箱、类型、有效期等信息
搜索许可证：在搜索栏输入邮箱，或使用状态/类型下拉筛选
管理操作：在每条记录的操作列中，点击详情（查看完整信息）、续费（延长有效期）、暂停（临时挂起）或撤销（永久停用）

License 信息列表

列	说明
License Key	许可证密钥（如 TL-XXXXX-XXXXX-XXXXX-XXXXX）
所有者	许可证持有人名称
邮箱	绑定邮箱
类型	月付 / 试用版
状态	激活 / 暂停 / 撤销
过期时间	到期日期与剩余天数
设备数	已绑定/最大设备数

权限管理

功能概览

权限管理用于管理用户角色和权限，控制对系统各功能的访问。

功能	说明
角色筛选	按角色（超级管理员、管理员、普通用户等）筛选用户
查看权限	查看用户拥有的全部权限列表
编辑权限	修改用户角色或自定义权限

操作步骤

进入权限管理：在左侧导航栏展开 系统设置 → 点击 权限管理
筛选用户：使用角色下拉框筛选特定角色的用户
查看权限：点击用户行的 查看权限 按钮，弹出该用户的完整权限列表
编辑权限：点击编辑按钮，可修改用户角色或增减自定义权限
保存修改：修改后点击确认保存

用户信息列表

列	说明
用户名	登录用户名
邮箱	用户邮箱
姓名	显示名称
角色	超级管理员 / 管理员 / 普通用户
权限数量	拥有的权限总数
自定义权限	额外授予的自定义权限数量
状态	激活 / 禁用
创建时间	账户创建日期

API Key 管理

功能概览

API Key 管理用于生成和管理 API 密钥，供第三方集成和自动化脚本使用。

功能	说明
生成 API Key	创建新的 API 密钥，指定名称、描述和过期时间
查看使用情况	查看 API Key 的调用次数和最后使用时间
撤销	停用不再需要的 API Key
删除	永久删除 API Key

操作步骤

进入 API Key 管理：在左侧导航栏展开 系统设置 → 点击 API Key 管理
生成密钥：点击 生成 API Key 按钮，填写名称和描述
复制密钥：生成成功后立即复制密钥（密钥仅显示一次）
管理密钥：在列表中查看所有 API Key 的状态、使用次数和过期时间
撤销/删除：不再需要时，点击操作列中的撤销或删除按钮

API Key 信息列表

列	说明
名称	API Key 名称
API Key	密钥值（部分隐藏）
描述	用途说明
状态	活跃 / 已撤销
使用次数	累计调用次数
最后使用	上次调用时间
过期时间	密钥有效期

系统设置 ​

代理设置 ​

代理配置详细步骤 ​

性能设置 ​

性能设置详细步骤 ​

日志设置 ​

日志设置详细步骤 ​

界面设置 ​

界面设置详细步骤 ​

保存与重置 ​

保存设置（详细步骤） ​

重置设置（详细步骤） ​

API 调用示例 ​

任务管理器 ​

功能概览 ​

操作步骤 ​

许可证管理 ​

功能概览 ​

操作步骤 ​

License 信息列表 ​

权限管理 ​

功能概览 ​

操作步骤 ​

用户信息列表 ​

API Key 管理 ​

功能概览 ​

操作步骤 ​

API Key 信息列表 ​

系统设置

代理设置

代理配置详细步骤

性能设置

性能设置详细步骤

日志设置

日志设置详细步骤

界面设置

界面设置详细步骤

保存与重置

保存设置（详细步骤）

重置设置（详细步骤）

API 调用示例

任务管理器

功能概览

操作步骤

许可证管理

功能概览

操作步骤

License 信息列表

权限管理

功能概览

操作步骤

用户信息列表

API Key 管理

功能概览

操作步骤

API Key 信息列表