Cài lệnh dsh vào terminal

RexAPF Desktop có sẵn một lệnh dsh dùng chính runtime của ứng dụng. Sau khi đăng ký lệnh, bạn chạy được dsh trong terminal mà không cần cài Node.js, kể cả khi Desktop đang đóng. Việc đăng ký là tuỳ chọn.

#Mở hộp thoại quản lý lệnh

macOS: chọn menu RexAPF › Manage dsh Command…, ngay dưới Check for Updates….

Windows: nhấn mục Application trên thanh tiêu đề rồi chọn Manage dsh Command….

Hộp thoại Manage dsh Command cho biết trạng thái hiện tại:

Phần chi tiết ghi đường dẫn lệnh của Desktop (Desktop command) và lệnh dsh mà terminal đang dùng (Current dsh command).

#Cài lệnh

1. Mở hộp thoại

   Chọn Manage dsh Command… như trên.

2. Nhấn Install

   macOS: RexAPF tạo /usr/local/bin/dsh. Nếu thư mục này cần quyền quản trị, macOS hỏi mật khẩu máy. Tệp khởi động shell như ~/.zshrc không bị thay đổi.

   Windows: RexAPF thêm thư mục lệnh vào biến PATH của người dùng hiện tại. Các mục PATH khác được giữ nguyên.

3. Xác nhận nếu đã có dsh khác

   Nếu máy đã có một lệnh dsh ở cùng chỗ, hộp thoại hỏi Continue with the Desktop command?. Lệnh cũ được giữ lại để khôi phục sau. Nhấn Continue để tiếp tục.

4. Kiểm tra

   Mở một cửa sổ terminal mới, rồi chạy:

   bashSao chép

   $ dsh --version

$ which dsh
/usr/local/bin/dsh
$ dsh --version
<phiên bản runtime của Desktop>

#Lệnh khác đang được ưu tiên

Nếu terminal vẫn chạy một dsh khác (ví dụ bản cài qua npm), hộp thoại cảnh báo Another dsh takes precedence kèm vị trí của lệnh đó. Bạn có thể gỡ hoặc đổi thứ tự cài đặt kia, hoặc gọi lệnh của Desktop bằng đường dẫn đầy đủ ghi ở dòng Desktop command.

Nếu RexAPF không kiểm tra được shell của bạn (ví dụ do alias), hộp thoại báo Your shell command could not be verified. Hãy chạy which dsh (macOS) hoặc where dsh (Windows) để tự kiểm tra.

#Sửa hoặc gỡ lệnh

• Repair: đăng ký lại lệnh. Dùng khi hộp thoại báo cần sửa, hoặc sau khi bạn chuyển ứng dụng sang vị trí khác trên macOS. Trên Windows, sau khi chuyển ứng dụng, hãy chạy Install từ vị trí mới.
• Remove: gỡ đăng ký lệnh của Desktop. Nếu trước đó có một lệnh dsh bị thay thế, RexAPF khôi phục nó. Các bản cài dsh khác không bị đụng tới.

#Dùng dsh để quản lý plugin của Desktop

Lệnh dsh của Desktop có thể thêm, liệt kê và gỡ plugin trong profile của Desktop:

1. Khởi tạo profile

   Mở RexAPF Desktop ít nhất một lần, rồi thoát hẳn ứng dụng.

2. Chạy lệnh plugin

   bashSao chép

   $ dsh plugin --profile desktop list
   $ dsh plugin --profile desktop add <tên-gói>
   $ dsh plugin --profile desktop remove <tên-gói>

3. Mở lại Desktop

   Mở RexAPF để dùng thay đổi.

Cách quản lý plugin trong giao diện có ở bài MCP & plugin.

#Lưu ý

• Phiên bản runtime của dsh luôn theo bản Desktop đã cài. Cập nhật Desktop cũng cập nhật dsh.
• Hãy chờ các lệnh dsh chạy xong trước khi cập nhật hoặc gỡ Desktop; trình cài đặt không chờ lệnh đang chạy.
• Trên macOS, ứng dụng phải nằm trong thư mục Applications. Nếu không, hộp thoại yêu cầu bạn chuyển ứng dụng vào đó trước. Xem Tải & cài đặt.
• Trong lúc đang cài bản cập nhật, hộp thoại yêu cầu bạn chờ cập nhật xong.
• Mục Manage dsh Command… chỉ có trên macOS và Windows.