跳到主要内容

系统配置

侧边栏「系统配置」。四个标签页:AI 文案接口、Telegram 接口、发送限流、日志。

页面右上角显示「配置已保存」或「有未保存修改」。所有标签页共用底部的「保存全部」按钮,改完哪一页都要点它。

「恢复默认」会用出厂值覆盖当前表单,同样要点「保存全部」才生效。

AI 文案接口

AI 文案接口

给剧本的 AI 改写 / 润色 / 对话导入,以及群发的 AI 生成文案用。

字段说明
服务商OpenAI / OpenAI 兼容
模型例如 gpt-4o
API Base例如 https://api.openai.com/v1
API Key

右上角「测试连接」验证连通性,结果显示「连接正常」或「连接失败」。右侧栏有本次会话的调用统计和最近调用记录。

不配这一项也不影响其它功能,只是 AI 相关的按钮会提示去配置。

Telegram 接口

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.logTelegram 协议层原生日志
wails.log应用框架:窗口、绑定调用

三者都是单个超过 10 MB 自动切割并压缩归档,每个来源最多留 5 份、保留 30 天。

「打开目录」在文件管理器里打开日志目录,「清理日志」删除全部归档并清空当前三个文件。

存储与缓存

Telegram 的本地占用只增不减,它自己不做任何清理。实测占用大头是聊天记录库而不是媒体文件:单账号能到 200 MB 以上,几个账号轻松上 GB。

界面列出五组占用:

分组类别说明
TDLib 媒体缓存可清理会话里的图片/语音/文件,以及头像、贴纸、缩略图
贴纸缩略图缓存可清理贴纸选择器的预览图
TDLib 消息库需确认本地缓存的聊天记录
账号会话数据不清理登录凭据本身,删了要重新登录
素材库不清理你上传的图片/语音,是资产不是缓存

两个清理按钮:

清理缓存(安全档)

删掉全部账号的媒体缓存与贴纸缩略图。图片、语音下次要看时自动重新下载,不影响登录,也不断开连接

清空消息库(重操作)

删掉全部账号的本地聊天记录缓存。

  • 不会掉登录(登录凭据在另一个文件里)
  • 短暂断开各账号连接,删完自动重连
  • 历史随后从服务器重新同步
  • 同步回来之前,群发的**「表情回应」会跳过**(它读本地消息库)

「素材库」和「账号会话数据」两组只统计不清理。素材要删请到素材库页面删。