DEsk 是一款写实拟物风格的 Linux Wayland 桌面环境：桌面是一张胡桃木书桌，窗口是纸，dock 是抽屉。它的核心配置文件shell.conf支持手动编辑，保存后一秒钟内热加载生效。本教程带你在 3 步内完成 DEsk 自定义：切换界面语言、调整画质档位（Graphics）、指定抽屉里的标准程序，无需重新编译。

先认识 DEsk 桌面

DEsk 的图形界面是光线追踪的"房间"，由一盏台灯照亮。画质越高，房间细节越精细——这正是我们要用shell.conf的graphics项来调节的部分。

shell.conf 文件位置与基本格式

shell.conf每行一条key = value，#开头是注释。官方参考见 docs/CONFIGURATION.md。

三个要点：

• 用户文件优先：安装器会把机器检测到的画质档位写入系统文件，你在用户文件里写的值会覆盖它。
• 热加载：DEsk 在一秒内读取你改动的shell.conf，语言等设置即时切换，无需注销。
• 容错：写错的 key 或值会记录到日志~/.local/state/desk/session.log并被忽略，不会损坏文件。

也可以用图形界面Shell Settings（抽屉里的那把螺丝刀）替你改shell.conf：

第一步：修改界面语言

DEsk 支持 7 种语言加自动跟随。在shell.conf中加入一行：

language = zh

zh使用专门排版的 CJK 字体切面。注意语言不仅影响 DEsk 自己的文字，书架上程序的归类名称也会跟着变：

语言解析逻辑在 src/wm.c 的language键读取处（约 L10110），翻译表在 src/i18n.c。

第二步：选择画质档位

graphics决定"画多少东西"，共 5 档：

graphics = medium

两个实用技巧：

• 安装时指定档位：sudo DESK_GRAPHICS=low sh scripts/install_debian.sh，安装器会把该档位作为机器默认写入/etc/xdg/desk/shell.conf（其他发行版脚本同理）。
• 自动检测：安装器会运行desk-index --suggest测量 GPU/处理器，自动挑选合适档位；屏幕只能由 CPU 绘制时则自动落到2d，并在信箱里放一封提示信。

老机器参考：按约 2010 年笔记本性能测试，low档下折叠一张"纸"仅约 5 ms/帧，登录后不到半秒显示桌面。

第三步：指定抽屉里的标准程序

抽屉（dock）出厂自带 4 个"标准程序"：终端、浏览器、文件管理器、文本编辑器。它们按以下顺序确定：

1. shell.conf的app.*键（最高优先，用户可改）
2. 系统默认应用列表（~/.config/desk-mimeapps.list、mimeapps.list等）
3. DEsk 内置首选：Xfce Terminal、Firefox ESR、Thunar、Mousepad 等经典 GTK 程序
4. 归类正确的任意程序

想固定用某款程序，写入它的.desktopid：

app.terminal = xfce4-terminal.desktop app.browser = firefox.desktop app.files = thunar.desktop app.editor = mousepad.desktop

改完后拉开抽屉，对应位置就是新程序，Super+Enter等快捷键也随之生效：

抽屉里那把螺丝刀则始终打开 Shell Settings。选程序的完整规则见 docs/MODDING.md 与 src/apps.c。

验证改动与快速重置

• 保存shell.conf后一秒钟内生效，观察桌面文字或画质变化即可确认。
• 有异常时查看~/.local/state/desk/session.log，错误的行会被记在那里。
• 想全部还原默认：删除~/.config/desk/目录（注意这也会清掉其他设置）。

更多设置键（scale缩放、motion动画速度、sound声音、clock24 小时制等）都在 docs/CONFIGURATION.md 中按表格列出了全部取值与默认值，值得常备查阅。