Xử lý sự cố
Cách sửa các vấn đề 1FileTool thường gặp: cảnh báo trình cài, lượt chạy lỗi, tải OCR và model, giới hạn ngày, kích hoạt bản quyền và AI Chat.
Phần lớn vấn đề của 1FileTool quy về trình cài, một lượt tải đầu tiên bị chặn, hoặc Replace source làm đúng những gì nó nói — hãy đi qua mục khớp với triệu chứng của bạn.
Cài đặt và cập nhật
Windows báo "Windows protected your PC" (SmartScreen). Trình cài Windows chưa được ký code-signing, nên SmartScreen gắn cờ ở lần chạy đầu. Chọn More info → Run anyway — file tải về đến từ bản phát hành chính thức. (Bản macOS được ký và notarize; cảnh báo này chỉ có trên Windows.)
AppImage không khởi chạy trên Linux. Hãy cấp quyền thực thi (chmod +x), và nếu distro của bạn thiếu FUSE, cài libfuse2/fuse hoặc chạy nó với --appimage-extract-and-run. Bản Linux không ký — package manager cũng có thể cảnh báo với gói .deb.
Không có bản ARM trên Windows hay Linux. App chỉ phát hành bản ARM cho Apple Silicon; Windows và Linux x64 được hỗ trợ.
Cập nhật: dùng Check for Updates... trong menu app (macOS) hoặc menu File (Windows/Linux). App cũng tự kiểm tra GitHub Releases mỗi 6 giờ; quản lý trong Settings › Updates.
Chạy công cụ
Bảo vệ file gốc trước đã
Replace source mặc định đang BẬT: file đầu ra ghi đè lên file gốc và không giữ bản sao lưu. Trước khi làm theo, mở Settings › General và tắt Replace source, hoặc chọn một thư mục đầu ra riêng.
Tôi không tìm thấy kết quả. Kiểm tra thẻ kết quả sau lần chạy, rồi History — mọi lần chạy đều được ghi lại. Nếu Replace source đang bật, đầu ra chính là file gốc (ghi đè tại chỗ); nếu đang tắt, nhìn trong ~/Documents/1FileTool hoặc thư mục bạn đã chọn bằng Change.
Công cụ lỗi kèm thông báo. Thẻ kết quả hiển thị văn bản lỗi; copy nó trước khi thử lại. Nguyên nhân thường gặp: định dạng đầu vào không được công cụ đó hỗ trợ (ví dụ HEIC chỉ là đầu vào — bạn không thể chuyển sang HEIC), file nguồn hỏng, hoặc file đang bị app khác khóa.
File đầu ra to hơn bản gốc. Chuyện đó hợp lệ — một số nguồn (file đã tối ưu, JPEG chất lượng thấp bị mã hóa lại thành PNG) không thể nhỏ đi. Thẻ kết quả luôn hiển thị dung lượng trước/sau nên không có gì bị giấu.
OCR ra kết quả lỗi loạn hoặc rỗng. Tesseract.js chỉ tiếng Anh và ghi ra file .txt, không phải PDF tìm kiếm được; chữ viết tay và bản quét độ phân giải thấp sẽ đọc kém.
Một tính năng AI yêu cầu tải model. Bình thường — lần dùng đầu của một giọng (~63 MB từ Hugging Face) hoặc Background Removal (~178 MB từ GitHub) tải model một lần. Nếu nó chựng lại, kiểm tra kết nối và thử lại; sau khi tải nó hoạt động offline.
Giới hạn và bản quyền
"Daily limit reached — resets tomorrow". Gói free đếm 8 file đầu ra mỗi ngày dương lịch; bộ đếm ở thanh bên cho biết bạn đang ở đâu. Pro bỏ giới hạn — xem Free vs Pro.
Kích hoạt bản quyền thất bại. Dán lại toàn bộ key trong Settings › License, kiểm tra bạn còn trong giới hạn thiết bị (1/3/5), và hủy kích hoạt một thiết bị cũ từ cùng tab đó trước khi thử lại. Kích hoạt cần truy cập mạng tới Lemon Squeezy.
AI Chat
AI Chat không hoạt động. Nó là một cầu tới AI CLI bạn tự cài (Claude Code, Gemini CLI, Codex và bạn bè) — CLI phải được cài và đã đăng nhập, và nhà cung cấp model nhìn thấy bất cứ thứ gì nó đọc. Auto-setup phủ Claude Code và Gemini CLI; các CLI khác cần thiết lập thủ công. Nếu không có gì phản hồi, mở terminal và kiểm tra CLI chạy độc lập trước.