DSH Desktop 常见问题

官方提供的是命令行 WebUI（npx @deepseek-ai/dsh web）。DSH Desktop 是社区维护的桌面客户端形态：同一个 WebUI，加上免装 Node.js、托盘常驻、崩溃自愈、快捷键唤起和自动更新，下载安装即用。

不是。它是社区维护的桌面封装项目，与 DeepSeek AI 没有隶属、授权或合作关系。DeepSeek Harness 及其依赖遵循各自的上游许可和商标政策。

发布版内置锁定的 Node.js 运行时和 Harness 依赖，普通用户不需要另行安装 Node.js，也不需要先运行 npx @deepseek-ai/dsh web。

默认不会。桌面版使用 ~/.dsh-desktop，命令行通常使用 ~/.dsh。如果需要共享，可以设置 DSH_HOME=~/.dsh，建议先备份。

当前 macOS 构建可能未经过 Apple 公证。确认安装包来自公开 Release 后，在 Finder 中右键应用选择“打开”。不要从不明来源下载或执行来路不明的终端命令。

当前 Windows 安装包尚未做代码签名。确认来源和校验值后，点击“更多信息 → 仍要运行”。如果不确定文件来源，请停止安装并在 GitHub 仓库提交问题。

不会。插件市场和社区插件都不打进发布包，必须由你在设置中手动安装；安装前请确认第三方仓库来源，因为安装过程可能下载并运行社区代码及安装脚本。

「设置 → 桌面设置」会展示准备、下载、验证和重启阶段，并区分网络、代理、超时、数据目录、安装脚本和随包工具故障。可展开脱敏技术详情或导出诊断，修复对应问题后直接重试；失败不会被误标为已安装，成功后会显示实际版本。

打开「设置 → 桌面设置 → 运行体检」。默认只读检查随包运行时、数据目录和磁盘、Harness loopback、Profile、插件和版本，不联网、不上传、不自动修复。需要判断代理、registry 或更新源时，再单独勾选联网检查；每项会显示正常、警告或失败及对应动作。

错误页提供「再次启动」「以安全模式启动」「打开日志目录」「导出诊断报告」；检测到可疑插件时还会逐个列出，可直接「升级」到最新版或「禁用」后重启——禁用只从启动列表移除，不删除文件，可随时在「设置 → 插件」恢复。安全模式只保留官方与内置扩展，并隔离用户插件，作为兜底恢复路径。

当前提供 amd64 Debian 包，面向 Debian、Ubuntu、UOS、Deepin 和麒麟等系统。不同发行版的系统依赖可能不同，建议优先使用系统软件中心安装。

每个安装包都附带同名 .sha256 文件。macOS/Linux 使用 shasum -a 256 -c 文件名.sha256，Windows 使用 CertUtil -hashfile 文件名 SHA256，再与 Release 中的校验文件比较。

可以打开下载页中的 GitCode 镜像入口。镜像状态会随发布同步变化；如果镜像没有对应文件，请回到 GitHub Release 页面。

在 DeepSeek 开放平台注册并进入 API Keys 页面创建密钥，然后在 dsh-desktop 的模型设置中粘贴。API 使用按量计费，请先确认账户余额。

在任意应用中按 Ctrl/Cmd + Shift + Space（Windows/Linux 用 Ctrl，macOS 用 ⌘），dsh-desktop 会显示并获得焦点。若快捷键被占用，可使用系统托盘或窗口右键菜单；快捷键冲突不会影响 Harness 启动。

可以。在 dsh-desktop 的「设置 → 桌面设置」中点击「重新设置」，按下包含修饰键的组合键，例如 Ctrl + Alt + K。如果组合键被占用，会提示换一个。开机启动默认关闭；Windows/macOS 还可以选择启动后隐藏到托盘，Linux 当前不提供该开关。

不会。通知只使用 Harness 已公开的会话运行态和后台任务状态，不读取截图、不做视觉识别，也不会上传数据。窗口未聚焦时，通知会提示完成、失败或需要确认，并可在「设置 → 桌面设置」关闭。

可以。桌面版自带垃圾桶：删除的会话、预设都会先进入垃圾桶，在 Harness「设置 → 垃圾桶」中随时还原。Agent 执行的删除类命令也会被拦截：目标先移入垃圾桶，可疑的删除会被直接拦截并说明原因。垃圾桶保留 30 天，过期自动清理。