# oh-my-archlinux

**Repository Path**: Lyong9102/oh-my-archlinux

## Basic Information

- **Project Name**: oh-my-archlinux
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-15
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Oh-My-ArchLinux

<p align="center">
  <img src="docs/assets/archlinux-logo.svg" alt="Arch Linux" width="96" height="96">
</p>

<p align="center">
  <strong>用一份配置完成 Arch Linux 安装与装后整理</strong><br/>
  <em>先预览 · 再执行 · 中断后可继续</em>
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="MIT"></a>
  <a href="https://archlinux.org/"><img src="https://img.shields.io/badge/Arch_Linux-1793D1?style=for-the-badge&logo=archlinux&logoColor=white" alt="Arch Linux"></a>
  <img src="https://img.shields.io/badge/version-0.1.0--dev-orange?style=flat-square" alt="version">
  <img src="https://img.shields.io/badge/界面-默认英语-blue?style=flat-square" alt="UI language">
</p>

<p align="center">
  <a href="README.md">English</a> · <b>中文</b>
</p>

---

## 这是什么

Oh-My-ArchLinux 用一份 YAML 配置，帮你完成 Arch 的安装与后续环境：桌面、开发工具、常用软件、驱动等。

你可以保存、分享、复用同一份配置；执行前先看计划，中途中断也能从上次完成的步骤继续。

| 你的场景 | 使用 |
|:---------|:-----|
| 在 Arch live 介质上装系统 | `install` |
| 系统已经装好，只做后续配置 | `setup` |

---

## 开始使用

### 安装

```bash
# curl
curl -fsSL https://raw.githubusercontent.com/Lyong2024/oh-my-archlinux/master/scripts/bootstrap-install.sh \
  | bash -s -- continuous

# wget
wget -qO- https://raw.githubusercontent.com/Lyong2024/oh-my-archlinux/master/scripts/bootstrap-install.sh \
  | bash -s -- continuous
```

会下载并校验最新 continuous 发行内容，安装到 `~/.local/share/oh-my-archlinux`。

```bash
export PATH="$HOME/.local/share/oh-my-archlinux:$PATH"
export OMA_TUI="$HOME/.local/share/oh-my-archlinux/tui/oma-tui"

oh-my-archlinux.sh version
oh-my-archlinux.sh help
```

### 常用命令

```bash
# 只生成计划，不改动系统
oh-my-archlinux.sh plan \
  --config "$HOME/.local/share/oh-my-archlinux/tests/fixtures/configs/setup_desktop_dev.yaml" \
  --state-dir ./oma-state

# 在已安装系统上执行装后配置
# （请先将配置里的 dry_run 设为 false）
oh-my-archlinux.sh setup \
  --config path/to/your.yaml \
  --state-dir ./oma-state \
  --new-session

# 中文界面（默认是英语）
oh-my-archlinux.sh setup --lang zh_CN --config path/to/your.yaml
```

<details>
<summary>更多：固定版本 · 克隆仓库 · 交互界面 · 远程配置</summary>

**安装指定版本**（在已有 `v*` 发行之后）：

```bash
curl -fsSL https://raw.githubusercontent.com/Lyong2024/oh-my-archlinux/master/scripts/bootstrap-install.sh \
  | bash -s -- v0.1.0
```

**克隆仓库使用：**

```bash
git clone https://github.com/Lyong2024/oh-my-archlinux.git
cd oh-my-archlinux
chmod +x oh-my-archlinux.sh scripts/*.sh
./oh-my-archlinux.sh version
```

**可选交互界面**（从 continuous 发行下载）：

```bash
curl -fsSL -O https://github.com/Lyong2024/oh-my-archlinux/releases/download/continuous/oma-tui-linux-amd64
curl -fsSL -O https://github.com/Lyong2024/oh-my-archlinux/releases/download/continuous/checksums.txt
sha256sum -c checksums.txt --ignore-missing
chmod +x oma-tui-linux-amd64
export OMA_TUI="$PWD/oma-tui-linux-amd64"
```

| 文件 | 适用 |
|------|------|
| `oma-tui-linux-amd64` | Arch x86_64 |
| `oma-tui-linux-arm64` | Arch aarch64 |

**使用在线配置：**

```bash
oh-my-archlinux.sh plan \
  --config https://raw.githubusercontent.com/user/repo/main/profile.yaml
```

远程配置会更谨慎：默认不允许擦盘、不允许“一律确认”，也不会信任未声明的第三方软件源。

**关闭启动画面：**

```bash
oh-my-archlinux.sh --no-banner help
```

</details>

---

## 能力概览

- **一份配置走完全程** — 磁盘、基础系统、桌面、开发环境、应用等  
- **先看计划再动手** — 正式改系统之前可以先生成步骤清单  
- **默认偏安全** — 默认使用已有分区；擦盘需要明确打开  
- **中断可续** — Ctrl+C 或失败后，可从上次完成处继续  
- **安装与装后两用** — live 上装机，或只在现有系统上配置  
- **可选交互界面** — 需要时再选应用与开发栈  
- **默认英语界面** — 需要中文时加 `--lang zh_CN`  

### 磁盘策略

| 策略 | 默认？ | 说明 |
|:-----|:------:|:-----|
| `use_existing` | 是 | 使用已有分区 |
| `create` | 否 | 按模板分区（UEFI / BIOS） |
| `advanced` | 否 | LVM、LUKS、Btrfs 等 — 需明确允许擦盘 |

> 当前为早期版本（`0.1.0-dev`）。可用 plan / dry-run 先验证配置；完整装机请在 Arch live 或虚拟机中进行。说明见 [docs/zh-CN/qemu.md](docs/zh-CN/qemu.md)。

---

## 发行说明

| 通道 | 更新时机 | 位置 |
|:-----|:---------|:-----|
| Continuous | `main` / `master` 有更新时 | [continuous](https://github.com/Lyong2024/oh-my-archlinux/releases/tag/continuous) |
| 正式版本 | 打上 `v*` 标签时 | 如 `v0.1.0` |

---

## 运行环境

| 日常使用 | 从 live 完整装机 |
|:---------|:-----------------|
| `bash`、`jq` | 同上，并具备 Arch live 工具链 |
| `python3` + PyYAML，或 `yq` | 可访问软件源 |
| 建议有 `curl` 或 `wget` | live 上请用可持久保存的状态目录 |

---

## 文档

| 内容 | 链接 |
|:-----|:-----|
| 用户指南 | [docs/zh-CN/README.md](docs/zh-CN/README.md) |
| 配置说明 | [docs/zh-CN/config.md](docs/zh-CN/config.md) |
| QEMU / 装机流程 | [docs/zh-CN/qemu.md](docs/zh-CN/qemu.md) |
| English user guide | [docs/user/README.md](docs/user/README.md) |

示例配置见 `tests/fixtures/configs/`。

---

## 安全说明

- 除非你明确允许，否则不会擦除磁盘  
- 密码只放在会话 secrets（权限 `600`），不要写进可分享的配置  
- 请使用本仓库提供的安装方式，或自行克隆本仓库  
- 安装脚本会校验 `checksums.txt`，不一致则停止  

---

## 许可证

[MIT](LICENSE) © 2026 Oh-My-ArchLinux 贡献者

---

<p align="center">
  <img src="docs/assets/archlinux-logo.svg" alt="Arch Linux" width="40" height="40"><br/>
  <sub>为 Arch 而做 · 配置可复用 · 安装可继续</sub><br/>
  <sub>标志取自 <a href="https://archlinux.org/static/archlinux_common_style/archlogo.svg">官方 Arch SVG</a></sub><br/>
  <a href="README.md">English</a> ·
  <a href="https://github.com/Lyong2024/oh-my-archlinux/releases">发行版</a> ·
  <a href="docs/zh-CN/qemu.md">装机说明</a>
</p>