名詞解釋
格式互轉
在 StringSession 與 tdata 目錄結構之間轉換，不經過 Telegram 登入；服務端不連線 Telegram 伺服器。不會判斷死號——轉換成功不代表憑證仍可登入。
StringSession
Telethon 格式的會話字串，通常為單行文字。可作為 .txt 上傳或貼到頁面。
tdata
Telegram Desktop 用來保存本機登入狀態的目錄（不是單個 .tdata 副檔名檔案）。目錄內包含加密金鑰與帳號對應檔案，屬於敏感登入資訊，與 Session 等價，切勿洩露。
怎樣算「有效的 tdata 目錄」
伺服端（opentele-ng）認定目錄有效需滿足：
- 是一個資料夾，且其中存在
key_datas，或 - 存在以
D877F783D5開頭的檔名（Telegram Desktop 帳號目錄識別）
僅有空資料夾或普通設定檔、沒有上述 marker 的目錄不能用於 tdata → Session。
ZIP 上傳時的 tdata 識別
上傳 ZIP 後，伺服端不解壓到磁碟前先讀壓縮包目錄列表，檢查是否包含：
- 路徑片段
tdata/（如tdata/key_datas、8613988881111/tdata/…） - 或任意路徑下名為
key_datas的檔案
通過後才會解壓並在目錄樹中 定位 tdata 資料夾（可能在 ZIP 根目錄、子目錄，或 Session 製作匯出的手機號目錄下）。
Session → tdata 的輸出結構
轉換成功後 ZIP 內固定為：
tdata/
├── key_datas
└── D877F783D5… （及其他 Desktop 所需檔案）即根目錄下只有 tdata/ 一層，不含 session.txt 或 account.json（那些屬於 Session 製作匯出包，不是互轉輸出）。
與 Telegram Desktop 的關係
- tdata → Session：從 Desktop 備份/複製的 tdata 還原為 Telethon StringSession
- Session → tdata：從 StringSession 產生 Desktop 可識別的 tdata 目錄
本工具不會啟動 Telegram Desktop，也不會修改您電腦上的 Desktop 安裝目錄；只負責格式轉換，匯入 Desktop 需您在本機操作。
常見 tdata 相關問題
| 問題 | 原因 / 處理 |
|---|---|
| ZIP 中未找到 tdata 相關檔案 | ZIP 裡沒有 tdata/ 路徑也沒有 key_datas；請按 使用方法 重新打包 |
| 未找到有效的 tdata 目錄 | 解壓後找不到名稱或內容合法的 tdata 資料夾 |
| 無效的 tdata，無法載入帳號 | 目錄結構損壞、備份不完整，或 tdata 與目前 Desktop 版本不相容 |
| Session 無效或已失效，無法轉換為 tdata | StringSession 對應會話已在 Telegram 側失效，需重新登入製作新 Session |
| 轉換成功但 Desktop 無法登入 | 可能 Desktop 版本差異或匯入路徑錯誤；請備份後查閱 Desktop 文件 |
從 Session 製作工具來的使用者
製作 ZIP 解壓後若只需互轉為 Session 文字，可直接上傳整個製作 ZIP（內含 …/tdata/），或開啟 session.txt 複製內容貼上，兩種方式均可。
自動識別（direction=auto）
| 內容 | 方向 |
|---|---|
| UTF-8 文字（非 ZIP） | Session → tdata |
ZIP（魔數 PK） | tdata → Session |
檔名不影響識別。
輸出檔案
| 方向 | 建議檔名 | 類型 |
|---|---|---|
| Session → tdata | converted_tdata.zip | ZIP |
| tdata → Session | converted_session.txt | 純文字 |
額度與扣次
與 Session 製作 共用授權碼額度。詳見 授權碼與額度。