ZacharyZhang-NYandClaude Fable 5
f72a48f747
omarchy-cn-convert turns a package-based install into OmarchyCN in one curl-able run: registry key + [omarchycn] repo, --ask=4 swap onto the cn-built packages (Chinese menu/bindings and OMARCHY CN branding ride the settings tree), [omarchy] mirror line, zh_CN locale, fcitx5-rime seeding, CN Arch mirrors, and a plymouth rebrand, recording pre-state in /var/lib/omarchycn/convert-state. omarchy-cn-revert restores that state symmetrically and survives user-removed packages, self-deletion mid-swap, and cosmetic plymouth failures after the state is cleared. Checkout installs are refused toward the overlay. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019hLK3wsDuKVAC37GgDqg6H
56 lines
2.6 KiB
Markdown
56 lines
2.6 KiB
Markdown
# 安装 OmarchyCN
|
||
|
||
## 下载与校验
|
||
|
||
从 [Releases](https://git.zacharyzhang.com/ZacharyZhang-NY/omarchycn/releases) 下载最新 ISO 及 `SHA256SUMS.txt`、`SHA256SUMS.txt.asc`：
|
||
|
||
```bash
|
||
curl -sSf https://git.zacharyzhang.com/ZacharyZhang-NY/omarchycn/raw/branch/quattro/cn/keys/omarchycn-release.asc | gpg --import
|
||
gpg --verify SHA256SUMS.txt.asc SHA256SUMS.txt
|
||
sha256sum -c SHA256SUMS.txt
|
||
```
|
||
|
||
签名主钥指纹应为 `04490F065F6ADD262A7243506EDF7B8603B5D247`（详见 `docs/release-signing.md`）。
|
||
|
||
## 写盘与启动
|
||
|
||
Linux 用 `caligula` 或 `dd`，Mac/Windows 用 balenaEtcher 写入 U 盘，UEFI 模式启动，按提示完成 Omarchy 安装（磁盘、用户、加密等流程与上游一致）。
|
||
|
||
## 首次进入桌面后
|
||
|
||
```bash
|
||
omarchycn setup
|
||
```
|
||
|
||
向导依次配置：语言、时区、显示缩放、中文 locale、中文字体、Fcitx5+Rime 输入法、输入法切换键、pacman 镜像、开发工具镜像、国内应用、AI Hub、隐私说明。每一步都可跳过，中断后重跑会从未完成的步骤继续。
|
||
|
||
## 原版 Omarchy 一键转换（包安装）
|
||
|
||
quattro 的原版 Omarchy 是包安装形态（`pacman -Q omarchy` 有输出），可以整机转换成 OmarchyCN，无需重装：
|
||
|
||
```bash
|
||
curl -fsSL https://git.zacharyzhang.com/ZacharyZhang-NY/omarchycn/raw/branch/quattro/bin/omarchy-cn-convert | bash
|
||
```
|
||
|
||
转换做的事：信任 OmarchyCN registry 公钥并接入 [omarchycn] 仓库；把 `omarchy`/`omarchy-settings` 换成 OmarchyCN 构建的 `omarchy-dev`/`omarchy-settings-dev`（中文菜单、中文键位描述、OMARCHY CN 品牌、AI 全家桶随包生效）；给 `[omarchy]` 仓库加自建镜像（Cloudflare 上游兜底）；系统语言切到 zh_CN.UTF-8 并安装配置 Fcitx5+Rime；Arch 官方仓库自动测速切换国内镜像；刷新 OMARCHY CN 开机画面。重新登录后生效。
|
||
|
||
转换前的包名、语言与 mirrorlist 会记录在 `/var/lib/omarchycn/convert-state`，随时一键还原：
|
||
|
||
```bash
|
||
omarchy cn revert
|
||
```
|
||
|
||
还原会换回上游软件包、恢复语言与 mirrorlist、移除 [omarchycn] 仓库与镜像行、卸载转换时新装的输入法包，并恢复上游开机画面。菜单 OmarchyCN 区段也有「回退为原版 Omarchy」入口。
|
||
|
||
## 现有 Omarchy 叠加安装（Overlay，checkout 形态）
|
||
|
||
老的 checkout 安装（`~/.local/share/omarchy` 是 git 检出）用 Overlay 叠加，不走一键转换：
|
||
|
||
```bash
|
||
git clone https://git.zacharyzhang.com/ZacharyZhang-NY/omarchycn.git
|
||
cd omarchycn && ./bin/omarchy-cn-install-overlay
|
||
omarchy cn version # 验证
|
||
```
|
||
|
||
卸载：`omarchy-cn-install-overlay --uninstall`。更新：`omarchycn update`。
|