Khắc phục sự cố

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

Bảng bên hiển thị các tệp mà Codex không chỉnh sửa

Nếu dự án của bạn nằm trong kho lưu trữ Git, bảng đánh giá sẽ tự động hiển thị các thay đổi dựa trên trạng thái Git của dự án, bao gồm cả những thay đổi mà Codex không thực hiện.

Trong ngăn đánh giá, bạn có thể chuyển đổi giữa các thay đổi đã đưa vào vùng chờ và các thay đổi chưa được đưa vào vùng chờ, đồng thời so sánh nhánh của bạn với main.

Nếu chỉ muốn xem các thay đổi từ lượt Codex gần nhất, hãy chuyển ngăn diff sang chế độ xem Lượt gần nhất.

Tìm hiểu thêm về cách sử dụng ngăn đánh giá.

Xóa dự án khỏi thanh bên

Để xóa một dự án khỏi thanh bên, hãy di chuột lên tên dự án, chọn biểu tượng ba chấm rồi chọn Xóa. Để khôi phục, hãy thêm lại dự án bằng nút Thêm dự án mới bên cạnh Cuộc trò chuyện hoặc dùng

Cmd+O.

Tìm cuộc trò chuyện đã lưu trữ

Bạn có thể tìm các cuộc trò chuyện đã lưu trữ trong Cài đặt. Khi bỏ lưu trữ một cuộc trò chuyện, cuộc trò chuyện đó sẽ xuất hiện lại ở vị trí ban đầu trên thanh bên.

Cuộc trò chuyện Work không xuất hiện trên thiết bị khác

• Xác nhận rằng bạn đã đăng nhập bằng ChatGPT vào cùng một tài khoản và không gian làm việc trên mỗi thiết bị.
• Nhờ chủ sở hữu không gian làm việc kiểm tra xem Work Cloud và Cho phép truy cập máy tính cục bộ đã được bật hay chưa. Nếu enforce_residency được bật trong bất kỳ chính sách đám mây nào, Cho phép truy cập máy tính cục bộ sẽ bị tắt cho cả Work và dots. Biện pháp bảo vệ này không cấu hình nơi lưu trú dữ liệu của không gian làm việc và cũng không tự nó vô hiệu hóa Work Cloud hay dots.
• Kiểm tra thời điểm tác vụ được tạo. Tính năng đồng bộ áp dụng cho các tác vụ mới được tạo sau khi tính năng này được bật. Các tác vụ hiện có, bao gồm tác vụ trong dự án, không được di chuyển và vẫn giữ nguyên cách hoạt động ban đầu: chỉ chạy cục bộ hoặc chạy trên đám mây mà không truy cập tệp cục bộ.

Đối với doanh nghiệp, nút chuyển Cục bộ/Đám mây trong ứng dụng và giá trị mặc định của nút này vẫn giữ nguyên khi ra mắt. Chỉ riêng trạng thái nút chuyển hoặc chế độ mặc định không đủ để xác nhận liệu một cuộc trò chuyện có thể đồng bộ hay không. Hãy phân biệt lịch sử Codex khi tìm cuộc trò chuyện Work. Xem Quyền truy cập máy tính cục bộ cho Work Cloud và dots để biết cách thiết lập và Câu hỏi thường gặp dành cho quản trị viên Work để tìm câu trả lời cho các câu hỏi phổ biến.

Tác vụ đã đồng bộ không thể sử dụng tệp hoặc công cụ của máy tính

Hãy giữ máy tính trực tuyến và duy trì kết nối. Nếu máy tính không khả dụng khi một lượt mới bắt đầu, tác vụ đã đồng bộ đủ điều kiện có thể tiếp tục trong container đám mây mà không có quyền truy cập tệp hoặc công cụ của máy tính. Lượt đang chạy không tự động chuyển từ máy tính lên đám mây.

Một lượt đã dừng sau khi tắt quyền truy cập máy tính cục bộ với Work Cloud

Việc tắt quyền truy cập máy tính cục bộ với Work Cloud sẽ làm gián đoạn các lượt đang chạy. Nếu bạn vẫn có quyền truy cập Work, hãy gửi tin nhắn mới để bắt đầu một lượt khác. Trong cuộc trò chuyện trên đám mây hiện có, lượt đó tự động sử dụng Work Cloud mà không có quyền truy cập tệp cục bộ.

Thiếu các bản cập nhật chính sách tự động

Sử dụng API chính sách để quản lý các cài đặt Global. Để quản lý các cài đặt Local hoặc Codex Cloud, hãy sử dụng giao diện Bảo mật tác nhân. Các quy trình dùng API Global hiện có vẫn khả dụng sau khi di chuyển. Hãy kiểm thử các tập lệnh và tích hợp Terraform của bạn, đồng thời xác nhận rằng việc gán và thứ tự chính sách không thay đổi.

Chỉ một số cuộc trò chuyện xuất hiện trên thanh bên

Thanh bên cho phép bạn lọc cuộc trò chuyện dựa trên trạng thái của dự án. Nếu thiếu cuộc trò chuyện, hãy chọn biểu tượng bộ lọc bên cạnh Cuộc trò chuyện, sau đó chọn Theo thứ tự thời gian. Nếu bạn vẫn không thấy cuộc trò chuyện, hãy mở Cài đặt và kiểm tra Cuộc trò chuyện đã lưu trữ.

Mã không chạy trên worktree

Các worktree được tạo trong một thư mục khác và mặc định kế thừa những tệp đã được đưa vào Git. Tùy thuộc vào cách bạn quản lý các phần phụ thuộc và công cụ cho dự án, bạn có thể phải chạy các tập lệnh thiết lập trên worktree bằng một môi trường cục bộ hoặc sao chép các tệp thiết lập bị bỏ qua bằng .worktreeinclude. Bạn cũng có thể checkout các thay đổi trong dự án cục bộ thường dùng. Xem tài liệu về worktree để tìm hiểu thêm.

Ứng dụng không nhận ra môi trường cục bộ được đồng đội chia sẻ

Cấu hình môi trường cục bộ phải nằm trong thư mục .codex tại thư mục gốc của dự án. Nếu bạn đang làm việc trong một monorepo có nhiều hơn một dự án, hãy đảm bảo bạn mở dự án tại thư mục chứa thư mục .codex.

Codex yêu cầu quyền truy cập Apple Music

Tùy thuộc vào tác vụ, Codex có thể cần duyệt hệ thống tệp. Một số thư mục trên macOS, bao gồm Music, Downloads hoặc Desktop, yêu cầu người dùng phê duyệt thêm. Nếu Codex cần đọc thư mục chính của bạn, macOS sẽ nhắc bạn phê duyệt quyền truy cập vào các thư mục đó.

Tác vụ theo lịch tạo ra nhiều worktree

Các tác vụ theo lịch chạy thường xuyên có thể tạo ra nhiều worktree theo thời gian. Hãy lưu trữ các lượt chạy theo lịch mà bạn không còn cần và tránh ghim lượt chạy trừ khi bạn định giữ lại worktree của chúng.

Khôi phục lời nhắc sau khi chọn nhầm đích

Nếu vô tình bắt đầu cuộc trò chuyện với sai đích (Cục bộ, Worktree hoặc Đám mây), bạn có thể hủy lượt chạy hiện tại và khôi phục lời nhắc trước đó bằng cách nhấn phím mũi tên lên trong trình soạn thảo.

Không có hoặc không bật được tùy chọn Phê duyệt giúp tôi

Để sử dụng tính năng xét duyệt tự động, chọn Phê duyệt giúp tôi trong mục điều khiển quyền bên dưới ô soạn thảo. Nếu chế độ này không xuất hiện hoặc bị vô hiệu hóa:

1. Cập nhật ứng dụng máy tính và kiểm tra menu quyền trong cuộc trò chuyện mà bạn muốn sử dụng tính năng xét duyệt tự động. Các tùy chọn có thể khác nhau giữa môi trường cục bộ và môi trường đám mây.
2. Khi chạy Codex cục bộ, kiểm tra cấu hình đang có hiệu lực để xem có thiết lập tường minh features.guardian_approval = false hay không, đồng thời xem lại hồ sơ quyền, chính sách phê duyệt và bên xét duyệt phê duyệt đã được cấu hình. Xem Cấu hình cơ bản để biết thứ tự ưu tiên cấu hình. Cấu hình cục bộ không kiểm soát môi trường chạy đám mây được quản lý.
3. Nếu một chế độ bị vô hiệu hóa hoặc không xuất hiện trong không gian làm việc được quản lý, hãy yêu cầu quản trị viên kiểm tra các hồ sơ quyền, chế độ môi trường cô lập, chính sách phê duyệt và bên xét duyệt phê duyệt được cho phép. Chính sách của tổ chức hoặc thiết bị có thể hạn chế các tùy chọn này; thiết lập cục bộ không thể ghi đè chính sách đó.

Nếu chế độ này vẫn không khả dụng ngoài dự kiến, hãy cung cấp phiên bản ứng dụng, hệ điều hành, môi trường thực thi và cho biết tùy chọn không xuất hiện hay bị vô hiệu hóa trong phản hồi của bạn.

Tính năng hoạt động trong Codex CLI nhưng không hoạt động trong ứng dụng ChatGPT dành cho máy tính

Ứng dụng ChatGPT trên máy tính và Codex CLI có thể tích hợp các phiên bản Codex khác nhau, nên các tính năng có thể xuất hiện trên một giao diện trước giao diện còn lại.

Để xem phiên bản Codex CLI trên hệ thống, hãy chạy:

codex --version

Để xem phiên bản Codex đi kèm ứng dụng ChatGPT dành cho máy tính, hãy sử dụng đường dẫn gói tương thích Codex.app được giữ lại:

/Applications/Codex.app/Contents/Resources/codex --version

Phản hồi và nhật ký

Nhập / vào trình soạn thảo tin nhắn để gửi phản hồi cho nhóm. Nếu kích hoạt phản hồi trong một cuộc trò chuyện hiện có, bạn có thể chọn chia sẻ phiên hiện tại cùng với phản hồi. Sau khi gửi phản hồi, bạn sẽ nhận được ID phiên để chia sẻ với nhóm.

Để báo cáo sự cố:

1. Tìm các sự cố hiện có trong kho lưu trữ Codex trên GitHub.
2. Mở một sự cố GitHub mới

Bạn có thể tìm thêm nhật ký tại các vị trí sau:

• Nhật ký ứng dụng (macOS): ~/Library/Logs/com.openai.codex/YYYY/MM/DD
• Bản ghi phiên: $CODEX_HOME/sessions (mặc định: ~/.codex/sessions)
• Phiên đã lưu trữ: $CODEX_HOME/archived_sessions (mặc định: ~/.codex/archived_sessions)

Nếu chia sẻ nhật ký, trước tiên hãy kiểm tra để xác nhận rằng chúng không chứa thông tin nhạy cảm.

Trạng thái bị kẹt và cách khôi phục

Nếu một cuộc trò chuyện có vẻ bị kẹt:

1. Kiểm tra xem Codex có đang chờ phê duyệt hay không.
2. Mở terminal và chạy một lệnh cơ bản như git status.
3. Bắt đầu cuộc trò chuyện mới bằng một lời nhắc ngắn gọn và tập trung hơn.

Nếu vô tình hủy quá trình tạo worktree và mất lời nhắc, hãy nhấn phím mũi tên lên trong trình soạn thảo để khôi phục lời nhắc.

Sự cố terminal

Terminal có vẻ bị kẹt

1. Đóng bảng terminal.
2. Mở lại bằng Ctrl+`.
3. Chạy lại một lệnh cơ bản như pwd hoặc git status.

Nếu các lệnh hoạt động khác với mong đợi, trước tiên hãy kiểm tra thư mục và nhánh hiện tại trong terminal.

Nếu terminal vẫn bị kẹt, hãy chờ các cuộc trò chuyện đang hoạt động hoàn tất rồi khởi động lại ứng dụng.

Phông chữ hiển thị không đúng

Codex sử dụng cùng một phông chữ cho ngăn đánh giá, terminal tích hợp và mọi đoạn mã khác hiển thị trong ứng dụng. Bạn có thể cấu hình phông chữ trong ngăn Cài đặt tại mục Phông chữ mã.

Môi trường cho phép truy cập mạng nhưng thao tác vẫn bị chặn

Kiểm tra mức ưu tiên của chính sách trước khi so sánh từng cài đặt. Chính sách có mức ưu tiên cao hơn được ưu tiên áp dụng so với chính sách có mức ưu tiên thấp hơn, ngay cả khi chính sách có mức ưu tiên thấp hơn cụ thể hơn. Trong cùng một chính sách, các giá trị ghi đè cho môi trường dành riêng cho từng hệ điều hành được ưu tiên hơn các giá trị ghi đè cho môi trường áp dụng cho mọi hệ điều hành, sau đó mới đến Global.

Một số yêu cầu về mạng có quy tắc hợp nhất riêng cho từng trường và các giới hạn khi thực thi. Môi trường thực thi đám mây không hỗ trợ các cổng lắng nghe HTTP/SOCKS được quản lý và trình lắng nghe proxy trên địa chỉ không phải loopback; khả năng hỗ trợ quy tắc socket phụ thuộc vào luồng thực thi. Cơ chế hợp nhất khi thực thi cục bộ được xử lý riêng.

So sánh các chính sách đang có hiệu lực và kiểm thử những thao tác dự kiến được cho phép hoặc bị chặn. Xem Cấu hình được quản lý để biết chi tiết từng trường hợp. Không nới lỏng cấu hình cơ sở toàn cục để khắc phục một kiểm thử thất bại.