omarchycn/README.md

# OmarchyCN

OmarchyCN 是基于 [Omarchy](https://omarchy.org)（DHH 打造的现代化、观点鲜明的 Arch + Hyprland 发行版）的中国开发者下游发行版。完整保留 Omarchy 的桌面体验、快捷键、主题与 AI Agent 工作流，面向中国网络环境、中文使用习惯与国内 AI 服务做系统级增强。

产品需求见 [OmarchyCN PRD](<OmarchyCN PRD.md>)，执行进度见 [OmarchyCN-TASKS](OmarchyCN-TASKS.md)。

## 当前版本状态

当前版本 `4.0.0.alpha-cn.1` 是 **M0 基线版本**：功能与上游 `basecamp/omarchy` 的 `quattro` 分支完全一致，未修改任何系统行为。它验证了 OmarchyCN 独立构建与发布链路（自有仓库 → 本地源构建 ISO → QEMU UEFI 启动验证 → Gitea Release 分发）。

## 相对 Omarchy 的差异

### 已落地（本仓库当前状态）

| 项目 | Omarchy | OmarchyCN |
|---|---|---|
| Canonical 仓库 | GitHub (basecamp/omarchy) | 自托管 Gitea（本仓库） |
| 版本号 | `4.0.0.alpha` | `<上游版本>-cn.<发布号>`，如 `4.0.0.alpha-cn.1` |
| ISO 分发 | omarchy.org | 本仓库 Release 页 + Package Registry，附 SHA-256 校验 |
| 产品文档 | — | 新增中文 PRD、执行任务清单与本 README |
| 系统功能 | — | 与上游完全一致（基线） |

### 规划中（PRD v1.0 路线图）

- **中国网络层**：Arch/npm/pip/Cargo/Go 等镜像测速、自动选择与故障切换（`omarchycn mirror` / `dev-mirror`）
- **中文环境**：开箱即用的 zh_CN locale、思源黑体/宋体字体栈、Fcitx5 + Rime 中文输入与快捷键冲突处理
- **AI Hub**：Kimi、DeepSeek、Z.AI/GLM 作为一等 Provider，与 Claude Code、Codex、OpenCode、Kimi Code、Deep Code 等 Harness 的统一配置向导与凭据管理
- **国内应用中心**：微信、QQ、飞书、钉钉、WPS 等应用的可信安装入口
- **Overlay 安装器**：在现有 Omarchy 上叠加 OmarchyCN，全程可逆
- **签名供应链**：`[omarchycn]` pacman 仓库、PGP 签名、SBOM 与发布清单

## 下载与安装

从 [Releases](https://git.zacharyzhang.com/ZacharyZhang-NY/omarchycn/releases) 页面获取 ISO 与 `SHA256SUMS.txt`，按 Release 说明校验后写入 U 盘，UEFI 启动安装。

## 上游文档

Omarchy 完整英文手册在 [`manual/`](manual/) 目录（与上游一致），亦见 [learn.omacom.io](https://learn.omacom.io/2/the-omarchy-manual)。

## 声明与许可证

OmarchyCN is an independent community distribution based on Omarchy. OmarchyCN is not affiliated with or endorsed by Basecamp, 37signals, or the Omarchy maintainers.

代码沿用上游 [MIT License](LICENSE)，保留 Omarchy 原始版权声明。