Xử lý sự cố plugin

Hầu hết các sự cố plugin đến từ một số nguyên nhân lặp lại: thiếu manifest, xung đột thứ tự layer, hoặc tham chiếu module sai. Hãy xử lý chúng theo thứ tự dưới đây.

Plugin không xuất hiện trong kết quả verify

Xác nhận layer trước:

dsh --profile default --dump-config

Nếu thiếu layer # == <package-name> của plugin, gần như chắc chắn package thiếu manifest dsh.bundle và được cài như một dependency thường. Thay vì đoán, hãy dán tên package vào trang kiểm tra phát hành — nó chạy đúng quy tắc mà bộ index dùng và báo chính xác manifest còn thiếu gì.

Hai plugin xung đột trên cùng một layer

Khi hai bundle vá cùng các dòng, bundle đứng sau trong profile thắng và thay thế toàn bộ cấu hình của dòng. Nếu hành vi hỏng sau khi thêm plugin thứ hai, hãy kiểm tra thứ tự bundle trong profile trước. Rồi gỡ một trong hai để xác nhận nó là thủ phạm:

dsh plugin remove <package-name>

Plugin báo lỗi lúc khởi động

Đọc log của dsh trước — nó nêu tên module lỗi. Rồi mở cordis.patch.yml của bundle và kiểm tra module nó tham chiếu có thực sự tồn tại trong package không (đúng tên, đúng entry point). Để cô lập vấn đề, gỡ plugin khỏi profile và khởi động lại: nếu khởi động sạch, plugin chính là thủ phạm.

Bản thân lệnh cài bị lỗi

Lỗi cài thường là chuyện tầm thường. Xác nhận tên package npm chính xác tuyệt đối (lệnh copy sẵn trên mục là nguồn an toàn nhất), rồi kiểm tra truy cập mạng từ máy chạy lệnh cài. Lệnh cài chuyển tiếp cho package manager, nên thông báo lỗi của nó được áp dụng nguyên văn.

Cài lại cho sạch

Khi một plugin kẹt ở trạng thái nửa hỏng, hãy gỡ và cài lại nó:

dsh plugin remove <package-name>
dsh plugin add <package-name>

Cách này bỏ cả dependency lẫn layer, rồi cài lại phiên bản mới nhất từ đầu.