它不会运行 pacman、AUR 或 Omarchy 的 Arch migration，也不会创建 Snapper 快照；NixOS generation 本身承担系统回滚能力。

会更新哪些内容

nix flake update 检查 flake.nix 可达的全部输入，并把找到的新 revision 写入 flake.lock。本仓库的主要输入是：

输入使用 follows 时会共享同一个 nixpkgs；锁文件中同名带后缀的节点是不同依赖 图节点，不应手工编辑。某次更新不一定改变所有节点：远端 revision 没有变化、被 固定到 tag，或者跟随其他输入时，锁文件会保持不变。

更新后的 rebuild 会重新求值整个系统，但 Nix 只构建或下载发生变化的 derivation；未变化的内容直接复用 /nix/store。

Shizuka 不再复制到本仓库。它作为 flake = false 的 Git 输入由 flake.lock 锁定。执行 nix flake update 或 nixos-update 时会检查 iamcheyan/shizuka 的 main 分支；如果有新 commit，就只更新锁文件中的 Shizuka revision，随后 rebuild 会从新 revision 重新打包主题。也可以只检查并更新 这一项：

nix flake update shizuka --flake ~/nixos-config
nixos-rebuild build --flake ~/nixos-config#hx90
sudo nixos-rebuild switch --flake ~/nixos-config#hx90

普通的 nixos-rebuild switch 不会主动访问网络更新任何输入，这是为了保持 flake.lock 的可复现性；需要检查远程更新时，应先执行上面的更新命令。

Shizuka 的版本到底由哪里管理

注意 Qt QML 磁盘缓存：即使 /run/current-system 已指向新版本，SDDM 也可能 沿用相同 URL 对应的旧字节码。2026-09-06 的黑壁纸现场中，真实 greeter 仍报 Cannot open: https://github.com/iamcheyan/nixos-config/blob/main/assets/background.jpg；同用户、同路径禁用 QML 磁盘缓存后 错误消失。modules/desktop.nix 因此将 settings.Theme.ThemeDir 指向主题包 自身的 /nix/store/.../share/sddm/themes，让每次主题更新使用不同 URL。 验证时必须同时检查真实 greeter 日志与画面，不能只凭 store 路径或预览退出码 认定修复成功。切换返回非零也可能已部分激活，应检查失败单元。

Shizuka 登录主题不是直接从 ~/development/shizuka 运行。它有四个明确的层次：

Shizuka GitHub main
        ↓  nix flake update shizuka
nixos-config/flake.lock       ← 锁定具体 Git commit
        ↓  nixos-rebuild switch
/run/current-system/.../shizuka ← 当前 NixOS generation 使用的不可变副本
        ↓
SDDM 登录界面

• 源码仓库是 iamcheyan/shizuka；本地开发目录只用于开发和测试。
• flake.nix 声明 shizuka 输入，flake.lock 保存实际 commit。GitHub 推送新 commit 后，NixOS 不会自动使用它。
• 注销或重新登录只会重启 SDDM/用户会话，不会更新 flake.lock，因此仍可能看到 旧主题版本。
• /nix/store 中的旧副本和旧 generation 会保留用于回滚，但不是当前运行版本。

更新 Shizuka 的推荐流程：

cd ~/development/shizuka
git add -A
git commit -m "describe the theme change"
git push origin main

nix flake update shizuka --flake ~/nixos-config
nix flake check --no-build ~/nixos-config
nixos-rebuild build --flake ~/nixos-config#hx90
sudo nixos-rebuild switch --flake ~/nixos-config#hx90

确认实际版本：

readlink /nix/var/nix/profiles/system
readlink -f /run/current-system/sw/share/sddm/themes/shizuka

如果主题目录路径末尾包含对应的 Shizuka Git commit，说明当前系统已经切换到该 版本；仅看到 GitHub 上有新 commit，不能证明本机已经更新。

锁屏插件是独立组件，位于 ~/.config/omarchy/plugins/iamcheyan.lock-screen。它与 Shizuka 保持视觉一一对应， 但不会因为更新 SDDM 主题而自动更新；修改锁屏插件后应单独验证其 QML 和锁屏流程。

为什么只改一个锁节点也可能下载很多包

锁文件的变更行数不等于软件包变更数量。nixpkgs 位于依赖图根部，它的一个 revision 决定内核、glibc、systemd、Firefox、桌面库和绝大多数系统包。因此即使 git diff flake.lock 只显示 nixpkgs 前移，也可能产生数百个新 derivation。

构建输出中的 copying path ... from https://cache.nixos.org 表示下载官方二进制 缓存，不是全部在本机编译。下载完成的 store path 是不可变缓存；中止构建后仍可在 下次构建中复用。只有 nixos-rebuild switch 成功后，新闭包才成为当前系统。

不会更新哪些内容

• ~/chezmoi、~/dotfiles 及其 Git 子模块；它们有各自的更新与提交流程。
• 浏览器资料、数据库、容器卷、keyring、Rime 用户数据等运行时数据。
• 不在 NixOS/Home Manager 声明中的手动安装软件或用户级包管理器内容。
• system.stateVersion；它是兼容性基线，不应随更新提高。
• NixOS 大版本分支。本仓库固定在 nixos-26.05，普通更新只在该分支内前移。

更新前后的推荐检查

更新前保证工作区干净，避免无法区分配置修改和锁文件更新：

cd ~/nixos-config
git status --short

如果希望先看规模而不直接切换，不使用一体化的 omarchy update，改为手动分步：

cd ~/nixos-config
nix flake update
git diff -- flake.lock
nixos-rebuild build --flake .#hx90

build 会显示计划构建/下载的 derivation，但不会激活系统。规模不合适时可以 Ctrl-C 停止，再决定保留还是恢复 flake.lock；确认构建成功后才运行：

sudo nixos-rebuild switch --flake .#hx90

更新后检查究竟有哪些输入变化：

git diff -- flake.lock
nix flake metadata
nix flake check --no-build
nixos-rebuild build --flake .#hx90

确认桌面、网络、音频、输入法和关键程序正常后提交锁文件：

git add flake.lock
git commit -m "chore: update NixOS flake inputs"
git push origin main

如果 rebuild 失败，flake.lock 仍可能已经被改写；应先检查失败原因或恢复锁文件， 不要把失败的更新直接提交。

只更新一个输入

需要缩小变更范围时，可只更新指定输入：

cd ~/nixos-config
nix flake update nixarchy
# 或：nix flake update nixpkgs
nix flake check --no-build
nixos-rebuild build --flake .#hx90
sudo nixos-rebuild switch --flake .#hx90

只更新 Nixarchy 也可能连带更新它未 follows 的传递输入。始终以 git diff -- flake.lock 为准。

回滚的两个层次

系统激活出问题时，回到上一 generation：

sudo nixos-rebuild switch --rollback

无法进入桌面时，可在 systemd-boot 启动菜单选择上一代。generation 回滚只改变 当前运行系统，不会自动恢复 Git 工作树中的 flake.lock。若确认本次输入更新不应 保留，再在仓库中恢复锁文件，然后重新构建：

git diff -- flake.lock
git restore flake.lock       # 仅在明确要丢弃未提交更新时使用
nixos-rebuild build --flake .#hx90
sudo nixos-rebuild switch --flake .#hx90

如果锁文件已经提交，优先用 git revert <commit> 留下可审计记录，而不是重写 历史。系统 generation 不会回滚用户目录运行时数据、浏览器资料、keyring 或容器卷。

常见路径问题

若出现：

/etc/nixos is not writable by tetsuya

先检查：

echo "$NIXARCHY_FLAKE"

正确值是 / nixos-rebuild switch 的旧终端 可能仍继承旧环境，可临时运行：

NIXARCHY_FLAKE="$HOME/nixos-config" omarchy update