DSH Desktop完全指南：把DeepSeek Harness变成一键安装、开箱即用的桌面AI智能体客户端

DSH Desktop完全指南：把DeepSeek Harness变成一键安装、开箱即用的桌面AI智能体客户端

【免费下载链接】deepseek-harness-desktop为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop

DSH Desktop 是一个开源免费的 DeepSeek Harness 桌面客户端，支持 Windows 和 macOS 一键安装、开箱即用。它把官方 DeepSeek Harness 的本地 Web UI、Host 服务和插件系统集成到原生桌面应用中：不用装 Node.js、不用敲命令，下载安装包就能获得一个可对话、可跑任务的桌面 AI 智能体客户端，还能自由安装 DSH 插件扩展能力。

DSH Desktop 是什么？

一句话理解：DSH Desktop 就是 DeepSeek Harness 的"桌面快捷方式"。

DeepSeek Harness（DSH）本身是命令行 + Web UI 形态的 agent harness，能力很强，但第一次运行要面对 Node.js、profile、依赖安装、端口和进程管理等一系列环境配置。DSH Desktop 的目标不是重写 Harness，而是：

它坚持"万物皆插件"的理念：从核心 agent 到桌面外壳都遵守同一条规则，模型、工具、界面、工作流都可以做成插件，像搭积木一样组合。详细的设计动机可以阅读 docs/why-desktop.md 与 docs/architecture.md。

一键安装步骤：无需任何环境配置

DSH Desktop 支持Windows x64与macOS Universal（Intel 和 Apple Silicon 通吃），当前没有 Linux 安装包。

💡 安装包比一般项目"大"一些，是因为运行时和固定版本依赖已包含在内，换取的是确定的首次启动体验——普通用户不需要另行安装 Node.js、pnpm 或 DSH，Desktop 也不会修改你的系统 PATH 或 shell 配置。

安装方式非常简单：

Windows 安装器还针对"运行中升级、同版本覆盖安装"等场景做了严格的回归验证，避免升级被安装目录内的辅助进程误拦截：

如果希望通过源码运行开发版本，也可以克隆仓库后执行（外层仓库使用 Yarn，固定的上游子模块使用 pnpm）：

git clone https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop cd deepseek-harness-desktop git submodule update --init --recursive corepack yarn install --immutable corepack yarn dev

首次启动体验：向导引导 + 原生主界面

首次启动时，每个尚未初始化的 profile 会先显示 DSH Desktop 自有的原生Setup Wizard（设置向导），可以配置：

• 窗口模式与系统材质
• 插件市场
• 通知
• 是否用系统默认浏览器自动打开
• Web 访问范围（默认仅本机回环地址，局域网访问是独立可选设置）

向导完成或跳过之前，Host 和主窗口都不会启动，整个过程不侵入官方页面。完成设置后，你将看到这样的主界面：

左侧是工作区与会话列表，底部可以直接进入插件市场和设置；中间是与 AI 智能体对话的输入区，可自由选择模型与访问权限：

几个新手容易踩的"坑"，提前知道更安心：

• 关闭窗口 ≠ 退出：通常只是隐藏窗口，应用还在系统托盘里运行，右键托盘图标选择退出才会结束。
• 数据都在本地：Desktop Host、profile 和 DSH home 都位于本机；是否向外部服务发送内容取决于你配置的模型提供商，详见 PRIVACY.zh.md。
• 局域网访问请谨慎：向局域网开放不提供鉴权，同一网络的人都能直接打开 DSH 操作你的电脑，只在完全信任的网络中开启。

核心功能清单：桌面AI智能体客户端能做什么

插件市场是其中的亮点：它从用户选择的目录来源发现插件，针对当前 Profile 执行安装；无论从市场、其他市场还是 DSH CLI 安装的插件，都会在"已安装"视图统一管理。更多产品行为见 dsh-community-market/README.zh.md。

插件安装与管理：像搭积木一样扩展

DSH Desktop 使用的是官方 Harness 的插件体系，官方插件可以直接安装。两个常用入口：

1. 插件市场：主界面左下角进入，浏览、搜索、筛选，一键安装（自动安装会严格校验 npm package 身份，不信任来源提供的版本）。
2. DSH 终端：从托盘打开终端后执行官方 CLI 命令，命令默认作用于当前激活的 profile：

dsh plugin add <plugin> dsh plugin remove <plugin> dsh plugin update

⚠️ 注意两点：插件变更后需要重启 DSH Desktop才能生效；切换 profile 不会自动复制旧 profile 的插件。想自己写插件？桌面壳与第三方插件使用同一套组合机制，Desktop 还提供受控的桌面服务接口（如查看切换工作配置、安装更新移除插件），完整文档见 docs/plugin-development.md 和 dsh-plugin-desktop/docs/plugin-services.zh.md，源码位于 dsh-plugin-desktop/ 目录。

如何更新：安全可控的升级流程

打包后的应用会在后台检查新版本，但绝不静默安装：

1. 发现新版本 → 更新托盘，每个版本只发一次非阻塞系统通知
2. 托盘选择Check for Updates…可手动检查
3. 确认下载后，先打开原生"保存更新安装包"对话框，你可以选目录和文件名，取消则不下载
4. macOS 打开 DMG 拖入 Applications；Windows 准备 NSIS 安装器并询问是否退出安装
5. 升级完成重启后，应用会询问是否删除安装包释放磁盘空间

升级与覆盖安装同样有可审计的验证证据链，失败不会破坏当前版本，托盘可随时重试：

新手常见问题速查

• 需要装 Node.js / pnpm 吗？不需要，安装包已全部内置。
• 这是 DeepSeek 官方产品吗？不是。DSH Desktop 是社区独立维护的开源项目，与深度求索不存在隶属、合作、授权或背书关系。
• 窗口消失了？先检查系统托盘，关闭窗口不是退出。
• 插件没有出现？确认命令作用于目标 profile，并重启应用。
• 更新没有提示？后台错误会静默，用托盘手动检查查看结果。

完整问答见 docs/faq.md，安装与日常使用的全部细节见 docs/user-guide.md。遇到问题时，可从托盘导出诊断信息，或按 docs/user-guide.md 的排查章节处理。

加入社区，一起共建插件生态

DSH 的插件生态由社区共同建设：上游插件、DSH Desktop 插件和其他社区插件遵循统一约定，通过相同的组合机制协作。项目发布了 docs/plugin-ecosystem.md 倡议书，并建立了统一插件 contract 讨论（dsh-community-fabric/）与插件市场产品（dsh-community-market/）。

欢迎扫码加入 QQ 群交流使用问题、插件开发与项目进展：

📦 本项目遵循 LICENSE（MIT）完全开源免费。如果有人以任何形式向你出售此软件，请直接拒绝交易。

写在最后

DSH Desktop 把 DeepSeek Harness 从"命令行工具"变成了"点两下就能用的桌面 AI 智能体客户端"：一键安装、开箱即用、插件自由组合。无论你是只想快速上手的普通用户，还是想给 DSH 添加新能力的开发者，它都提供了清晰的入口。现在下载安装包，几分钟内就能开始你的第一个 AI 智能体会话。

【免费下载链接】deepseek-harness-desktop为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop