Tham chiếu nhanh
Trạng thái hoạt động của dịch vụ (Service Status)
| Nhãn hiển thị | Màu sắc | Ý nghĩa thực tế |
|---|
| ● Đang chạy | Xanh lá | Dịch vụ đang hoạt động bình thường dưới nền. |
| ○ Đã dừng | Đỏ / Xám | Dịch vụ đang dừng hoạt động. |
| ⟳ Đang khởi động… | Xanh dương | WinWraper đang tiến hành kích hoạt chạy dịch vụ. |
| ↺ Đang khởi động lại… | Cam | Dịch vụ gặp lỗi bất ngờ và đang được tự động chạy lại (Auto-Restart). |
| ⛔ Mất kết nối | Tím | Cầu chì tự ngắt (Circuit Breaker) đã khóa dịch vụ sau 5 lần crash liên tục. |
| ⚠ Thiếu đường dẫn | Cam đậm | Thư mục hoặc tệp chạy .exe của dịch vụ đã bị di chuyển hoặc bị xóa mất. |
| ⚠ Thiếu Runtime | Cam | Môi trường chạy (Node.js/Python/Ruby) chưa được cài đặt trên máy tính của bạn. |
| — Tắt (Disabled) | Xám mờ | Dịch vụ đã bị bạn tạm ẩn (vô hiệu hóa) thủ công trong cửa sổ Cấu hình chung. |
Trạng thái Windows Service (SCM)
| Trạng thái hiển thị | Ý nghĩa thực tế |
|---|
| ● Đang chạy (WinSvc) | Dịch vụ hệ thống đang chạy ngầm trực tiếp qua Windows. |
| ○ Đã dừng (WinSvc) | Dịch vụ hệ thống đã được đăng ký nhưng đang dừng hoạt động. |
| ⟳ Đang khởi động (WinSvc) | Hệ thống Windows đang tiến hành chạy dịch vụ. |
| ↓ Đang dừng (WinSvc) | Hệ thống Windows đang tiến hành dừng dịch vụ. |
| ‖ Tạm dừng (WinSvc) | Dịch vụ hệ thống đang tạm ngưng hoạt động. |
| — | Dịch vụ chưa đăng ký chạy dưới dạng Windows Service. |
Trạng thái kiểm tra sức khỏe (Health Check)
| Trạng thái hiển thị | Màu sắc | Ý nghĩa thực tế |
|---|
| ● Online | Xanh lá | Dịch vụ web phản hồi tín hiệu bình thường (HTTP 200). |
| ● Offline | Đỏ | Dịch vụ web không phản hồi hoặc trả về mã lỗi hệ thống. |
| ○ — | Xám | Dịch vụ chưa được thiết lập kiểm tra sức khỏe (hoặc không hỗ trợ). |
Các loại dịch vụ được hỗ trợ (Service Runtimes)
| Nhãn (Badge) | Tên công nghệ | Cách hoạt động của WinWraper |
|---|
.exe | Executable | File thực thi Windows thông thường (.exe). |
Console | WinConsole | Ứng dụng chạy trên dòng lệnh Windows (CUI). |
Win UI | WinUI | Ứng dụng Desktop Windows có giao diện đồ họa thông thường (GUI). |
Node.js | NodeJs | Script Node.js, tự phát hiện tệp tin node.exe trên hệ thống. |
Python | Python | Script Python, tự phát hiện tệp tin python.exe hoặc python3. |
Next.js | NextJs | Dự án Next.js, tự khởi chạy máy chủ bằng npm start. |
Ruby | Ruby | Script Ruby, tự động tìm kiếm tệp ruby.exe trên máy tính. |
Ruby on Rails | RubyOnRails | Dự án Rails, tự chạy máy chủ bằng bundle exec rails server. |
Custom | Custom | Trình biên dịch tùy chỉnh theo đường dẫn bạn tự nhập thủ công. |
Giới hạn theo chế độ bản quyền
| Tính năng cốt lõi | Dùng thử (Trial) | Kích hoạt (Active) | Bị khóa (Blocked) |
|---|
| Số lượng dịch vụ tối đa | Tối đa 1 dịch vụ | Không giới hạn | Giữ nguyên dịch vụ đã có |
| Bật / Dừng dịch vụ | Cho phép chạy dịch vụ lẻ | Hoạt động đầy đủ | Bị vô hiệu hóa hoàn toàn |
| Đăng ký Windows Service | Không hỗ trợ | Mở khóa đầy đủ | Bị vô hiệu hóa |
| Điều khiển bằng AI (MCP) | Không hỗ trợ | Mở khóa đầy đủ | Bị vô hiệu hóa |
| Xem biểu đồ 📊 (Metrics) | Cho phép xem bình thường | Hoạt động đầy đủ | Cho phép xem (Read-only) |
| Xem nhật ký 👁 (Watcher) | Cho phép xem bình thường | Hoạt động đầy đủ | Cho phép xem (Read-only) |
Danh sách công cụ điều khiển bằng AI (MCP Tools)
Khi bạn kết nối WinWraper với các trợ lý AI (như Claude hay GitHub Copilot), các AI Agent sẽ sử dụng bộ công cụ sau để giúp bạn:
start <name> Khởi động dịch vụ theo tên
stop <name> Dừng dịch vụ theo tên
restart <name> Khởi động lại dịch vụ theo tên
start_all Khởi động tất cả dịch vụ trong danh sách
stop_all Dừng toàn bộ dịch vụ đang chạy
restart_all Khởi động lại toàn bộ dịch vụ
get_all Lấy danh sách và trạng thái tất cả dịch vụ
get_one <name> Xem chi tiết thông số của 1 dịch vụ
register_win_service <name> Đăng ký dịch vụ thành Windows Service ngầm
unregister_win_service <name> Hủy đăng ký Windows Service
start_service <name> Bật dịch vụ chạy qua Windows SCM
stop_service <name> Dừng dịch vụ đang chạy qua Windows SCM
show_window Hiển thị cửa sổ WinWraper lên màn hình chính
hide_window Giấu cửa sổ WinWraper xuống System Tray
get_license_info Kiểm tra thông tin bản quyền hiện tại
Đường dẫn tệp tin quan trọng
| Mục đích | Đường dẫn thực tế trên Windows |
|---|
| Thư mục cài đặt ứng dụng | C:\Program Files\WinWraper\ |
| Thư mục dữ liệu & log | %APPDATA%\WinWraper\ (Dán vào Explorer để mở nhanh) |
| Tệp tin điều khiển AI | C:\Program Files\WinWraper\WinWraper.MCP.exe |
Liên kết hữu ích