Chuyển tới nội dung chính

Khắc phục sự cố

Các sự cố thường gặp và cách khắc phục.

Sự cố nhà cung cấp​

"Error: 401 Unauthorized"​

  • Nguyên nhân: Khóa API không hợp lệ.
  • Cách khắc phục: Vào Settings > Providers. Nhập lại khóa API của bạn. Đảm bảo không có khoảng trắng thừa hoặc ký tự xuống dòng.

"Error: 403 Forbidden"​

  • Nguyên nhân: Khóa API của bạn không có quyền truy cập mô hình được yêu cầu.
  • Cách khắc phục:
    • Với OpenAI: Một số mô hình yêu cầu gói trả phí. Kiểm tra quyền truy cập của bạn tại platform.openai.com.
    • Với Anthropic: Đảm bảo tài khoản của bạn có quyền truy cập mô hình Claude mà bạn đang yêu cầu.

"Error: 429 Too Many Requests"​

  • Nguyên nhân: Bạn đã đạt giới hạn tần suất (rate limit) hoặc đã hết credit.
  • Cách khắc phục:
    • Đợi vài phút rồi thử lại (giới hạn tần suất).
    • Kiểm tra tình trạng thanh toán và nạp thêm credit trên trang web của nhà cung cấp.
    • Cân nhắc chuyển tạm sang một nhà cung cấp khác.

"Error: 500 Internal Server Error"​

  • Nguyên nhân: Máy chủ của nhà cung cấp đang gặp sự cố.
  • Cách khắc phục: Đợi vài phút rồi thử lại. Kiểm tra trang trạng thái (status page) của nhà cung cấp.

"Connection Refused" (Ollama)​

  • Nguyên nhân: Rephlo không thể kết nối tới máy chủ AI cục bộ.
  • Cách khắc phục:
    1. Mở một terminal và chạy ollama serve.
    2. Kiểm tra xem nó đã chạy chưa: truy cập http://localhost:11434 trên trình duyệt.
    3. Kiểm tra xem có ứng dụng nào khác đang dùng cổng 11434 hay không.

"Model Not Found" (Ollama)​

  • Nguyên nhân: Mô hình được yêu cầu chưa được tải xuống.
  • Cách khắc phục: Chạy ollama pull [model-name] trong terminal của bạn (ví dụ: ollama pull llama3).

Sự cố giao diện​

"Hotkeys are not working"​

  • Nguyên nhân (Windows/Linux): Một ứng dụng khác (như PowerToys hoặc một trò chơi) có thể đã chiếm mất phím tắt.
  • Cách khắc phục: Vào Settings > Hotkeys và đổi phím kích hoạt sang tổ hợp khác (ví dụ: Ctrl + Shift + Alt + Z).

Người dùng macOS: Xem Sự cố riêng trên macOS bên dưới để khắc phục sự cố phím tắt trên macOS.

"Tray Icon is Missing"​

  • Nguyên nhân: Windows có thể đã ẩn nó trong menu "overflow" (tràn).
  • Cách khắc phục: Nhấp vào mũi tên ^ gần đồng hồ hệ thống. Kéo biểu tượng Rephlo ra khu vực taskbar chính.

Sự cố tính năng​

"Vision/Screenshot not working"​

  • Nguyên nhân (Windows): Quyền ghi màn hình có thể đã bị từ chối trong cài đặt Windows Privacy.
  • Cách khắc phục (Windows): Chạy Rephlo với quyền Administrator hoặc kiểm tra Windows Privacy settings > Camera / Screen capture.
  • Nguyên nhân (macOS): Rephlo cần quyền Screen Recording.
  • Cách khắc phục (macOS): Xem Sự cố riêng trên macOS bên dưới để biết các bước chi tiết.

"Space is not answering questions"​

  • Nguyên nhân: Space có thể đang trống hoặc quá trình nạp dữ liệu (ingestion) bị lỗi.
  • Cách khắc phục: Kiểm tra chi tiết Space. Đảm bảo các tệp được liệt kê và trạng thái hiển thị "Ready". Thử xóa bộ nhớ đệm trong Advanced Settings.

"Variable not found in Space"​

  • Nguyên nhân: Bạn đang dùng biến {{filename}} nhưng tệp đó không có trong Space đang hoạt động.
  • Cách khắc phục:
    1. Kiểm tra xem Space có chứa tệp được tham chiếu hay không.
    2. Xác nhận tên biến khớp với tên tệp (đã chuyển sang snake_case, ví dụ: "Style Guide.pdf" -> {{style_guide_pdf}}).
    3. Đảm bảo đúng Space đang được kích hoạt.

Sự cố riêng trên macOS​

"Hotkeys are not working" (macOS)​

  • Nguyên nhân: Rephlo cần quyền Accessibility để phát hiện các phím tắt toàn cục.
  • Cách khắc phục:
    1. Mở System Settings > Privacy & Security > Accessibility.
    2. Tìm Rephlo trong danh sách và bật (ON).
    3. Nếu Rephlo không có trong danh sách, thoát và khởi động lại ứng dụng.
    4. Khởi động lại Rephlo sau khi cấp quyền.

Lưu ý quan trọng: Phím tắt toàn cục chỉ hoạt động khi chạy Rephlo dưới dạng gói .app đã được ký (signed). Nếu bạn là lập trình viên chạy dotnet run từ terminal, phím tắt có thể không hoạt động. Xem Hướng dẫn thiết lập trên macOS để biết cách build và chạy gói .app.

"Screenshot / Vision not working" (macOS)​

  • Nguyên nhân: Rephlo cần quyền Screen Recording để chụp nội dung màn hình.
  • Cách khắc phục:
    1. Mở System Settings > Privacy & Security > Screen Recording.
    2. Tìm Rephlo trong danh sách và bật (ON).
    3. Khởi động lại Rephlo.

"Permission dialog keeps appearing"​

  • Nguyên nhân: Rephlo đang chạy mà không có chữ ký mã (code signature) ổn định. Mỗi lần build lại sẽ thay đổi mã băm (hash) của tệp nhị phân, khiến macOS coi đây là một ứng dụng mới và đặt lại quyền.
  • Cách khắc phục: Dùng bản build phát hành (release) đã được ký từ kênh phân phối chính thức của Rephlo. Sau khi cấp quyền một lần cho ứng dụng đã ký, các quyền này sẽ được giữ nguyên qua các bản cập nhật.

"Overlay doesn't appear even after granting permissions"​

  • Cách khắc phục:
    1. Thoát hoàn toàn Rephlo (nhấp chuột phải vào biểu tượng khay hệ thống > Exit).
    2. Khởi động lại từ gói .app.
    3. Kiểm tra cả hai quyền Accessibility VÀ Screen Recording đã được cấp.
    4. Thử nút Test Overlay trong Settings > Hotkeys.

Sự cố hiệu năng​

"Responses are very slow"​

  • Nguyên nhân: Nhiều yếu tố khác nhau có thể làm chậm phản hồi.
  • Cách khắc phục:
    • Ngữ cảnh Space quá lớn: Cân nhắc nén (compact) Space của bạn.
    • Nhà cung cấp chậm: Chuyển sang một mô hình nhanh hơn như GPT-5.4 Mini hoặc Gemini 3.5 Flash để có phản hồi nhanh hơn.
    • Mô hình cục bộ (Ollama): Đảm bảo GPU đang được sử dụng. Kiểm tra log của Ollama.

"App feels sluggish on startup"​

  • Nguyên nhân: Đang tải các Space lớn hoặc quá nhiều lệnh.
  • Cách khắc phục: Lưu trữ (archive) các lệnh không dùng đến. Xóa các Space cũ mà bạn không còn cần.

Sự cố Chat​

"Chat history is missing"​

  • Nguyên nhân: Các cuộc trò chuyện được lưu trữ cục bộ và có thể đã bị xóa.
  • Cách khắc phục: Kiểm tra Settings > Privacy để xem cài đặt lưu giữ lịch sử. Nếu đang đặt là "Immediate", lịch sử sẽ không được giữ lại.

"Chat keeps forgetting context"​

  • Nguyên nhân: Bạn đã vượt quá cửa sổ ngữ cảnh (context window) của nhà cung cấp.
  • Cách khắc phục: Bắt đầu một cuộc trò chuyện mới hoặc dùng một nhà cung cấp có cửa sổ ngữ cảnh lớn hơn. Kiểm tra tài liệu của nhà cung cấp để biết kích thước cửa sổ ngữ cảnh cụ thể.

Sự cố Biến & Template​

"Variable not found" or "Invalid variable"​

  • Nguyên nhân: Tên biến không khớp với biến hệ thống hợp lệ hoặc tệp nào trong Space của bạn.
  • Cách khắc phục:
    • Dùng đúng cú pháp: {{input_content}}, {{space_data_all}}, hoặc {{filename}}.
    • Với biến tệp: Chuyển tên tệp sang snake_case (ví dụ: "Style Guide.pdf" -> {{style_guide_pdf}}).
    • Xác nhận tệp tồn tại trong Space đang hoạt động của bạn.
    • Kiểm tra lỗi gõ sai — tên biến không phân biệt hoa thường nhưng phải viết đúng chính tả.

"Space variables ignored in Standalone mode"​

  • Nguyên nhân: Các lệnh Standalone không tự động chèn dữ liệu Space.
  • Giải thích: Chế độ Standalone cho bạn toàn quyền kiểm soát thủ công. Các biến như {{space_data_all}} sẽ không được tự động thay thế.
  • Cách khắc phục: Chuyển sang chế độ Combination để tự động chèn dữ liệu Space, hoặc tự dán dữ liệu Space vào prompt của bạn.

Sự cố Space​

"Space full" or "Token budget exceeded"​

  • Nguyên nhân: Space của bạn đã vượt quá giới hạn token đã cấu hình.
  • Cách khắc phục:
    1. Mở giao diện xem dữ liệu của Space và xem lại mức sử dụng hiện tại.
    2. Xóa các tệp ít quan trọng hơn khỏi Space, hoặc tăng ngân sách token (tối đa 1.000.000 token) — hai cách này trực tiếp giảm bớt cho một Space đang vượt ngân sách lưu trữ.
    3. Chuyển chế độ dữ liệu sang 🗜️ Compact để lưu tóm tắt do AI tạo thay vì toàn bộ văn bản — cách này giảm số token được tính của Space (hãy xác nhận chi phí credit). Sau đó chọn một mức nén:
      • Conservative: Tóm tắt tối thiểu (giữ lại chi tiết).
      • Balanced: Tóm tắt vừa phải (mặc định, được khuyến nghị).
      • Aggressive: Tóm tắt mạnh (phù hợp nhất cho các Space rất lớn).
      • Lưu ý: với một Space rất lớn (≈128.000 token trở lên), Compact bị vô hiệu hóa theo thiết kế — thay vào đó hãy xóa tệp hoặc tăng ngân sách.
    4. Lưu ý: 🔍 Smart Search giữ cho mỗi yêu cầu nhỏ gọn bằng cách chỉ gửi những đoạn văn bản liên quan, nhưng vẫn tính toàn bộ văn bản gốc vào ngân sách của Space — vì vậy nó kiểm soát chi phí theo từng yêu cầu, chứ không giải quyết một Space đang vượt giới hạn lưu trữ.

"Space ingestion failed" (PDF/document error)​

  • Nguyên nhân: Tệp không thể xử lý được — có thể bị hỏng, được bảo vệ bằng mật khẩu, hoặc ở định dạng không được hỗ trợ.
  • Cách khắc phục:
    • Đảm bảo tệp PDF không được bảo vệ bằng mật khẩu.
    • Thử xuất lại tài liệu từ ứng dụng gốc.
    • Với PDF dạng quét (scanned): Rephlo chỉ trích xuất văn bản — hình ảnh bên trong PDF không được đọc.
    • Kiểm tra tệp không bị hỏng bằng cách mở thử trong một ứng dụng khác trước.

Sự cố Tạo ảnh​

"This prompt was blocked by our content policy"​

  • Nguyên nhân: Prompt tạo ảnh của bạn đã bị hệ thống kiểm duyệt nội dung đánh dấu và từ chối trước khi quá trình tạo ảnh diễn ra.
  • Cách khắc phục: Viết lại prompt để loại bỏ nội dung không được phép và thử lại. Xem trang Chính sách Nội dung để biết những gì không được phép.

"Content moderation is temporarily unavailable"​

  • Nguyên nhân: Dịch vụ kiểm duyệt nội dung tạm thời gặp sự cố (gián đoạn tạm thời), nên prompt của bạn không thể được kiểm tra.
  • Cách khắc phục: Vui lòng chờ một lát rồi thử lại.

Nhận trợ giúp​

Làm sao để báo cáo kết quả AI có hại hoặc không phù hợp?​

  • Cách khắc phục:
    • Đã đăng nhập: Nhấp vào ảnh đại diện của bạn ở cuối thanh bên > Help > Report inappropriate content.
    • Bất cứ lúc nào: Mở Settings > About > Contact & Support > Report inappropriate content.
    • Thao tác này sẽ mở rephlo.app/contact trên trình duyệt của bạn với danh mục báo cáo đã được chọn sẵn.