GUIDE / 安装指南
DeepSeek Harness 桌面版安装指南
DSH Desktop 的目标是让你不用先配置 Node.js、npm 或终端，就能直接打开 DeepSeek Harness 的本地 Agent 工作台。
三步开始使用
- 下载：前往下载页，选择 Windows、macOS 或 Linux 安装包。
- 安装：运行安装包并启动 dsh-desktop。应用会自动启动自己的本地 Harness 实例。
- 配置：在 Harness 设置中选择模型服务商，粘贴 API Key，然后创建第一个会话。
各平台首次启动
Windows
运行 NSIS 安装程序即可。如果 Windows SmartScreen 显示“Windows 已保护你的电脑”，确认下载来源后点击“更多信息 → 仍要运行”。
macOS Apple Silicon
打开 DMG，将应用拖入 Applications。首次启动如提示无法验证开发者，请在 Finder 中右键应用，选择“打开”，再确认一次。
Linux amd64
双击 Debian 包，或使用系统软件中心安装。安装后从应用菜单启动 dsh-desktop。
配置 DeepSeek API Key
登录 DeepSeek 开放平台，进入 API Keys 创建密钥。回到 dsh-desktop，在模型或服务商设置中粘贴密钥。API 按用量计费，使用前请确认账户余额和平台价格。
桌面版和命令行数据是否共享？
默认不共享。桌面版使用独立的 ~/.dsh-desktop 数据目录，不会覆盖命令行使用的 ~/.dsh。如果你确实要共享配置，可以在启动前设置 DSH_HOME=~/.dsh，但建议先备份数据。
启动失败怎么办？
先确认安装包完整、磁盘可写，并检查系统是否拦截了本地进程或 loopback 连接。应用的帮助菜单可以导出诊断报告；提交问题时请同时提供版本号、平台和相关日志。更多首次启动问题见常见问题。