# Cài mới hoàn toàn Chat LAN

Cài sạch là xóa vĩnh viễn toàn bộ dữ liệu Chat LAN của tài khoản đang dùng máy,
rồi bắt đầu lại như một máy chưa từng cài. Việc này **không bắt buộc**: bản cài
đặt thông thường giữ nguyên lịch sử và danh bạ.

Chỉ nên cài sạch khi:

- Máy còn dữ liệu của các bản Chat LAN đời cũ và app mở lên bị lỗi lạ.
- Máy được chuyển cho người khác dùng.
- Muốn thử app từ đầu, đúng như người dùng mới thấy.

## Cái gì bị xóa

Xóa hết, không sao lưu, không vào Thùng rác:

- Lịch sử trò chuyện riêng và nhóm, kể cả ảnh và tệp đã nhận nằm trong app.
- Danh bạ, danh sách nhóm và Cloud của tôi.
- Cấu hình, tên hiển thị, ảnh đại diện.
- **Mã định danh (UID) và khóa bảo mật của máy.**

Không đụng tới: tệp đã tải hoặc đã xuất ra ngoài, ví dụ về Desktop hay
Downloads. Cũng không đụng tới dữ liệu của tài khoản Windows hoặc macOS khác
trên cùng máy, vì công cụ chỉ làm việc trong thư mục của tài khoản đang chạy nó.

> **Quan trọng.** Xóa UID nghĩa là lần mở sau máy có một danh tính mới. Người
> khác vẫn thấy tên cũ trong danh bạ của họ nhưng đó là một máy đã biến mất;
> hai bên phải kết bạn lại. Nếu chỉ muốn sửa một lỗi nhỏ, hãy thử gỡ và cài lại
> app trước, cách đó giữ nguyên dữ liệu.

## Windows

Trong bộ cài `ChatLAN-Setup-x.y.z-x64.exe`, ở mục *Dữ liệu của tài khoản đang
cài*, đánh dấu **Cài mới hoàn toàn**. Ô này mặc định không chọn, và có hỏi lại
một lần trước khi xóa.

Hãy thoát Chat LAN trước, kể cả biểu tượng ở khay hệ thống cạnh đồng hồ. App
còn chạy thì bộ cài dừng lại và báo, chứ không xóa nửa chừng.

Cài hàng loạt, không có ai đứng trước máy, phải nói rõ ý định bằng một tham số
riêng:

```
ChatLAN-Setup-0.23.0-x64.exe /VERYSILENT /TASKS="cleaninstall" /ERASEUSERDATA=YES
```

Thiếu `/ERASEUSERDATA=YES` thì bộ cài từ chối xóa và dừng, để một lệnh cài tự
động chạy nhầm không quét sạch dữ liệu của cả phòng.

Sau khi cài, công cụ nằm sẵn tại `C:\Program Files\Chat LAN\ChatLAN-clean.exe`
nếu về sau cần dùng lại.

## macOS

Mở tệp `ChatLAN-x.y.z-macos.dmg`. Ngoài biểu tượng app, trong đó có
`Cai-sach-Chat-LAN.command`.

1. Thoát Chat LAN.
2. Nháy đúp vào `Cai-sach-Chat-LAN.command`. Lần đầu macOS có thể chặn: bấm
   chuột phải vào tệp, chọn **Open**, rồi xác nhận.
3. Cửa sổ Terminal liệt kê các vị trí sẽ xóa. Gõ đúng `XOA VINH VIEN` rồi Enter.
   Gõ sai hoặc bỏ trống là hủy, không xóa gì.

## Linux

Bản `.tar.gz` và gói `.deb` đều kèm công cụ `chatlan-clean`. Với gói `.deb`, lệnh
đã có sẵn trong `PATH`:

```
chatlan-clean --dry-run      # chỉ xem sẽ xóa những gì
chatlan-clean --interactive  # xóa thật, có hỏi lại
```

Chạy bằng chính tài khoản đang dùng app, không dùng `sudo`. Công cụ từ chối
chạy dưới `root` để khỏi xóa nhầm thư mục của tài khoản khác.

## Xem trước cho chắc

Trên cả ba hệ điều hành, `--dry-run` in ra danh sách đường dẫn sẽ bị xóa và
dừng ở đó. Nên chạy một lần trước khi xóa thật, nhất là trên máy dùng chung.

## Khi công cụ dừng giữa chừng

| Báo trên màn hình | Nghĩa là | Cần làm |
|---|---|---|
| Chat LAN vẫn đang chạy | App còn mở, có thể chỉ nằm ở khay hệ thống | Thoát hẳn app rồi chạy lại |
| Thư mục cha là liên kết | Một thư mục trên đường dẫn đã bị trỏ sang nơi khác | Dừng lại, báo người quản trị máy |
| Hãy chạy bằng tài khoản người dùng | Đang chạy dưới `root` hoặc `SYSTEM` | Đăng nhập đúng tài khoản rồi chạy lại |

Công cụ luôn kiểm tra trước khi xóa, và hễ có gì bất thường thì dừng chứ không
xóa tiếp. Nếu nó dừng, nghĩa là chưa có gì bị mất.

## Sau khi cài sạch

Mở Chat LAN, đặt lại tên và ảnh đại diện. Trong cùng mạng LAN, các máy khác sẽ
tự thấy máy này trở lại sau ít giây. Muốn nhắn cho người ở mạng khác thì phải
kết bạn lại bằng mã rút gọn, mã QR hoặc danh thiếp, xem `HUONG-DAN.md`.
