入門指南¶
本指南將幫助您快速上手TG-FF資源管理助手 V3，包括軟件下載、安裝、登錄設置和基本使用流程，讓您輕鬆解決Telegram圖片視頻無法下載的問題。
系統要求¶
- Windows: Windows 10/11 (x86_64)
- macOS: macOS 10.15+ (x86_64)
- 網絡: 可訪問Telegram的網絡環境（可能需要代理）
- 存儲: 至少1GB可用空間用於軟件安裝及資源緩存
軟件下載¶
TG-FF提供多種下載渠道，您可以選擇最適合您的方式獲取軟件，解決Telegram圖片和視頻無法保存的問題：
如何驗證下載文件的安全性？¶
TG-FF軟件包均通過以下方式保證安全性：
- 數字簽名：所有官方發佈的軟件包都帶有開發者的數字簽名，確保軟件來源可靠
- SHA256校驗：GitHub發佈頁提供SHA256哈希值，可用於驗證文件完整性，防止被篡改
- 開源代碼：關鍵組件代碼開源，社區共同監督，提高軟件透明度和安全性
如遇到安全警告，可能是因爲軟件使用了特定系統API來實現Telegram媒體下載功能，請放心使用官方渠道下載的版本。
軟件安裝¶
Windows系統安裝步驟¶
- 下載完成後，雙擊
.exe安裝文件啓動安裝程序 - 如遇到Windows安全提示，點擊"更多信息">"仍要運行"繼續安裝
- 按照安裝嚮導提示選擇安裝位置和創建快捷方式等選項
- 安裝完成後，從桌面快捷方式或開始菜單啓動TG-FF軟件
macOS系統安裝步驟¶
- 下載完成後，雙擊
.dmg安裝文件打開鏡像 - 將TG-FF應用程序圖標拖拽到Applications文件夾中完成安裝
- 首次運行時，在Finder中找到應用程序，右鍵點擊>"打開"
- 如遇到安全提示，點擊"打開"按鈕確認運行軟件
登錄設置¶
TG-FF通過Telegram的官方API接口與您的賬戶連接，採用安全的掃碼登錄方式，不會存儲您的密碼。
爲什麼需要設置代理？¶
由於網絡環境的限制，在中國大陸及部分地區，無法直接連接到Telegram服務器。因此，您必須設置代理才能使用TG-FF。代理是一種網絡中繼服務，可以幫助您繞過網絡限制，連接到Telegram服務器，從而實現下載受保護的圖片和視頻等功能。
什麼是代理？如何獲取代理？¶
代理是一種允許您通過中間服務器連接到目標網站的技術方式。獲取代理的常見途徑包括：
- 使用付費VPN服務，這些服務通常提供SOCKS5或HTTP代理
- 使用專用的代理工具，如Clash、V2rayN、Shadowsocks等
- 從代理服務提供商處購買專用代理
- 使用已有的科學上網工具，大多數都提供本地代理服務
掃碼登錄¶
登錄詳細步驟:
- 初始界面: 啓動軟件後，您將看到登錄界面，但二維碼可能因網絡限制無法加載（如上圖所示的"等待"狀態）
- 設置代理: 點擊右下角的"設置代理"按鈕，打開代理設置界面，配置正確的代理參數
網絡代理設置¶
配置代理詳細步驟: 1. 在登錄界面點擊"代理設置"按鈕進入代理配置頁面 2. 選擇代理類型（大多數用戶應選擇"SOCKS5"類型代理） 3. 填寫代理服務器地址（通常是"127.0.0.1"，即本機地址） 4. 填寫代理端口號（根據您的代理軟件而定，見下文說明） 5. 如有需要，填寫用戶名和密碼（多數本地代理不需要此項） 6. 點擊"測試代理"按鈕確認連接是否正常 7. 連接成功後點擊"保存"按鈕應用代理設置
如何查找您的代理端口?
不同的代理客戶端有不同的默認端口和查看方式，以下是常見代理軟件的端口設置：
Clash
- 默認SOCKS5端口: 7890
- 查看位置: Clash面板 → 設置 → 端口
- HTTP代理端口: 通常是7890或7891
V2rayN
- 默認SOCKS5端口: 10808 或 10809
- 查看位置: 主界面 → 設置 → 基本設置 → 本地SOCKS端口
Shadowsocks
- 默認SOCKS5端口: 1080
- 查看位置: 設置 → 本地端口
Surge
- 默認SOCKS5端口: 6152
- 查看位置: 設置 → 出站模式 → 代理設置
Quantumult X
- 默認SOCKS5端口: 7890
- 查看位置: 設置 → 本地SOCKS5/HTTP服務
代理測試過程: - 填寫完代理信息後，點擊"測試代理"按鈕開始測試連接 - 系統將嘗試通過您設置的代理連接Telegram服務器 - 上圖顯示系統正在測試您配置的代理連接狀態 - 測試成功會顯示"連接成功"提示，表示代理可用 - 測試失敗會顯示具體錯誤信息，請檢查代理設置是否正確
完成登錄流程: - 代理設置正確並保存後，系統將自動加載登錄二維碼 - 使用手機Telegram應用掃描顯示的二維碼 - 在手機上確認登錄請求，授權TG-FF訪問您的賬號 - 登錄成功後軟件將自動進入主界面，開始使用各項功能
常見問題處理:
如果您無法成功設置代理或加載二維碼，請嘗試以下解決方法：
- 代理無法連接：
- 確認您的代理服務/VPN是否正常運行
- 檢查端口號是否正確填寫
- 嘗試重啓您的代理軟件後再次連接
-
嘗試使用其他類型的代理（如從SOCKS5切換到HTTP）
-
二維碼加載失敗：
- 點擊刷新按鈕重新加載二維碼
- 確認代理設置正確並已成功保存
-
檢查網絡連接是否穩定，可能需要更換網絡環境
-
掃碼無反應：
- 確保手機和電腦在同一網絡環境下
- 更新手機Telegram應用到最新版本
- 嘗試調整屏幕亮度，確保二維碼清晰可見
-
確保手機攝像頭對準整個二維碼
-
登錄後很快就自動退出
- 檢查您的Telegram賬號是否在其他設備上被登出
- 確保您的網絡連接穩定，考慮使用更可靠的代理服務
- 檢查代理服務是否仍在運行，嘗試重新設置代理
您的賬號安全嗎？
TG-FF使用Telegram官方API接口，不會存儲您的密碼或私人聊天內容。軟件只會將您明確指定要下載或索引的內容保存到您選擇的本地目錄中。其他聊天內容不會被永久存儲。登錄過程完全通過Telegram官方認證流程，確保賬號安全。所有數據均存儲在您的本地設備上，不會上傳到任何第三方服務器。
首次使用¶
成功登錄後，您將進入軟件首頁，開始使用TG-FF解決Telegram媒體下載問題：
首頁顯示內容： - 您的Telegram賬戶信息和登錄狀態 - 當前代理設置和連接狀態 - 功能導航菜單和快捷入口
修改代理設置¶
您可以隨時在首頁修改代理設置，確保軟件正常連接：
- 點擊首頁右上角的"代理設置"按鈕
- 在彈出的設置面板中調整代理參數或切換代理類型
- 測試並保存更改，確保連接正常
基本功能導航¶
TG-FF軟件的主要功能區域包括：
- 普通下載: 瀏覽並下載對話中的媒體文件，包括受保護的圖片和視頻
- 批量下載: 一次性下載大量歷史媒體內容，支持多種篩選條件
- 批量轉文: 將圖片批量轉換爲文檔格式，適合內容創作者
- 消息轉發: 自動轉發消息到其他對話，實現內容同步
- 自動下載: 設置條件自動下載新媒體內容，不錯過重要更新
- 信息檢索: 搜索和索引聊天內容，快速找到需要的信息
點擊左側導航欄中的相應選項，即可進入各功能區域，開始使用相應功能解決Telegram媒體下載問題。
獲取幫助¶
如果您在使用過程中遇到問題，可以通過以下渠道獲取幫助和支持：
下一步¶
現在您已經完成了基本設置，可以開始使用軟件的各項功能解決Telegram媒體下載問題：
- 普通下載功能：瞭解如何下載對話中的圖片和視頻，包括受保護內容
- 批量下載功能：探索批量下載選項，高效獲取大量媒體
- 自動下載功能：設置自動下載規則，實時獲取新內容
- 批量轉文功能：圖片批量轉換爲文檔，便於編輯和分享
- 消息轉發功能：自動轉發消息，實現內容同步
- 信息檢索功能：搜索和管理聊天內容，快速找到需要的信息