仓库结构

Linxira OS 的源码与制品统一托管在 Linxira-OS GitHub 组织下，分为核心仓库、自研系统工具、采用的上游项目与文档四类。本文列出各仓库的职责，以及它们从源码构建到 ISO 交付之间的关系。

核心仓库

承载发行版整体架构、软件包供应链与 ISO 产物的仓库：

仓库	用途
`linxira-os`	项目总览与治理：产品架构文档、仓库治理清单（`governance/repositories.yaml`）、发行说明（`releases/`）与支持矩阵
`packages`	官方软件包定义与发布流水线：每个自研包一个锁定版本的 PKGBUILD，CI 在 Arch 容器内隔离构建、签名、`repo-add` 并发布到 GitHub Pages
`linxira-packages`	[linxira] 签名软件包仓库（x86_64），由 GitHub Pages 托管；安装 `linxira-keyring` 后即可启用
`linxira-iso-direct`	现行 ISO 构建档案（Direct-Arch）：完整离线安装闭包、`linux` + `linux-lts` 双内核回退、Calamares 安装器配置
`linxira-iso`	已废弃的旧 ISO 构建系统（fork 自 CachyOS-Live-ISO），仅保留作历史归档
`linxira-keys`	私有仓库：GPG 签名密钥保险箱（双层加密），仅密钥持有者可访问；仓库中不含任何口令或明文私钥

自研系统工具

17 个由 Linxira 维护的工具仓库（shelly 是源码构建的打包例外）：

仓库	用途
`linxira-welcome`	Plasma 原生状态与路由入口：展示系统状态与安装完成度，提供固定的工具入口，不执行软件事务
`linxira-config-hub`	配置与诊断 CLI（`linxira-config`）：镜像源（Arch/npm/PyPI/AUR/Go/Flatpak）、SSH、网络与 headless 切换
`linxira-update`	系统更新工具：Cachy-Update/Arch-Update 代码线的自研延续，含系统托盘与更新前/后检查
`linxira-package-center`	精选应用安装器（Quick System Software Setup）：目录绑定计划，委托 `linxira-components` 执行事务
`linxira-component-manager`	组件/能力树选择器（Quick System Runtime Setup）：嵌套能力树，plan/confirm/apply 事务流
`linxira-components`	目录绑定的 pacman 事务后端：生成确定性计划、确认，以 root 执行单次 pacman 事务并持久化回执
`linxira-completion-agent`	首次联网完成代理：展示安装回执中延后的软件与操作
`linxira-gaming-manager`	游戏库与兼容性工作区：Steam 库发现、固定参数启动、restic 加密备份
`linxira-hwd-detector`	CHWD 1.23.0 的只读硬件检测派生（Rust）：输出版本化 JSON 硬件报告
`linxira-hardware-driver-manager`	硬件与驱动管理器：只读报告与固定策略计划，无特权变更后端
`linxira-kernel-manager`	内核与启动只读报告：`linux` / `linux-lts` 支持矩阵、GRUB 条目与 DKMS 状态
`linxira-recovery-diagnostics`	恢复诊断：Btrfs/Timeshift/引导/密钥环就绪性报告与脱敏支持包
`linxira-catalog`	规范化、带版本的软件组件元数据（Catalog v2/v3）：应用、组件、预设与离线策略
`linxira-artwork`	品牌美术资源：Logo、壁纸、图标、欢迎横幅；品牌资产保留所有权利
`linxira-hooks`	ALPM/Pacman 钩子与辅助脚本：os-release 品牌、reboot-required 标记、initramfs 重建
`linxira-keyring`	签名公钥环包（trusted release key）：安装时导入并信任 Linxira 发布密钥
`shelly`	图形化软件包管理器（GPL-3.0，固定上游提交源码构建的打包例外）：管理 Arch/AUR/Flatpak/AppImage 软件包

采用上游

以 fork 或 re-package 方式采用的上游项目，均保留上游许可证与归属：

仓库	用途
`CachyOS-Welcome`	CachyOS Welcome（Rust）rebase 历史候选；已由自研 `linxira-welcome` 取代，仅归档参考
`CachyOS-Settings`	CachyOS 系统性能与优化配置（本地为 Linxira-Settings，品牌资产替换为 Linxira）
`cachyos-plymouth-theme`	Plymouth 开机主题（Jimmac spinner + ACPI BGRT 背景，替换为 Linxira 品牌，GPL-3.0）
`cachyos-kde-settings`	KDE 桌面设置（本地为 linxira-kde-settings，GPL-1.0）
`cachyos-fish-config`	fish shell 配置
`cachyos-zsh-config`	zsh 配置
`cachyos-calamares`	Calamares 安装器配置（settings 与 branding 模块）
`cachyos-wallpapers`	壁纸集
`cachyos-hypr-noctalia`	Hyprland + Noctalia 合成器配置
`cachyos-niri-noctalia`	Niri + Noctalia 合成器配置
`cachyos-mangowc-dms`	MangoHud + DMS 游戏性能监控设置
`chwd`	CHWD 硬件检测与驱动配置工具（`linxira-hwd-detector` 的上游，版本 1.23.0）
`rate-mirrors`	镜像测速排名工具（Rust）：约 30 秒找出最快镜像
`calamares`	安装器框架：采用上游官方 3.3.14 发布归档构建（不采用 CachyOS fork）

文档

仓库	用途
`linxira-wiki`	官方 Wiki（MkDocs Material）：仅记录 Linxira 独有特性
`Linxira-OS.github.io`	官方网站仓库（即本网站）

仓库之间的关系

软件包从源码构建到随 ISO 交付的主链路：

packages（PKGBUILD + CI）
   │  Arch 容器内隔离构建 → 签名子密钥签名 → repo-add
   ▼
linxira-packages（[linxira] 签名仓库，GitHub Pages 托管）
   │  scripts/fetch-linxira-packages.sh 拉取 16 个自研包
   ▼
linxira-iso-direct → build-direct-iso.sh → ISO
   │  离线闭包：Arch 镜像 → 构建缓存 → /opt/linxira/offline-repo
   ▼
Calamares 安装器 → pacstrap 完全离线安装

签名链：

linxira-keys（私有，双层加密保管签名密钥）
   │  linxira-keyring 包携带公钥，安装即导入并信任
   ▼
启用 [linxira] 签名仓库（SigLevel = Required DatabaseOptional）

应用选择与安装的数据流：linxira-catalog 提供规范目录 → linxira-package-center / linxira-component-manager 生成目录绑定的选择计划 → linxira-components 以 root 执行单次 pacman 事务并持久化回执。ISO 构建、安装器与各管理器共用同一份目录与包身份；packages 的发布流水线仅在配置了签名 Secrets（LINXIRA_GPG_PRIVATE_KEY / LINXIRA_GPG_FINGERPRINT）时启用。