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
Phần tiêu đề “Bắt đầu”Tôi có cần tài khoản không?
Phần tiê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?
Phần tiêu đề “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 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?
Phần tiêu đề “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 để chọn đúng hướng.
Tôi có thể làm việc ngoại tuyến không?
Phần tiêu đề “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?
Phần tiêu đề “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 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?
Phần tiêu đề “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 hoặc quy trình CV. 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
Phần tiêu đề “Cài đặt”Hệ điều hành chặn trình cài đặt
Phần tiêu đề “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 (mở trong thẻ mới) và khớp với nền tảng của bạn. Làm theo hướng dẫn cài đặt để 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?
Phần tiêu đề “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 để biết yêu cầu hệ thống.
Biên dịch
Phần tiêu đề “Biên dịch”Lần biên dịch đầu tiên của tôi chậm
Phần tiêu đề “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 để xem điều gì đang diễn ra.
Thiếu một gói
Phần tiêu đề “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.
Tôi chọn pdfLaTeX và Oleafly yêu cầu một bản phân phối TeX
Phần tiêu đề “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.
MiKTeX báo latexmk cần Perl
Phần tiêu đề “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.
PDF của tôi thiếu chữ
Phần tiêu đề “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 và Ký tự hiện thành ô vuông.
Oleafly dừng lần biên dịch của tôi vì quá lâu
Phần tiêu đề “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?
Phần tiêu đề “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.
Tài liệu của tôi dùng minted hoặc PythonTeX
Phần tiêu đề “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.
Quá trình biên dịch kết thúc với cảnh báo
Phần tiêu đề “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 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
Phần tiêu đề “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.
Vì sao thiếu một định dạng xuất?
Phần tiêu đề “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.
Trợ lý AI
Phần tiêu đề “Trợ lý AI”Tôi có thể dùng trợ lý nào?
Phần tiêu đề “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. Thiết lập AI đề cập từng hướng đi.
Tôi có cần AI để dùng trình soạn thảo không?
Phần tiêu đề “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ì?
Phần tiêu đề “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ụ.
Verified bên cạnh tên mô hình có nghĩa là gì?
Phần tiêu đề “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.
Vì sao mức sử dụng hiển thị là Unknown?
Phần tiêu đề “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.
Tôi có thể kết nối một trợ lý ngoài không?
Phần tiêu đề “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 tích hợp sẵn, bật máy chủ MCP cục bộ của Oleafly, hoặc kết nối agent của bạn với lệnh oleafly, lệnh này còn hoạt động cả khi ứng dụng đang đóng.
Lịch sử và hợp tác
Phần tiêu đề “Lịch sử và hợp tác”Làm thế nào để khôi phục một phiên bản cũ?
Phần tiêu đề “Làm thế nào để khôi phục một phiên bản cũ?”Mở 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 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?
Phần tiêu đề “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, 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 để trao đổi commit.
Tôi có thể dùng dự án trên hai máy tính không?
Phần tiêu đề “Tôi có thể dùng dự án trên hai máy tính không?”Có. 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.
Xuất mã nguồn có sao lưu được tất cả mọi thứ không?
Phần tiêu đề “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 để bao gồm những gì bạn cần.
Báo cáo một vấn đề
Phần tiêu đề “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 (mở trong thẻ mới); dùng cộng đồng Discord cho các câu hỏi và trợ giúp về quy trình.