# FAQ & khắc phục sự cố

Câu trả lời nhanh về cách bắt đầu, dự án, biên dịch, trợ lý và sao lưu.

## Bắt đầu

### Tôi có cần tài khoản không?

Không. Tải Oleafly xuống, mở ứng dụng và bắt đầu viết. Các dịch vụ tùy chọn như nhà cung cấp AI trên đám mây, GitHub hay Dropbox dùng tài khoản riêng của chúng.

### Oleafly có hỗ trợ LaTeX, Typst và Markdown không?

Có. Chọn engine khi bạn tạo dự án. Mỗi engine có khả năng soạn thảo và xuất riêng. [Hướng dẫn bắt đầu nhanh](/docs/getting-started/) sẽ dẫn bạn qua tệp PDF đầu tiên.

### Tôi có thể mang vào một bài báo hay CV sẵn có không?

Có. Nhập mã nguồn dự án, một tệp nén ZIP hoặc một kho Git. Oleafly cũng có các đường chuyển đổi cho DOCX và PDF dạng văn bản. Đọc [Mang một dự án sẵn có vào Oleafly](/docs/import-project/) để chọn đúng hướng.

### Tôi có thể làm việc ngoại tuyến không?

Bạn có thể viết, sắp xếp tệp, dùng tính năng soát lỗi cục bộ và chạy một mô hình AI cục bộ đã tải xuống mà không cần kết nối đám mây. Tectonic có thể biên dịch bằng các gói đã có trong bộ nhớ đệm. Gói mới, tham chiếu từ xa, mô hình đám mây, GitHub và các bản tải xuống cần kết nối. Hãy chuẩn bị dự án với một lần biên dịch thành công trước khi đưa nó ra ngoại tuyến.

### Tệp của tôi nằm ở đâu?

Các dự án của bạn là những thư mục thông thường trong thư viện cục bộ. Bạn có thể sao chép, sao lưu hoặc mở chúng bằng công cụ khác. [Nơi dữ liệu của bạn nằm](/docs/where-your-data-lives/) giải thích về tệp dự án, cài đặt ứng dụng và các điểm kiểm tra.

### Tôi có thể dùng Oleafly cho luận văn hay CV không?

Có. Bắt đầu với [quy trình luận văn](/docs/workflows/thesis/) hoặc [quy trình CV](/docs/workflows/resume/). Cả hai đều dùng cùng trình soạn thảo, bản xem trước, tài liệu tham khảo và công cụ xuất như với một bài báo nghiên cứu.

## Cài đặt

### Hệ điều hành chặn trình cài đặt

Kiểm tra rằng tệp đến từ [các bản phát hành chính thức](https://github.com/Oleafly/Oleafly/releases/latest) và khớp với nền tảng của bạn. Làm theo [hướng dẫn cài đặt](/docs/install/#first-launch) để biết các bước khởi động lần đầu trên nền tảng đó.

### Nên dùng gói Linux nào?

Chọn kiến trúc khớp với máy tính của bạn, cùng gói AppImage, gói Debian, hoặc RPM. Xem [Cài đặt trên Linux](/docs/install/#linux) để biết yêu cầu hệ thống.

## Biên dịch

### Lần biên dịch đầu tiên của tôi chậm

Tectonic có thể cần tải xuống các gói mà tài liệu này dùng, và lần biên dịch đầu tiên trên một máy tính cũng tải về một loạt gói thông dụng. Chúng được lưu vào bộ nhớ đệm cho các lần dựng sau. Khi các gói vẫn đang tải, lần biên dịch có thể chạy quá giới hạn năm phút thông thường. Mở [Logs](/docs/compiling/#reading-the-logs) để xem điều gì đang diễn ra.

### Thiếu một gói

Nếu Offline mode đang bật, hãy chọn **Turn off and compile** trong thông báo, hoặc tắt nó trong một lần biên dịch để tải gói đó về. Với bộ công cụ TeX của hệ thống, dùng **Find and install** trong thông báo lỗi. TeX Live từ Debian, Ubuntu hoặc Fedora nhận gói của nó qua `apt` hoặc `dnf`. Xem [Engine và gói LaTeX](/docs/latex-engines/#recover-from-a-missing-file).

### Tôi chọn pdfLaTeX và Oleafly yêu cầu một bản phân phối TeX

pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX và pLaTeX chạy trên một bản phân phối TeX được cài trên máy tính của bạn. Khi chưa có, chọn bất kỳ trình nào trong số đó sẽ mở một hộp thoại trước khi có gì được biên dịch. Chọn **Download and use TinyTeX** để cài một bản, hoặc **Switch back to Tectonic** để quay lại engine tích hợp sẵn. Sau một lần biên dịch thất bại, bản xem trước đề xuất cùng lựa chọn đó dưới dạng **Download and use TinyTeX** và **Use Tectonic**. Xem [Khi chưa cài TeX](/docs/latex-engines/#when-no-tex-is-installed).

### MiKTeX báo latexmk cần Perl

`latexmk` của MiKTeX chạy trên Perl, thứ mà MiKTeX không kèm theo. Cài Strawberry Perl, hoặc cài TinyTeX từ **Settings → Engines → LaTeX**, bản này tự mang theo Perl và tiếp quản việc biên dịch từ MiKTeX. Xem [MiKTeX và Perl](/docs/latex-engines/#miktex-and-perl).

### PDF của tôi thiếu chữ

Phông chữ không có glyph cho các ký tự đó. Điều này xảy ra nhiều nhất với văn bản tiếng Hàn, tiếng Trung và tiếng Nhật, và TeX bỏ các ký tự đó đi mà không làm lần biên dịch thất bại. Oleafly cảnh báo bạn và liệt kê chúng trong nhật ký. Trong LaTeX, hãy dán đoạn thiết lập mà cảnh báo đưa ra cho hệ chữ của bạn. Trong Typst, tải gói phông chữ mà thông báo đề xuất, hoặc thêm một phông chữ có các ký tự đó vào thư mục `fonts` của dự án. Trong Markdown, đặt `mainfont` hoặc `CJKmainfont` trong phần đầu YAML thành một phông chữ có chúng. Xem [Ký tự bị thiếu trong PDF](/docs/latex-engines/#characters-missing-from-the-pdf) và [Ký tự hiện thành ô vuông](/docs/typst/#characters-that-show-as-boxes).

### Oleafly dừng lần biên dịch của tôi vì quá lâu

Một lần biên dịch có thể chạy trong 5 phút. Khi các gói vẫn đang tải, giới hạn kéo dài tới 30 phút. Markdown sang PDF được 15 phút, còn Quarto và Calepin được một giờ. Hãy biên dịch lại: lượt tải tiếp tục từ chỗ nó dừng. Với bản nháp dài trên Tectonic, đặt **Compile mode** thành **Fast** trong menu biên dịch.

### Dự án mới có thể dùng bản cài TeX riêng của tôi không?

Có. Mở **Settings → Engines → LaTeX** và đặt **Default compile engine** thành **latexmk (system TeX)**. Các dự án LaTeX mới, nhập vào và chuyển đổi sẽ khởi đầu trên đó. Xem [Đặt mặc định cho dự án mới](/docs/engines/#set-a-default-for-new-projects).

### Tài liệu của tôi dùng minted hoặc PythonTeX

Các gói này chạy những chương trình khác trong khi tài liệu biên dịch, điều mà Oleafly chặn theo mặc định. Chúng cần LaTeX của hệ thống. Nếu bạn tin tưởng mọi tệp trong dự án, hãy chọn **Allow external commands** trong dải thông báo phía trên trình soạn thảo. Xem [Cho phép lệnh ngoài](/docs/latex-engines/#allow-external-commands).

### Quá trình biên dịch kết thúc với cảnh báo

Mở **Logs** và kiểm tra trước các trích dẫn và tham chiếu chưa được định nghĩa. [Preflight](/docs/preflight/) giúp tìm các vị trí mã nguồn bị ảnh hưởng trước khi bạn xuất.

### Tôi không hiểu một lỗi biên dịch

Hãy nhờ trợ lý đọc nhật ký, sửa lỗi và biên dịch lại. Dùng **Ask for approval** khi bạn muốn xem xét các hành động được đề xuất trong suốt quá trình. Bạn cũng có thể đăng nhật ký lên diễn đàn trợ giúp trên [Discord](/discord).

### Vì sao thiếu một định dạng xuất?

Các định dạng khả dụng tùy thuộc vào engine và loại tài liệu. Xem [bảng định dạng xuất](/docs/export/#editable-formats).

## Trợ lý AI

### Tôi có thể dùng trợ lý nào?

Kết nối một nhà cung cấp mô hình, dùng mô hình cục bộ, hoặc chọn một [CLI agent](/docs/cli-agents/). [Thiết lập AI](/docs/ai-setup/) đề cập từng hướng đi.

### Tôi có cần AI để dùng trình soạn thảo không?

Không. Viết, biên dịch, trích dẫn, bản xem trước, sơ đồ, lịch sử dự án và xuất đều khả dụng mà không cần trợ lý.

### Trợ lý có thể làm gì?

Nó có thể làm việc với các tệp dự án, tra cứu nguồn tài liệu, xem xét PDF, tạo hình, chạy công cụ và giúp sửa một lần dựng. Chọn chế độ lập kế hoạch và chính sách phê duyệt phù hợp với công việc. Xem [Trò chuyện & công cụ](/docs/ai-chat/).

### Verified bên cạnh tên mô hình có nghĩa là gì?

Mô hình đã vượt qua một bài kiểm tra gọi công cụ. Dấu hiệu này giúp bạn chọn mô hình cho các hành động trong dự án; nó không đánh giá chất lượng văn phong hay nghiên cứu của mô hình. Xem [Thiết lập AI](/docs/ai-setup/).

### Vì sao mức sử dụng hiển thị là Unknown?

Một số nhà cung cấp và CLI agent không báo cáo mức sử dụng. Unknown nghĩa là giá trị này không có sẵn. Đọc [Mức sử dụng & ngân sách](/docs/ai-usage/).

### Tôi có thể kết nối một trợ lý ngoài không?

Có. Dùng một [kết nối CLI agent](/docs/cli-agents/) tích hợp sẵn, bật [máy chủ MCP](/docs/mcp/) cục bộ của Oleafly, hoặc kết nối agent của bạn với [lệnh `oleafly`](/docs/cli/), lệnh này còn hoạt động cả khi ứng dụng đang đóng.

## Lịch sử và hợp tác

### Làm thế nào để khôi phục một phiên bản cũ?

Mở [Checkpoints](/docs/checkpoints/) để so sánh mã nguồn từ các lần dựng thành công và khôi phục một phiên bản. Dùng [Source Control](/docs/git-history/) cho các commit Git mà bạn tự quản lý.

### Tôi có thể làm việc với đồng tác giả không?

Có. Với [hợp tác trực tiếp](/docs/collaboration/), bạn và các đồng tác giả cùng chỉnh sửa một dự án tại cùng một thời điểm qua một máy chủ hợp tác do nhóm của bạn vận hành. Mỗi người giữ dự án dưới dạng tệp trên máy của riêng mình. Bạn cũng có thể chia sẻ tệp nén mã nguồn hoặc dùng [đồng bộ GitHub](/docs/github-sync/) để trao đổi commit.

### Tôi có thể dùng dự án trên hai máy tính không?

Có. [Cloud sync](/docs/cloud-sync/) giữ các dự án trong thư viện và cài đặt của bạn bên trong Dropbox riêng của bạn, và mỗi máy tính bạn kết nối đều có thể tải chúng xuống. Mở **Settings → Data Storage → Cloud sync** để kết nối nó. Bạn cũng có thể chuyển một dự án giữa các máy tính bằng [đồng bộ GitHub](/docs/github-sync/).

### Xuất mã nguồn có sao lưu được tất cả mọi thứ không?

Nó sao lưu mã nguồn dự án. Các điểm kiểm tra tự động, tùy chọn ứng dụng và thông tin xác thực nằm riêng. Làm theo [hướng dẫn sao lưu](/docs/where-your-data-lives/#back-up-your-work) để bao gồm những gì bạn cần.

## Báo cáo một vấn đề

Mở **Settings → Help & About → Copy Info** và kèm các chi tiết đó cùng mô tả ngắn, các bước tái hiện vấn đề và nhật ký liên quan. Báo cáo trong [Issues](https://github.com/Oleafly/Oleafly/issues); dùng [cộng đồng Discord](/discord) cho các câu hỏi và trợ giúp về quy trình.
