还在终端里敲pacman命令吗？Shelly 是专为Arch Linux设计的现代图形界面包管理器，基于 GTK4 构建，让你像管理软件商店一样完成软件包的搜索、安装与更新。本指南面向新手，带你从零上手 Shelly 的完整操作流程。

为什么选择 Shelly 图形界面包管理器

相比传统命令行工具，Shelly 把复杂的包管理操作变成点点鼠标的轻松体验：

• 🖱️纯图形操作：基于 GTK4，原生支持 Wayland，界面流畅美观
• 🔍多源统一搜索：官方仓库、AUR、Flatpak 一个搜索框搞定
• 📦完整包管理：安装、更新、卸载、清理，事务进度一目了然
• ⚙️双引擎后端：默认使用 libalpm，可切换 RLPM，保留 CachyOS 扩展
• 🏠AUR 友好：自动审查 PKGBUILD，构建前安全把关

相关功能实现可参考 Shelly.Ui.Gtk/ 目录，GTK4 绑定与内存管理细节见 Shelly.Ui.Gtk/README.md。

快速安装 Shelly：两种方式一步到位

方式一：CachyOS 官方仓库（推荐）

sudo pacman -S shelly

方式二：AUR 助手

yay -S shelly # 或 paru -S shelly

安装完成后，在终端输入shelly-ui即可启动图形界面；命令行版本则使用shelly命令。更多说明见 README.md。

首次启动：3 步欢迎向导带你上手

第一次打开 Shelly，会进入欢迎向导（welcome.zig）：

1. 勾选软件源：Standard（官方仓库）、AUR、Flatpak、AppImage 按需启用
2. 选择导航样式：侧边栏或顶部栏
3. 设置托盘服务：是否在系统托盘显示更新提醒

💡 Flatpak 支持是可选的：需在设置中安装shelly-flatpak-backend，基础版本不会强制依赖它。

一键搜索软件包：多源过滤 + 快捷安装

搜索页是 Shelly 的核心功能（源码：search_page.zig、界面定义：search_page.ui）：

• 搜索框：输入关键词即可同时搜索标准仓库、AUR 和 Flatpak，快捷键Ctrl+F聚焦搜索框
• 来源开关：Standard / AUR / Flatpak 三个按钮独立开关，自由过滤结果
• 勾选安装：结果列表支持复选框多选，点击右上角Install Selected批量安装

选中某个软件包后，右侧详情面板会同步显示版本、来源等元信息；AUR 包会附带仓库标签方便区分。

从确认到完成：看懂安装事务流程

点击安装后，Shelly 会打开事务页（transaction_page.zig）：

• ✅计划预览：确认将要安装/升级的软件包列表
• 🔐权限提升：需要 root 权限时弹出 Polkit 认证框，一次性完成授权
• 📊实时进度：每个软件包都有独立进度条和状态标记（Installed / Upgraded / Done）
• ⚠️AUR 安全审查：构建 AUR 包前会弹出警告对话框，GUI 中可完整查看 PKGBUILD diff，确认安全后再继续构建

整个流程与 AUR 助手等价，但每一步都可视可控。

系统更新：查看可升级项并一键完成

打开Update页（update_page.zig）：

1. 页面自动检查更新，列表展示每个软件包的旧版本 → 新版本及下载大小
2. 用顶部开关筛选要更新的来源（官方包 / AUR / Flatpak）
3. 点击Upgrade按钮，进入事务页执行升级

命令行用户也可以直接用shelly upgrade all；若不想在合并升级中检查 AppImage 或 Flatpak，可执行：

shelly config set DisableFlatpakUpdateCheck true

进阶技巧：深链接直达与托盘通知

Shelly 支持命令行深链接直达特定页面（实现见 deep_link.zig）：

shelly-ui --tray-updates # 直达更新页 shelly-ui --page flatpak-update # 打开 Flatpak 更新页

启用托盘服务后，shelly-notifications会在系统托盘图标上提示有可更新软件包，点击即可弹出对应页面——真正做到"更新永不错过"。

常见问题 FAQ

总结

Shelly 用 GTK4 图形界面重新定义了 Arch Linux 的包管理体验：搜索一个框走天下、安装事务透明可控、更新检查自动化。装好 Shelly，你就能告别繁琐命令，享受流畅的图形化软件管理之旅 🎉