Feature-focused Chinese README; move PRD and task list to local-only

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QKxGW1raAWaqeU8WdHsMsp
This commit is contained in:
2026-08-24 18:06:40 -04:00
co-authored by Claude Fable 5
parent 8125f24531
commit 743ae05acc
4 changed files with 28 additions and 1820 deletions
+4
View File
@@ -2,3 +2,7 @@
# Python bytecode (orchestrator) # Python bytecode (orchestrator)
__pycache__/ __pycache__/
*.pyc *.pyc
# Local working documents
OmarchyCN PRD.md
OmarchyCN-TASKS.md
-1747
View File
File diff suppressed because it is too large Load Diff
-49
View File
@@ -1,49 +0,0 @@
# OmarchyCN 执行任务清单
进度真相文件。按顺序执行,禁止跳项。每项完成后勾选并记录结果。
范围裁剪:本轮交付 = 用户目标三项(公开仓库 + 基线 ISO + Gitea Release),即 PRD M0 中的
Canonical Repo 与「未修改功能的基线 ISO」两项。M0 其余项(上游同步 MR 自动化、Release Key
与签名体系、法务/治理文档)以及 M1–M5 功能章节均不在本轮范围。本轮校验产物为 SHA-256
checksum,不含 PGP 签名(PRD §15.1 签名体系属后续 M0 收尾项)。
- [x] T1 复核 PRD 全文(§1–28),确认本轮交付物 = 公开仓库 + 基线 ISO + ReleaseM0 部分交付)
- [x] T2 探测 git.zacharyzhang.com Gitea API:版本、token 身份、release 附件大小上限
- [x] T3 通过 API 创建公开仓库 omarchycn
- [x] T4 提交 PRD 与本清单到 quattro 分支,推送全部历史到 Gitea
- [x] T5 准备 WSL 构建环境:克隆 omacom-io/omarchy-iso 与 omacom-io/omarchy-pkgs,按其 bin 脚本要求装依赖
- [x] T6 构建基线 ISO./bin/omarchy-iso-make --no-boot-offer --local-source ../omarchy ../omarchy-pkgs
- [x] T7 校验 ISO:生成 SHA-256WSL 有 /dev/kvm,尽可能做 QEMU UEFI 启动冒烟测试
- [x] T8 创建 Gitea Releasetag 4.0.0.alpha-cn.1):ISO 传 generic package registryrelease 附 sha256 与下载链接
- [x] T9 输出最终核对表:仓库 URL、Release URL、逐条验收结果
- [ ] T10 README 改为中文,说明 OmarchyCN 相对 Omarchy 的差异(现状如实 + PRD 规划),提交推送
- [ ] T11 经 Dokploy API 将 Gitea 上传大小上限调到 8GB(附件类型放开 .iso;如仍有 60s 超时则一并处理),实测验证
- [ ] T12 完整 ISO 直传 release 附件,验证下载后清理分卷包,更新 release 正文
- [ ] T13 更新执行记录并输出最终核对表
## 执行记录
(每项完成后在此追加一行:任务号、结果、产物路径/URL)
- T1 完成:PRD §1–28 全文已复核。本轮交付=M0 部分交付(Canonical Repo + 基线 ISO + SHA-256 校验产物)。
- T2 完成:Gitea 1.27.1token=ZacharyZhang-NY(admin)。附件限制 100MB 且不允许 .isorelease asset API 无 external_url。
已验证 generic package registry 可上传(201)。策略:ISO 传 generic registryrelease 附 sha256(.txt) 与下载链接。
如需 ISO 直接作为 release 附件,需管理员改服务器 app.ini 的 [attachment] ALLOWED_TYPES/MAX_SIZE。
- T3 完成:https://git.zacharyzhang.com/ZacharyZhang-NY/omarchycn public,默认分支 quattro)。
- T4 完成:quattro 全历史已推送,HEAD=2c8a6874(含 PRD 与本清单)。
- T5 完成:WSL Ubuntu 24.04 装 docker.io 29.1.3systemd 托管,active);~/omarchycn-build 下
三个 checkoutomarchyquattro 5fa312e0,克隆自本地)、omarchy-isoquattro)、omarchy-pkgsmaster)。
构建命令按 omarchy-iso-make 实际要求:--keep-pkg-cache 跳过交互 sudo--no-boot-offer 跳过 gum。
- T6 完成:release/omarchy-2026.08.24-x86_64-local.iso5.8G,含离线镜像仓库),mkarchiso DoneEXIT=0。
- T7 完成:SHA-256=1d5421d1427cf97c0950c766778380c0543f180c9062e0a7c06f99b457dd8300.sha256 已落盘)。
QEMU 8.2 + OVMF + KVM 冒烟测试通过:UEFI 启动进入安装器欢迎屏(Press Return to Start Install),
QMP screendump 三张截图确认。曾出现两次环境故障并已修根因:WSL 随最后一个客户端退出导致 nohup QEMU
被杀(改为前台任务保活);/dev/kvm 权限(用户加入 kvm 组)。
- T8 完成:Release https://git.zacharyzhang.com/ZacharyZhang-NY/omarchycn/releases/tag/4.0.0.alpha-cn.1
tag 4.0.0.alpha-cn.1 @ 3b0f0296prerelease,附件 SHA256SUMS.txt)。服务器对大请求体存在约 60 秒
硬超时(2GB/5.8GB 实测 502200MB 通过),故 ISO 以 8 个 800MB 分卷发布于 generic package registry
omarchycn-iso/4.0.0.alpha-cn.1,全部 201,匿名可下载、支持 Range),release 正文含分卷表、合并
与校验命令。ISO 直传 release 附件需管理员改服务器配置(超时 + [attachment] 类型/大小)。
- T9 完成:全部 9 项完成。仓库 https://git.zacharyzhang.com/ZacharyZhang-NY/omarchycn
Release https://git.zacharyzhang.com/ZacharyZhang-NY/omarchycn/releases/tag/4.0.0.alpha-cn.1 。
每项均经 codexgpt-5.6-sol xhigh)对抗式审查通过:T1T4 第 3 轮 PASST5/T6/T7/T8 首轮 PASS。
+24 -24
View File
@@ -1,41 +1,41 @@
# OmarchyCN # OmarchyCN
OmarchyCN 是基于 [Omarchy](https://omarchy.org)(DHH 打造的现代化、观点鲜明的 Arch + Hyprland 发行版)的中国开发者下游发行版完整保留 Omarchy 的桌面体验、快捷键、主题与 AI Agent 工作流,面向中国网络环境、中文使用习惯与国内 AI 服务做系统级增强。 面向中国开发者的 [Omarchy](https://omarchy.org) 下游发行版完整保留 Omarchy 的 Arch + Hyprland 桌面体验,为中国网络环境、中文使用习惯与国内 AI 服务做系统级增强。
产品需求见 [OmarchyCN PRD](<OmarchyCN PRD.md>),执行进度见 [OmarchyCN-TASKS](OmarchyCN-TASKS.md) 当前版本 `4.0.0.alpha-cn.1`(基于上游 `quattro` 分支构建的基线 ISO
## 当前版本状态 ## 特性
当前版本 `4.0.0.alpha-cn.1`**M0 基线版本**:功能与上游 `basecamp/omarchy``quattro` 分支完全一致,未修改任何系统行为。它验证了 OmarchyCN 独立构建与发布链路(自有仓库 → 本地源构建 ISO → QEMU UEFI 启动验证 → Gitea Release 分发)。 继承自 Omarchy
## 相对 Omarchy 的差异 - Hyprland 动态平铺桌面 + Quickshell 顶栏、菜单与系统面板,键盘驱动工作流
- `omarchy` CLI 与 `Super + Space` 系统菜单,CLI 与 GUI 同构
- 内置主题系统与一键换肤,终端 / 编辑器 / 桌面配色统一
- AI coding agent 桌面集成(Claude Code、Codex、OpenCode 等,`mise` 按需安装)
- Btrfs + Snapper 更新前快照与系统回滚
- archiso 离线安装镜像,支持无人值守安装与双系统引导
### 已落地(本仓库当前状态) OmarchyCN 增强(开发中,按路线图逐步交付):
| 项目 | Omarchy | OmarchyCN | - **中国镜像管理**Arch / npm / pip / Cargo / Go 等软件源测速、自动选择与故障切换
|---|---|---| - **中文环境开箱即用**zh_CN locale、思源黑体 / 宋体字体栈、高分屏分数缩放预设
| Canonical 仓库 | GitHub (basecamp/omarchy) | 自托管 Gitea(本仓库) | - **中文输入法**Fcitx5 + Rime 预配置,Wayland / GTK / Qt / Electron 全栈兼容,快捷键冲突自动处理
| 版本号 | `4.0.0.alpha` | `<上游版本>-cn.<发布号>`,如 `4.0.0.alpha-cn.1` | - **AI Hub**Kimi、DeepSeek、Z.AI/GLM 一等 Provider 支持,与 Claude Code、Codex、OpenCode、Kimi Code、Deep Code 等 Harness 的统一配置向导、凭据安全存储与连接诊断
| ISO 分发 | omarchy.org | 本仓库 Release 页 + Package Registry,附 SHA-256 校验 | - **国内应用中心**:微信、QQ、飞书、钉钉、腾讯会议、WPS 等应用的可信安装入口
| 产品文档 | — | 新增中文 PRD、执行任务清单与本 README | - **Overlay 安装器**:在现有 Omarchy 上叠加 OmarchyCN,全程可逆、可卸载
| 系统功能 | — | 与上游完全一致(基线) | - **统一诊断**`omarchycn doctor` 覆盖网络、镜像、输入法、显示与 AI 配置
### 规划中(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 启动安装 从 [Releases](https://git.zacharyzhang.com/ZacharyZhang-NY/omarchycn/releases) 页面下载 ISO 与 `SHA256SUMS.txt`,校验后写入 U 盘,UEFI 启动安装
```bash
sha256sum -c SHA256SUMS.txt
```
## 上游文档 ## 上游文档
Omarchy 完整英文手册在 [`manual/`](manual/) 目录(与上游一致),亦见 [learn.omacom.io](https://learn.omacom.io/2/the-omarchy-manual)。 Omarchy 完整英文手册在 [`manual/`](manual/) 目录,亦见 [learn.omacom.io](https://learn.omacom.io/2/the-omarchy-manual)。
## 声明与许可证 ## 声明与许可证