Villode OS

Villode OS 是一个基于 Arch Linux 官方仓库和 ArchISO 的桌面发行镜像。它使用独立品牌与支持渠道，默认提供 Villode Hyprland、Caelestia Shell、Dock、Launcher 和动态桌面。

当前状态：第一阶段开发预览。源码已经包含可启动 Live ISO profile、离线 Villode 组件快照、Live 自动登录、安装入口和目标系统部署脚本。尚未发布稳定 ISO。

设计边界

• 内核、systemd、pacman 和基础软件直接来自 Arch 官方仓库。
• Villode 只维护桌面体验、默认配置、安装流程和组件发布通道。
• 已安装系统继续采用滚动更新，不需要按 ISO 版本重装。
• ISO 是安装快照，不是 Arch Linux 官方介质，也不由 Arch 社区提供支持。

仓库结构

profile/                 ArchISO profile
  airootfs/              Live 系统文件树
release/                 锁定的 Villode 组件版本
scripts/prepare-release.sh
                         下载并固定离线组件源码
scripts/build-iso.sh     构建 ISO
scripts/test-iso.sh      使用 QEMU 启动 ISO
scripts/check.sh         静态检查

Live 系统

启动后会自动进入 villode 用户的 Hyprland 会话：

• NetworkManager 管理有线和无线网络。
• PipeWire/WirePlumber 提供音频。
• Fcitx5 提供中文输入。
• 首次启动从 ISO 内置、锁定版本的源码离线部署 Villode 组件。
• 欢迎窗口可以进入安装向导。
• Super+I 可随时重新打开安装器。

Live 用户仅用于安装介质，拥有免密码 sudo。安装后的普通用户不会继承此规则。

构建要求

在 Arch Linux 或兼容的 Arch 构建机上安装：

sudo pacman -S --needed archiso git rsync qemu-desktop edk2-ovmf

先检查并准备锁定组件：

./scripts/check.sh
./scripts/prepare-release.sh

构建 ISO：

./scripts/build-iso.sh

默认输出位于 out/。构建过程调用 mkarchiso，因此需要 sudo；脚本不会读取或保存密码。

QEMU 测试

./scripts/test-iso.sh

至少验证：

1. UEFI 启动。
2. 自动进入 Live Hyprland。
3. 有线网络与 DNS。
4. Caelestia、Dock、Launcher 和 Desktop 启动。
5. 注销后会话可恢复。
6. Archinstall 可以启动。
7. 目标系统部署脚本不会修改未挂载的路径。

安装流程

第一阶段使用 Archinstall 负责磁盘、加密、用户和引导器。Archinstall 完成且目标仍挂载在 /mnt 时执行：

sudo villode-install-target /mnt

该脚本会：

• 验证目标是一个 Arch 系统。
• 找到 Archinstall 创建的普通用户。
• 安装 Villode 桌面依赖。
• 复制 ISO 内锁定的离线组件源码。
• 以目标用户身份安装 Villode 组件。
• 启用 NetworkManager 和 SDDM。

第二阶段会用图形前端替代这段两步流程。

发布组件

release/components.tsv 固定每个 Villode 组件的完整 Git 提交。更新版本时必须：

1. 完成组件自身测试。
2. 更新完整提交哈希。
3. 运行 scripts/prepare-release.sh。
4. 构建并完成 QEMU 安装测试。
5. 发布 ISO、SHA-256 校验和与签名。

上游基线

ArchISO 基线提交记录在 ARCHISO_BASE。同步新 ArchISO 时应重新比较官方 releng profile，不能盲目覆盖 Villode 的 Live 用户、网络和显示管理器配置。

许可证

ISO 构建源码使用 GPL-3.0。ISO 中各软件包和 Villode 组件仍遵循各自许可证与素材条款。