Anchor Shell 架构

Anchor Shell 架构

Anchor Shell 是 Labwc 会话使用的桌面功能层：顶栏、工作区、活动窗口、 桌面图标、剪贴板、语音粘贴、锁屏、通知、闲置和相关面板。窗口管理器只 提供 Wayland 会话、输入和窗口管理。

它由 Quickshell 承载，源码全部在本目录。Labwc 改这里不会影响 Hyprland 会话： 后者由 inua 作为桌面壳，配置在 modules/home-manager/hypr/。

源码树

modules/anchor-shell/
├── shell.qml              Quickshell 入口
├── shell.json             仓库默认布局
├── Commons/               颜色、样式
├── Ui/                    通用界面组件
├── services/              应用库、插件注册、状态
├── plugins/               Labwc 实际加载的插件
│   ├── bar/               顶栏、工作区、活动窗口
│   ├── clipboard/         剪贴板（runtime id: iamcheyan.clipboard）
│   ├── desktop-icons/     桌面图标（runtime id: desktop-icons）
│   ├── omadock/           左侧应用 dock（runtime id: thepathless.omadock）
│   ├── voxtype/           语音粘贴（runtime id: hancore.voxtype-enhance）
│   ├── launcher/          启动器
│   ├── lock/              锁屏（runtime id: omarchy.lock）
│   ├── notifications/
│   ├── osd/
│   ├── panels/            网络、电源、蓝牙、时钟等
│   ├── polkit/
│   └── services/          闲置、夜灯、电池、媒体
├── compat/omarchy/        Labwc 自己的 omarchy-* 命令和默认资源副本
└── docs/                  迁移记录和插件说明

compat/omarchy/ 是给 Labwc 会话用的兼容层：历史 omarchy-* 命令、主题目录 和系统级资源（shell rc、xcompose、字体、plymouth）。它由 modules/packages/desktop-compat.nix 构建。

Hyprland 会话不再使用 Omarchy：它由 inua 作为桌面壳，基础配置在 modules/home-manager/hypr/base/（从 Omarchy 的 default.hypr.* 移植）。 desktop-compat 包里已经没有 Omarchy 的 Quickshell 壳 （shell/shell.qml、shell/Commons、shell/Ui）和 Hyprland 配置层 （default/hypr/），构建时被 rm -rf 掉。保留的 shell/plugins/ 子集只有 Anchor Shell 实际读取的两处：image-picker 和 panels/dropbox。

旧的 modules/quickshell/ 已经删除。它曾经是迁到本目录之前的回退副本， 没有任何 .nix 引用，Labwc 和 Hyprland 都不读它。

仓库接线

modules/labwc.nix                          Labwc 会话、autostart、systemd
modules/labwc-plus.nix                     本机 labwc-plus 合成器包
modules/labwc/labwc/scripts/quickshell     启动入口（安装为 quickshell-topbar）
modules/labwc/labwc/scripts/quickshell-mode

modules/desktop.nix、modules/desktop-runtime.nix 是两会话共用的系统接线 （SDDM、输入法、音频、desktop-compat 包）。modules/home-manager/hypr/ 属于 Hyprland/inua 会话；改 Labwc 顶栏或插件时不要动这些文件。

运行时目录

Labwc 第一次启动时，如果新目录还没有对应文件，会从 ~/.config/omarchy/、~/.local/state/omarchy/、~/.config/quickshell/ 复制一份。旧目录会留下，Hyprland 继续用它们。

磁盘上的 ~/.config/quickshell/ 只是旧数据。quickshell-mode 在 ~/.config/anchor-shell/mode 不存在时仍会去读它，不要把它当成现行配置。

开发模式和正式模式

~/.config/anchor-shell/mode 为 dev 时，启动器直接加载本目录：

QUICKSHELL_ROOT=/

其他情况使用 Nix 构建的不可变副本：

QUICKSHELL_ROOT=/nix/store/<hash>-anchor-shell

用户插件目录始终是 ~/.config/anchor-shell/plugins/。仓库内 first-party 插件由 shell.qml 通过 QUICKSHELL_ROOT/plugins 扫描，不经过 QUICKSHELL_PLUGINS_DIR。

quickshell-mode dev      # 切到仓库源码并重启
quickshell-mode nix      # 切回 store 副本并重启
quickshell-mode status

改 QML、manifest 或本目录下的插件时，用 dev，改完再执行一次 quickshell-mode dev 重启。Labwc 的 reload（右键菜单 Reload Configuration）如果发现当前是开发模式，会写回 nix 并只通过 anchor-shell-labwc-probe.service 拉起一根顶栏，避免开发实例和 systemd 实例叠在一起。改 modules/labwc.nix、启动脚本或要验证 store 构建时，才需要：

cd /
git add modules/anchor-shell/<changed-file>
sudo nixos-rebuild switch --flake /

Nix 构建使用 flake.lock 锁定的 labwc-plus 源码。要测试本地 / checkout，可在 build 命令上添加：

--override-input labwc-plus path:/

quickshell list --all
pid=$(quickshell list --all | awk '/Process ID:/ {print $3; exit}')
tr '\0' ' ' < /proc/$pid/cmdline; echo
tr '\0' '\n' < /proc/$pid/environ | rg '^QUICKSHELL_|^ANCHOR_|^OMARCHY_PATH='

Labwc
  └── ~/.config/labwc/autostart
      └── systemctl --user restart anchor-shell-labwc-probe.service
          └── ~/.local/bin/quickshell-topbar
              └── quickshell -p $QUICKSHELL_ROOT

QUICKSHELL_ROOT              本目录或 /nix/store/...-anchor-shell
QUICKSHELL_CONFIG            ~/.config/anchor-shell/shell.json
QUICKSHELL_PLUGINS_DIR       ~/.config/anchor-shell/plugins
ANCHOR_SHELL_CONFIG_DIR      ~/.config/anchor-shell
ANCHOR_SHELL_STATE_DIR       ~/.local/state/anchor-shell
ANCHOR_SHELL_PLUGINS_DIR     ~/.config/anchor-shell/plugins
OMARCHY_PATH                 modules/anchor-shell/compat/omarchy 的副本
XDG_CURRENT_DESKTOP          labwc

Labwc       → anchor-fcitx5.service
Hyprland    → omarchy-fcitx5.service

modules/desktop.nix
modules/home-manager/hypr/
modules/home-manager/omarchy-plugins.list
modules/home-manager/nixos-user.nix   中的 programs.nixarchy
modules/packages/nixarchy-omarchy.nix