GTLX Blog

yazi

Wed, 13 May 2026 00:00:00 GMT

安装

sudo snap install yazi
- sudo snap install yazi --classic

使用

配置文件地址：
- ~/.config/yazi/（Linux/macOS）
- %AppData%\yazi\config（Windows）
通用配置：yazi.toml
快捷键配置：keymap.toml
- 默认快捷键与vim类似
配色方案配置：theme.toml(主题)
显示调试：yazi --debug
查询默认应用程序：xdg-mime query default text/plain
- text/plain：指定的 MIME 类型（这里是指普通文本）

配置

命令行输入：nano ~/.config/yazi/yazi.toml

# ============ 管理器设置 ============
[manager]
ratio = [1, 4, 3]
sort_by = "alphabetical"
show_hidden = false

# ============ 预览设置 ============
[preview]
max_width = 600
max_height = 900

# ============ 文件打开器 ============
[opener]
# LibreOffice — 统一打开 xlsx/xls/ods/pdf/csv
libreoffice = [
    { run = 'libreoffice "$@"', orphan = true, desc = "LibreOffice" }
]

# 图片 — nomacs
nomacs = [
    { run = 'nomacs "$@"', orphan = true, desc = "nomacs" }
]

# 文本编辑 — NeoVim
nvim = [
    { run = 'nvim "$@"', block = true, desc = "NeoVim" }
]

# 视频/音频 — VLC
vlc = [
    { run = 'vlc "$@"', orphan = true, desc = "VLC" }
]

# AppImage — 需要先手动赋予权限
appimage = [
    { run = '"$@"', desc = "运行 AppImage", block = true }
]

# 兜底：系统默认程序
fallback = [
    { run = 'xdg-open "$@"', orphan = true, desc = "系统默认" }
]

# ============ 文件打开规则 ============
[open]
rules = [
    # 图片 → nomacs
    { mime = "image/*", use = ["nomacs", "reveal"] },

    # 办公文档 + PDF → LibreOffice（mime 匹配）
    { mime = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", use = ["libreoffice"] },
    { mime = "application/vnd.ms-excel", use = ["libreoffice"] },
    { mime = "application/vnd.oasis.opendocument.spreadsheet", use = ["libreoffice"] },
    { mime = "application/pdf", use = ["libreoffice"] },
    { mime = "text/csv", use = ["libreoffice"] },

    # 办公文档兜底：url 匹配（防止 MIME 被误识别为 zip）
    { url = "*.xlsx", use = ["libreoffice"] },
    { url = "*.xls", use = ["libreoffice"] },
    { url = "*.ods", use = ["libreoffice"] },
    { url = "*.csv", use = ["libreoffice"] },
    { url = "*.pdf", use = ["libreoffice"] },

    # 视频/音频 → VLC
    { mime = "video/*", use = ["vlc", "reveal"] },
    { mime = "audio/*", use = ["vlc", "reveal"] },

    # 文本文件 → NeoVim
    { mime = "text/*", use = ["nvim", "reveal"] },
    { mime = "application/json", use = ["nvim", "reveal"] },
    
    # AppImage 文件及其它可执行文件
    { mime = "application/vnd.appimage", use = ["appimage"] },
    { url = "*.AppImage", use = ["appimage"] },
    { mime = "application/x-executable", use = ["appimage"] },
    { mime = "application/x-sharedlib", use = ["appimage"] },
]

说明

管理器设置：`[mgr]`

[mgr]
ratio = [1, 4, 3]
sort_by = "alphabetical"
show_hidden = false

ratio = [1, 4, 3]：设置yazi界面三个面板的宽度比例
- 第一个数字：左侧面板宽度比例（通常是父目录树或预览）
- 第二个数字：中间主文件列表宽度比例
- 第三个数字：右侧面板宽度比例（通常是预览面板）
- [1, 4, 3] 表示比例为 1:4:3
sort_by = "alphabetical"：文件排序方式
- "alphabetical"：按字母顺序排序
- 其他可选值：
  - "natural"（自然排序）
  - "mtime"（修改时间）
  - "size"（文件大小）
  - "ctime"（创建时间）
  - "atime"（访问时间）
show_hidden = false：是否显示隐藏文件
- false：不显示以点（.）开头的隐藏文件
- true：显示所有隐藏文件

预览设置：`[preview]`

[preview]
max_width = 600
max_height = 900

max_width = 600：预览图片的最大宽度（像素）
max_height = 900：预览图片的最大高度（像素）
这些设置控制图片预览时的尺寸限制，防止大图片占用过多内存

文件打开器：`[opener]`

参数说明：

参数	含义(作用)	值
`run`	执行的命令
`"%@"`	代表选中文件的路径，Yazi 会自动替换	占位符（Shell 语法）
`block`	`true` = 阻塞等待程序关闭；`false` = 不等待	终端编辑器选择
`orphan`	`true` = 脱离终端独立运行	GUI 程序必加
`desc`	描述信息
`for`	平台限定：`"unix"` 或 `"windows"`

文件打开规则：`[open]`

参数说明

参数	值	作用
`orphan = true`	GUI 程序必加	脱离终端独立运行，关闭 Yazi 后程序不退出 [1]
`mime`		用 MIME 类型的 glob 表达式来匹配文件。
	语法	glob 通配符表达式，如 `text/、image/、application/pdf`
	大小写	默认不区分大小写。若要区分，在表达式开头加 `\s`（如 `\stext/*`）
	多类型	可用 {} 同时匹配多个，如 `{audio,video}/*`
`use`		指定用`[opener]`中的哪个（或哪些）打开器来处理匹配到的文件。
	类型	必须是数组，如 `use = ["edit"]`，不能是字符串 `use = "edit"`
	多 opener	可以指定多个，如`use = ["open", "edit"]`
	对应关系	数组中的名称必须与`[opener]`段定义的规则名一致，如 edit、play、libreoffice 等
`"reveal"`	内置值	同时在预览面板显示文件内容 [1]

MIME 类型速查表

文件类型	MIME 类型
`.xlsx`	`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`
`.xls`	`application/vnd.ms-excel`
`.ods`	`application/vnd.oasis.opendocument.spreadsheet`
`.pdf`	`application/pdf`
所有图片	`image/*`

主题美化

主题的安装

手动安装主题

创建 yazi 主题目录：mkdir -p ~/.config/yazi/flavors

图标美化

安装 Nerd Fonts 字体来显示图标

Arch Linux：sudo pacman -S ttf-nerd-fonts-symbols
macOS：brew install font-symbols-only-nerd-font

配置

终端输入：nano ~/.config/yazi/theme.toml

[general]
# 设置主界面配色方案
background_color = "#1e1e2e"  # 背景颜色
foreground_color = "#cdd6f4"  # 文本颜色
cursor_color = "#89dceb"      # 光标颜色
selection_color = "#585b70"   # 选中项背景颜色
highlight_color = "#fab387"   # 高亮颜色

[ui]
# 界面边框与间距
border_color = "#45475a"      # 边框颜色
padding = 4                   # 界面内容的内边距

[file_browser]
# 文件浏览器颜色配置
directory_color = "#89b4fa"   # 目录名称颜色
file_color = "#cdd6f4"        # 普通文件颜色
symlink_color = "#f5c2e7"     # 符号链接颜色
hidden_file_color = "#6c7086" # 隐藏文件颜色

[status_bar]
# 状态栏颜色
background_color = "#313244"  # 状态栏背景
foreground_color = "#a6adc8"  # 状态栏文字
error_color = "#f38ba8"       # 状态栏错误信息

[icon]
# ============ 文件夹图标 ============
dirs = [
   # 特殊文件夹 — 名字精确匹配
   { name = ".git",     text = "", fg = "#f14c28" },
   { name = ".github",  text = "", fg = "#ffffff" },
   { name = ".ssh",     text = "󰣀", fg = "#f9e2af" },
   { name = "Desktop",  text = "", fg = "#89b4fa" },
   { name = "Documents",text = "", fg = "#4ade80" },
   { name = "Downloads",text = "", fg = "#74c7ec" },
   { name = "Music",    text = "󰝚", fg = "#cba6f7" },
   { name = "Pictures", text = "󰋩", fg = "#94e2d5" },
   { name = "Videos",   text = "󰨜", fg = "#f38ba8" },
   { name = "node_modules", text = "", fg = "#6c7086" },
]

# ============ 文件图标 ============
files = [
   # 按文件名匹配
   { name = "Dockerfile",          text = "󰡨", fg = "#89b4fa" },
   { name = "docker-compose.yml",  text = "󰡨", fg = "#89b4fa" },
   { name = "package.json",        text = "", fg = "#e8274b" },
   { name = "package-lock.json",   text = "", fg = "#6c7086" },
   { name = "README.md",           text = "󰂺", fg = "#f59e0b" },
   { name = "LICENSE",             text = "", fg = "#cdd6f4" },
   { name = "Makefile",            text = "", fg = "#6c7086" },
   { name = "*.rs",                text = "", fg = "#f38ba8" },
   { name = "*.py",                text = "", fg = "#89b4fa" },
   { name = "*.js",                text = "", fg = "#f9e2af" },
   { name = "*.ts",                text = "", fg = "#74c7ec" },
   { name = "*.lua",               text = "", fg = "#89b4fa" },
   { name = "*.toml",              text = "", fg = "#6c7086" },
   { name = "*.yaml",              text = "", fg = "#6c7086" },
   { name = "*.yml",               text = "", fg = "#6c7086" },
   { name = "*.json",              text = "", fg = "#f9e2af" },
   { name = "*.lock",              text = "󰌾", fg = "#6c7086" },
   { name = "*.zip",               text = "", fg = "#6c7086" },
   { name = "*.tar*",              text = "", fg = "#6c7086" },
]

背景渲染

ueberzugpp

基于 ueberzug协议
arch系安装：sudo pacman -S ueberzugpp
验证安装：ueberzugpp --version

插件的管理

yazi 本身不直接处理挂载，但可以通过插件增强体验：
U盘的挂载见 > [[U盘的自动挂载#yazi终端文件管理器中使用]]

常见的插件

类别	依赖/插件	用途
	augment-command	命令增强
	bypass	智能进入目录
预览	duckdb	JSON/CSV/Excel 预览
美化	full-border	边框美化插件
解压	fast-enter	解压文件，并进入
挂载	gvfs	设备挂载
挂载	mount	挂载设备
预览	mediainfo	媒体文件信息预览
压缩	ouch	压缩文件操作
回收站	recycle-bin	回收站功能
美化	starship	状态栏美化
智能进入	smart-enter	智能进入
书签	whoosh	书签管理

通过yazi包配置 yazi 插件：

安装 yazi 的 mount 插件：ya pack -a yazi-rs/plugins:mount

# 编辑 ~/.config/yazi/package.toml
[plugin]
add = ["mount"]

手动下载插件包

创建 yazi 插件目录：mkdir -p ~/.config/yazi/plugins

类 vi 编辑器

Fri, 08 May 2026 00:00:00 GMT

关系

vi 一般是Linux自带的，带有可以在命令行中运行
vim 在 vi的基础上，可在命令行中运行，在vi的基础上更加美观
neovim 在 vim 的基础上，拥有界面，更加美观花里胡哨，可媲美 VScode

基本的语法（键位）

命令	用途
`:w`	保存
`:q`	退出
`!` 如：`q！`就是强制退出，不保存	强制
`d` 若不使用`p`粘贴就是删除	剪切/删除
`y`	复制
`p`	粘贴
`i`	进入批注模式
`v`	进入复制模式
`esc`	返回正常模式
`gf`	进入
`s`，写法：`:s {被替换的字符}/{需要替换的字符}`支持正则表达式	替换

vim

Vim官网：网站

NeoVim

NeoVim官网：网站编辑器

安装 LazyVim框架

LazyVim 是目前最受欢迎的 Neovim 配置框架（基于 lazy.nvim），开箱即有 IDE 级功能，启动极快
官网：网站
Github 开源地址：网站
学习资源
- :help + :Lazy + :Mason 是最好的老师。
- YouTube 搜索 “LazyVim 2026” 或 “Neovim note taking” 有很多最新视频。
- 中文社区：Reddit r/neovim、B站搜索 “Neovim 配置”。

安装步骤：

备份旧配置（重要！）

备份原有 Neovim 配置
- mv ~/.config/nvim ~/.config/nvim.bak
- mv ~/.local/share/nvim ~/.local/share/nvim.bak
可选但推荐
- mv ~/.local/state/nvim ~/.local/state/nvim.bak
- mv ~/.cache/nvim ~/.cache/nvim.bak

克隆 LazyVim 启动模板

终端输入：git clone https://github.com/LazyVim/starter ~/.config/nvim

安装后的目录结构

~/.config/nvim/中

├── lua/
│   ├── config/
│   │   ├── autocmds.lua      # 自动命令
│   │   ├── keymaps.lua        # 快捷键设置
│   │   ├── lazy.lua           # 懒加载配置
│   │   └── options.lua        # 编辑器选项
│   └── plugins/               # 自定义插件目录
│       └── example.lua
└── init.lua                   # 入口文件

移除 .git 文件夹

终端输入：rm -rf ~/.config/nvim/.git
- 方便托管自己的配置到个人仓库中

启动 Neovim

终端输入：nvim
首次启动时，LazyVim 会自动下载并安装所有默认插件，请耐心等待 2-5 分钟到结束。
如果有插件安装错误：见 [[类 vi 编辑器（以 NeoVim 为例）#插件安装失败]]

安装插件（使用LazyVim框架）

在 ~/.config/nvim/lua/plugins/ 目录下新建 .lua 文件：

使用

安装完后，用 :LazyExtras 命令启用需要的扩展（非常方便）。
LazyVim 默认已包含很多插件：（可以部分替代 VSCode 的核心功能）
- LSP、补全、格式化、Lint：mason.nvim + nvim-lspconfig + blink.cmp（或 nvim-cmp）+ conform.nvim 等。
- Treesitter：优秀语法高亮和代码结构。
- Telescope / fzf-lua：模糊查找文件、符号、grep（比 VSCode 的 Command Palette 还强）。
- 调试：nvim-dap（支持多种语言）。
- Git：gitsigns、lazygit、neogit。

启用语言支持：

在 ~/.config/nvim/lua/plugins/ 下新建文件：
Python、Rust、Go、TypeScript、Java 等：
- 用 :LazyExtras 搜索对应 lang.* 启用。
示例启用 Python 和 Markdown：
- 在 lua/config/lazy.lua 或 plugins 文件中添加：

return {
  { import = "lazyvim.plugins.extras.lang.python" },
  { import = "lazyvim.plugins.extras.lang.markdown" },

设置中文：

whichkey.lua

文件路径：nvim ~/.config/nvim/lua/plugins/whichkey.lua

-- ~/.config/nvim/lua/plugins/whichkey.lua
return {
  {
    "folke/which-key.nvim",
    opts = {
      spec = {
        -- ==================== 顶级分组 ====================
        { "<leader>f", group = "🔍 文件" },
        { "<leader>s", group = "🔎 搜索" },
        { "<leader>w", group = "🪟 窗口" },
        { "<leader>b", group = "📑 Buffer" },
        { "<leader>g", group = "🌿 Git" },
        { "<leader>l", group = "⚡ LSP" },
        { "<leader>d", group = "🐛 调试" },
        { "<leader>t", group = "🧪 测试" },
        { "<leader>q", group = "❌ 会话/退出" },
        { "<leader>o", group = "📝 Obsidian" },
        { "<leader>n", group = "📓 笔记" },
        { "<leader>u", group = "🔧 UI/界面" },
        { "<leader>x", group = "🔧 诊断" },

        -- ==================== 子分组 ====================
        -- 文件
        { "<leader>ff", desc = "查找文件" },
        { "<leader>fg", desc = "全文搜索 (Live Grep)" },
        { "<leader>fr", desc = "最近打开的文件" },
        { "<leader>fb", desc = "浏览 Buffer" },

        -- 窗口
        { "<leader>wd", desc = "关闭当前窗口" },
        { "<leader>wo", desc = "只保留当前窗口" },
        { "<leader>ws", desc = "水平分栏" },
        { "<leader>wv", desc = "垂直分栏" },
        { "<leader>w=", desc = "窗口等大" },

        -- Obsidian
        { "<leader>ob", desc = "反向链接 (Backlinks)" },
        { "<leader>ot", desc = "今日笔记" },
        { "<leader>oq", desc = "快速切换笔记" },
        { "<leader>os", desc = "搜索笔记内容" },
        { "<leader>on", desc = "新建笔记" },
        { "<leader>op", desc = "粘贴图片" },
      },
    },
  },
}

keymaps.lua

文件路径：nvim ~/.config/nvim/lua/config/keymaps.lua

-- ~/.config/nvim/lua/config/keymaps.lua
local map = vim.keymap.set

-- Obsidian 快捷键
map("n", "<leader>ob", "<cmd>ObsidianBacklinks<cr>", { desc = "反向链接" })
map("n", "<leader>ot", "<cmd>ObsidianToday<cr>", { desc = "今日笔记" })
map("n", "<leader>oq", "<cmd>ObsidianQuickSwitch<cr>", { desc = "快速切换笔记" })
map("n", "<leader>os", "<cmd>ObsidianSearch<cr>", { desc = "搜索笔记内容" })
map("n", "<leader>on", "<cmd>ObsidianNew<cr>", { desc = "新建笔记" })

-- 窗口操作
map("n", "<leader>ws", "<C-w>s", { desc = "水平分栏" })
map("n", "<leader>wv", "<C-w>v", { desc = "垂直分栏" })
map("n", "<leader>wd", "<C-w>c", { desc = "关闭当前窗口" })
map("n", "<leader>wo", "<C-w>o", { desc = "只保留当前窗口" })

实用技巧 & 工作流

快捷键：LazyVim 默认很多 <leader> 键（空格），如 <leader>ff 找文件、gd 跳转定义、K 显示悬浮文档。
终端集成：用 WezTerm / Kitty + Tmux，nvim 里用 :terminal 或 toggleterm.nvim。
多语言：一个 vault 放笔记，项目目录直接打开 nvim 写代码。
同步：笔记用 Git + GitHub，或 Syncthing。
手机端：Obsidian App + Git 同步，或 Termux + nvim（进阶）。
性能：Neovim 通常比 VSCode 轻很多，适合老电脑或远程 SSH。

其他

常见问题解决

插件安装失败

清除缓存后重试
- rm -rf ~/.cache/nvim
- rm -rf ~/.local/share/nvim/lazy
- rm -rf ~/.local/stare/nvim/lazy
- 启动：nvim
然后在 Neovim 中执行：update
- 查找更新

如何重置配置

# 备份自定义配置
cp -r ~/.config/nvim/lua/custom ~/nvim-custom-backup

# 重新安装
rm -rf ~/.config/nvim
git clone https://github.com/LazyVim/starter ~/.config/nvim

# 恢复自定义配置
cp -r ~/nvim-custom-backup ~/.config/nvim/lua/custom

Niri 的安装与使用

Sat, 24 Jan 2026 00:00:00 GMT

安装

niri 官网：网站
Github 开源地址：网站

arch系安装：`niri`包

后端依赖：
- 基础包：xdg-desktop-portal （必装）
  - Wayland 合成器功能：xdg-desktop-portal-wlr （Wayland专用/必装）
  - GTK应用支持：xdg-desktop-portal-gtk （强烈推荐）
  - GNOME 应用支持：xdg-desktop-portal-gnome
    - KDE 应用支持：xdg-desktop-portal-kde
  - wxWidgets 应用支持：xdg-desktop-portal-wxgtk
  - 运行 Qt5 应用：xdg-desktop-portal-qt5
  - 运行 Qt6 应用：xdg-desktop-portal-qt6
安装xwayland兼容：xorg-xwayland和xwayland-satellite
- xorg-xwayland：传统的 Xwayland 服务器，用于在 Wayland 环境中运行 X11 应用程序
- xwayland-satellite：专门为 niri 设计的 Xwayland 管理工具，提供更好的集成和认证管理

使用

安装 [[桌面shell]]

配置文件

配置文件：
- 用户级配置文件：~/.config/niri/config.kdl
验证配置文件：niri validate

主配置文件

// ============================================
// Niri 主配置文件
// 快捷键配置已分离到 binds.kdl
// ============================================

// 包含快捷键配置文件
include "binds.kdl"

// 键盘鼠标触摸板等输入设备相关配置
input {
    // 禁用触摸板（Touchpad）
    touchpad { off; }
    
    keyboard {
        xkb {
            layout "us"
            // 可选：添加更多键盘布局选项
            // vaIIInt "altgr-intl"
            // options "ctrl:nocaps"  // 将CapsLock用作Ctrl键
        }
    
        // 在启动上启用 numlock，省略此设置会禁用它
        numlock
        
        // 可选：重复按键设置
        // repeat-delay 600
        // repeat-rate 25
    }
    
    mouse {
        accel-profile "flat"
        // 可选：调整鼠标速度 (-1到1之间由慢到快)
        // accel-speed 0.5
    }
    
    // 鼠标移动到新聚焦的窗口
    warp-mouse-to-focus
    
    // 聚焦鼠标移动到的窗口上
    focus-follows-mouse
    
    // 切换mod键：正常使用Super，嵌套窗口内使用Alt
    // mod-key "Super"
    // mod-key-nested "Alt"
    
    // 可选：禁用电源键处理（使用系统默认功能）
    // disable-power-key-handling
}

// 显示器配置
// 运行 `niri msg outputs` 或 `wlr-randr` 查看显示器名称
output "eDP-1" {
    mode "2560x1440@165.000"
    scale 1.33
    position x=0 y=0
    focus-at-startup
    // 可选：旋转显示器
    // transform "normal"  // normal, 90, 180, 270, flipped, flipped-90, flipped-180, flipped-270
}

// 如果有多个显示器，可以添加更多配置
// output "HDMI-A-1" {
//     mode "1920x1080@60.000"
//     scale 1.0
//     position x=2560 y=0
// }

// 窗口布局设置
layout {
    // 窗口周围的缝隙（逻辑像素）
    gaps 5
    
    // 背景颜色（工作区透明）
    background-color "transparent"
    
    // 存在多个窗口时，未最大化的窗口不自动居中，方便分屏
    center-focused-column "never"
    
    // 只有一个窗口时自动居中显示
    always-center-single-column
    
    // 预设列宽度（使用Mod+R切换）
    preset-column-widths {
        proportion 0.3    // 30%宽度
        proportion 0.5    // 50%宽度
        proportion 0.7556 // 75.56%宽度
        proportion 1.0    // 100%宽度
        // 也可以使用固定像素宽度（受scale影响）
        // fixed 1920
    }
    // ============================================
    // 隐藏窗口标题栏
    // ============================================
    // prefer-no-csd

    // 预设窗口高度（使用Mod+Shift+R切换）
    preset-window-heights {
        proportion 0.5    // 50%高度
        proportion 0.8    // 80%高度
        proportion 1.0    // 100%高度
    }
    
    // 聚焦环设置（可选）
    focus-ring {
        off  // 关闭聚焦环
        // 或者自定义颜色
        // active-color "#61AFEF"
        // inactive-color "#505050"
    }
    
    // 边框设置
    border {
        on
        width 2.5
        active-color "#4ec9b0"
        inactive-color "#505050"
    }
}

// ============================================
// 环境变量设置
// ============================================
environment {
    // 语言和区域设置
    LANG "zh_CN.UTF-8"
    LC_CTYPE "zh_CN.UTF-8"
    LC_NUMERIC "zh_CN.UTF-8"
    LC_TIME "zh_CN.UTF-8"
    LC_COLLATE "zh_CN.UTF-8"
    LC_MONETARY "zh_CN.UTF-8"
    LC_MESSAGES "zh_CN.UTF-8"
    LC_PAPER "zh_CN.UTF-8"
    LC_NAME "zh_CN.UTF-8"
    LC_ADDRESS "zh_CN.UTF-8"
    LC_TELEPHONE "zh_CN.UTF-8"
    LC_MEASUREMENT "zh_CN.UTF-8"
    LC_IDENTIFICATION "zh_CN.UTF-8"
    
    // Wayland 相关环境变量
    QT_QPA_PLATFORM "wayland"
    GDK_BACKEND "wayland"
    SDL_VIDEODRIVER "wayland"
    MOZ_ENABLE_WAYLAND "1"
    ELECTRON_OZONE_PLATFORM_HINT "wayland"
    
    // 输入法设置
    QT_QPA_PLATFORMTHEME "qt6ct"
    QT_IM_MODULE "fcitx"
    XMODIFIERS "@im=fcitx"
    QT_IM_MODULES "wayland;fcitx"
    
    // 代理设置（可选）
    // ALL_PROXY "http://127.0.0.1:7890"
    // HTTP_PROXY "http://127.0.0.1:7890"
    // HTTPS_PROXY "http://127.0.0.1:7890"
}

// ============================================
// 自启动程序
// ============================================
spawn-at-startup "fcitx5" "-d"
spawn-at-startup "xwayland-satellite"
spawn-at-startup "qs" "-c" "noctalia-shell"
// spawn-at-startup "/usr/lib/polkit-kde-authentication-agent-1"


// 可选：添加更多自启动程序
// spawn-at-startup "waybar"
// spawn-at-startup "swaync"
// spawn-at-startup "swayidle" "-w" "timeout" "601" "niri msg action power-off-monitors" "timeout" "600" "swaylock -f" "before-sleep" "swaylock -f"
// spawn-at-startup "niri-switch-daemon"

// 使用shell命令启动（支持变量、管道等）
spawn-sh-at-startup "wl-paste --watch cliphist store"
// spawn-sh-at-startup "swaybg -i ~/Pictures/wallpaper.jpg -m fill"

// ============================================
// 内部窗口规则
// ============================================
window-rule {
    geometry-corner-radius 12
    clip-to-geometry true
    opacity 1.0  // 设置窗口不透明度为 100%
}

// 可选：为特定应用添加规则
// window-rule {
//     match app-id="firefox"
//     default-column-width { proportion 0.8; }
//     open-on-output "eDP-1"
// }

// window-rule {
//     match app-id="alacritty"
//     default-column-width { proportion 0.5; }
// }

// Steam 全屏游戏规则
window-rule {
    match app-id="steam"
    default-column-width { proportion 1.0; }
}

//kitty 背景透明的设置
window-rule {
    match app-id="kitty"
    opacity 0.8
    draw-border-with-background false
}

// ============================================
// 光标设置
// ============================================
cursor {
    xcursor-theme "breeze"
    xcursor-size 24
    hide-when-typing
}
// ============================================
// 动画设置
// ============================================
animations {
     // 窗口出现
     window-open {
         duration-ms 150
         curve "ease-out-expo"
     }
     // 窗口消失
     window-close {
         duration-ms 150
         curve "ease-out-quad"
     }
     // 窗口在列内移动
     // window-move{}
     // 工作区切换
     workspace-switch{
         duration-ms 250
         curve "cubic-bezier" 0.42 0.0 0.58 1.0
     }
 }

// ============================================
// 截图设置
// ============================================
screenshot-path "~/Pictures/ScreenShot/%Y-%m-%d %H-%M-%S.png"


hotkey-overlay {
    // 跳过“重要的热键”弹出窗口。
    skip-at-startup
}

// 禁用鼠标左上角热脚
gestures {
    hot-corners {
        off
    }
}

快捷键配置文件

在配置文件中添加：include "binds.kdl"分离快捷键配置文件

// ============================================
// Niri 快捷键配置文件
// 包含所有快捷键绑定
// 快捷键需要使用完整的xkb键名
// ============================================
binds {
    // ========== 系统级快捷键 ==========
    Mod+Shift+E hotkey-overlay-title="退出 niri" { quit; }
    Control+D hotkey-overlay-title="关闭当前窗口" { close-window; }
    Mod+Shift+Slash hotkey-overlay-title="显示快捷键列表" { show-hotkey-overlay; }
    
    // ========== 窗口导航快捷键 ==========
    // 基础导航
    Mod+Left hotkey-overlay-title="方向键向左切换窗口" { focus-column-left; }
    Mod+Right hotkey-overlay-title="方向键向右切换窗口" { focus-column-right; }
    Mod+Down hotkey-overlay-title="方向键向下切换列" { focus-workspace-down; }
    Mod+Up hotkey-overlay-title="方向键向上切换列" { focus-workspace-up; }
    
    // 移动窗口
    Mod+Shift+Left hotkey-overlay-title="向左移动列" { move-column-left; }
    Mod+Shift+Right hotkey-overlay-title="向右移动列" { move-column-right; }
    Mod+Shift+Down hotkey-overlay-title="向下移动窗口" { move-window-down; }
    Mod+Shift+Up hotkey-overlay-title="向上移动窗口" { move-window-up; }
    
    // 快速导航
    Mod+Home hotkey-overlay-title="聚焦第一列" { focus-column-first; }
    Mod+End hotkey-overlay-title="聚焦最后一列" { focus-column-last; }
    
    // ========== 窗口管理快捷键 ==========
    Mod+R hotkey-overlay-title="切换预设列宽" { switch-preset-column-width; }
    Mod+Shift+R hotkey-overlay-title="切换预设窗口高度" { switch-preset-window-height; }
    Mod+F hotkey-overlay-title="扩展列到可用宽度" { expand-column-to-available-width; }
    Mod+W hotkey-overlay-title="切换窗口全屏" { toggle-windowed-fullscreen; }
    Mod+C hotkey-overlay-title="居中当前列" { center-column; }
    Mod+Ctrl+C hotkey-overlay-title="居中所有可见列" { center-visible-columns; }
    
    // 调整列宽/高度
    Mod+Minus hotkey-overlay-title="减少列宽10%" { set-column-width "-10%"; }
    Mod+Equal hotkey-overlay-title="增加列宽10%" { set-column-width "+10%"; }
    Mod+Shift+Minus hotkey-overlay-title="减少窗口高度10%" { set-window-height "-10%"; }
    Mod+Shift+Equal hotkey-overlay-title="增加窗口高度10%" { set-window-height "+10%"; }
    
    // ========== 工作区管理 ==========
    // 工作区切换（1-9）
    Mod+1 hotkey-overlay-title="切换到工作区1" { focus-workspace 1; }
    Mod+2 hotkey-overlay-title="切换到工作区2" { focus-workspace 2; }
    Mod+3 hotkey-overlay-title="切换到工作区3" { focus-workspace 3; }
    Mod+4 hotkey-overlay-title="切换到工作区4" { focus-workspace 4; }
    Mod+5 hotkey-overlay-title="切换到工作区5" { focus-workspace 5; }
    Mod+6 hotkey-overlay-title="切换到工作区6" { focus-workspace 6; }
    Mod+7 hotkey-overlay-title="切换到工作区7" { focus-workspace 7; }
    Mod+8 hotkey-overlay-title="切换到工作区8" { focus-workspace 8; }
    Mod+9 hotkey-overlay-title="切换到工作区9" { focus-workspace 9; }
    Mod+0 hotkey-overlay-title="切换到工作区10" { focus-workspace 10; }
    
    // 移动窗口到工作区
    Mod+Shift+1 hotkey-overlay-title="移动列到工作区1" { move-column-to-workspace 1; }
    Mod+Shift+2 hotkey-overlay-title="移动列到工作区2" { move-column-to-workspace 2; }
    Mod+Shift+3 hotkey-overlay-title="移动列到工作区3" { move-column-to-workspace 3; }
    Mod+Shift+4 hotkey-overlay-title="移动列到工作区4" { move-column-to-workspace 4; }
    Mod+Shift+5 hotkey-overlay-title="移动列到工作区5" { move-column-to-workspace 5; }
    Mod+Shift+6 hotkey-overlay-title="移动列到工作区6" { move-column-to-workspace 6; }
    Mod+Shift+7 hotkey-overlay-title="移动列到工作区7" { move-column-to-workspace 7; }
    Mod+Shift+8 hotkey-overlay-title="移动列到工作区8" { move-column-to-workspace 8; }
    Mod+Shift+9 hotkey-overlay-title="移动列到工作区9" { move-column-to-workspace 9; }
    Mod+Shift+0 hotkey-overlay-title="移动列到工作区10" { move-column-to-workspace 10; }
    
    
    // ========== 应用程序启动快捷键 ==========
    // 打开Noctalia shell启动器
    Alt+Space { spawn "qs" "-c" "noctalia-shell" "ipc" "call" "launcher" "toggle"; }
    // 打开 kitty 终端模拟器
    Mod+T { spawn "kitty"; }
    
    // ========== 实用工具快捷键 ==========
    // 打开剪贴板
    mod+V { spawn "qs" "-c" "noctalia-shell" "ipc" "call" "launcher" "clipboard"; }
    
    // 截图功能
    Print hotkey-overlay-title="截图（全屏）" { screenshot show-pointer=false; }
    Shift+Print hotkey-overlay-title="截图（选择区域）" { spawn-sh "grim -g \"$(slurp)\" - | wl-copy"; }
    Ctrl+Print hotkey-overlay-title="截图屏幕（保存）" { screenshot-screen write-to-disk=true; }
    Alt+Print hotkey-overlay-title="截图窗口（保存）" { screenshot-window write-to-disk=true; }
    
    // 锁屏
    mod+L { spawn "qs" "-c" "noctalia-shell" "ipc" "call" "lockScreen" "lock"; }
    
    // ========== 多媒体控制 ==========
    // 音量控制（锁屏时也可用）
    XF86AudioRaiseVolume allow-when-locked=true hotkey-overlay-title="增加音量" { 
        spawn-sh "wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.1+"; 
    }
    XF86AudioLowerVolume allow-when-locked=true hotkey-overlay-title="降低音量" { 
        spawn-sh "wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.1-"; 
    }
    XF86AudioMute allow-when-locked=true hotkey-overlay-title="静音/取消静音" { 
        spawn-sh "wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle"; 
    }
    XF86AudioMicMute allow-when-locked=true hotkey-overlay-title="麦克风静音" { 
        spawn-sh "wpctl set-mute @DEFAULT_AUDIO_SOURCE@ toggle"; 
    }
    
    // 亮度控制（锁屏时也可用）
    XF86MonBrightnessUp allow-when-locked=true hotkey-overlay-title="增加亮度" { 
        spawn "brightnessctl" "set" "+10%"; 
    }
    XF86MonBrightnessDown allow-when-locked=true hotkey-overlay-title="降低亮度" { 
        spawn "brightnessctl" "set" "10%-"; 
    }
    
    // ========== 鼠标滚轮绑定 ==========
    // 工作区切换
    Mod+WheelScrollDown cooldown-ms=150 hotkey-overlay-title="滚轮向下：下一个工作区" { 
        focus-workspace-down; 
    }
    Mod+WheelScrollUp cooldown-ms=150 hotkey-overlay-title="滚轮向上：上一个工作区" { 
        focus-workspace-up; 
    }
    
    // 列切换(可适配触摸板)
    Mod+WheelScrollRight hotkey-overlay-title="滚轮向右：向右聚焦列" { 
        focus-column-right; 
    }
    Mod+WheelScrollLeft hotkey-overlay-title="滚轮向左：向左聚焦列" { 
        focus-column-left; 
    }
    
    // 移动窗口到工作区
    Mod+Ctrl+WheelScrollDown cooldown-ms=150 { move-column-to-workspace-down; }
    Mod+Ctrl+WheelScrollUp cooldown-ms=150 { move-column-to-workspace-up; }
    
    // ========== 高级功能 ==========
    // 切换悬浮窗口
    Mod+Shift+Space hotkey-overlay-title="切换窗口悬浮状态" { toggle-window-floating; }
    Mod+Space hotkey-overlay-title="在悬浮和平铺窗口间切换焦点" { switch-focus-between-floating-and-tiling; }
    
    // 切换标签页模式
    Mod+X hotkey-overlay-title="切换列标签页显示" { toggle-column-tabbed-display; }
    
    // 关闭显示器
    Mod+Shift+P hotkey-overlay-title="关闭显示器" { power-off-monitors; }
    
    // 调试快捷键
    Mod+Shift+Ctrl+D hotkey-overlay-title="调试：切换损伤显示" { debug-toggle-damage; }
    Mod+Escape allow-inhibiting=false hotkey-overlay-title="切换键盘快捷键抑制" { 
        toggle-keyboard-shortcuts-inhibit; 
    }
    
    // 切换概览
    Mod+G repeat=false hotkey-overlay-title="切换概览" { toggle-overview; }
    
    // 窗口选择器 默认为 Alt+Tab

arch linux 的安装

Tue, 04 Nov 2025 00:00:00 GMT

写在前面的话：
- 欢迎加入arch“邪教”。
- 通过这个命令行安装，你会初步的了解linux的解构以及linux与winoed的区别等。总结下来,还算是收获颇丰的。
- 然后因为arch linux的手册很全，有些软件可以参考官方手册进行安装。
- 最后，享受这个痛苦的过程吧！！

安装

官网

官方文档手册：
镜像包下载：
- 清华源

一. 安装前的其他设置（可以省略此步）

改字体：setfont /usr/share/kbd/consolefonts/
改键盘布局：loadkeys de-latin1

以上的看情况可以省略，以下的校准时间不建议省略

校准时间： timedatectl set-ntp true;
- 使用 timedatectl status 检查服务状态

其他一些小设置

输入：vim /etc/pacman.conf
- PS：可以使用vim或nano文件编辑器
- 启动32为应用支持：
  - 删除 【multilib】 前的#号批注；
- 美化进度条（进度条会变成吃豆人）：
  - 找到#color 的删除前面的#号批注
  - 也可以在其下一行加入ILoveCandy

换源：

vim /etc/pacman.d/mirrorlist
同步备份：pacman -Syy
一些国内的源：
- 清华源: Server = https://mirrors.tuna.tsinghua.edu.cn/archlinuxcn/$arch；
ps：
- 如果遇到签名错误，可以安装sudo pacman -S archlinuxcn-keyring
- etc/pacman.d为pacman配置文件路径
- 可以找到路径，按esc退出修改，按：输入wq保存并且退出，并且将光标移到路径上，按gf进入添加源
- 后续也可以直接使用vim编辑文件服务器添加源：（更改源以后记得输入 pacman -Syy 同步备份）

ip link

二. 硬盘分区 `lsblk` （查看硬盘分区）

一般情况loop0，sr0是镜像文件不用管：sda是你的硬盘大小（一般情况是sda）

1. 删除分区

gdisk /dev/sda
- 先输入x，进入管理员模式
- 再输入z，删除分区数据
- 接着分别联系输入俩个Y,确认删除

ps：gdisk为删除指令

2. 设置分区表

parted /dev/sda
1. 输入mktable
2. 输入gpt
3. 输入quit

3. 分区

验证引导模式：

ls /sys/firmware/efi/efivars
PS： 如果命令结果显示了目录且没有报告错误，则系统以UEFI 模式引导。如果目录不存在，则系统可能以 BIOS 模式 (或 CSM 模式) 引导。如果系统未以您想要的模式引导启动，请参考您的主板说明书。

设置分区 `cfdisk`

PS： cgdisk为图形化分区指令

选择gpt回车进入分区界面 (如果不需要选择，可以忽略此步)
移动光标到New删除原来的分区大小，输入直接想要的分区大小,回车确认
光标移动到Yypc确认分区类型

重复以上步骤完成分区，再将光标移动到write输入yes点击回车，保存；然后将光标移动到Quit退出
**PS：**格式的选择
- BIOS分区将光标移动到BIOS boot上回车确认；
- 交换分区：Linux swap；
- 个人分区和根分区Linux filesystem

4. 格式化分区

PS：ext4系统分区格式；（BIOS不用格式化启动分区，UEF需要）

启动分区：mkfs.fat -F 32 /dev/(启动分区名)
交换分区：mkswap /dev/(交换分区名)
根，个人分区： mkfs -t ext4 /dev/(个人或系统分区名)

PS：格式化分区结束，接下来可以输入lsblk查看硬盘分区还在不在。一般格式化完分区以后是没有任何变化的这个不用慌，正常情况。）

5. 挂载分区（不挂载会报错）

常用命令：
- 挂载命令：mount
- 卸载分区：umount
- 启动交换分区命令：swapon
- 新建文件夹命令：mkdir
- 删除文件夹命令：rm -rf 目录名字

挂载交换分区：swapon /dev/(交换分区名)
挂载根分区: mount /dev/(根分区) /mnt
挂载启动分区：(BIOS不需要挂载)
- 新建文件夹 mkdir /mnt/boot
- 挂载启动分区 mount /dev /(启动分区名)/mnt/boot
挂载个人分区：
- 新建文件夹 mkdir /mnt/home
- 挂载个人分区 mount /dev/(个人分区) /mnt/home

三. 配置Liunx（具体的可以见官方手册）

1.下载Linux内核

需要安装的软件包如下：
- base；
- Linux内核和linux框架固件：linux-firmware
- 英特尔（amd）显卡驱动：intel（amd）-ucode

开始安装：pacstrap /mnt base base-devel linux linux-firmware intel-ucode
- ps：
  - pacstrap为安装包特有的安装工具；
  - 如果报错请检查是否拼写错误，或者换一个国内的源

2. 生成 fstab 文件分区:

先生成 fstab 文件分区输入： genfstab -U /mnt >> /mnt/etc/fstab
再用cat命令查看生产的文件是否正确： cat /mnt/etc/fstab

3. 设置本地化

进入安装文件: arch-chroot /mnt

1.设置键盘布局(可选)

1.先输入vim /etc/vconsole.conf
2.再写入：KEYMAP=de-latin1（键盘布局）

2.设置时区：

输入： ln -sf /usr/share/zoneinfo/Asia(地区名)/Shanghai(城市名) /etc/localtime
- cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
同步硬件时间：hwclock --systohc

3.设置语言：

输入 vim /etc/locale.gen；查找#en_US.UIF-8和#zh_CN.UTF-8回车；去掉#批注后保存退出
输入locale-gen确认文件是否正常
3.（新版可选也可以不应用，不用管）

用vim创建文件输入vim /etc/locale.conf；再设定 LANG 变量写入LANG=en_US.UTF-8；

应用语言 export LANG=en_US.UTF-8

4.设置计算机名：(默认是archios)

用vim命令输入：vim /etc/hostname，再输入主机名

5.配置网络： `vim /etc/hosts`

输入以下配置：（当中按tab）

127.0.0.1   localhost
::1         localhost
127.0.1.1   archios.localdomain archios （主机名.本地域名 主机名）

四. 本地化和引导

1. 安装一些常用应用和必要文件

PS：
- 如果报错请检查是否拼写错误
- arch下安装程序的指令pacman -S；pacman -Sy为同步;pacman -Syy更新软件
pacman -S vim networkmanager xorg sudo efibootmgr
- 文件编辑器vim或nano；
- 网络工具networkmanager，iwd,dhcpcd；
- 引导grub，sudo；
- 编辑启动项工具efibootmgr；
- 寻找其他操作系统os-prober；

2. 设置 Root 密码,创建日常用户：

1. 设置 root 密码：

PS： UNIX系统在输入时不会显示密码
输入passwd(改密)
再输入自己要创建的密码，并且再输入一遍确认无误；
看见passud: password updated success fu lly显示成功

2. 创建日常用户（用户名不能大写）:

输入useradd -m -G wheel -s /bin/bash (用户名）
用passwd创建密码：passwd （用户名）
给日常用户提权：输入 visudo；寻找%wheel ALL=(ALL)ALL行去掉#号注释；

可以末尾添加Defaults rootpw有问题直询问根用户（预选）

3. 安装引导

安装grub引导：

输入uname -m确认cup架构

BIOS+MBR输入这个指令安装引导：

grub-install /dev/sda
grub-install --target=i386-pc /dev/sda
- 见到 Installation finished. No error reported. 表示安装完成

UEFI+MBR输入这个指令安装引导:

grub-install --target=(目标架构)-efi --efi-directory

创建一个存放系统引导的文件夹： mkdir /boot/grub (引导文件夹名字)
在文件夹下生成引导配置： grub-mkconfig -o /boot/grub/grub.cfg

4. 重启安装

输入exit或者ctrl+d退出chroot环境
手动卸载分区： umount -R /mnt
执行 reboot 重启系统
- 或shutdown now
重启后点击 Boot existing os 进入系统

五. 推荐官方脚本安装

命令行运行官方脚本：archinstall
- 注意，有时候可能需要网络环境。

GTLX Blog

yazi

安装

使用

配置

说明

管理器设置：[mgr]

预览设置：[preview]

文件打开器 ：[opener]

参数说明：

文件打开规则：[open]

参数说明

MIME 类型速查表

主题美化

主题的安装

手动安装主题

图标美化

安装 Nerd Fonts 字体来显示图标

配置

背景渲染

ueberzugpp

插件的管理

常见的插件

通过yazi包配置 yazi 插件：

手动下载插件包

类 vi 编辑器

关系

基本的语法（键位）

vim

NeoVim

安装 LazyVim框架

安装步骤：

备份旧配置（重要！）

克隆 LazyVim 启动模板

安装后的目录结构

移除 .git 文件夹

启动 Neovim

安装插件（使用LazyVim框架 ）

推荐额外插件

编程插件：

其他笔记插件：

做笔记（Markdown / Zettelkasten / Obsidian 风格）

使用

启用语言支持：

设置中文：

whichkey.lua

keymaps.lua

实用技巧 & 工作流

其他

常见问题解决

插件安装失败

如何重置配置

Niri 的安装与使用

安装

arch系安装：niri包

使用

安装 [[桌面shell]]

配置文件

主配置文件

快捷键配置文件

arch linux 的安装

安装

一. 安装前的其他设置（可以省略此步）

其他一些小设置

换源：

二. 硬盘分区 lsblk （查看硬盘分区）

1. 删除分区

2. 设置分区表

3. 分区

验证引导模式：

设置分区 cfdisk

4. 格式化分区

5. 挂载分区（不挂载会报错）

三. 配置Liunx（具体的可以见官方手册）

1.下载Linux内核

2. 生成 fstab 文件分区:

3. 设置本地化

1.设置键盘布局(可选)

2.设置时区：

3.设置语言：

管理器设置：`[mgr]`

预览设置：`[preview]`

文件打开器：`[opener]`

文件打开规则：`[open]`

安装插件（使用LazyVim框架）

arch系安装：`niri`包

二. 硬盘分区 `lsblk` （查看硬盘分区）

设置分区 `cfdisk`

5.配置网络： `vim /etc/hosts`