5. Vận hành

5.1. Làm mới tự động

Plugin lấy lại danh sách model khi:

• opencode service khởi động;
• cấu hình, credential hoặc integration của opencode thay đổi.

Lần đầu mở opencode trong một thư mục mới, model của 9router có thể mất vài giây mới hiện.

5.2. Làm mới thủ công

Cách	Dùng ở đâu	Tác dụng
/models-discovery-refresh	Lệnh trong TUI của opencode	Lấy lại danh sách model ngay
/models-discovery-console	Lệnh trong TUI của opencode	Xem trạng thái của plugin
models_discovery_refresh	Tool của agent trong phiên chat	Agent làm mới danh sách model
models_discovery_status	Tool của agent trong phiên chat	Agent đọc trạng thái của plugin
opencode service restart	Terminal	Khởi động lại service và nạp lại plugin

5.3. Thứ tự khởi động

Khởi động 9router trước opencode. Nếu opencode khởi động khi 9router chưa sẵn sàng, danh sách model sẽ trống. Khi đó, làm mới thủ công theo 5.2. Để 9router tự chạy khi đăng nhập Windows, xem 2.3.1.

5.4. Cập nhật 9router

Dừng 9router trước khi cập nhật

Khi 9router đang chạy, npm không ghi đè được file đang mở và báo lỗi EBUSY hoặc EPERM. Xem 6.9.

1. Sao lưu dữ liệu 9router theo 7.1.

2. Dừng 9router bằng một trong các cách sau:

   • Nhấp phải biểu tượng 9router ở khay hệ thống, chọn Quit.

   • Nhấn Ctrl+C trong terminal đang chạy 9router.

   • Chạy lệnh PowerShell sau. Lệnh dừng mọi tiến trình node.exe và powershell.exe có đường dẫn \9router\ trong dòng lệnh:

     Get-CimInstance Win32_Process |
       Where-Object { $_.Name -in @('node.exe', 'powershell.exe') -and $_.CommandLine -like '*\9router\*' -and $_.ProcessId -ne $PID } |
       ForEach-Object { Stop-Process -Id $_.ProcessId -Force }

3. Cài phiên bản mới:

   npm install -g 9router@latest

4. Khởi động lại bằng file 9router.vbs hoặc lệnh 9router. Nếu bạn chọn Hide to Tray (Background) trong menu, kiểm tra lại file VBS theo 2.3.1.

5. Chạy 9router --version, sau đó kiểm tra lại theo 4.1.

5.5. Nâng cấp plugin

1. Đọc changelog của opencode-models-discovery. Chú ý tuỳ chọn mới, tuỳ chọn bị đổi và URL bên ngoài mà plugin gọi. Đánh giá lại plugin theo 8.6.
2. Sửa phiên bản trong plugins thành "opencode-models-discovery@<phiên-bản-mới>".
3. Chạy opencode service restart.
4. Kiểm tra lại theo 4.2 và 4.3.

5.6. Thay đổi provider

Khi bạn thêm hoặc gỡ provider trong 9router, danh sách model của 9router thay đổi ngay. Trong opencode, làm mới danh sách theo 5.2. Trước khi kết nối provider dùng phiên OAuth thuê bao, đọc 8.1.