名詞解釋
本文彙總 Session / TData 製作與格式互轉涉及的術語。授權碼與額度細則見 授權碼與額度。
通用術語
授權碼
購買服務後獲得的憑證，用於全站登入並扣減「剩餘可用次數」。與製作、互轉共用同一額度池。登入方式、扣次規則與購買說明見 授權碼與額度。
Session / StringSession
Telethon 使用的字串格式登入會話。製作工具保存在 ZIP 的 session.txt 中；互轉時可上傳 .txt 或貼上單行文字。屬於敏感資訊，請勿洩露。
TData / tdata
Telegram Desktop 使用的本機資料目錄（目錄名一般為 tdata/，不是單個 .tdata 副檔名檔案）。內含加密金鑰與帳號對應，與 Session 等價，切勿洩露。
ZIP 壓縮包（製作匯出）
製作成功後的下載檔案。檔名一般為區號+手機號（如 8613988881111.zip），內含 session.txt、account.json、tdata/。
account.json
帳號元資訊（JSON），含手機號、產生時間、裝置資訊、has_2fa、profile 等。不包含兩步驗證密碼明文。
剩餘可用次數 / 額度
授權碼綁定的共用額度（製作 + 互轉）。頁面右上角顯示「剩餘可用次數 X / Y 次」。製作 ZIP 全部產生成功或互轉成功各扣 1 次；失敗流程不扣次。
兩步驗證 / Cloud Password
Telegram 雲端密碼。登入時輸入，不寫入匯出檔案。
Telethon / Pyrogram / Telegram Desktop
常見使用場景：Python 庫載入 StringSession；Desktop 匯入 TData 目錄。
Session 製作相關
任務 ID
單次匯出任務的唯一識別，用於查詢狀態與下載。任務可能過期。
任務狀態
| 狀態 | 含義 |
|---|---|
| 等待處理 | 任務已建立 |
| 驗證碼已發送 | 已向手機號發碼 |
| 等待掃碼 | 等待掃描二維碼 |
| 掃碼監聽已逾時 | 需重新整理二維碼 |
| 等待兩步驗證密碼 | 需輸入 Cloud Password |
| 產生中 | 正在產生檔案 |
| 已完成 | 可下載 |
| 失敗 / 已過期 | 需重新開始 |
區號 / 驗證碼 / 二維碼登入
- 區號：如
+886，與手機號分開填寫 - 驗證碼：Telegram 官方 5/6 位登入碼
- 二維碼登入：手機 Telegram → 設定 → 裝置 → 連結桌面裝置
格式互轉相關
格式互轉
在 StringSession 與 tdata 目錄結構之間轉換，不經過 Telegram 登入；服務端也不連線 Telegram 伺服器。不會判斷死號；轉換成功不代表憑證仍可登入。
怎樣算「有效的 tdata 目錄」
須包含 key_datas 和/或以 D877F783D5 開頭的檔名。沒有上述 marker 的目錄不能用於 tdata → Session。
ZIP 上傳時的 tdata 識別
上傳 ZIP 後，服務端先讀目錄列表檢查 tdata/ 路徑或 key_datas 檔案，再解壓並定位 tdata 資料夾。
Session → tdata 的輸出結構
tdata/
├── key_datas
└── D877F783D5…不含 session.txt 或 account.json（屬於製作匯出包，不是互轉輸出）。
與 Telegram Desktop 的關係
- tdata → Session：Desktop 備份 → StringSession
- Session → tdata：StringSession → Desktop 相容目錄
本工具不會啟動或修改 Telegram Desktop。
自動識別（direction=auto）
| 內容 | 方向 |
|---|---|
| UTF-8 文字（非 ZIP） | Session → tdata |
ZIP（魔數 PK） | tdata → Session |
檔名不影響識別。
互轉輸出檔案
| 方向 | 建議檔名 | 類型 |
|---|---|---|
| Session → tdata | converted_tdata.zip | ZIP |
| tdata → Session | converted_session.txt | 純文字 |
與 Session 製作的區別
- 製作：透過 Telegram 官方流程登入新會話並匯出完整 ZIP
- 互轉：對已有 Session 或 tdata 做格式變換，無需發碼
從製作工具來的使用者
可直接上傳整個製作 ZIP（內含 …/tdata/），或開啟 session.txt 複製內容貼上。
常見錯誤（互轉）
| 提示 | 含義 |
|---|---|
| 檔案為空 | 未上傳有效內容 |
| 不支援的檔案類型 | 非文字也非有效 ZIP |
| ZIP 中未找到 tdata 相關檔案 | 缺少 tdata/ 或 key_datas |
| Session 格式無效 | StringSession 文字結構不合法 |
| 無效的 tdata | tdata 檔案結構無法載入 |
| 轉換逾時 | 超過伺服端時間限制 |