MechRevo-NixOS Config

NixOS 个人配置，基于 flakes + Home Manager。

系统概览

项目	内容
系统	NixOS 26.05 (Yarara)
WM	Hyprland (Wayland)
Shell	fish (plugins) + bash (ble.sh) + starship + zellij
桌面面板	Noctalia Shell
终端	Foot(default), Ghostty
文件管理器	Yazi (HM module + 9 插件 + myargonaut 绿色主题 + 6 备选)
输入法	fcitx5 + rime-ice
编辑器	Neovim (kickstart + lazy.nvim, LSP/completion/telescope)
代理	mihomo (TUN 模式)
云同步	OneDrive (HM programs.onedrive)
游戏	Steam + mangohud
Windows 兼容	virt-manager (KVM)

目录结构

├── flake.nix                  # 入口，inputs/outputs 定义
├── flake.lock
├── hardware-configuration.nix # 自动生成，不要手动改
│
├── host/                      # 系统基础设施 (12 文件)
│   ├── default.nix            # 入口汇总
│   ├── boot.nix               # 启动与内核
│   ├── hardware.nix           # GPU、udev、nix-ld
│   ├── locale.nix             # 时区、locale、键盘
│   ├── nix.nix                # Nix 配置
│   ├── users.nix              # 用户与 sudo
│   ├── network.nix            # 网络、mihomo、防火墙
│   ├── services.nix           # PipeWire、蓝牙、CUPS、电源
│   ├── desktop.nix            # Hyprland、fcitx5、字体、foot
│   ├── sddm.nix               # 登录管理器
│   ├── litellm.nix            # AI 代理
│   └── gaming.nix             # Steam、Flatpak、libvirtd
│
├── home/                      # 用户配置 (4 子目录)
│   ├── default.nix            # 入口汇总
│   ├── git.nix                # Git 配置
│   ├── theme.nix              # 主题、字体、深色模式、图标
│   ├── env/                   # 桌面环境
│   ├── dev/                   # 开发工具 (含 AI)
│   ├── productivity/          # 办公、通讯、Windows 兼容
│   └── leisure/               # 影音、游戏、浏览器
│
├── docs/                      # 使用指南
│   ├── hyprland.md
│   ├── noctalia.md
│   ├── nvim.md
│   ├── shell.md
│   ├── litellm.md
│   ├── mihomo.md
│   ├── distrobox.md
│   └── yazi.md
│
├── CLAUDE.md
└── README.md

rebuild

cd ~/myNixOSConfig && sudo nixos-rebuild switch --flake .

配置原则

• 系统级 → host/（驱动、服务、系统工具）
• 用户级 → home/（编辑器、浏览器、日常软件）
• 改用户级配置不需要 sudo，rebuild 自动处理
• 所有改动必须通过 nixos-rebuild 应用，禁止非 nix 方式修改
• secrets 走 /persist/secrets/，不进 git

注意事项

• 显卡/网卡驱动改动要谨慎
• 2K 屏 Hyprland scaling 已配 (1.5)，改 DPI/scale 时注意
• MS CJK 字体: 从 Windows 授权副本提取的字体文件（SimSun/SimHei/KaiTi/FangSong/YaHei/DengXian 等 267 个）存放在 /persist/Fonts/，不进 git。home.activation.copyMsCjkFonts 在每次 rebuild 时将其复制到 ~/.local/share/fonts/MS/，20-ms-office-cjk.conf 配置原生字体优先、开源字体 fallback 的替换链。首次部署需手动从 Windows 机器提取字体文件放到 /persist/Fonts/

新机器首次部署

0. 前置条件

确保已从 U 盘或网络获取本仓库：

git clone <repo-url> ~/myNixOSConfig
cd ~/myNixOSConfig

1. 生成硬件配置

nixos-generate-config --root /mnt
cp /mnt/etc/nixos/hardware-configuration.nix ~/myNixOSConfig/

2. 修改机器特定配置

文件	需要修改的内容
host/core.nix	networking.hostName、time.timeZone、i18n.defaultLocale、users.users.<name>
home/default.nix	home.username、home.homeDirectory
home/hyprland.nix	monitor 显示器配置
flake.nix	nixosConfigurations.<hostname>、home-manager.users.<name>

3. 挂载 /persist 子卷并创建文件

/persist 是 btrfs 子卷（@persist），需在分区时创建并挂载。mihomo 和 LiteLLM 依赖其下的配置文件，首次部署需手动准备：

# 创建目录
sudo mkdir -p /persist/mihomo /persist/secrets

# mihomo 代理配置（必需，否则 mihomo 服务启动失败）
sudo cp <your-mihomo-config.yaml> /persist/mihomo/config.yaml

# LiteLLM 环境变量（可选，仅当使用 LiteLLM 代理时需要）
sudo cp <your-litellm.env> /persist/secrets/litellm.env

/persist/secrets/litellm.env 格式（KEY=VALUE，fish shell 启动时自动加载到用户环境）：

ANTHROPIC_AUTH_TOKEN=your-token
ANTHROPIC_BASE_URL=http://127.0.0.1:4000
OPENAI_API_KEY=your-litellm-master-key
OPENAI_BASE_URL=http://127.0.0.1:4000/v1
DEEPSEEK_API_KEY=your-deepseek-key
LITELLM_MASTER_KEY=your-litellm-master-key

ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 是客户端变量，供 Claude Code 等工具连接 LiteLLM 代理使用。OPENAI_API_KEY + OPENAI_BASE_URL 供 Codex 等 OpenAI 兼容工具使用。DEEPSEEK_API_KEY 和 LITELLM_MASTER_KEY 是 LiteLLM 服务端变量。

GitHub CLI 等工具也可能依赖 /persist/secrets/ 下的其他 env 文件：

sudo cp <your-gh.env> /persist/secrets/gh.env

4. 用户文件和缓存

以下文件路径使用 config.home.homeDirectory 动态解析，但文件本身需要存在：

文件	用途	缺失时影响
~/Pictures/ProfiePictures/	Noctalia 头像	头像不显示
~/Pictures/Wallpapers/	Noctalia 壁纸	壁纸功能不可用
~/.cache/noctalia/HVE/	Noctalia HVE 配置	Hyprland 装饰配置缺失
~/.config/hypr/noctalia/	Noctalia 颜色配置	Hyprland 颜色回退到默认

首次启动 Noctalia 后，~/.cache/noctalia/HVE/ 和 ~/.config/hypr/noctalia/ 会自动生成。

5. 应用配置

sudo nixos-rebuild switch --flake ~/myNixOSConfig#

6. 首次认证

• OneDrive: 终端运行 onedrive 完成 OAuth 认证
• mihomo: 确保 /persist/mihomo/config.yaml 中的订阅链接有效