先记下配置目录和日志位置——DSH Desktop 排查能省一半时间

一出问题就到处翻文件，往往是因为平时没有把 DSH Desktop 的配置、数据和日志位置固定下来。先记下这三个路径，再把几条查看日志的命令练熟，排查时就能从“反复重启和猜”切换到按目录找线索、按日志定位原因。适用场景是桌面端 DSH Desktop 出现启动失败、连接异常或配置不生效；边界是路径随安装方式变化，以本机实际找到的为准，不要直接删除数据目录。

在 DSH Desktop 正常运行时，先把配置目录、数据目录、日志目录三条路径记到笔记里；出问题后先看日志尾部，不要急着重启。日志里的时间戳和报错前后文通常能区分连接、配置或启动失败三类线索，再对应到端口、配置文件、权限或依赖的检查动作。路径随安装方式变化，以本机为准；日志和配置可能含敏感信息，复制前先脱敏。

三类目录分别放什么

DSH Desktop 在运行时会读写三类位置，它们出问题时的症状不一样，先分清再找，能少走弯路。

配置目录：存放用户设置、连接参数、界面偏好等。典型症状是启动后设置被重置、配置不生效、界面提示配置格式错误或缺少字段。排查时优先看这个目录下的主配置文件，确认最近是否改过或升级后格式不兼容。
数据目录：存放会话、缓存、索引、本地数据库等。典型症状是历史记录打不开、列表为空、数据不一致、程序卡在加载界面。不要一看到数据异常就删目录，先备份再判断是否索引损坏。
日志目录：存放运行日志、错误日志，有时按日期分文件。典型症状是程序闪退、卡住、弹窗报错，但界面没有给出可操作信息。日志通常是最直接的线索来源。

验证方式：在 DSH Desktop 正常时，打开设置页或关于页，看是否显示“配置目录”“数据目录”“日志目录”的路径；如果没有，再用下一节的命令在文件系统里找。风险边界：配置目录和数据目录不要直接整体删除，否则可能丢设置或本地数据。

在系统里把这三个位置定位出来

不同安装方式（安装包、便携版、包管理器）会把文件放在不同位置，所以“大概在用户目录下”不够，需要在本机确认。通用思路是先看用户配置区和应用数据区，再看安装目录和系统日志区。

Windows

优先看 %APPDATA%、%LOCALAPPDATA% 和 %PROGRAMDATA%，安装目录也可能有 logs 或 config 子目录。可以用 PowerShell 找：

Get-ChildItem $env:APPDATA,$env:LOCALAPPDATA -Directory | Where-Object Name -like '*DSH*'
Get-ChildItem $env:LOCALAPPDATA -Recurse -Filter *.log -ErrorAction SilentlyContinue | Where-Object FullName -like '*DSH*'
Get-ChildItem 'C:\Program Files','C:\Program Files (x86)' -Directory -ErrorAction SilentlyContinue | Where-Object Name -like '*DSH*'

如果便携版，直接看 DSH Desktop 可执行文件旁边的 config、data、logs 目录。验证：找到后把路径复制到记事本，确认目录里确实有配置文件或 .log 文件。

macOS

常见位置是 ~/Library/Application Support/DSH Desktop、~/Library/Logs/DSH Desktop，以及 /Applications 下的应用包。可以终端执行：

ls -la ~/Library/Application\ Support | grep -i dsh
ls -la ~/Library/Logs | grep -i dsh
find ~/Library -maxdepth 4 -iname '*dsh*' 2>/dev/null

应用包内也可能有 Resources 或 Frameworks 目录存放默认配置。注意不要直接改应用包内文件，改用户目录下的配置更安全。

Linux

常见位置是 ~/.config/dsh-desktop、~/.local/share/dsh-desktop、~/.cache/dsh-desktop，系统级可能在 /etc 或 /var/log。可以执行：

ls -la ~/.config ~/.local/share ~/.cache 2>/dev/null | grep -i dsh
find ~ -maxdepth 4 -iname '*dsh*' 2>/dev/null
ls -la /var/log | grep -i dsh

如果 DSH Desktop 以服务方式运行，日志可能交给 systemd，用 journalctl -u dsh-desktop 查看。路径随安装方式变化，以本机实际找到的为准。验证：用 ls 确认目录里存在配置文件或日志文件，而不是空目录。

用几条命令看日志尾部并读出线索

找到日志文件后，不要从头读。先看末尾，再按关键词过滤，最后看报错前后文。日志行开头通常有时间戳，先定位最早出现的错误时间，再看该时间附近发生了什么。

# Linux / macOS 通用
tail -n 100 ~/.local/share/dsh-desktop/logs/app.log
grep -iE 'error|fail|exception|timeout|refused' ~/.local/share/dsh-desktop/logs/app.log
grep -n -iE 'error|fail|exception' ~/.local/share/dsh-desktop/logs/app.log | tail -n 5
# 假设上一步找到第 120 行有报错，看前后 20 行
sed -n '100,140p' ~/.local/share/dsh-desktop/logs/app.log
# 实时跟踪新日志
tail -f ~/.local/share/dsh-desktop/logs/app.log

Windows PowerShell 类似：

Get-Content (Join-Path $env:LOCALAPPDATA 'DSH Desktop\logs\app.log') -Tail 100
Select-String -Path (Join-Path $env:LOCALAPPDATA 'DSH Desktop\logs\app.log') -Pattern 'error|fail|exception|timeout' -CaseSensitive:$false
Get-Content (Join-Path $env:LOCALAPPDATA 'DSH Desktop\logs\app.log') | Select-Object -Skip 100 -First 40

时间戳与前后文的关系：报错行往往只是最终表现，真正原因可能在前几行的“连接超时”“配置解析失败”或“权限不足”。验证方式：先记下报错时间，重启 DSH Desktop，再看同一时间附近是否出现同样内容；如果复现，说明线索稳定。风险边界：tail -f 只用于观察，不要长时间挂着忘记关。

把日志线索对应到可执行动作

看完日志如果仍然不知道下一步做什么，可以按线索类型分成三类处理。

连接类线索（connection refused、timeout、resolve、certificate）：检查目标地址和端口是否可达。Linux/macOS 可用 nc -vz host port 或 curl -v；Windows 可用 Test-NetConnection host -Port port。然后回到配置目录，核对地址、端口、协议和网络中间层设置。验证：从同一台机器用其他工具能否连通同一目标。风险边界：不要为了绕过问题长期关闭防火墙或降低证书校验。
配置类线索（invalid config、parse error、unknown field、missing key）：先备份配置文件，再与默认配置对比，逐项恢复最近改过的字段。检查 DSH Desktop 升级后配置格式是否变化。验证：改回后重启，看日志是否还报同样解析错误。风险边界：不要直接删除整个配置目录，否则会丢失设置。
启动失败类线索（permission denied、port already in use、disk full、dependency missing）：检查端口占用用 lsof -i :端口或 netstat -ano | findstr :端口；检查磁盘用 df -h；检查权限用 ls -l；检查依赖是否安装。验证：释放端口或修复权限后重启，看启动日志第一屏是否还报同一错误。风险边界：不要用 kill -9 杀未知进程，先确认进程归属。

下次出问题时最先要准备的三条信息

无论是自查还是向他人求助，准备好这三条信息能减少来回确认。收集方式都不复杂，平时可以留个模板。

应用版本：在 DSH Desktop 界面“关于”或“帮助”里找版本号；如果支持命令行，执行 dsh-desktop `--version` 或查看安装包名称。也留意日志开头是否打印版本。验证：版本号与安装来源一致。
出错时间点的日志片段：记录本地时间，用 tail -n 200 日志文件，或 grep -C 50 'error' 日志文件截取报错前后几十行，保存为文本。验证：片段里包含时间戳和完整堆栈或错误码。风险边界：粘贴前删掉令牌、密码、本机用户名等敏感信息。
当前配置的关键项：从配置目录找到主配置文件，复制监听地址、端口、数据目录、日志级别等字段；不要直接发完整文件，先手动脱敏。验证：确认这些字段与你在界面里设置的一致。如果配置项很多，只保留最近改过或与报错相关的几项。

把这三条信息加三个目录路径放在同一个笔记里，下次 DSH Desktop 出问题时，先按日志尾部找线索，再对应到连接、配置或启动失败动作，通常比反复重启更快定位。