TGDirector 是什么
TGDirector 是一个 Telegram 群氛围操盘工具。你用预先写好的剧本驱动多个 Telegram 账号，让它们在目标群里像真人一样按节奏发言，同时实时监控、随时插话、事后复盘。
它是一个装在自己电脑上的桌面应用（macOS / Windows），账号、剧本、素材、日志全部存在本机，不经过任何中转服务器。
四种用法
一套账号池，四条互不干扰的业务线，按需要用哪条就开哪条。
| 能力 | 干什么 | 典型场景 |
|---|---|---|
| 剧本演出 | 多个账号按剧本的节拍顺序在一个群里演一段对话 | 新品种草、活动预热、答疑引导 |
| 定时群发 | 一个账号按计划向多个群投放内容 | 每日播报、开播提醒、周期性触达 |
| 客服管理 | 把已登录的账号当内嵌 IM 客户端，人工接待 | 私聊咨询、群内被 @ 后的应答 |
| 复盘归档 | 演出与群发的执行记录、趋势、对话回放 | 效果对比、话术迭代 |
剧本演出和定时群发跑在两条独立的调度器上，可以同时开着互不影响。
导演隐喻：五个核心概念
产品的整套命名沿用剧组隐喻，理解了这五个词就理解了主流程。
| 概念 | 界面叫法 | 含义 |
|---|---|---|
| Actor | 演员 / 账号 | 一个已登录的 Telegram 账号 |
| Role | 角色槽 | 剧本里的一个"位置"，比如「提问者」「回应者」。剧本只定位置，不绑定具体账号 |
| Beat | 节拍 | 剧本里的一条动作：发一句台词、发一张图、发一条语音、发一个贴纸，或一个分支判断 |
| Script | 剧本 | 角色槽 + 有序节拍序列。可复用到任意群 |
| Performance | 演出 | 剧本 + 一个目标群 + 一份选角（角色槽 → 具体账号）。一场演出对一个群 |
选角是把剧本落地到具体群的那一步：同一个剧本发到三个群，就是三场演出、三份选角，互不影响。
一场演出是怎么跑起来的
账号库登录若干账号
↓ 同步群
剧本管理写好角色槽与节拍
↓
中控台「新建演出」：选剧本 → 选目标群 → 逐群选角
↓
导演台点「开演」
↓
引擎按节拍顺序驱动各账号发言（节拍间有随机延迟）
↓ 演出中可暂停 / 跳拍 / 改词 / 临时发言 / 处理告警
演出结束 → 自动生成复盘归档
侧边栏导航一览
| 菜单 | 对应文档 |
|---|---|
| 中控台 | 演出大厅与新建演出 |
| 剧本管理 | 剧本编辑 |
| 账号管理 | 账号库 |
| 客服管理 | 客服接待 |
| 复盘归档 | 复盘与回放 |
| 定时群发 · 群发任务 | 定时群发 |
| 定时群发 · 素材库 | 素材库 |
| 系统配置 | 系统配置 |
| 激活验证（侧边栏底部） | 激活授权与账号额度 |
下一步
第一次用，按顺序走这四篇：
:::caution 使用前请注意 本工具驱动的是你自己的 Telegram 用户账号，不是 Bot。批量发言、频繁发送、短时间内大量登录都可能触发 Telegram 风控（限速、封号）。请先读防风控与节奏建议，并遵守 Telegram 服务条款与所在群组的规则。 :::