常见问题
启动与授权
主窗口被一层灰罩挡住，关不掉
本机还没激活。按激活授权走三步，或点右上角的 × 退出应用。
侧边栏显示「校验失败」
Telegram 或授权服务暂时不可用，不是你的问题。本地授权在 24 小时有效期内照常可用，稍后会自动重试。
侧边栏显示「已退群」
你退出了必进的频道或群组。重新加入面板里列出的会话，点「重新检测」。
激活码提示"已被另一个 Telegram 账号使用"
这条链接被别人先点了。点「重新生成」拿一个新的，用你自己的账号打开，不要把它发给任何人。
换了电脑
授权绑定单台设备，新机器上重新走一遍激活流程。解绑会让手上这张授权立即失效。
账号
添加账号时收不到验证码
验证码由 Telegram 发到该账号已登录的其他设备（官方账号 777000 的私聊），或以短信下发。先在手机上确认。
列表里的「验证码」按钮这时候用不了：它要求账号已经登录成功。
新建演出/群发任务时选不到群
该账号还没「同步群」。去账号管理，操作列点「同步群」。账号每次加了新群都要重新同步。
「同步群 / 导出群 / 验证码 / 设备」是灰的
这四个按钮要求账号状态是正常（已登录）。先登录。
提示"账号「XX」超出当前授权额度"
账号数超过了授权额度。额度内的账号按添加时间升序取前 N 个，超出的那几个不能用于演出和群发。
两个办法：邀请好友解锁额度，或删掉多余账号。
账号状态变成「封禁」
被 Telegram 封了。停掉相关任务，读防风控与节奏建议调整节奏，不要用同一套配置继续跑其它号。
剧本与演出
「校验并下一步」通不过
必填角色槽（名字后带 *）没分配账号，或分配的账号不在那个群里。红字提示会指出具体是哪个角色。
分支节拍没有自动跳转
分支不会自动判断条件。它只在导演台的时间轴上留一个决策点，需要你看着群里的实际反应，手动点「跳至 #N」。
改了剧本，正在跑的演出没变
演出创建时保存的是剧本快照。要改当前这场，用导演台时间轴上的「改词」。
演出里同一句话连发了三条一模一样的
那条节拍的「复读」大于 1，而选角时没配气氛组。配上气氛组，重复的几条会轮流由不同账号发。
定时群发
勾了五类内容，为什么每次只发一条
**这是设计如此。**五类内容互为候选，每次触发在每个群里只随机抽一种形式，再从该形式的多条里随机抽一条。勾多几种是让花样更杂，不是一次多发几条。
图片配了 5 张，抽中图片时也只发一张。
某些群被跳过了
常见原因：
- 没达到「最小间隔消息数」（群里别人的新消息不够）
- 候选池为空：勾选的几类内容此刻都做不了，比如只勾了图片而图片素材已被删
- 表情回应找不到可回应的他人消息，或最新那条已经回应过了
具体原因看发送记录。
应用关着的时候错过的任务会补发吗
不会。错过的触发点一律不补发，重启只算未来的触发点。
表情回应一直不生效
三种情况：
- 群里最新一条他人消息已经被回应过了，而它不会回溯到更早的消息
- 没达到「最小间隔消息数」
- 刚清过消息库，本地聊天记录还没同步回来
时间窗为什么每天时间都不一样
这就是时间窗的用途：每天在指定区间内随机一个时刻发一次，避免固定时刻的机械感。同一天算出来的时刻是稳定的，重启应用不会重算。
客服管理
账号有未读，红点却不亮
群和频道只统计未读提及（@我、文本提及、别人回复我的消息），不统计全部未读。一个活跃群刷几百条不会把红点顶起来。
红点是灰色的小点，不是红色数字
未读全部来自已免打扰的会话。条数在 tooltip 里。
视频和文档打不开
客服窗口只下载图片、语音、贴纸，视频和文档一律显示占位卡片。大文件下载会拖垮连接。
置顶失败，提示 PINNED_DIALOGS_TOO_MUCH
Telegram 的置顶数量上限，非 Premium 账号是 5 个。先取消一个再置顶。
存储与性能
占用越来越大
Telegram 的本地占用只增不减，它自己不做清理。大头是聊天记录库不是媒体。
去系统配置 · 日志 · 存储与缓存：先点「清理缓存」（安全，不掉登录也不断连接）；还不够就「清空消息库」（不掉登录，但会短暂断连，历史重新同步）。
清空消息库会掉登录吗
不会。登录凭据存在另一个文件里。代价是各账号短暂断连，以及历史同步回来之前群发的「表情回应」会跳过。
其它
AI 按钮提示去配置
先在系统配置 · AI 文案接口填好接口，点「测试连接」确认通了。
改了 Telegram API 凭据，已登录的账号没反应
保存后只对新登录的账号立即生效。已登录的账号需要重启应用；换了 api_id 通常还要重新登录。
日志在哪
<数据目录>/logs/，或在系统配置的「日志」页点「打开目录」。排查问题时把级别调成 debug，复现一次再调回来。