企业官网建设流程全解析

Caelestia 是一款把完整桌面 Shell 移植到 KDE Plasma 6 的开源项目（caelestia-kde）。本文带你从一条安装命令开始，5 分钟内装好 Caelestia KDE 桌面：装完即得自定义面板、锁屏、SDDM 登录界面、桌面组件和全套配色方案，无需手动配置任何一项。

先认识一下 Caelestia KDE 桌面

Caelestia 最初是为 Hyprland 打造的一套"成品桌面"，这个移植版把同样的设计语言搬到了 KDE Plasma 6（KWin 合成器）上。装上之后你会得到：

• 🖥️ 自绘面板、启动器、Dashboard、侧边栏通知中心
• 🔒 自定义锁屏 + Material You 风格的 SDDM 登录界面
• 🎨 壁纸一键生成配色方案（自动提取主色应用到全系统）
• 📁 桌面图标、文件夹小组件与快捷方式管理

安装前检查：3 个硬性要求

开始前确认环境满足条件，装机会更顺利：

💡 安装器会自动备份你当前的 KDE 主题再动手，中途反悔也能卸载还原。

一条命令开始安装

官方为install.sh设计了 curl 单行命令的用法，在国内镜像环境下，克隆后执行同一入口脚本即可：

git clone https://gitcode.com/gh_mirrors/ca/caelestia-kde.git cd caelestia-kde bash install.sh

install.sh 会检测当前目录就是仓库，随即启动 scripts/setup.sh。脚本先尝试下载预编译的安装器二进制，没有对应版本时才调用g++/cmake现场编译——两种方式都只需等待，不需要你做任何事。

安装界面怎么填：默认配置就能用

接下来是一个终端里的图形菜单（TUI），用方向键选择即可，共 6 个区块：

配置完点Review installation确认清单，然后等待——首次安装会执行一轮系统包更新与 C++ 插件编译，耗时视网络而定。

安装过程都在做什么

安装管线由 scripts/ 目录下编号脚本按序执行，理解它有助于排错：

1. 00-backup-themes.sh— 先备份现有 Plasma 主题
2. 01-ensure-prereqs.sh— 检查/补齐前置工具
3. 02-packages.sh/02a-submodules.sh— 安装依赖包与子模块
4. 03~07— 部署配置、壁纸、KDE 组件、SDDM 主题与系统服务
5. 08-build-shell.sh— 编译 Caelestia 的 C++ QML 插件
6. 09-system-tweaks.sh/10-autostart.sh— 系统微调与开机自启

安装完成：重登后进入成品桌面

注销并重新登录（重要，插件需要新会话才加载）。重登后桌面立刻变为 Caelestia 样式，最常用快捷键：

锁屏与登录界面：最出片的部分

Caelestia 的锁屏集成了时钟、天气、系统信息、音乐卡片和通知区：

登录界面（SDDM 主题）支持壁纸与颜色同步，素材位于 src/sddm/themes/：

通知为空时，锁屏与侧边栏会显示这只默认小恐龙（noNotifsPic配置项，见 userpaths.hpp）：

常用配置入口：Nexus 设置

按Super后输入>Settings打开 Nexus，可以调整外观、壁纸、面板元素、窗口规则、快捷键和插件，几乎所有行为都能在这里改。所有设置最终写入~/.config/caelestia/shell.json，更新时也会保留。

⚠️ 换壁纸请在 Nexus 的 Appearance 页操作——KDE 自带壁纸管理器不会驱动 Caelestia 的配色方案。

更新与卸载

• ⬆️更新：安装器 TUI 选Update，或 Nexus → Updates，或执行bash update.sh（可选 main 稳定分支 / dev 尝鲜分支）
• 🗑️卸载：Nexus → Settings → About →Uninstall Caelestia，或执行 uninstall.sh

常见问题快速排查

排查更复杂的问题时，可在 Nexus → About → Advanced 开启 Debug Mode，再运行caelestia shell -l查看详细日志。

关键文件速查

• 安装入口：install.sh ｜ 更新：update.sh ｜ 卸载：uninstall.sh
• 安装管线脚本：scripts/（lib/为共享函数库）
• TUI 安装器源码：installer/tui/，菜单定义见 installer/data/menu.json
• Shell 源码（QML + C++ 插件）：shell/
• 架构文档：docs/architecture/

装完登录一次，你的 KDE Plasma 6 就已经是 Caelestia 的样子了。🎉