chore: align Flathub ordering and commit guidance

Resolves #222
This commit is contained in:
xixu-me committed 2026-03-14 16:45:01 +08:00
1 parent 88c351a9ac
commit 7340cb481f
7 files changed
+215 -208

No files matched your search

+67 -66
View File
@@ -44,6 +44,7 @@
[![NuGet](https://img.shields.io/badge/NuGet-004880?logo=nuget&logoColor=white)](#nuget-包管理加速)
[![Rust](https://img.shields.io/badge/Rust-000000?logo=rust&logoColor=white)](#rust-包管理加速)
[![Packagist](https://img.shields.io/badge/Packagist-F28D1A?logo=packagist&logoColor=white)](#php-包管理加速)
[![Flathub](https://img.shields.io/badge/Flathub-000000?logo=flathub&logoColor=white)](#flathub-存储库镜像)
[![Debian](https://img.shields.io/badge/Debian-A81D33?logo=debian&logoColor=white)](#debianubuntu-apt-配置)
[![Ubuntu](https://img.shields.io/badge/Ubuntu-E95420?logo=ubuntu&logoColor=white)](#debianubuntu-apt-配置)
[![Fedora](https://img.shields.io/badge/Fedora-51A2DA?logo=fedora&logoColor=white)](#fedora-dnf-配置)
@@ -249,6 +250,7 @@ classDiagram
| NuGet | `nuget` | `https://api.nuget.org/...` | `https://xget.xi-xu.me/nuget/...` |
| Rust Crates | `crates` | `https://crates.io/...` | `https://xget.xi-xu.me/crates/...` |
| Packagist | `packagist` | `https://repo.packagist.org/...` | `https://xget.xi-xu.me/packagist/...` |
| Flathub | `flathub` | `https://dl.flathub.org/...` | `https://xget.xi-xu.me/flathub/...` |
| Debian | `debian` | `https://deb.debian.org/...` | `https://xget.xi-xu.me/debian/...` |
| Ubuntu | `ubuntu` | `https://archive.ubuntu.com/...` | `https://xget.xi-xu.me/ubuntu/...` |
| Fedora | `fedora` | `https://dl.fedoraproject.org/...` | `https://xget.xi-xu.me/fedora/...` |
@@ -256,7 +258,6 @@ classDiagram
| openSUSE | `opensuse` | `https://download.opensuse.org/...` | `https://xget.xi-xu.me/opensuse/...` |
| Arch Linux | `arch` | `https://geo.mirror.pkgbuild.com/...` | `https://xget.xi-xu.me/arch/...` |
| arXiv | `arxiv` | `https://arxiv.org/...` | `https://xget.xi-xu.me/arxiv/...` |
| Flathub | `flathub` | `https://dl.flathub.org/...` | `https://xget.xi-xu.me/flathub/...` |
| F-Droid | `fdroid` | `https://f-droid.org/...` | `https://xget.xi-xu.me/fdroid/...` |
| Jenkins 插件 | `jenkins` | `https://updates.jenkins.io/...` | `https://xget.xi-xu.me/jenkins/...` |
| 容器注册表 | `cr` | 见[容器注册表](#容器注册表) | 见[容器注册表](#容器注册表) |
@@ -636,6 +637,22 @@ https://repo.packagist.org/packages/list.json
https://xget.xi-xu.me/packagist/packages/list.json
```
#### Flathub
```url
# Flathub 存储库原始 URL
https://dl.flathub.org/repo/summary
# 转换后(添加 flathub 前缀)
https://xget.xi-xu.me/flathub/repo/summary
# Flathub 应用引用原始 URL
https://dl.flathub.org/repo/appstream/org.gnome.gedit.flatpakref
# 转换后(添加 flathub 前缀)
https://xget.xi-xu.me/flathub/repo/appstream/org.gnome.gedit.flatpakref
```
#### Linux 发行版
```url
@@ -708,22 +725,6 @@ https://f-droid.org/api/v1/packages/org.fdroid.fdroid
https://xget.xi-xu.me/fdroid/api/v1/packages/org.fdroid.fdroid
```
#### Flathub
```url
# Flathub 存储库原始 URL
https://dl.flathub.org/repo/summary
# 转换后(添加 flathub 前缀)
https://xget.xi-xu.me/flathub/repo/summary
# Flathub 应用引用原始 URL
https://dl.flathub.org/repo/appstream/org.gnome.gedit.flatpakref
# 转换后(添加 flathub 前缀)
https://xget.xi-xu.me/flathub/repo/appstream/org.gnome.gedit.flatpakref
```
#### Jenkins 插件
```url
@@ -1681,6 +1682,55 @@ composer config -l
}
```
### Flathub 存储库镜像
#### 配置 Flatpak / Flathub 使用 Xget 镜像
```bash
# 通过重写后的 .flatpakrepo 描述文件添加 Flathub 远程仓库
flatpak remote-add --if-not-exists flathub \
https://xget.xi-xu.me/flathub/repo/flathub.flatpakrepo
# 或者直接添加 OSTree 存储库地址
flatpak remote-add --if-not-exists flathub \
https://xget.xi-xu.me/flathub/repo/
```
#### 支持的 Flathub 服务
```url
# OSTree 存储库元数据
https://xget.xi-xu.me/flathub/repo/summary
https://xget.xi-xu.me/flathub/repo/summary.sig
# Flatpak 远程仓库描述文件
https://xget.xi-xu.me/flathub/repo/flathub.flatpakrepo
# 应用引用描述文件
https://xget.xi-xu.me/flathub/repo/appstream/[应用 ID].flatpakref
# 存储库对象与静态增量
https://xget.xi-xu.me/flathub/repo/objects/...
https://xget.xi-xu.me/flathub/repo/deltas/...
```
#### 使用示例
```bash
# 查看远程仓库内容
flatpak remote-ls flathub
# 从 Xget 加速的 Flathub 镜像安装应用
flatpak install flathub org.gnome.gedit
# 直接通过重写后的 .flatpakref 安装
flatpak install --from \
https://xget.xi-xu.me/flathub/repo/appstream/org.gnome.gedit.flatpakref
# 更新已安装的应用和运行时
flatpak update
```
### Linux 发行版加速
#### Debian/Ubuntu APT 配置
@@ -1883,55 +1933,6 @@ task checkFDroidAvailability {
}
```
### Flathub 存储库镜像
#### 配置 Flatpak / Flathub 使用 Xget 镜像
```bash
# 通过重写后的 .flatpakrepo 描述文件添加 Flathub 远程仓库
flatpak remote-add --if-not-exists flathub \
https://xget.xi-xu.me/flathub/repo/flathub.flatpakrepo
# 或者直接添加 OSTree 存储库地址
flatpak remote-add --if-not-exists flathub \
https://xget.xi-xu.me/flathub/repo/
```
#### 支持的 Flathub 服务
```url
# OSTree 存储库元数据
https://xget.xi-xu.me/flathub/repo/summary
https://xget.xi-xu.me/flathub/repo/summary.sig
# Flatpak 远程仓库描述文件
https://xget.xi-xu.me/flathub/repo/flathub.flatpakrepo
# 应用引用描述文件
https://xget.xi-xu.me/flathub/repo/appstream/[应用 ID].flatpakref
# 存储库对象与静态增量
https://xget.xi-xu.me/flathub/repo/objects/...
https://xget.xi-xu.me/flathub/repo/deltas/...
```
#### 使用示例
```bash
# 查看远程仓库内容
flatpak remote-ls flathub
# 从 Xget 加速的 Flathub 镜像安装应用
flatpak install flathub org.gnome.gedit
# 直接通过重写后的 .flatpakref 安装
flatpak install --from \
https://xget.xi-xu.me/flathub/repo/appstream/org.gnome.gedit.flatpakref
# 更新已安装的应用和运行时
flatpak update
```
### Jenkins 插件下载
#### 使用 Xget 加速 Jenkins 插件下载和更新