系统配置
侧边栏「系统配置」。四个标签页:AI 文案接口、Telegram 接口、发送限流、日志。
页面右上角显示「配置已保存」或「有未保存修改」。所有标签页共用底部的「保存全部」按钮,改完哪一页都要点它。
「恢复默认」会用出厂值覆盖当前表单,同样要点「保存全部」才生效。
AI 文案接口

给剧本的 AI 改写 / 润色 / 对话导入,以及群发的 AI 生成文案用。
| 字段 | 说明 |
|---|---|
| 服务商 | OpenAI / OpenAI 兼容 |
| 模型 | 例如 gpt-4o |
| API Base | 例如 https://api.openai.com/v1 |
| API Key |
右上角「测试连接」验证连通性,结果显示「连接正常」或「连接失败」。右侧栏有本次会话的调用统计和最近调用记录。
不配这一项也不影响其它功能,只是 AI 相关的按钮会提示去配置。
Telegram 接口

账号登录用的 TDLib 客户端凭据,就是首次启动时填的那两项。
「快速选择」提供几个公开的第三方客户端凭据预设,也可以选「自定义」自己填。在 my.telegram.org/apps 申请自己的一份。
生效规则:
- 保存后对新登录的账号立即生效
- 已登录的账号需要重启应用
- 换了
api_id通常要重新登录
凭据只存在本机数据库,不上传。
发送限流

防风控的账号级速率限制。
| 项 | 默认 | 说明 |
|---|---|---|
| 每账号每分钟最多发送 | 20 条 | 1–60 |
| 两条消息最小间隔 | 3 秒 | 0–600 |
限流是按账号算的,并且演出、群发、客服共用同一个桶。群发跑得凶的时候,客服页面发消息会排队。
改动重启后生效。
节奏怎么定,见防风控与节奏建议。
日志

日志级别
| 级别 | 用途 |
|---|---|
| debug | 全量,排查问题时临时开 |
| info | 默认,记录关键动作 |
| warn | 只记异常与降级 |
| error | 只记错误 |
点「保存全部」后即时生效,不用重启。Telegram 协议层的详细度跟着一起调,调到 debug 会让 tdlib.log 的写入量显著变大。
三个日志文件
| 文件 | 来源 |
|---|---|
app.log | 后端业务:演出引擎、定时群发、账号监听 |
tdlib.log | Telegram 协议层原生日志 |
wails.log | 应用框架:窗口、绑定调用 |
三者都是单个超过 10 MB 自动切割并压缩归档,每个来源最多留 5 份、保留 30 天。
「打开目录」在文件管理器里打开日志目录,「清理日志」删除全部归档并清空当前三个文件。
存储与缓存
Telegram 的本地占用只增不减,它自己不做任何清理。实测占用大头是聊天记录库而不是媒体文件:单账号能到 200 MB 以上,几个账号轻松上 GB。
界面列出五组占用:
| 分组 | 类别 | 说明 |
|---|---|---|
| TDLib 媒体缓存 | 可清理 | 会话里的图片/语音/文件,以及头像、贴纸、缩略图 |
| 贴纸缩略图缓存 | 可清理 | 贴纸选择器的预览图 |
| TDLib 消息库 | 需确认 | 本地缓存的聊天记录 |
| 账号会话数据 | 不清理 | 登录凭据本身,删了要重新登录 |
| 素材库 | 不清理 | 你上传的图片/语音,是资产不是缓存 |
两个清理按钮:
清理缓存(安全档)
删掉全部账号的媒体缓存与贴纸缩略图。图片、语音下次要看时自动重新下载,不影响登录,也不断开连接。
清空消息库(重操作)
删掉全部账号的本地聊天记录缓存。
- 不会掉登录(登录凭据在另一个文件里)
- 会短暂断开各账号连接,删完自动重连
- 历史随后从服务器重新同步
- 同步回来之前,群发的**「表情回应」会跳过**(它读本地消息库)
「素材库」和「账号会话数据」两组只统计不清理。素材要删请到素材库页面删。