AeroThemePlasma首次运行完整指南：ootb设置向导、SDDM会话选择与HiDPI字体渲染问题修复-育师

【免费下载链接】aerothemeplasma

An alternative shell for KDE Plasma that aims to replicate the look and feel of Windows 7.

项目地址：https://gitcode.com/gh_mirrors/ae/aerothemeplasma

AeroThemePlasma 是一款在 KDE Plasma 上重现 Windows 7 风格的桌面外壳项目。本文是面向新手的 AeroThemePlasma 首次运行指南：从 SDDM 登录界面选择会话，到 ootb 设置向导逐步配置外观，再到修复 HiDPI 字体渲染异常，带你快速完成整个入门流程。

1. 在 SDDM 登录界面选择 AeroThemePlasma 会话

安装完成后（通过 install.sh 一键构建，或按 INSTALL.md 操作），首次启动的关键一步是在SDDM 登录界面的会话列表中选择 AeroThemePlasma 会话。项目提供了两套会话入口：

AeroThemePlasma (X11)：由 aerothemeplasmax11.desktop.cmake 生成，官方建议优先选择，目前更稳定、功能更全
AeroThemePlasma (Wayland)：由 aerothemeplasmawayland.desktop.cmake 生成，Wayland 支持尚未完全就绪，部分特效暂不可用

会话启动脚本 startatp.cmake 在登录时会自动完成几件"幕后"工作：

把/etc/xdg/aerothemeplasma加入XDG_CONFIG_DIRS，加载项目预置的全局配置；
通过kreadconfig6读取aerothemeplasmarc中的qmlDisableDistanceField值（默认 1）并导出为QML_DISABLE_DISTANCEFIELD环境变量——这正是后文 HiDPI 字体问题的关键；
设置PLASMA_DEFAULT_SHELL=io.gitgud.wackyideas.desktop，指定 AeroShell 桌面外壳，并启用USE_UAC_AGENT=1的 UAC 风格授权弹窗。

登录成功后，系统会进入带有 Windows 7 锁屏风格（见 screenshots/ 目录预览图）的桌面环境。

2. ootb设置向导全流程：首次运行自动配置详解

桌面加载完成后，ootb（Out Of The Box，开箱体验）设置向导会自动弹出。它由 x-atpootb.desktop 自启动项触发，在面板就绪后（X-KDE-autostart-after=panel）运行/usr/bin/atpootb。

向导共 5 个页面，界面源码位于 Main.qml，各页面说明如下：

欢迎页

"AeroThemePlasma Setup Wizard"，确认进入向导。首次运行判断依据是~/.config/aerothemeplasmarc中OOTB组的wizardRun键：未完成时为false，点击 Finish 后写入true，向导便不会再自动弹出（需要时可直接手动运行atpootb重进）。

Look and Feel 页面（应用外观）

向导会修改Plasma Style、Application Style、Color Scheme、Icon and Sound Theme、Window Effects and Animations五个方面，且这些配置同样会作用于普通 Plasma 会话，之后也可随时更改。点击 Apply 后，app.cpp 中的applyLookAndFeel()会执行：

将全局字体写入kdeglobals（Segoe UI 9pt 等）；
批量启用 AeroShell 专属 KWin 特效：aeroglassblur（Aero 玻璃模糊）、aeroglide、smodglow、smodpeekscript（Aero Peek）、libkwin_effect_smodsnap、launchfeedback、fadingpopupsaero等；
同时关闭blur、scale、slide、squash等原生动效，避免与 Windows 7 风格冲突；
依次执行plasma-apply-lookandfeel -a authui7、kvantummanager --set Windows7Aero、plasma-apply-cursortheme aero-drop等命令，应用主题、Kvantum 控件样式与光标。

SDDM 主题页面

将 SDDM 登录界面切换为 sddm-theme-mod 主题，并同步 Plasma 与 SDDM 之间的设置（光标、字体、DPI、NumLock 等）。该步骤需要管理员权限（通过 KAuth 提权）。

光标主题页面

将默认光标主题全局设置为aero-drop，确保 SDDM 登录界面也能正确识别，同样需要管理员权限。

完成页

点击 Finish 保存wizardRun标记并退出向导。完成后的桌面即呈现完整的 Windows 7 视觉效果：

3. HiDPI字体渲染问题修复：一行配置搞定

如果你在高分屏（HiDPI）下登录后发现QML 应用字体发虚、显示异常，这是已知问题。原因在于启动脚本默认导出QML_DISABLE_DISTANCEFIELD=1（禁用 QML 距离场文字渲染），该设置在 HiDPI 缩放场景下可能导致字体渲染不正常。

修复方法（完整说明见 INSTALL.md）：

编辑~/.config/aerothemeplasmarc文件；
添加以下内容（若已有其他配置请保留，勿误删）：

[General] qmlDisableDistanceField=0

重启会话（注销后重新登录），字体即可恢复正常显示。

💡 老版本用户迁移前请先阅读 INSTALL.md 的 Migration notice：运行 migration-uninstall.sh 清理旧组件，并删除旧版写入/etc/environment的QML_DISABLE_DISTANCEFIELD=1行。

4. 可选进阶：自定义 SDDM 登录界面

SDDM 主题支持在 theme.conf 中配置：

选项	作用
`background`	登录界面背景壁纸
`branding`	品牌 Logo
`forceUserSelect`	是否始终显示用户选择页
`enableStartup`	开机首次是否播放 Vista 风格启动动画
`playSound`	开机是否播放启动声音