帮助中心

DSH Desktop 常见问题

这里集中回答下载、安装、API Key、数据目录、插件市场、系统兼容性和项目关系等问题。

DSH Desktop 支持哪些平台?

当前提供 macOS Apple Silicon 与 Windows x64 正式安装包。Linux x64 提供 AppImage,处于测试邀请阶段(见 Issue #19);macOS Intel 可以从源码运行,需要 Node.js 24+。

如何配置模型 API Key?

打开应用后进入 DSH 设置,粘贴模型服务提供的 API Key。密钥由本地 DSH 设置管理,不会上传到本站。

我的数据保存在哪里?

Profile、Session 与本地运行数据默认保存在 ~/.dsh,也可以通过 DSH_DATA_ROOT 修改。

DSH Desktop 会覆盖我已有的 Profile 吗?

不会。应用启动对已有 Profile 只读,不会因为启动或更新重写你的配置;只有创建新 Profile 时才会使用安装包中的固定产物初始化。

怎么安装更多 DSH 插件?

在应用的设置中打开插件市场,查看来源、版本、兼容性与权限后安装。也可以使用官方 CLI 操作同一个 Profile。默认 Bundle 清单可以在插件生态页面查看。

应用内更新失败怎么办(v0.2.4 及更早的 macOS 版本)?

这是已知问题:v0.2.4 及更早的 macOS 安装包缺少更新配置文件,点击标题栏更新按钮后无法完成下载。请从 下载页 手动下载安装一次最新版,之后的自动更新即可恢复正常。Windows 版本不受影响。

DSH Desktop 与 DeepSeek 是什么关系?

DSH Desktop 是基于 DeepSeek Harness 与 Cordis 插件体系构建的独立社区项目,与深度求索不存在隶属、合作、授权或背书关系。项目代码以 MIT 许可发布。

DSH Desktop 与官方桌面端是什么关系?

官方桌面端(@deepseek-ai/dsh-desktop)是 DeepSeek Harness 仓库内的官方 Electron 壳,与 DSH 运行时同版本锁定、使用独立的 profiles/desktop,截至本文写作尚未公开发布安装包。DSH Desktop 是独立的社区发行版:今天即可下载安装,预装固定版本并通过验证的插件组合,并提供可管理的插件市场。两者使用不同的 Profile 目录,安装在同一台机器上互不干扰;本项目也在跟进官方壳的演进。

macOS 提示无法验证开发者怎么办?

先确认下载来源是本站链接的 GitHub Release。若仍有提示,在 Applications 中右键应用选择“打开”,或到“系统设置 → 隐私与安全性”允许打开。

Windows SmartScreen 拦截怎么办?

先确认文件来自 GitHub Release 且文件名正确。若 SmartScreen 仍提示“Windows 已保护你的电脑”,点击“更多信息”,再选择“仍要运行”。

GitHub 下载很慢怎么办?

在 GitHub Release 页面复制资产直链,使用下载工具完成下载。下载后请核对发布页的文件名和校验信息,不要使用来源不明的安装包。

可以使用自己的插件吗?

符合官方 DSH Bundle 与 dshClient 合同的插件通常不需要为 DSH Desktop 重写;需要窗口、原生文件对话框或 Browser Workspace 的插件,则要显式使用对应的窄 Host 合同。