DEsk是一款拟物风格的 Linux Wayland 桌面环境（窗口是桌面上的纸张，Dock 是抽屉）。当 DEsk 安装失败、启动缓慢或出现崩溃时，使用自带工具desk-report一条命令即可生成包含版本、显卡、日志的完整问题报告，快速获得社区支持。本文介绍 desk-report 的完整用法、报告内容与社区反馈渠道。

什么是 desk-report

DEsk 为问题排查专门提供了一个报告工具：scripts/desk-report。它的作用可以概括为一句话：

DEsk 不工作时，把这一个文件发出去就够了。

它的几个特点是新手最关心的：

• ✅无需 DEsk 正在运行：在任何桌面环境或 TTY 控制台里都能跑，哪怕 DEsk 根本没启动；
• ✅自动脱敏：用户名、主目录、机器名、IP 地址、MAC 地址、邮箱、序列号都会在写入前被替换为<user>、<address>等占位符；
• ✅内容全面：DEsk 版本、Linux 发行版、显卡与驱动、显示器与桌面类型、配置、崩溃记录（coredumpctl）、最近两次会话日志、最近一次安装日志，全部自动收集。

desk-report 快速上手：一条命令生成报告

在终端中执行：

desk-report

成功后终端会提示：

Written: ~/desk-report.txt (xxx lines). Please read it through, then attach it to your GitHub issue or Discord message:

生成的报告保存在~/desk-report.txt。发送前请务必通读一遍（官方也这么建议），然后把它作为附件提交到项目的 Issues 页面，或粘贴到社区消息中。

💡 小技巧：如果不想落盘、只想在终端里直接查看，可以用--print参数：

desk-report --print

报告里都有什么：各分区逐项解读

打开~/desk-report.txt，你会看到由=====分隔的多个分区，对照下面这张表即可快速理解每一部分：

其中日志类文件的实际位置是：

• 会话日志：~/.local/state/desk/session.log（上一次在session.log.old）
• 安装日志：~/.local/state/desk/install.log

如果 DEsk 启动很慢，日志中形如desk: room:的行记录了房间在不同硬件上光线追踪的耗时，是排查"首次登录慢"的关键线索。

没有 desk-report 时：手动附带日志

如果 DEsk 版本较旧或根本没有安装成功，可以手动收集以下纯文本文件，发送前同样先自行检查一遍：

1. ~/.local/state/desk/session.log—— DEsk 本次会话的输出；
2. ~/.local/state/desk/session.log.old—— 上一次会话的输出（问题发生在上次登录时带上它）；
3. 安装中断时：终端里的最后几行输出，或~/.local/state/desk/install.log（通过install_session.sh安装时）。

桌面卡住时：desk-ctl 先自救再报告

在等待或提交报告之前，可以先尝试自救。DEsk 自带控制工具 scripts/desk-ctl：

desk-ctl reset # 相当于连按两次 Ctrl+Alt+Del：重新绘制整个桌面 desk-ctl logout # 相当于按三次 Ctrl+Alt+Del：先询问窗口关闭再退出 desk-ctl logout --now # 立即结束会话（未保存内容会丢失）

• 在桌面上卡住时，可在桌面终端直接运行；
• 桌面完全无响应时，切到另一个虚拟终端（Ctrl+Alt+F3，用同一用户登录）再执行；
• reset不会关闭你的窗口，锁定的桌面也保持锁定状态。

写好一份有效的问题报告

工具收集完信息后，还需要你补充两句话，社区排查效率会高很多：

1. 你做了什么（操作步骤、按了什么键、跑过什么命令）；
2. 发生了什么（实际现象 vs 期望行为）。

同时确认你的环境是否在已知支持范围内：Debian 13、Ubuntu 24.04 / 26.04、Arch、Fedora 43 / 44。已知限制（如 layer-shell 协议未支持、HiDPI 缩放手柄等）整理在 RELEASE-NOTES.md 的 "Known limitations" 一节，提交前先看一下可以避免重复报告。

社区支持渠道：Issues 与 Discord

报告文件准备好后，有两个官方渠道：

几个小建议：

• 📎 把desk-report.txt作为附件上传，而不是截图终端；
• 🔄 提交前在 Issues 列表里搜索关键词，可能已有相同问题或修复版本；
• ⚙️ 显卡或显示相关的疑问，可结合 Shell Settings（desk-settings）中 Graphics 一行的提示，以及 docs/CONFIGURATION.md 中对应配置项说明。

总结

掌握 desk-report 的使用，你就完成了 DEsk 问题反馈的一半——另一半是清晰的描述。祝你用得顺利！