DSH Desktop 快速上手：一键安装桌面AI智能体客户端-开发者社区

DSH Desktop 快速上手：一键安装桌面AI智能体客户端

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

如果你也曾在终端里折腾 Node.js、pnpm 和一堆环境变量，就为了跑起一个能对话的 AI 助手，那么 DSH Desktop 值得你花五分钟了解：它把 DeepSeek Harness（下文简称 DSH）封装成可一键安装、开箱即用的桌面AI智能体客户端，不用装运行环境，下载安装包就能发出第一条消息。

项目定位：DSH Desktop 在哪一层工作

DSH 本身是"命令行 + Web UI"形态的 agent harness，能力完整，但第一次跑起来要自己处理运行时、profile、依赖、端口和进程管理。DSH Desktop 不重写 Harness，而是给它加一层"桌面壳"：你看到的窗口、托盘、终端、更新，都是壳负责；真正干活的 agent、模型、工具与会话，仍然由官方 Harness 完成。项目坚持"万物皆插件"——桌面壳本身也是插件，和第三方插件走同一套组合机制。

层级	承担的职责
安装包	内置 Electron 与 Node 运行时，锁定固定版本的 DSH 依赖
桌面外壳	管理窗口、系统托盘、单实例，负责本地服务的启动、停止与恢复
官方 Harness	继续提供 agent、模型接入、工具调用、会话与 Web UI 核心能力
插件层	桌面壳与第三方插件按同一约定组合，能力像积木一样拼装

想深入了解设计动机，可以读 docs/why-desktop.md 和 docs/architecture.md。

一键安装步骤：从安装包到第一条消息

当前正式版本支持Windows x64与macOS Universal（Intel 与 Apple Silicon 通用），暂无 Linux 官方安装包。

整个路径可以拆成四步：

下载安装包。Windows 运行 NSIS 安装程序，按提示点完即可；macOS 打开 DMG，把 DSH Desktop 拖进 Applications。安装包体积偏大，是因为运行时和固定版本依赖已经打包在内——换来的是确定的首次启动体验。全程不需要 Node.js、pnpm 或 DSH 本体，也不会改动系统 PATH 或 shell 配置。
首次启动走向导。每个尚未初始化的 profile 会先弹出 DSH Desktop 自有的 Setup Wizard，可以配置：窗口模式与系统材质、插件市场、通知、是否用系统默认浏览器自动打开、Web 访问范围（默认仅本机回环地址，局域网访问是独立的可选设置）。向导完成或跳过之前，Host 和主窗口都不会启动，官方页面全程不被侵入。
进入主界面。左侧是工作区与会话列表，底部有插件市场和设置入口，中间是对话输入区，可自由选择模型与访问权限。
发出第一条消息。选好工作区，输入内容，发送。几分钟内你就拥有了第一个可对话、可跑任务的桌面 AI 智能体客户端会话。

💡 如果希望从源码运行开发版本，克隆仓库后执行（外层仓库使用 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

核心能力拆解：按场景看它能做什么

对话交互：选模型、给权限，直接开工

主界面的输入区支持自由选择模型与访问权限，智能体会实时流式响应，并展示上下文注入、思考过程、token 统计等信息。官方 Web UI 的对话能力被完整保留，桌面壳只是让它住进了原生窗口。

工作区与会话怎么组织

左侧边栏按工作区分组管理会话，支持搜索与筛选。也可以"用文件夹启动"：Windows 上把文件夹拖到快捷方式图标上，或命令行执行dsh-desktop <文件夹>，该文件夹会被注册为工作区并直接打开。

多 Profile 如何切换

Profile 是一组 DSH bundle、依赖与 patch 的组合，相当于多套"环境配置"。托盘的Profile菜单列出现有 profile，也提供按需创建的desktop和web默认 profile。选择后应用会有序重启：新 profile 要在 Host、窗口和浏览器客户端都启动成功后才被记录为可用；启动失败会自动回退到上一次可用选择。注意切换 profile 不会复制旧 profile 的插件，需要时再为目标 profile 单独安装。

内置终端怎么用

从托盘或设置里点Open DSH Terminal，即可打开自带固定版本 pnpm 环境的 DSH 终端。Desktop 会生成私有的dsh、pnpm、nodeshim，只对这一个终端进程设置 PATH，不修改系统 PATH 或用户 shell 配置。欢迎信息会显示应用版本、当前 profile、profile 目录和 DSH home，方便确认命令作用对象。

窗口模式与材质

提供兼容 / 扩展 / 增强三种呈现模式：兼容模式完整保留官方布局，扩展窗口安装桌面自有 layout 与 sidebar，增强模式保留独立注册与紧凑内部标题。macOS 可开关透明材质；Windows 目前使用不透明窗口（旧版亚克力、Mica 偏好会被安全地按关闭处理）。切换模式或材质会触发重启，不会热替换正在运行的窗口。Linux 只提供兼容模式。

插件市场怎么用

插件市场内置在主界面左下角，提供插件发现、详情、安装与管理。它从你选择的目录来源发现插件，针对当前 Profile 执行安装；无论通过市场还是 DSH CLI 安装的插件，都会在"已安装"视图统一管理。自动安装会严格校验 npm package 身份，不信任来源提供的版本。市场的产品行为详见 dsh-community-market/README.zh.md。

插件 CLI 管理与自研入口

DSH Desktop 使用的是官方 Harness 的插件体系，官方插件可以直接安装。除了市场，另一个常用入口就是内置终端里的 CLI 命令，在 Desktop 终端中默认作用于当前激活的 profile：

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

显式传--profile <name>时以显式指定为准。🧩 两条注意事项：

插件变更后需要重启 DSH Desktop才能生效；
切换 profile 不会自动复制旧 profile 的插件。

想自己写插件？桌面壳与第三方插件遵循同一套组合机制，Desktop 还提供受控的桌面服务接口（如查看切换工作配置、安装/更新/移除插件）。完整文档见 docs/plugin-development.md 与 dsh-plugin-desktop/docs/plugin-services.zh.md，桌面壳源码在 dsh-plugin-desktop/ 目录。

如何安全更新：绝不静默安装

打包后的应用会在后台检查新版本，但绝不静默安装。整个升级流程是：

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

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

隐私边界与局域网风险提示

⚠️ 三点提前说清：

数据都在本地：Desktop Host、profile 和 DSH home 都位于本机；是否向外部服务发送内容，取决于你配置的模型提供商——使用云端模型时，相应请求仍会发送给该提供商。详见 PRIVACY.zh.md。
服务默认只监听127.0.0.1。只有在设置中确认危险提示并明确允许后，才会改为监听所有网络接口。
向局域网开放不提供鉴权：同一网络的人都能直接打开 DSH 操作你的电脑，只在完全信任的网络中开启。

新手避坑速查

现象	怎么处理
需要装 Node.js / pnpm 吗？	不需要，安装包已全部内置，系统环境零改动
这是 DeepSeek 官方产品吗？	不是。社区独立维护的开源项目，与 DeepSeek 无隶属、授权或背书关系
窗口消失了找不回？	先检查系统托盘。关闭窗口只是隐藏，右键托盘选退出才真正结束
插件没有出现？	确认命令作用于目标 profile，然后重启 DSH Desktop
更新没有提示？	后台错误会静默，用托盘手动检查查看结果
改了系统代理后请求异常？	应用遵循系统代理，改完代理后重启应用再试

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

社区交流与开源声明

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

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