• 开篇fastfetch

• 仅讨论KDE，hyprland可使用End-4配置安装，niri可使用End-4移植版安装

ISO安装

• 安装过程中主要容易卡在两个点上，一是下载（CachyOS属于在线安装，会自己测镜像，跑不通会安装失败），二是自动分区

镜像问题

• 配置镜像，比如USTC（查看下方使用说明进行配置）

• 如果是校园网，应修改DNS，避免镜像站无法访问（比如wifi里dns加223.6.6.6）

CachyOS - USTC Mirror Help

USTC Mirror Help

https://mirrors.ustc.edu.cn/help/cachyos.html

分区问题

• 按照wiki设置手动分区，注意挂载到 /boot

• 自动分区可能会挤到windows的分区里去（双磁盘）

• 引导分区大小建议按照wiki中设置，用于存储btrfs快照，空间足够可以存放更多快照

CachyOS Installation Desktop/Laptop

How to install CachyOS in a Desktop or Laptop

https://wiki.cachyos.org/installation/installation_on_root/#manual-partitioning

个性化设置

• 可参考的设置，没有设置是必须

必备设置

输入法配置

• fcitx5 + rime + mozc方案

• 安装参考arch wiki，安装fcitx5后也有提示中文输入相关包名

• 参考命令sudo pacman -S fcitx5 fcitx5-rime fcitx5-gtk fcitx5-qt fcitx5-configtool

• 词库在dicts文件夹下，下载的词库放这

• grave 为 `（MySQL里反引号） ~ 对应按键，可能与ctrl + `（ditto键位）冲突，可以换掉

• 在此文件下添加词库，在rime文件夹下放置模型

• 如果卡英文可以注释掉ascii_composer

• 如此使得ctrl+空格只会有rime自己的中英切换，杜绝被卡英文必须找图标改输入法的情况

• 使用，打出表情

快照设置

• 在btrfs assistant下调快照策略

• 默认是只有root的快照，home是没有快照的，需要的话可以单独设置，cachyos默认配置在pacman操作时hook进行快照

• 额外地，可以在设置里开启timeline快照，按时间打快照，设置完需要右上角保存

• 此处设置为总共的快照设置，也就是在此界面进行恢复的快照设置，如果使用了limine引导，更改快照数量需要更改limine的设置

• 更改limine设置

• 此项为最大快照数（所以boot分区按推荐设置2G没有问题）

• tty可以抢救用，不改或可以至少留一个，如果快照设的多关了也可以，大不了liveCD救

基础设置

取消kde密码验证

• 可以避免karing等应用自启时询问密码（如果设置自动登录，非自动登录不需要）

• 删除原本的默认密码库

• 创建名为kdewallet的密码库设为默认

• 直接给空白密码

• 启动后核查kdewallet自动打开，且应用key正确写入（有内容）

• 如果没有正确的自启解锁，可以在kde自启里加启动脚本

取消sudo密码验证

• 在如下文件夹如下文件写入（名字任意，但-前数字表示顺序，可不加，自行替换用户名）

取消primary selection

• primary selection会将光标选中的文本进行复制（尽管不一定存储到剪贴板，取决于设置，如果有的话）

• 如果使用copyq这种没有相关设置的，会使得：
• 1.最近复制的内容在光标选中某内容后被覆盖为空对应内容
• 2.不可以使用选中某项目后enter进行粘贴

• x11下取消：

• wayland方式：
• kde



• or 参考arch wiki
Clipboard - ArchWiki
In X10 (1985), cut buffers were introduced. These were limited buffers that stored arbitrary text and were used by most applications. However, they were inefficient and implementation of them varied, so selections were introduced. Cut buffers are long deprecated, and although some applications (such as xterm) may have legacy support for them, it is both not likely and not recommended that they be used.

https://wiki.archlinux.org/title/Clipboard#Selections

系统与软件更新

• 执行sudo pacman -Syu仅进行系统更新

• 可以使用arch-update，除系统更新，也检查aur 与 flatpak更新

• cachy-update实际也是对arch-update的调用

• 看窗口名也可以出，是执行arch-update命令

类niri的WM

• Karousel（建议0.10版本，新版实测容易出现浏览器，dolphin等不受控）

• kwin脚本可能使得kde桌面重启，在应用程序无法保存工作的状态下慎用

性能监控

• 如果需要游戏内覆盖的（类似MSI Afterburner），可以使用steam，自带

• GPU监控

• nvtop

• nvidia-smi

• nvidia-smi -q可查询程序是否跑在独显上（混合模式用）

• cpu与内存，网络，磁盘等 - btop
• 在不合并下方的tree时，显示的为单项而非总和占用
• 此处可对进程管理（kill，terminate）

性能调控

• GPU超频 - LACT

• CPU限制 - cpupower+acpi+amd-pstate-epp

General System Tweaks

Things you can do to tweak after installing

https://wiki.cachyos.org/configuration/general_system_tweaks/#amd-p-state-driver

• 参数设置可参考能耗曲线

• pstate默认active，试下来也是最优，acpi对应笔记本模式限制，energy_performance_preference与能效设置相对应

• 日用可进一步限制全核4.5G

• 如果不混用power profile daemon，不需要sleep（sleep用于确保生效，或设置为在power profile daemon后启动）

• 编辑服务，自动开机启用

• 如果需要操作系统层面控制电源计划，可用power profile daemon

• 其他调控方案 - ryzenadj（实测8945/7945不可用） lenovolegionlinux（读数不准）

• 可换adios，但nvme感觉用不出什么差别，可以不用改

• 减少空载功耗，改完需要sudo limine-update

额外设置

禁用剪贴板

• 系统托盘附近空白角落或在显示隐藏处右键进入配置

 

• entries中禁用

copyQ wayland下粘贴到当前窗口

• xwayland下可用，使用以下方式

• env QT_QPA_PLATFORM=xcb copyq

win+tab显示桌面概况

• win+tab设置

关闭系统提示音

• 对如回收站删除等场景静音

• 建议直接打开勿扰模式，避免弹窗

搜狗皮肤转Fcitx5皮肤

• 使用此项目

• 原本的代码需要AI改一下数据范围问题

• 默认生成的配置在x11上适合字体10，12，往上会出现皮肤图片撕裂的情况（wayland下不会），可尝试手动调整生成的配置文件，如右图
 

开发设置

兼容其他发行版与环境隔离

• distrobox

• 基础命令：create | enter | rm | stop

• —name 名称 第二个为N卡设置(也可—nvidia，不过没见过enter不卡住的，如果不行再用此flag) —home使用独立的home（默认共用home）

• 创建的distro对应/usr/bin等不与host共用，实现环境的隔离

• N卡小灶

Help with nvidia and podman (distrobox)

On my host ive got the nvidia drivers working and i also installed nvidia-container-toolkit but i cant seem to get my gpu recognized in my distrobox…

https://www.reddit.com/r/NixOS/comments/1e0t2hh/help_with_nvidia_and_podman_distrobox/

容器使用

• podman或docker，以下写一些使用的区别

• docker需要多一步sudo usermod -aG docker $USER

• podman默认rootless，docker可以配置rootless，distrobox会优选podman，除非没装

• podman-compose 要求镜像写全名

• 可以通过podman-restart服务开机自启容器，但容器必须是always，不能是unless-stopped（systemctl edit更改服务不会有用）

SSH连接远程服务器

• 通过私钥连接远程服务器时，应将私钥设置为仅owner有r权限，不然可能有publickey报错连不上

• 作host时，应确保ssh service正常运行

• 防火墙已经放开22端口，ufw allow 22

• 如果/home满了也可能连不上（VSCode），这时可以cmd里尝试ssh连上去删点东西

Jetbrains系安装

• IDE本体 + Runtime

使用mise管理环境

• 基本安装：mise use -g xxx

• 卸载：mise uninstall xxx（只删除对应包，并不修改config.toml配置）

• mise use -g uv，之后通过mise下的uv处理环境，也隔绝开系统的uv（其他依赖包引入，位于/usr/bin下），之后正常mise下uv venv然后pip install -r requirements.txt或让ai给一堆import生成uv dependencies声明，然后uv run

• mise → 装npm → npm装pnpm → pnpm add -g → 直接使用二进制包

• 加了pnpm配置后不再需要mise前缀，或者直接激活mise

• 设置CC为例

• 善用别名（如果不激活mise）

• 配置mise的zsh补全

dotfile管理 - GNU stow

• stow用于生成符号链接，可以应用无感下将配置文件集中到一个文件夹存放，然后git版本控制

软件方案与兼容方案与性能调优

Linux原生应用安装方式总览

• flathub，装了跑在沙箱里

• pacman，仓库里有就能装，cachyos一堆优化包

• paru（aur，官仓也会查询）或PKGBUILD自行构建（源码，deb，rpm，appimage等构建源）

安装方式对应典型app

flathub

• qq，微信，腾讯会议（存在兼容性问题，见后文），rustdesk

• 在界面CV命令安装

• wps（libreoffice的演示播放在往上翻有点lagging）

• obs

pacman（CachyOS仓库优先）

• GUI应用package manager

• 或sudo pacman -S | paru -S 包名

• qbittorrent

AUR与PKGBUILD

• spekx

• paru -S 包名（CachyOS预装aur helper）

• PKGBUILD
• aur的karing版本比较旧，测试上容易每次开机时无法自动开启TUN，需要每次手动清除缓存然后重开TUN
• 修改其PKGBUILD以安装新版karing：



• 验证版本，新版稳定自启TUN



• 也可尝试使用debtap

兼容性方案

3dslicer

• 导入nii图可能出现此类错误

• debug时猜测是数据类型不同导致，查询到linux上对long长度与win不同，使用脚本转换后正常运行

腾讯会议

• x11正常使用摄像头，wayland下1.混合模式通过集显处理，不然会黑屏，但ffmpeg正常调用摄像头 2.独显模式指定环境变量（__EGL_VENDOR_LIBRARY_FILENAMES=/usr/share/glvnd/egl_vendor.d/50_mesa.json）

Snipaste按键会被聚焦窗口读取

• 参见快捷键设置

未解决

• wayland下snipaste无法智能识别wayland窗口，无论以wayland或xwayland启动

• （vaapi驱动）chrome无法硬件解码av1（fallback到cpu软解），firefox，mpv等正常工作

游戏与Win软件

• 使用Steam | Lutris，便于切换wine/proton版本，也可直接wine

steam方式

• steam，搜得到的游戏直接下，搜不到的或win软件（包括执行安装用的exe），都可以通过Games菜单下的添加Non-Steam Game执行

• 界面有的可直接勾选，没有就Browse找到对于exe加进去

• 网盘示例

• 如果出现打不开的，可以使用修改兼容性，换兼容层版本

• 夸克网盘运行示例

• 游戏示例

• 部分二游国际服可一键安装

• STEAMDECK=1 %command%，添加此选项不会有ACE问题

• 游戏DLSS设置效果

lutris方式

• 使用lutris add game执行安装，安装后指定程序即可

• 网易云配置示例

• 应用内关闭GPU加速，会更流畅 （

应用替代

Office

• LibreOffice，OpenOffice，WPS

• 如果需要OneDrive同步，可以web端使用office365

全局快捷键方案

• 面向x11设计的应用如果跑在wayland上，一般除非被聚焦，快捷键是不会生效的，需要xwayland运行，常见环境变量QT_QPA_PLATFORM=xcb

• 另一部分是依靠命令执行的，本身不带有按键的，需要自行注册

• snipaste，用于兼容问题，避免（如设置f1)快捷键被聚焦窗口读取

音乐方案

均衡器与编码

• 蓝牙预装LDAC，不需要额外处理

• 均衡器可用JamesDSP，平替Equalizer + APO，带AutoEQ数据库与图形EQ

• spek可用

在线方案

• 网易云（参考lutris处配置 + proton-cachyos-slr流畅运行，听歌识曲正常工作），但不接受耳机线控，不接受不聚焦下媒体控制键

• 正常自动更新

• 使用新的网页版也可以，音质非VIP下是极高，本地文件云盘的会正常下载源文件，不能听歌识曲，不能调节音质，可以媒体控制

• yt music（web）

本地方案

• 以下均支持DSD（转PCM）

• rmpc(mpd+mpc)，需要配置

• 自带的mpv

Win 截图与剪贴板工作流替代

• 类flow launcher + ditto + snipaste/pixpin工作流，需要补上缺失的：多图剪贴，图片预览，多文本剪贴。

二开vicinae

• 直接多图片的剪贴无法实现 - 转而通过uri实现（可多uri剪贴）

• 多文本剪贴通过多文本合并实现

• 修复在文本编辑中无法ctrl + c复制部分文本

• 图片预览

二开spectacle

• 添加辅助功能 - 保存uri而不是图片本身

其他问题与解决方案

蓝牙出现不可用

• 非OS问题

• 断静电（笔记本拔掉电源静待30s，长按电源开关机重启）

cachyos仓库签名无效

• 一般为镜像问题，1.重试

• 2.sudo cachyos-rate-mirrors或cachyhello里重排序镜像，换镜像再试

paru无法下载错误

• 常见于：下载连接可以在浏览器中正常下载，但使用paru提示无法下载

• 属于下载不完全的文件，但网站不支持按范围继续下载

• 可以删除.cache下对应文件，如果没有对应文件，删除对应文件夹

• 重试即可

• rm -rf ~/.cache/paru/clone/vmware-workstation

• rm ~/.cache/paru/clone/vmware-workstation/winPreVista.iso

更新后spectacle缺少依赖无法启动

• 缺少412版本opencv，最新更新为413

• 降级opecv使用

其他杂项

• ctrl + h 隐藏文件

• f11预览

• kitty使用less的搜索，按下ctrl + shift + h 打开less搜索，/ 加对应词进行搜索，n跳转下一项，shift + n上一项

• 安装yank，默认y复制，p剪贴

• 安装xclip

• 在~/.config/yazi/keymap.toml下写入

• 按下c显示新快捷键，结合i可验证剪贴板写入

• 参考源

How to have Spectacle not open a window when doing meta+Printscreen? I just want to save the image.

I may be blind cause I just can't find an option so it doesn't open a window.

https://www.reddit.com/r/kde/comments/vaimsp/how_to_have_spectacle_not_open_a_window_when/

• 替换原本Win上Snipaste的方案，不要把F1设为启动，会使得矩形截图弹窗（设置复制或保存退出仍然短暂弹窗），设置F1为矩形完美解决，F1选定区域，F4直接截图窗口，F6截图桌面，但不能贴图，也缺少窗口智能识别

• 使用mkcert

• 可用于本地https

• 在chrome，edge等外的自定义密码存储-Bitwarden/VaultWarden的本地部署会用到

• 全局nvidia变量或prime run

• 通过protontricks选择对应prefix（会弹出winetricks，此处选择默认prefix）GUI安装

• or使用vn_winestuff仓的脚本安装

• 效果

• 拓展阅读

欢迎 - Linux 101

Linux 101 课程讲义

https://101.lug.ustc.edu.cn/

Linux 201

Linux 201 进阶教程

https://201.ustclug.org/

理解inode - 阮一峰的网络日志

我觉得，理解inode，不仅有助于提高系统操作水平，还有助于体会Unix设计哲学，即如何把底层的复杂性抽象成一个简单概念，从而大大简化用户接口。

https://www.ruanyifeng.com/blog/2011/12/inode.html

• 注释以下两条，在X11应用可以单独设置：
GTK_IM_MODULE=fcitx QT_IM_MODULE=fcitx

• 编译

• 编译后

• 静息