DSH Desktop 快速上手指南：装完 3 分钟就能用的桌面 AI 智能体客户端
【免费下载链接】deepseek-harness-desktop为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop
DSH Desktop 是 Windows 和 macOS 上的 DeepSeek Harness（DSH）开源桌面客户端。你可以把它理解为 Harness 的"桌面快捷方式"：不用装 Node.js、不用敲终端命令，装完安装包，就能得到一个能对话、能跑任务的桌面 AI 智能体客户端。
为什么需要它
如果你在终端里跑过官方 DeepSeek Harness，多半经历过这样的首次启动：先装 Node.js，再固定 pnpm 依赖，然后配 profile，最后还要想怎么让服务进程一直活着。每一步对开发者都正常，对普通用户却偏重。DSH Desktop 解决的就是这一段：agent、模型、工具、会话等核心能力仍由官方 Harness 提供，Desktop 只负责把环境和进程管起来，且不改上游源码。
| 环节 | 没有 DSH Desktop | 有 DSH Desktop |
|---|---|---|
| 环境准备 | 自己装 Node.js、pnpm 并固定版本 | 运行时与固定版本依赖全部内置在安装包 |
| 首次启动 | 终端敲安装命令，自己处理端口 | 自动启动本地服务，首次走设置向导 |
| 日常管理 | 进程是黑盒，没有窗口和托盘 | 窗口 + 系统托盘，一键导出诊断、自动检查更新 |
设计动机详见 docs/why-desktop.md。
从下载到用起来
从下载到开始第一次对话，只需要三步：下载、安装、跟着向导走。全程不碰命令行。
| 平台 | 包形态 | 安装方式 |
|---|---|---|
| Windows x64 | NSIS 安装程序 | 运行安装器，按提示完成 |
| macOS Universal（Intel / Apple Silicon） | DMG | 把 DSH Desktop 拖入 Applications |
📦 说明：安装包明显比一般应用"大"，是因为运行时和固定版本依赖都包含在内，换取的是确定的首次启动体验。Desktop 也不会修改系统 PATH 或 shell 配置。
首次启动时，每个未初始化的 profile 会先显示原生Setup Wizard：窗口模式与材质、插件市场、通知、是否用系统浏览器自动打开、Web 访问范围（默认仅本机），全部可跳过。向导结束前，本地服务和主窗口都不会启动。
向导完成后就是主界面：
左侧是工作区和会话列表，底部直达插件市场与设置入口。
💡 提示：关闭窗口不是退出，只是把窗口藏进系统托盘。右键托盘图标选择退出，应用才真正结束。
⚠️ 警告：局域网访问选项不带鉴权，开启后同一网络的人能直接打开 DSH 操作你的电脑，只在完全信任的网络里开。
它能帮你做什么
装好之后，DSH Desktop 具体帮你干什么？下面四个场景最常用。
DSH Desktop 日常对话：选个模型直接提问
主界面底部的输入区就是日常入口：选择模型与访问权限，发出问题即得回复。整个对话界面由官方 Harness 的 Web UI 提供，Desktop 负责把它托管进原生窗口。适合只想"装上就能聊"的人。
跑长任务：工具调用与自动恢复
让代码分析、文件操作这类任务跑上半天时，你担心的是进程别挂。长任务的工具与会话机制来自官方 Harness，Desktop 补上的是进程生命周期：本地服务自动拉起，启动失败会进入恢复助手，可管理插件、回滚、切换配置，当前版本不会被破坏。适合需要"把任务丢给它跑"的人。
切换配置：托盘菜单管理多套 profile
想工作环境和测试环境分开？关键在 profile。一个 profile 是一组 DSH bundle、依赖和 patch 的组合，相当于多套独立工作环境：
| 操作 | 在哪里 | 行为 |
|---|---|---|
| 切换 profile | 托盘 → Profile 菜单 | 选中后应用有序重启生效 |
| 启动失败 | 自动 | 回退到上一次可用 profile，可进恢复助手 |
| 切换后装插件 | DSH 终端 | 不会从旧 profile 自动复制，对目标 profile 操作 |
适合"多套配置来回切"的开发者。
诊断与更新：一键出诊断包，更新不偷偷装
遇到问题时，右键托盘选导出诊断信息…，会生成诊断 zip 包，报告问题时附上即可。应用会在后台检查新版本，绝不静默安装：确认后才下载，下载前你可以选安装包的保存位置；macOS 打开 DMG 拖入替换，Windows 启动 NSIS 安装器，升级完成还会问你是否删除安装包释放空间。
扩展与自定义
桌面壳本身也是插件——这是项目的核心设计理念，第三方插件与桌面壳按同一套机制组合。DSH Desktop 用的是官方 Harness 插件体系，官方插件可直接安装；内置插件市场提供插件发现、详情、安装与管理，产品细节见 插件市场说明。
常用入口有两个：主界面左下角的插件市场，以及从托盘打开的DSH Terminal（自带固定版本 pnpm 环境，不碰全局 PATH）。只有走终端装/卸插件时才需要这两条命令：
dsh plugin add <plugin> dsh plugin remove <plugin>插件变更后必须重启 DSH Desktop 才生效，命令要在托盘打开的终端里执行，系统终端里找不到dsh命令。想自己写插件，先读 插件开发文档。
常见问题与排错速查
新手问得最多的几个问题，直接过一遍：
Q：需要先装 Node.js 或 pnpm 吗？不用。安装包已包含 Electron、Node.js、pnpm 和固定版本的 DSH 依赖，装完就能启动。
Q：这是 DeepSeek 官方产品吗？不是。DSH Desktop 是社区独立维护的开源项目，与深度求索不存在隶属、合作、授权或背书关系，名字仅说明它与官方 DeepSeek Harness 的技术关系。
Q：窗口找不到了？先看系统托盘。关闭窗口通常只是隐藏，应用还在运行。
Q：插件装完没出现？确认两点：命令是否作用于目标 profile，以及是否重启了应用。
Q：更新没有提示？后台检查失败会保持静默，用托盘里的 Check for Updates… 手动检查看结果。
Q：数据存在哪里？Desktop Host、profile 和 DSH home 都在本机；是否向外部发送内容取决于你配置的模型提供商，详见 隐私说明。
下一步
到这里，你应该已经能完成桌面端的第一次对话了。接下来去 文档索引 找 用户指南 和 常见问题 深入使用，或直接加入社区参与插件生态共建；开发者若要从源码运行，先克隆仓库（外层仓库用 Yarn）：
git clone https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop📦 说明：项目以 MIT 协议发布，完全开源免费，如果有人以任何形式出售此软件，请直接拒绝交易。本项目是社区独立项目，非 DeepSeek 官方产品。
【免费下载链接】deepseek-harness-desktop为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考