企业官网建设流程全解析

Ambxst 是一款“极度可定制”的 Wayland 桌面 shell，把顶栏、Dock、动态岛、Dashboard 仪表盘、锁屏、通知中心、壁纸管理器和 AI 助手整合进一套响应式 JSON 配置系统。本文带你用 NixOS 的 flake 与 home-manager 以声明式方式部署 Ambxst，并掌握“换主题免 rebuild”的核心机制。

Ambxst 是什么：一套“全都要”的桌面外壳

Ambxst 构建在 Quickshell 之上，由一个 Go 编写的ambxst后端守护进程统一监管 Quickshell、axctl 与剪贴板服务（当前版本 1.3.11，见 version）。它覆盖的场景包括：

• 📊Dashboard 仪表盘：媒体播放器、日历、通知中心、系统监控、剪贴板管理、便签、tmux 会话管理
• 🎨主题系统：内置 Catppuccin、Kanagawa、Tokyo Night 等十余套配色，一键换肤
• 🧩组件全定制：Bar 位置、Dock、动态岛、圆角、阴影均可拖拽式配置
• 🔌系统级集成：Wi-Fi、蓝牙、音频混音、夜间模式、功耗模式、游戏模式、屏幕录制/截图、OCR 与扫码

部署前提：先装好 Hyprland 或 Niri

Ambxst 唯一的硬性前提是系统里装有Hyprland或Niri合成器（NixOS 配置中启用对应wayland.windowManager即可）。它对现有配置零侵入：只在合成器配置里追加一段 import 块，其余部分原样保留。官方安装说明见 README.md。

方式一：NixOS flake 一键接入（推荐新手）

Ambxst 的 flake.nix 暴露了nixosModules.default模块，一个模块就能装齐包 + 字体 + 推荐服务：

# flake.nix { inputs.ambxst.url = "git+https://gitcode.com/gh_mirrors/am/Ambxst"; outputs = { self, nixpkgs, ambxst, ... }: { nixosConfigurations.myhost = nixpkgs.lib.nixosSystem { system = "x86_64-linux"; modules = [ ambxst.nixosModules.default # 你的其他模块…… ]; }; }; }

该模块会开启programs.ambxst.enable（默认true），并自动注册 Roboto、Noto CJK、Phosphor Icons 等字体，同时默认启用upower、power-profiles-daemon、gpu-screen-recorder与networkmanager四项推荐服务（详见 nix/modules/default.nix）。

然后执行三步收尾：

nixos-rebuild switch --flake .#myhost # 应用配置并重启进入会话 ambxst install hyprland # 向合成器配置注入 import 块 ambxst # 首次手动启动测试

方式二：home-manager 声明式安装 Ambxst 包

上面的nixosModules属于 NixOS 层。如果你习惯用 home-manager 管理用户环境，只需把包加进home.packages：

# flake.nix 的 inputs inputs.ambxst.url = "git+https://gitcode.com/gh_mirrors/am/Ambxst"; # home.nix home.packages = [ inputs.ambxst.packages.${pkgs.system}.default ];

之后像常规发行版一样执行ambxst install hyprland（或niri）即可。一个例外：home-manager 场景下若录屏只用portal后端，请在配置中补上programs.gpu-screen-recorder.enable = true;，才能启用非 portal 录屏后端。

关键细节：compositor 配置被 home-manager 接管时怎么办

home-manager 管理的配置文件是指向/nix/store的只读符号链接，ambxst install检测到这一点后会拒绝写入，并直接打印一份声明式接线指南。此时把生成文件~/.local/share/ambxst/hyprland.lua通过xdg.configFile引入即可：

wayland.windowManager.hyprland.enable = false; xdg.configFile."hypr/hyprland.lua".text = '' loadfile(os.getenv("HOME") .. "/.local/share/ambxst/hyprland.lua")() -- OVERRIDES：在此写你自己的覆盖项 '';

检测与提示逻辑可在 backend/cmd/ambxst/commands.go 中查看。

为什么改主题不用 home-manager switch？

这是 Ambxst 在 NixOS 上最爽的特性：axctl守护进程会在每次主题、窗口间距、快捷键变更时实时重写~/.local/share/ambxst/hyprland.lua，外观类调整即刻生效，无需home-manager switch，只有结构性变更（新增绑定、切换布局）才需要重新构建。

包都装了些什么？（了解即可）

Nix 包由多个子清单拼装而成（入口 nix/packages/default.nix）：

支持x86_64-linux、aarch64-linux、i686-linux三种架构（见 nix/lib.nix）。

常见问题速查

• 登录后没自动启动？确认执行过ambxst install hyprland，且终端中ambxst命令可用；首次可ambxst & disown手动拉起。
• 设置窗口在哪打开？点 Bar 上的齿轮进入设置，Compositor页可直接切换 Hyprland 布局参数，Ambxst页管理 Bar/圆角/启动行为。
• 如何卸载？运行ambxst goodbye即可清理注入的配置块。
• 多屏？Ambxst 原生支持多显示器，每块屏幕独立实例化 Bar 与组件。

下一步：让桌面真正“你的”

部署完成后，推荐按这个顺序玩起来：

1. 🎨 在设置里换一套预设主题（assets/presets/ 内置 Caelestiax、Retro、Liquid Glass 等）
2. 🖼️ 用壁纸管理器挑一张 4K 壁纸，体验自动取色生成主题
3. 🧱 尝试模组管理器，扩展原生设置（官方说明见 docs/mods/README.md）

声明式的配置加上即时生效的主题热更新，让 Ambxst 成为 NixOS 用户定制 Wayland 桌面目前最省心的选择之一。