Khắc phục sự cố và nhận trợ giúp trong Prism

Prism là không gian làm việc LaTeX cộng tác, ưu tiên AI, được xây dựng trên các mô hình tiên phong—được thiết kế để giúp các nhà nghiên cứu suy nghĩ, viết và lặp nhanh hơn. Trí tuệ tích hợp của nó khuếch đại cả tốc độ lẫn chiều sâu của công việc khoa học.

Hướng dẫn này trình bày cách khắc phục các sự cố thường gặp và nơi tìm thêm trợ giúp.

Cách truy cập Prism

Prism hiện có tại prism.openai.com cho tất cả người dùng có tài khoản ChatGPT Free, Go, Plus hoặc Pro, miễn là hiện không phải và trước đây chưa từng là thành viên của một không gian làm việc Business hoặc Enterprise. Chúng tôi sẽ sớm mở rộng quyền truy cập cho Business, Enterprise và Edu.

1. Sử dụng trí tuệ tích hợp của Prism

Prism bao gồm một trợ lý tích hợp ngay trong trình soạn thảo, được hỗ trợ bởi các mô hình tiên phong của OpenAI. Trợ lý này hiểu ngữ cảnh tài liệu của bạn và có thể giúp tạo LaTeX, chẩn đoán lỗi và đề xuất cách sửa mà không cần rời khỏi trình soạn thảo. Bạn có thể truy cập nó từ bảng ở dưới cùng của không gian làm việc.

1. Tạo đoạn LaTeX: Yêu cầu Prism tạo các thành phần LaTeX phổ biến, chẳng hạn như “Tạo bảng 4×4” hoặc “Thêm hình có chú thích.” Prism sẽ trả về LaTeX sẵn dùng và cung cấp các tùy chọn Keep và Undo để bạn có thể chèn trực tiếp vào dự án của mình.

2. Chẩn đoán sự cố biên dịch: Nếu tài liệu của bạn không biên dịch được, hãy mô tả sự cố trong bảng điều khiển (ví dụ: “Tài liệu của tôi không biên dịch được”). Prism sẽ đặt câu hỏi làm rõ và hướng dẫn bạn qua các nguyên nhân có khả năng xảy ra, chẳng hạn như thiếu lệnh hoặc tham chiếu chưa được giải quyết.

3. Sửa lỗi ngay tại chỗ: Lỗi và cảnh báo xuất hiện dưới dạng dấu màu đỏ hoặc vàng ở lề trình soạn thảo. Bạn có thể yêu cầu Prism sửa một lỗi cụ thể, và nó sẽ phân tích các dòng liên quan, giải thích điều gì sai và đề xuất các chỉnh sửa có mục tiêu. Bạn có thể áp dụng trực tiếp đề xuất đó và biên dịch lại để xác nhận bản sửa.

4. Đọc soát: Yêu cầu Prism đọc soát một phần và nêu bật mọi lỗi hoặc lỗ hổng trong logic, đồng thời đưa ra gợi ý về cách tôi có thể cải thiện độ rõ ràng của phần đó. Bạn có thể tận dụng Skills, chẳng hạn như Paper Review, để nhận phản hồi về biên tập và tính thực tế.

5. Tìm kiếm tài liệu: Thêm thư mục tài liệu tham khảo vào bài báo của tôi, bao gồm cả việc gợi ý các công trình liên quan mà tôi có thể đã bỏ sót.

2. Chẩn đoán lỗi biên dịch

Nếu tài liệu LaTeX của bạn không biên dịch được, hãy thử các bước sau:

1. Kiểm tra dấu báo lỗi: Các dấu màu đỏ và vàng làm nổi bật nơi Prism phát hiện sự cố. Nhấp vào dấu đó để xem chi tiết, rồi dùng trợ lý tích hợp để chẩn đoán lỗi.

2. Xem lại nhật ký biên dịch: Khi biên dịch thất bại, khung xem trước PDF sẽ hiển thị nhật ký biên dịch. Hãy tập trung vào thông báo lỗi đầu tiên (ví dụ, thiếu \end{document}), vì các lỗi về sau thường là hiệu ứng dây chuyền. Chia sẻ thông báo này với Prism để nhận hướng dẫn chính xác hơn.

3. Hoàn tác các thay đổi gần đây: Nếu lỗi xuất hiện sau một chỉnh sửa gần đây, hãy hoàn tác hoặc tạm thời comment thay đổi đó để xem việc biên dịch có thành công không.

4. Rút gọn thành ví dụ tối thiểu: Nếu sự cố vẫn tiếp diễn, hãy đơn giản hóa tài liệu để chỉ còn nội dung thiết yếu. Việc loại bỏ các phần không liên quan sẽ giúp cô lập nguồn gây lỗi.

3. Các phương pháp hay nhất để tránh sự cố

1. Luôn đăng nhập: Luôn làm việc khi đã đăng nhập để bảo đảm các thay đổi của bạn được lưu và khả dụng trong các phiên khác nhau.

2. Dùng các gói được hỗ trợ: Prism hỗ trợ nhiều gói LaTeX thường dùng. Các gói hiếm, lỗi thời hoặc không còn được duy trì có thể gây ra lỗi biên dịch ngoài dự kiến.

3. Chỉnh sửa từng bước: Thực hiện các thay đổi nhỏ và biên dịch thường xuyên. Điều này giúp dễ xác định chỉnh sửa nào đã gây ra lỗi và khôi phục nhanh hơn.

Chuyển dự án LaTeX sang Prism

Hướng dẫn này giải thích cách chuyển các dự án LaTeX hiện có—từ Overleaf hoặc từ máy tính cục bộ của bạn—vào prism. Việc nhập các dự án giúp giữ mọi thứ ở một nơi và cho phép bạn tiếp tục làm việc mà không phải dựng lại các tệp theo cách thủ công.

Nhập dự án từ Overleaf

Để chuyển một dự án từ Overleaf sang prism, trước tiên hãy tải các tệp dự án xuống từ Overleaf rồi tải chúng lên prism.

Tải xuống một dự án

1. Mở bảng điều khiển dự án Overleaf của bạn.

2. Xác định dự án bạn muốn chuyển.

3. Nhấp vào biểu tượng tải xuống trên cùng hàng với tên dự án.

4. Overleaf sẽ tải toàn bộ dự án xuống máy tính của bạn dưới dạng tệp .zip.

Tải xuống nhiều dự án

1. Mở danh sách dự án Overleaf của bạn.

2. Chọn các dự án bằng ô chọn ở đầu mỗi hàng.

   

3. Để chọn tất cả, hãy nhấp vào ô chọn đầu tiên trong danh sách.

4. Sau khi chọn xong, hãy nhấp vào biểu tượng tải xuống ở góc trên bên phải của danh sách dự án.

   

Các dự án đã chọn sẽ được tải xuống dưới dạng tệp .zip.

Nhập dự án vào Prism

Prism có thể nhập dự án theo ba cách: tải lên một thư mục, tải lên một tệp nén .zip, hoặc kéo và thả tệp vào chế độ xem All Projects.


Để nhập một dự án từ menu Import:

1. Mở Prism và đi tới Import.

2. Nhấp vào dấu chevron bên cạnh Import để chọn kiểu nhập.

Chọn một trong các mục sau:

1. Mở prism và điều hướng đến tùy chọn Import.

2. Nhấp vào dấu chevron bên cạnh Import để chọn kiểu nhập.

3. Chọn một trong các mục sau:

Nhập tệp .zip: Chọn tệp nén dự án đã tải xuống từ máy tính của bạn. Prism sẽ tự động giải nén và tải dự án.

Nhập thư mục: Chọn thư mục dự án từ máy tính của bạn. Prism sẽ nhập các tệp .tex, tệp thư mục tài liệu tham khảo, hình ảnh và các tài nguyên dự án khác.

Để nhập bằng kéo và thả: Từ chế độ xem All Projects, kéo và thả một thư mục dự án hoặc tệp .zip vào Prism. Prism sẽ tự động tạo một dự án mới và nhập các tệp cho bạn.

Sau khi tải lên hoàn tất, Prism sẽ mở toàn bộ dự án để bạn có thể bắt đầu chỉnh sửa và biên dịch.

Các câu hỏi thường gặp khác

Tài khoản, bảo mật và thanh toán

H: Tôi có thể tìm chính sách quyền riêng tư của bạn ở đâu?
Đ: Bạn có thể tìm chính sách quyền riêng tư của Prism tại đây.

H: Các bạn có huấn luyện trên dữ liệu của tôi không?
Đ: Người dùng có toàn quyền kiểm soát việc dữ liệu của họ có được dùng để giúp cải thiện các mô hình của chúng tôi hay không, phù hợp với Chính sách quyền riêng tư.

H: Các bạn có dùng “không lưu giữ dữ liệu” (ZDR) không? Việc ghi nhật ký/lưu giữ diễn ra như thế nào?
Đ: Prism hiện không dùng tùy chọn API “không lưu giữ dữ liệu” (ZDR) và duy trì nhật ký trong một khoảng thời gian sau các yêu cầu để cải thiện sản phẩm.


H: Các bạn có cung cấp chế độ riêng tư trong đó không có văn bản nào được lưu trữ hoặc con người xem xét, và/hoặc nơi lưu trú dữ liệu chỉ tại EU không?
Đ: Đây là những tính năng đã được yêu cầu; chúng nằm trong lộ trình/danh sách chờ phát triển, nhưng hiện chưa có mốc thời gian cam kết.

Chia sẻ và cộng tác

H: Vì sao tôi không thể chia sẻ liên kết “bất kỳ ai cũng có thể chỉnh sửa”? (Menu thả xuống chỉ cho phép “bất kỳ ai cũng có thể xem”.)
Đ: Đây hiện là chủ đích thiết kế. Chia sẻ bằng liên kết theo kiểu “bất kỳ ai có liên kết đều chỉnh sửa được” hiện chưa được hỗ trợ; người chỉnh sửa phải được thêm làm cộng tác viên (với tài khoản Prism).

H: Cộng tác viên không nhận được email mời—họ có thể truy cập dự án bằng cách nào?
Đ: Hãy bảo họ kiểm tra thư mục spam/thư rác, và đăng nhập bằng địa chỉ email đã được mời; dự án được chia sẻ sẽ xuất hiện với họ sau lần đăng nhập đầu tiên.

Nhập và xuất dự án

H: Tải lên/nhập ZIP của tôi bị kẹt ở “đang nhập dự án của bạn”. Tôi nên làm gì?
Đ: Hãy thử tải lên lại. Nếu vẫn bị kẹt sau khi thử lại, hãy chia sẻ tệp ZIP với bộ phận Hỗ trợ để đường dẫn nhập có thể được gỡ lỗi.

H: Làm thế nào để xuất/tải xuống dự án của tôi dưới dạng ZIP?
Đ: Nhấp vào tên dự án, rồi chọn Export để tải xuống một bản nén của dự án. Có thể mất vài giây để kết nối backend được thiết lập trước khi bạn có thể xuất.

Độ tin cậy, sự cố ngừng hoạt động và kết nối

H: Các dự án của tôi biến mất sau khi làm mới. Chúng có bị mất không?
Đ: Hãy làm mới lại lần nữa và kiểm tra lại danh sách dự án, dữ liệu của bạn sẽ xuất hiện lại.

H: Các dự án của tôi biến mất sau khi làm mới trang. Chúng có bị mất không?
Đ: Điều này có thể xảy ra trong thời gian gián đoạn từ một nhà cung cấp. Hãy thử lại; các dự án của bạn sẽ xuất hiện lại. Nếu không, bộ phận hỗ trợ có thể giúp khôi phục chúng.

H: Trang có vẻ đang ngoại tuyến / ứng dụng báo không thể kết nối với backend. Tôi nên làm gì?
Đ: Hãy thử lại/tải lại. Nếu sự cố vẫn tiếp diễn, hãy gửi cho bộ phận hỗ trợ chi tiết về những gì bạn đang thấy (và nếu có thể, cả liên kết dự án) để họ điều tra.

Tính toàn vẹn dữ liệu, khôi phục, sao lưu và lịch sử phiên bản

H: Tài liệu của tôi bị treo, rồi nội dung biến mất và các neo bình luận bị di chuyển. Tôi có thể khôi phục không?
Đ: Hãy bắt đầu bằng cách tải xuống một bản sao lưu .zip. Prism cũng có lịch sử phiên bản, có thể cho phép bạn khôi phục phiên bản trước đó. Vị trí neo bình luận có thể không phải lúc nào cũng khôi phục được, và các bình luận hiện chưa được xuất trong các bản sao lưu. Nếu định dạng bị thay đổi, hãy thử trình định dạng mã để sửa lại.

H: Tôi mở lại một dự án và tệp/nội dung đã bị hoàn nguyên hoặc biến mất—đã xảy ra chuyện gì?
Đ: Đã có một giai đoạn việc lưu dự án phụ thuộc vào một nhà cung cấp bên ngoài không thể theo kịp trong thời điểm mức sử dụng tăng đột biến. Việc lưu đã được chuyển sang một hệ thống nội bộ để giảm lỗi kết nối và ngăn sự việc tái diễn, đồng thời đã bổ sung thêm các biện pháp bảo vệ.

H: Có thể khôi phục vị trí bình luận không, và các bình luận có được đưa vào bản sao lưu dự án không?
Đ: Vị trí bình luận có thể không khôi phục được sau khi sự việc đã xảy ra. Hiện đã có các bản sao lưu định kỳ (ví dụ: khoảng mỗi 10 phút) để phục hồi trong các sự cố sau này, nhưng các bình luận hiện chưa được xuất trong các bản sao lưu ZIP.

Tích hợp

Zotero

H: Vì sao tôi không thể nhập các thư viện nhóm Zotero vào Prism?
Đ: Các thư viện nhóm Zotero hiện chưa được hỗ trợ; các thư viện cá nhân thì hoạt động, nhưng thư viện nhóm hiện chưa được hỗ trợ.

H: Tích hợp Zotero của tôi bị kẹt (ví dụ: sau khi đổi tài khoản hoặc khóa API). Có thể khắc phục thế nào?
Đ: Bộ phận Hỗ trợ sẽ cần ID số Zotero của bạn (không phải tên người dùng) để hủy liên kết tích hợp khỏi người dùng trước đó/người dùng ẩn danh, sau đó bạn có thể liên kết lại với tài khoản của mình. Ví dụ cách thực hiện: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

H: Tôi có thể sao chép một dự án Prism qua Git (GitHub/GitLab) hoặc giữ đồng bộ với nền tảng Git của viện mình không?
Đ: Tích hợp Git hiện chưa có, nhưng đây là một dự án phát triển sắp tới có mức ưu tiên cao.

Biên dịch LaTeX và khắc phục sự cố

H: Làm thế nào để buộc dựng lại sạch (xóa các artifact Aux/toc/bbl)?
Đ: Tải lại trang. Làm mới trang sẽ buộc thực hiện một lần dựng mới, sạch.

H: Hình/sơ đồ không tải được trong Prism, nhưng cùng mã LaTeX đó lại hoạt động ở nơi khác.
Đ: Hãy dùng các đường dẫn tương đối so với tệp .tex đang thực hiện việc nhập. Nếu tệp .tex nằm trong một thư mục con và ảnh ở thư mục gốc của dự án, hãy thêm tiền tố ../ vào đường dẫn.

H: Việc biên dịch cực kỳ chậm hoặc không bao giờ hoàn tất. Làm thế nào để xác định nguyên nhân?
Đ: Hãy comment các phần (rồi đến các phần nhỏ hơn bên trong các phần đó) cho đến khi biên dịch thành công, sau đó thu hẹp xuống dòng chính xác gây ra sự cố. Đồng thời xem lại các cảnh báo và lỗi trong nhật ký, bắt đầu từ lỗi đầu tiên.

H: Tôi nhận được cảnh báo “Underfull/Overfull \hbox” trong tệp .bbl được tạo ra. Đây có phải lỗi biên dịch không?
Đ: Không, đây là các cảnh báo dàn trang chứ không phải lỗi biên dịch nghiêm trọng. Nếu đầu ra PDF trông chấp nhận được, cảnh báo này thường có thể bỏ qua.

H: Trong Beamer, vì sao các môi trường lstlisting/listings báo lỗi bên trong một frame (ví dụ: “Extra }, or forgotten \endgroup”)?
Đ: Hãy đánh dấu frame Beamer là [fragile] khi dùng các môi trường listing; cách này thường giải quyết được các lỗi đó.

H: Các trích dẫn \cite của tôi hiển thị thành “[?]” dù tệp .bib của tôi có tồn tại và các lệnh thư mục tài liệu tham khảo đều có. Cấu hình nào hoạt động?
Một cách khắc phục đã thành công là bảo đảm thư mục tài liệu tham khảo được đưa đúng cách từ tài liệu chính; với quy trình kiểu BibTeX, hãy thêm \bibliographystyle{plain} và \bibliography{refs} (trong đó refs.bib là tệp của bạn).

Giao diện sản phẩm và yêu cầu tính năng

H: Prism có chế độ sáng không?
Đ: Có. Prism hỗ trợ ba cài đặt giao diện: Hệ thống, Sáng và Tối. Bạn có thể chọn chủ đề phù hợp nhất với mình.