nan0in_dotfiles

Important

已经重装3次Arch Linux，btrfs损坏直接repair修复好了一次

nan0in's dotfiles for Arch Linux — Hyprland + KDE Plasma 双桌面环境. 使用 GNU Stow 管理配置文件，通过符号链接让 $HOME 下的文件直接指向此仓库，编辑即追踪。

快速安装

git clone git@github.com:nan0in/nan0in_dotfiles.git ~/projects/nan0in_dotfiles
cd ~/projects/nan0in_dotfiles
bash install.sh

脚本会把 config、fcitx5、home 三个包 stow 到 $HOME，并从 .zshrc.secrets.example 生成 ~/.zshrc.secrets（填入你的 API key 等敏感值）。

theme/ 包含 SDDM/grub 主题，需要 root 权限手动安装，不在脚本范围内。

单独 stow / unstow 某个包

bash install.sh stow config          # 只链接 config 包
bash install.sh unstow home          # 只移除 home 包的符号链接
bash install.sh restow config        # 重新链接（结构调整后使用）
bash install.sh status               # 查看各包链接状态
bash install.sh list                 # 列出所有可用包
bash install.sh --dry-run install    # 预览将要执行的操作

Stow 包结构

包	Stow 目标	内容
`config/`	`~/.config/`	Hyprland, Waybar, Dunst, Kitty, Neovim (LazyVim), Ranger, Yazi, fontconfig
`fcitx5/`	`~/.config/fcitx5/`, `~/.local/share/fcitx5/`	Fcitx5 profile、Rime 雾凇拼音 (`rime_ice`)、blog-dark 主题
`home/`	`~/`	`.zshrc`, `.p10k.zsh`, tmux 配置 (`~/.tmux.conf` + `~/.tmux/plugins`)
`theme/`	`/usr/share/`	SilentSDDM 替换文件 / grub 主题（需 root 权限，手动安装）
`ambxst/`	`~/.local/src/ambxst/`	ambxst 源码魔改版（stow 自动链接）
`config/.config/ambxst/`	`~/.config/ambxst/`	用户运行时配置（config 包内）

config 包内各模块

config/.config/
├── hypr/           # Hyprland 窗口管理器
│   ├── hyprland.conf        # 主入口（按顺序 source 各模块）
│   ├── conf.d/              # 模块化配置（env, monitors, binds, rules, …）
│   ├── scripts/             # 辅助脚本（托盘恢复、额外快捷键注册）
│   ├── dms/                 # DMS 主题模块
│   └── lua/                 # 实验性 Lua 配置
├── waybar/         # 状态栏
│   ├── config               # waybar 配置
│   ├── style.css             # 样式（Catppuccin 配色）
│   └── scripts/              # 自定义脚本（playerctl、录屏状态）
├── dunst/          # 通知守护进程
│   ├── dunstrc               # 主配置
│   └── dunstrc.d/            # Catppuccin 主题
├── kitty/          # 终端模拟器
│   ├── kitty.conf            # 主配置
│   └── *.conf                # 主题变体（dracula, translucent, opaque, dank）
├── ambxst/         # ambxst 面板配置 + 预设
├── nvim/           # Neovim (LazyVim)
├── ranger/         # 文件管理器
└── fontconfig/     # 字体配置

收集与管理配置文件

初次收集（--adopt 方法）

参考 chaneyzorn 的方法：

在 home 目录下创建 stow 目录：mkdir ~/projects/nan0in_dotfiles
在 stow 目录下按包分类创建子目录，如 mkdir -p nan0in_dotfiles/config/.config/hypr
将真实配置文件拷贝到对应子目录
运行 stow --adopt config — 会将 $HOME 下同路径的文件移动到 stow 目录并创建符号链接
用 git commit + git checkout 选择性保留或回退变更

Stow 常用操作

命令	说明
`stow -d <dir> -t <target> <pkg>`	从 `<dir>` 将 `<pkg>` 链接到 `<target>`
`stow -D <pkg>`	移除 `<pkg>` 的所有符号链接
`stow -S <pkg>`	创建 `<pkg>` 的符号链接
`stow -R <pkg>`	移除后重新创建（结构调整后使用）
`stow --adopt <pkg>`	将已有文件移入 stow 并创建符号链接

冲突处理：当目标文件已存在时，可手动删除或使用 --adopt + git 操作处理。

依赖清单

桌面环境 (Hyprland)

# 窗口管理器 & 核心组件
sudo pacman -S hyprland xdg-desktop-portal-hyprland qt5-wayland qt6-wayland

# 状态栏 & 应用启动器
sudo pacman -S waybar wofi

# 通知守护进程
sudo pacman -S dunst libnotify

# 壁纸管理
sudo pacman -S swww

# 截图 & 批注
sudo pacman -S grim slurp swappy

# 剪贴板管理
sudo pacman -S wl-clipboard cliphist

# 锁屏 & 登出界面
sudo pacman -S hyprlock wlogout

# 亮度 / 音量控制
sudo pacman -S brightnessctl pamixer

# 网络 & 蓝牙托盘
sudo pacman -S network-manager-applet blueberry bluetuith

基础工具

sudo pacman -S stow git lazygit

Shell

# oh-my-zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
# 插件
git clone https://github.com/zsh-users/zsh-autosuggestions ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting
# p10k 主题
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ~/.oh-my-zsh/custom/themes/powerlevel10k
# 美化工具
sudo pacman -S fortune-mod cowsay lolcat fastfetch
# ls 替代 & 路径跳转
sudo pacman -S eza zoxide
# uv Python 包管理器
curl -LsSf https://astral.sh/uv/install.sh | sh

终端

sudo pacman -S kitty

tmux

sudo pacman -S tmux xclip       # xclip 用于系统剪切板集成

dotfiles 会通过 home/ 包管理 ~/.tmux.conf 和 ~/.tmux/plugins。

# 插件管理器 & 插件
git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
git clone https://github.com/tmux-plugins/tmux-resurrect ~/.tmux/plugins/tmux-resurrect
git clone https://github.com/tmux-plugins/tmux-sensible ~/.tmux/plugins/tmux-sensible
git clone https://github.com/dracula/tmux ~/.tmux/plugins/dracula
# tmux-thumbs（需要 Rust）
sudo pacman -S rust
git clone https://github.com/fcsonline/tmux-thumbs ~/.tmux/plugins/tmux-thumbs
~/.tmux/plugins/tmux-thumbs/tmux-thumbs.sh
# 安装后在 tmux 中按 prefix + I 加载所有插件

编辑器 (Neovim)

sudo pacman -S neovim make cmake   # avante.nvim 需要 cmake
yay -S kd                          # nan0in-plugins.lua 中的翻译工具
# 字体：Maple Mono NF CN
mkdir -p ~/.local/share/fonts/MapleMono
curl -L -o /tmp/MapleMono-NF-CN-v1780677570.zip https://github.com/nan0in/maple-font/releases/download/v1780677570/MapleMono-NF-CN.zip
unzip -n /tmp/MapleMono-NF-CN-v1780677570.zip -d ~/.local/share/fonts/MapleMono/
fc-cache -fv

输入法

sudo pacman -S fcitx5 fcitx5-chinese-addons fcitx5-configtool fcitx5-qt fcitx5-gtk fcitx5-rime
yay -S rime-ice-git

本仓库在 fcitx5/ 包中管理 Fcitx5 profile 和 Rime 用户补丁：

输入法引擎：rime
Rime schema：雾凇拼音 rime_ice
用户补丁：~/.local/share/fcitx5/rime/default.custom.yaml

部署后可执行：

rime_deployer --build ~/.local/share/fcitx5/rime /usr/share/rime-data ~/.local/share/fcitx5/rime/build
cd ~/.local/share/fcitx5/rime && rime_deployer --set-active-schema rime_ice
fcitx5-remote -r

SDDM

# 基础主题
git clone https://github.com/uiriansan/SilentSDDM /tmp/SilentSDDM

# 字体：LXGW WenKai / 霞鹜文楷
sudo pacman -S ttf-lxgw-wenkai

theme/sddm/ 中保存的是 SilentSDDM 的替换文件：

16_10.png：登录背景
nan0in.conf：SilentSDDM 配置覆盖，字体使用 LXGW WenKai

手动安装时，将 SilentSDDM 放入 /usr/share/sddm/themes/，先备份同名文件，再用本仓库中的 nan0in.conf 和 16_10.png 替换对应主题文件。

GRUB

theme/grub/blackice/ 保存当前使用的 GRUB 主题：

原主题：TomorrowX6/arch-grub
背景：nan0in_banner.png
字体：Maple Mono NF CN（.pf2 已内置）
分辨率：推荐 2560x1600,2560x1440,1920x1080,auto

手动安装：

cd ~/projects/nan0in_dotfiles
sudo cp -r theme/grub/blackice /boot/grub/themes/
sudo sed -i 's|^#*GRUB_THEME=.*|GRUB_THEME="/boot/grub/themes/blackice/theme.txt"|' /etc/default/grub
sudo sed -i 's|^#*GRUB_GFXMODE=.*|GRUB_GFXMODE="2560x1600,2560x1440,1920x1080,auto"|' /etc/default/grub
sudo grub-mkconfig -o /boot/grub/grub.cfg

文件管理

sudo pacman -S yazi ranger btop
# yazi 预览
sudo pacman -S chafa ffmpegthumbnailer poppler
yay -S resvg
# yazi 插件：进入 yazi 后运行 ya pkg install

其他工具

# Go 版本管理
bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)
# Node.js 版本管理
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
# Python 环境 (miniforge3)
curl -L -O "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
bash Miniforge3-$(uname)-$(uname -m).sh
# 音乐
yay -S go-musicfox

配置说明

Hyprland (窗口管理器)

配置文件入口为 hyprland.conf，按顺序加载各模块：

hyprland.conf
├── 00-vars.conf       # 基础变量（$mainMod, $terminal 等）
├── 10-env.conf        # 环境变量（XDG, GTK, QT, fcitx5）
├── ambxst generated   # 自动生成的窗口装饰主题
├── 20-monitors.conf   # 显示器配置
├── 30-startup.conf    # exec-once（waybar, dunst, swww 等）
├── 40-input.conf      # 键盘、鼠标、触控板
├── 45-colors.conf     # DMS 颜色变量 + groupbar 着色
├── 50-look.conf       # 外观（圆角、间距、模糊）
├── 55-animations.conf # 动画效果
├── 60-binds.conf      # 快捷键
├── 70-rules.conf      # 窗口规则
└── 90-local.conf      # 本机覆盖（临时测试用）

快捷键：主修饰键为 SUPER（Windows 键）
终端：SUPER + Return → kitty
应用启动器：SUPER + D → wofi
ambxst 面板：SUPER + SHIFT + C 打开配置面板
托盘恢复：SUPER + SHIFT + B（执行 ~/.config/hypr/scripts/recover-tray.sh）
更多快捷键见 conf.d/60-binds.conf

Waybar (状态栏)

配置：waybar/config
样式：waybar/style.css（Catppuccin Mocha 配色）
自定义模块：
- scripts/playerctl/playerctl.sh — 媒体播放控制
- scripts/wlrecord.sh — 录屏状态指示

Dunst (通知)

主配置：dunstrc
主题切换：dunstrc.d/ 下的 Catppuccin 四变体（Latte / Frappe / Macchiato / Mocha）
Hyprland 子地图通知：dunstrc.d/00-hyprland-keybind-submap.conf

Kitty (终端)

主配置：kitty/kitty.conf
主题变体：
- dracula.conf — Dracula 配色
- translucent.conf — 半透明背景
- opaque.conf — 不透明背景
- dank-tabs.conf — Dank Neon 标签页主题
- dank-theme.conf — Dank Neon 配色
- background.conf — 独立背景配置
- diff.conf — diff 高亮配色

ambxst (窗口装饰与面板)

ambxst 是基于 Quickshell 构建的 Hyprland 桌面面板，提供：

毛玻璃液态窗口装饰
配色方案预设切换
工作区管理、启动器、系统托盘

本仓库包含 ambxst 的用户配置和源码魔改补丁。

仓库中的 ambxst 文件

魔改内容

CompositorTomlWriter：重新启用 ignore_alpha layerrule 生成（Hyprland 0.54+ 支持）
CompositorConfig：增加 blurExplicitIgnoreAlpha / blurIgnoreAlphaValue 字段
GlobalShortcuts：托盘恢复快捷键 SUPER+SHIFT+B
ThemePanel：UI 调整，支持字体设置
其他：wal_sync.py pywal 配色同步脚本

新机器安装

# ambxst 源码已包含在 dotfiles 中，由 install.sh 自动 stow 到 ~/.local/src/ambxst/
cd ~/.local/src/ambxst && bash install.sh

无需额外 clone 或 apply patch，clone dotfiles 即包含完整魔改版 ambxst 源码。

预设切换

在 ambxst 面板中 SUPER+SHIFT+C → 选择预设。当前预设保存在 ~/.config/ambxst/presets/active_preset。

截图

桌面 (Hyprland+ambxst)

桌面 (KDE Plasma)

终端: kitty，Shell: oh-my-zsh + powerlevel10k，字体: Maple Mono NF CN + LXGW WenKai / 霞鹜文楷

输入法

Fcitx5 Rime / 中州韵 + 雾凇拼音 rime_ice + blog-dark 主题（Tokyo Night 毛玻璃磨砂暗色）

tmux

Neovim (LazyVim)

antigravity for vibe coding
opencode / oh-my-opencode / codex
cc-switch 配色切换

常用软件

工具	用途
wps-office	替代 Microsoft Office
draw.io	绘图
drawpen	快速批注
goldendict	字典
IMHEX	十六进制编辑器 (类 010editor)
yazi / ranger	文件管理
btop	进程管理
virt-manager + qemu/kvm	虚拟机
VLC	视频播放
go-musicfox	命令行音乐
xiling vivado	FPGA 开发
思源笔记	主笔记软件
meld	文件diff工具

License

MIT

Name		Name	Last commit message	Last commit date
ambxst/.local/src/ambxst		ambxst/.local/src/ambxst
assets		assets
config		config
fcitx5		fcitx5
home		home
input-themes/blog-dark		input-themes/blog-dark
theme		theme
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
install.sh		install.sh

Latest commit

History

Folders and files

Repository files navigation

nan0in_dotfiles

目录

快速安装

单独 stow / unstow 某个包

Stow 包结构

config 包内各模块

收集与管理配置文件

初次收集（--adopt 方法）

Stow 常用操作

依赖清单

桌面环境 (Hyprland)

基础工具

Shell

终端

tmux

编辑器 (Neovim)

输入法

SDDM

GRUB

文件管理

其他工具

配置说明

Hyprland (窗口管理器)

Waybar (状态栏)

Dunst (通知)

Kitty (终端)

ambxst (窗口装饰与面板)

仓库中的 ambxst 文件

魔改内容

新机器安装

预设切换

截图

桌面 (Hyprland+ambxst)

桌面 (KDE Plasma)

输入法

tmux

Neovim (LazyVim)

常用软件

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages