安装与首次启动
运行环境
| 项 | 要求 |
|---|---|
| 系统 | macOS 11+（Apple 芯片）/ Windows 10+（x64） |
| 机器 | 实体机。在虚拟机、VPS 或挂着调试器的环境里应用会直接拒绝启动 |
| 网络 | 能连上 Telegram 与授权服务。连不上 Telegram 的网络，给账号配代理 |
| 磁盘 | 预留 2 GB 以上。每个登录的账号都会在本机建一份 Telegram 本地库，长期使用会持续增长 |
获取安装包
安装包统一在 Telegram 频道发布，本站不提供下载。
进更新通知频道，在频道消息里按自己的系统取对应的安装包。后续版本也发在同一个频道。
:::caution 只认这一个渠道 从别处拿到的安装包无法保证是官方构建，不要用。下载安装遇到问题，到 TGDirector 交流群问。 :::
首次启动
没有配置向导。启动后直接进主窗口，未激活时被一层关不掉的「激活验证」遮罩挡住，先用卡密激活。
主窗口默认 1280×720，无系统标题栏：红黄绿按钮在左上角品牌区，拖动窗口抓顶部那一条空白。
左侧菜单从上到下：炒群剧本、账号管理、代理管理、群成员采集、私信群发、客服管理、定时群发、系统配置。底部是授权到期日、「深色模式」开关和「N / M 账号在线」。
Telegram 接口凭据出厂已配好（Telegram Desktop 的身份），不用填。要换见系统配置 · Telegram 接口。
数据存在哪里
| 系统 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/TGDirector |
| Windows | %AppData%\TGDirector |
| 子项 | 说明 |
|---|---|
tgdirector.db | 业务数据库：账号、代理、剧本、演出、群发任务、素材、配置 |
tdlib/<账号ID>/ | 每个账号的 Telegram 本地库，含登录凭证与聊天缓存 |
media/ | 上传的图片、语音、快拍素材 |
exports/ | 群成员采集导出的 CSV |
logs/ | app.log（业务）、tdlib.log（Telegram 协议层）、wails.log（框架） |
:::caution 备份与迁移
**删掉 tdlib/<账号ID>/ = 该账号需要重新登录。**整目录拷到新机器可以带走账号和数据，但卡密绑定设备，新机器要另用一张卡激活。
:::
占用统计与清理入口在系统配置 · 日志。