安装与首次启动
运行环境
| 项 | 要求 |
|---|---|
| 系统 | macOS 11+ / Windows 10+ |
| 网络 | 能直连 Telegram。国内网络需要自己解决网络可达性问题，应用本身不带代理设置 |
| 磁盘 | 预留 2 GB 以上。每个登录的账号都会在本机建一份 Telegram 本地库，长期使用会持续增长 |
首次启动前不需要装任何依赖，可执行文件是自带前端资源的单文件。
获取安装包
安装包统一在 Telegram 频道发布，本站不提供下载。
进更新通知频道，在频道消息里按自己的系统取对应的安装包。后续版本也发在同一个频道，想收到更新提醒就关注它。
:::caution 只认这一个渠道 从别处拿到的安装包无法保证是官方构建，不要用。渠道有疑问、或者下载安装遇到问题，到 TGDirector 交流群问。 :::
第一步：填写 Telegram 应用凭据
首次启动会弹出一个小窗口，要求填 API ID 和 API Hash。
这两个值是 Telegram 官方的应用凭据，用来标识"这是哪个客户端在连 Telegram"，与你的账号无关。填完只需一次，之后可在「系统配置 · Telegram 接口」修改。
有两种填法：
用内置预设（最快）
点「快速选择」里的任一预设，两个字段会自动填好，直接点「保存并进入」。
预设是公开流传的第三方客户端凭据，能直接用。缺点是很多人共用同一个 api_id，更容易触发 Telegram 的风控。
自己申请（推荐长期使用）
- 用任意一个 Telegram 账号登录 my.telegram.org/apps
- 填一个应用名和简称，创建应用
- 页面上的 App api_id 与 App api_hash 就是要填的两项
在「快速选择」里点「自定义」，把这两个值填进去。
信息
凭据只保存在本机数据库里，不会上传到任何服务器。
填完点「保存并进入」，向导窗口关闭，主窗口打开。
第二步：确认主界面
主窗口默认 1280×720，左侧是固定的功能菜单，底部有授权状态与全局态势。
第一次进来是空的：没有账号、没有剧本、没有演出。接下来按顺序做两件事：
数据存在哪里
所有数据都在本机的应用数据目录下：
| 系统 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/TGDirector |
| Windows | %AppData%\TGDirector |
目录里的内容：
| 子项 | 说明 |
|---|---|
tgdirector.db | 业务数据库：账号、剧本、演出、群发任务、素材、配置 |
logs/ | 三个日志文件：app.log（业务）、tdlib.log（Telegram 协议层）、wails.log（框架） |
media/ | 素材库文件：上传的图片、语音、快拍素材 |
| 各账号目录 | 每个登录账号的 Telegram 本地库，含登录凭证与本地聊天缓存 |
:::caution 备份与迁移
账号的登录凭证在各账号目录的 td.binlog 里。删掉账号目录 = 该账号需要重新登录。整目录拷走可以迁移，但授权是绑定单台设备的，换机器要重新激活。
:::
日志与缓存的占用统计、清理入口都在系统配置 · 日志。
修改凭据
进「系统配置 · Telegram 接口」改。
- 保存后对新登录的账号立即生效
- 已登录的账号需要重启应用
- 换了
api_id通常要重新登录