# XHCOS Lite — ForThinPC 无鼠标装机指南

面向 **瘦客户机**（2GB RAM / 8GB eMMC 焊接 / Atom x5-Z8350），**没有鼠标**也能完成验证 + 安装。
本指南配套的构建脚本：`build-forthinpc.sh`（产出 `XHCOS-Lite-ForThinPC-2.0.0-amd64.iso`）。

---

## 一、BIOS 设置（键盘 100% 可操作，不需要鼠标）
开机狂按 **F2** 进 BIOS，密码 `Fireport`。

| 键 | 作用 |
|---|---|
| ← → | 切顶部标签页 |
| ↑ ↓ | 选菜单项 |
| Enter | 进入 / 确认 |
| Space | 开关选项 |
| **F10** | 保存并退出 |

要改的两项：
1. **Secure Boot** → `Settings → Secure Boot → Secure Boot Enable` 设为 **Disabled**（瘦客户机纯 UEFI，装 Linux 必须关）
2. **Boot Sequence** → 把 **USB** 调到第一启动项
3. F10 保存，重启。

---

## 二、做启动 U 盘（在主机 Windows 上，你有触控板）
用 **Rufus** 或 **Ventoy** 把 `XHCOS-Lite-ForThinPC-2.0.0-amd64.iso` 写进 U 盘。
（主机有鼠标/触控板，这一步正常做。）

---

## 三、两种用法（瘦客户机端全程键盘，无鼠标）

### 默认行为：上电直接自动安装（最省事，推荐）
构建出的 ISO 启动菜单**第一项默认就是「XHCOS Auto-Install (ForThinPC)」**，带 `xhcos.autoinstall` 内核参数。
插 U 盘开机 → 从 USB 启动 → **等待 10 秒（倒计时）后自动开始安装**，全程无人值守：
自动分区（GPT + 512M ESP + 单 ext4，无 swap 分区，用 zram）+ rsync 系统 + 装 UEFI GRUB。
装完提示后**拔掉 U 盘、重启**，进的就是装好的 XHCOS Lite。

> ⚠️ 因为默认就装，重启前务必**拔 U 盘**——否则插着 U 盘再开机又会跑一遍自动安装。
> 想要「零等待直接开装」：构建时设 `AUTO_TIMEOUT=0`（见第五节）。

### 用法 A：先验证兼容性（不装，只在倒计时内切一下）
在 grub 倒计时（默认 10 秒）内，用 **↓** 把高亮移到不带参数的 **XHCOS Lite** live 项，回车 →
**自动登录进 XFCE 桌面**（不用点任何东西）。键盘操作：Win 键开菜单、方向键+TAB 导航、Enter 运行。
能开终端、开 Firefox、看 XHCOS 主题/壁纸/Plymouth 是否正常 —— 即完成「真机兼容性验证」。

### 用法 B：手动触发安装（想看进度，两种都不要鼠标）

**B1. grub 菜单里临时加参数（旧路线，仍可用）**
1. 在 grub 菜单高亮任意 XHCOS 启动项，按 **`e`** 进编辑（纯键盘）。
2. 找到以 `linux` 开头的行，在 `---` 之前加一个空格和 `xhcos.autoinstall`。
3. 按 **F10** 启动，进入全自动安装。

**B2. 桌面启动器（进 live 后用）**
1. 用法 A 进 live 桌面。
2. 打开桌面上的 **「安装 XHCOS 到本机（键盘）」**（键盘：TAB/方向键移到图标，Enter 打开）。
3. 终端里输入 `yes` 回车，自动开始安装。

> 三种方式底层都是 `/opt/xhcos/xhcos-autoinstall.sh`：探测 eMMC（`/dev/mmcblk0`）、分区、rsync 当前系统、装 UEFI GRUB。
> 默认自动安装项由 `build-forthinpc.sh` 第 7 步注入 grub；装完后脚本会**移除目标盘的自动安装服务**，
> 所以装好的系统下次启动不会再自格式化。

---

## 四、8GB eMMC 适配说明
- 不建 swap 分区，用 **1GB zram 压缩交换**（`chroot-customize-mint.sh` 已注入，`swappiness=10`）。
- 单 ext4 分区，装完约 3–4GB，8GB 留 ~4GB 余量，够用。
- 不要装完整 Ubuntu 桌面 / LibreOffice 等大件（已在精简列表里移除）。

---

## 五、构建（在 WSL2 以 root 跑）
```bash
# 自动复用已构建的 XHCOS-Lite-Mint-2.0.0-amd64.iso
# 默认：grub 第一项 = 自动安装，倒计时 10 秒
sudo bash /mnt/d/xhcos-lite-mint/build-forthinpc.sh

# 想要「上电零等待直接开装」：倒计时设为 0（不显示菜单，直接进安装）
AUTO_TIMEOUT=0 sudo bash /mnt/d/xhcos-lite-mint/build-forthinpc.sh

# 或指定源 ISO（会基于它叠加 ForThinPC 改造）
SRC_ISO_ARG=/mnt/d/linuxmint-22.3-xfce-64bit.iso sudo bash /mnt/d/xhcos-lite-mint/build-forthinpc.sh
```
产物：`D:\xhcos-lite-mint\XHCOS-Lite-ForThinPC-2.0.0-amd64.iso``

---

## 六、与其他文件的关系
- `build-xhcos-mint.sh`：产出带 Calamares（鼠标）安装器的原版 ISO，本脚本的输入。
- `xhcos-autoinstall.sh`：被本脚本打进 ISO 的键盘安装器，也可单独拿去任何 XHCOS Lite live 用。
- `chroot-customize-mint.sh`：XHCOS 品牌换皮 + 精简 + zram，已在源 ISO 里生效。