“Tài liệu tốt không chỉ giải thích cách hoạt động của mã nguồn, mà còn trình bày rõ ràng lý do tại sao nó được thiết kế như vậy.”
— Technical Writing Standards
INTRODUCTION

Giới thiệu về WinNest

Khi cài đặt phần mềm Windows trên Linux thông qua Wine, người dùng thường gặp phải hiện tượng "xáo trộn Registry" hoặc các thư viện DLL bị đè lên nhau trong một prefix mặc định duy nhất (`~/.wine`). Điều này trực tiếp gây ra lỗi không tương thích giữa các ứng dụng khác nhau.

WinNest ra đời nhằm đóng gói mỗi phần mềm Windows vào một thư mục dữ liệu độc lập hoàn toàn, tự động hóa cấu hình và cung cấp khả năng tích hợp nguyên bản vào môi trường Desktop của Linux.

Đặc trưng thiết kế:

  • Cô lập tuyệt đối: Mỗi phần mềm là một sandbox prefix tách biệt, có cấu hình Registry ảo độc lập.
  • An toàn tiến trình: Nói không với việc ghép chuỗi câu lệnh Shell thô, loại trừ nguy cơ tấn công Injection.
  • Tích hợp Desktop tự động: Tự sinh file phím tắt khởi chạy `.desktop` và đăng ký MIME types để nhấp đúp chạy ứng dụng.
INSTALLATION GUIDE

Thiết lập & Cài đặt hệ thống

WinNest được phát triển bằng ngôn ngữ TypeScript chạy trên nền tảng Node.js. Để cài đặt và chạy thử nghiệm cục bộ, vui lòng đảm bảo hệ thống của bạn đã cài đặt các điều kiện tiên quyết sau:

  • Node.js: Phiên bản LTS 20 hoặc cao hơn.
  • Wine & Wineserver: Cài đặt hệ thống sẵn có (Wine 8.0+).
  • Hệ điều hành: Các bản phân phối Linux phổ biến (Ubuntu, Arch Linux, Fedora...).

Quy trình build cục bộ:

Nhập các lệnh sau trong thư mục gốc của WinNest:

bash --setup
# 1. Cài đặt các thư viện phụ thuộc npm install # 2. Kiểm tra kiểu tĩnh TypeScript (Không build ra file) npm run check # 3. Biên dịch TypeScript sang JavaScript (Thư mục dist/) npm run build # 4. Kiểm tra lỗi Spawning và log với đường dẫn đặc biệt npm run test:path-torture
Lưu ý về Lệnh chạy thử nghiệm

Sau khi chạy biên dịch, bạn có thể gọi trực tiếp file CLI trong quá trình phát triển bằng lệnh:
npm run dev:cli -- doctor (Thay thế `doctor` bằng lệnh bạn muốn test).