Files

T

ZacharyZhang-NYandClaude Fable 5 f72a48f747

One-click convert between vanilla Omarchy and OmarchyCN

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

2026-08-27 18:20:51 -04:00

2.6 KiB

Raw Permalink Blame History

安装 OmarchyCN

下载与校验

从 Releases 下载最新 ISO 及 SHA256SUMS.txt、SHA256SUMS.txt.asc：

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 安装（磁盘、用户、加密等流程与上游一致）。

首次进入桌面后

omarchycn setup

向导依次配置：语言、时区、显示缩放、中文 locale、中文字体、Fcitx5+Rime 输入法、输入法切换键、pacman 镜像、开发工具镜像、国内应用、AI Hub、隐私说明。每一步都可跳过，中断后重跑会从未完成的步骤继续。

原版 Omarchy 一键转换（包安装）

quattro 的原版 Omarchy 是包安装形态（pacman -Q omarchy 有输出），可以整机转换成 OmarchyCN，无需重装：

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，随时一键还原：

omarchy cn revert

还原会换回上游软件包、恢复语言与 mirrorlist、移除 [omarchycn] 仓库与镜像行、卸载转换时新装的输入法包，并恢复上游开机画面。菜单 OmarchyCN 区段也有「回退为原版 Omarchy」入口。

现有 Omarchy 叠加安装（Overlay，checkout 形态）

老的 checkout 安装（~/.local/share/omarchy 是 git 检出）用 Overlay 叠加，不走一键转换：

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。

2.6 KiB Raw Permalink Blame History Unescape Escape