# XHCOS Lite (Mint) 2.0.0 — 构建指南

基于 **Linux Mint 22.3 XFCE 64-bit** 重塑的轻量发行版，面向 **瘦客户机**
（2GB RAM / 8GB eMMC 焊接 / Atom x5-Z8350）。桌面已是 XFCE，故本路线只做：

- **品牌换皮**：Plymouth 开机动画、GRUB/isolinux 启动菜单、LightDM 登录界面、
  XFCE HERO 主题 + 壁纸、系统身份（os-release/lsb/hostname）全部改为 XHCOS。
- **安装器界面**：注入 **Calamares (XHCOS)** 品牌，对齐 **XHCOSEmulator** 安装界面
  —— 深蓝侧栏 + 暖橙主按钮 + 5 张幻灯片（欢迎 / 软件商店 / HERO / 三花工坊 / 安全更新）。
- **适度精简**：移除 LibreOffice / Thunderbird / Rhythmbox / 游戏 / Timeshift / 影音大件，
  保留 XFCE + LightDM + Firefox + 基础工具，装完约 3–4GB，8GB eMMC 可装下并留余量。
- **2GB 内存优化**：1GB zram 压缩交换 + swappiness=10。

## 为什么这套流程长这样（重要）
1. **C 盘已满** → 所有重活放在 **D 盘**，不写 C。
2. **Mint 22.3 的 `filesystem.squashfs` 约 4.x GB，藏在 ISO 的 UDF 层**，WSL2 的 drvfs
   读不到 UDF 里的 >4GB 文件，loop 挂载也因缺 UDF 内核模块失败。
   → 用 **Windows 7-Zip**（原生读 UDF、写 NTFS >4GB 文件）解包 ISO 到 `D:\xhcos-lite-mint\iso`。
3. chroot / unsquashfs / mksquashfs 需要 POSIX 文件系统（NTFS 不支持设备节点/符号链接）
   → 在 D 盘建一个 **16GB ext4 镜像**（`work.img`，loop 挂载为 `/xhcos-work`）跑全部改造。

## 前置条件
- WSL2（任意发行版），能以 root 运行（`sudo` 或默认 root）。
- **Windows 7-Zip** 已安装（默认路径 `C:\Program Files\7-Zip\7z.exe`）。
- D 盘剩余空间 **≥ 20GB**（16GB 工作镜像 + 解包树 + 最终 ISO）。
- `linuxmint-22.3-xfce-64bit.iso` 放在 D 盘任意位置，或 `C:\Users\xihaochen\Downloads\`。
- WSL 内可联网（chroot 阶段要 `apt` 移除/补装软件；离线也能完成品牌换皮，只是精简不彻底）。

## 运行
在 WSL2 终端（**务必 sudo**）：

```bash
# 自动在 D 盘搜 linuxmint-22.3-xfce-64bit.iso
sudo bash /mnt/d/xhcos-lite-mint/build-xhcos-mint.sh

# 或手动指定源 ISO
SRC_ISO=/mnt/d/linuxmint-22.3-xfce-64bit.iso sudo bash /mnt/d/xhcos-lite-mint/build-xhcos-mint.sh
```

首次会创建 16GB 工作镜像（较慢），之后复用。全流程约 20–40 分钟（取决于 CPU/磁盘）。

## 产物
- `D:\xhcos-lite-mint\XHCOS-Lite-Mint-2.0.0-amd64.iso`（iso-hybrid，UEFI + BIOS 均可启动）

用 Ventoy / Rufus 写入 U 盘，插到 ForThinPC 从 U 盘启动即可安装。

## 释放 D 盘空间
工作镜像 `D:\xhcos-lite-mint\work.img` 构建完会保留复用。要释放：
```bash
sudo umount /xhcos-work 2>/dev/null; rm -f /mnt/d/xhcos-lite-mint/work.img
```

## 已知风险 / 兜底
- **loop 挂载失败**：极少数 WSL 配置不支持在 `/mnt/d` 上 loop 普通文件。报错时会提示，
  备选方案是把 `work.img` 放到 WSL 原生 ext4（如 `~/xhcos-lite-mint/work.img`）再跑，
  或先在 PowerShell 用 `New-VHD` 建 VHDX 挂载后把 `WORK_IMG` 指向它。
- **构建中断**：脚本退出时会自动卸载 chroot 绑定挂载与工作镜像，下次重跑会清掉旧 `edit/iso` 重建。
- **精简误删**：`chroot-customize-mint.sh` 的 `PURGE` 列表是“适度”，若想更激进/更保守，改那个变量即可。

## 文件说明
- `build-xhcos-mint.sh`：主构建管线（解包 → unsquashfs → chroot → resquashfs → 品牌化 → xorriso）。
- `chroot-customize-mint.sh`：chroot 内品牌化 + 精简 + Calamares 注入（被上面调用）。
- `assets/`：XHCOS 品牌资产（logos / plymouth / wallpaper / theme / store / calamares / slideshow / isolinux）。

## ForThinPC 无鼠标变体（★新增）
瘦客户机（2GB/8GB/Atom Z8350）**没有鼠标**也能装。复用本 ISO，叠加 live 自动登录
+ 键盘安装器（`xhcos-autoinstall.sh`，OEM 磁盘镜像式，grub 内核参数 `xhcos.autoinstall` 一键全自动）。
- 构建：`sudo bash build-forthinpc.sh` → `XHCOS-Lite-ForThinPC-2.0.0-amd64.iso`
- 用法见 **`README_ForThinPC.md`**（BIOS 键位 / 两种无鼠标安装路线 / 8GB 适配）。