发布日期：2026-09-02 | 话题标签：DSH Desktop、DeepSeek Harness、桌面客户端、Agent Harness、插件生态
DSH Desktop 是由社区团队 anywhere-labs 于 2026 年 8 月 13 日开源的 DeepSeek Harness（DSH）桌面客户端，把官方 Harness 的本地 Web UI、Host 服务和插件系统封装进 Windows 与 macOS 原生应用，安装包自带 Electron、Node.js、pnpm 和固定版本的 DSH 依赖，用户无需安装 Node 或敲命令即可启动一个完整的本地 Agent 运行时。项目采用 MIT 协议，上线两周半即获得 2.2 万余 Star，最新版本 v2.0.4 于 8 月 28 日发布，提供 Windows x64 安装程序和 macOS Universal 镜像。它的核心设计是"桌面本身也是插件"：不修改上游源码，桌面壳作为一个普通 DSH 插件与官方能力在同一运行时组合，因此上游插件可直接安装，桌面能力也能被第三方插件通过受控接口调用。与直接运行npx @deepseek-ai/dsh web相比，Desktop 换来的是免环境配置、系统托盘常驻、多 Profile 切换、自动更新和手机远程控制，代价是安装包体积更大、版本跟随上游固定节奏而非最新 alpha。本文基于官网、GitHub 仓库、用户指南、FAQ 与近期 Issue 拆解它的定位、安装方式、模型配置和常见故障。
DSH Desktop 是什么
DSH Desktop 是面向 Windows 和 macOS 的开源 DeepSeek Harness 桌面客户端，由社区独立维护，不是 DeepSeek 官方产品。它把官方 Harness 的 Web UI、Host 服务和插件体系装进原生应用，并补上窗口、系统托盘、内置终端、自动更新和 Profile 管理这些桌面层能力。
几个关键事实（数据来自 GitHub API，2026 年 9 月 2 日）：
| 项目 | 数值 |
|---|---|
| 仓库创建时间 | 2026-08-13（与上游 DeepSeek Harness 同日） |
| Star / Fork | 22,821 / 1,120 |
| 许可证 | MIT，完全免费 |
| 最新版本 | v2.0.4（2026-08-28，官网版本接口同步返回 2.0.4） |
| 安装包 | DSH-Desktop-2.0.4-x64-Setup.exe、DSH.Desktop-2.0.4-universal.dmg |
| 开放 Issue | 305 |
官网首页写明"由社区独立维护的开源项目，并非 DeepSeek 官方产品，与 DeepSeek 无隶属或背书关系"，且只提供 Mac 与 Windows 两个下载入口。README 进一步声明：仓库中没有深度求索员工或上游官方团队成员参与开发、维护或治理，"DeepSeek Harness"名称仅用于说明兼容性和技术来源。任何人以任何形式向你出售这款软件，都应拒绝。
与上游 DeepSeek Harness 的分工
上游 DeepSeek Harness 是 DeepSeek AI 于 2026 年 8 月发布的开源 Agent Harness，目前处于开发者预览阶段，GitHub 已超过 20.8 万 Star，最新 tag 为dsh-v0.1.2-alpha.4（9 月 1 日）。它基于 Cordis 内核实现"一切皆插件"架构，模型、工具、技能、会话、沙箱、存储、循环、调度和 UI 全部是可插拔能力。
两者的边界很清晰：
- 上游负责：Agent 语义、模型接入、工具、会话、Web 客户端、插件系统
- Desktop 负责：应用封装、本地服务的启动/停止/恢复、窗口与托盘、安装包构建发布、桌面化界面体验
Desktop 固定并原样运行某个上游版本，不做长期分叉。
"桌面也是插件"怎么理解
"桌面也是插件"的意思是：DSH Desktop 的窗口、托盘、终端、更新和工作配置这些桌面壳能力，本身是以一个 DSH 插件的形式接入上游运行时的，与官方插件和第三方插件走同一条组合路径，没有任何特权。
这带来三个直接结果：
- 上游插件直接可用。Desktop 使用的就是官方 Harness 的插件体系，
dsh plugin add装的插件在 Desktop 里同样生效。 - 桌面能力可被插件调用。Desktop 通过明确公开的 Host service 向第三方插件暴露能力，例如查看和切换工作配置、在当前配置中安装/更新/移除插件。插件不能直接控制窗口、托盘、安装器等内部实现。
- 上游升级不需要重写外壳。因为没有魔改上游源码，切换固定的上游版本只是换一个 bundle。
项目还发布了《DSH 插件生态倡议书》，提出"组合优先、声明清晰、兼容优先"三条原则，并在推进名为 DSH Community Fabric 的插件 contract 草案（Manifest、Capability、Host Descriptor）。需要注意的是，文档明确说 Fabric 目前只有文档，不是已发布的标准，当前插件仍使用现有 DSH/Cordis 接口。
Desktop 安装包 vs npx 起 Web UI vs 源码运行：怎么选
三种运行 DeepSeek Harness 的方式各有取舍，选择依据是你愿意管理多少环境。
| 维度 | DSH Desktop 安装包 | npx @deepseek-ai/dsh web | 源码pnpm dsh web |
|---|---|---|---|
| 前置环境 | 无，安装包自带 Electron / Node / pnpm / DSH | 需自行安装 Node.js | 需 Node.js + pnpm + git |
| 启动方式 | 双击应用，托盘常驻 | 终端执行命令，浏览器打开127.0.0.1:3080 | 克隆、安装、构建后执行 |
| 版本节奏 | 固定上游版本，随 Desktop 发版更新 | 每次拉取 npm 最新发布版 | 任意 commit，可跟 alpha |
| 端口 | 默认随机分配（port: 0），可固定 | 默认 3080 | 默认 3080 |
| 多配置 | Profile 菜单切换desktop/web等 | 需手动管理 DSH home | 需手动管理 |
| 更新 | 后台检查，确认后下载 DMG / NSIS | 重新执行 npx | git pull+ 重建 |
| 手机远程 | iOS / Android 远程连接 | 需自行配置 | 需自行配置 |
| 适合谁 | 只想用、不想配环境的用户 | 开发者快速试用 | 参与核心开发、需要最新特性 |
选择建议：
- 非技术背景、或在 Windows 上不想碰 Node 环境：选 Desktop。
- 已有 Node 环境、想第一时间跟上游 alpha：直接
npx。 - 想写插件、改 preset、跑基准测试：源码运行。
一个容易忽略的点：Desktop 安装包体积明显更大，FAQ 解释这是把运行时和固定版本依赖全部打进去的代价，换来的是"更确定的首次启动和版本组合"。
安装与首次启动步骤
DSH Desktop 的安装流程是下载安装包、运行、走完 Setup Wizard、配置模型四步，全程不需要命令行。
- 下载安装包。从项目下载页 dshdesktop.cn 或 GitHub Releases 获取。Windows 选
x64-Setup.exe，macOS 选universal.dmg（Intel 与 Apple Silicon 通用）。目前没有 Linux 安装包，FAQ 特别提醒不要根据源码里的跨平台代码推断已发布。 - 安装。Windows 运行 NSIS 安装程序；macOS 打开 DMG 把应用拖入 Applications。
- 首次启动走 Setup Wizard。每个未初始化的 Profile 首次启动会先显示原生设置向导，可设置窗口模式与系统材质、插件市场、通知、是否用系统浏览器自动打开，以及 Web 访问范围。也可以直接跳过。向导完成或跳过之前，Host 和主窗口不会启动。
- 配置模型。打开Settings → Models，在 DeepSeek 卡片填入 API Key 保存，无需重启即可使用。
关闭窗口只是隐藏到托盘，从托盘选择退出才会结束应用和 Host 进程。
网络暴露范围要看清
Web 服务默认只监听本机回环地址127.0.0.1。"用浏览器打开"选项不改变网络暴露范围。局域网访问是独立的可选设置，用户指南用"危险"标注：向局域网开放不提供鉴权，同一局域网内的任何人都能直接打开 DSH 并操作你的电脑。只在完全信任的网络中开启。
怎么接入 DeepSeek 之外的模型
DSH 的模型配置分三层：DeepSeek 官方卡片、目录内的其他供应商（Anthropic、OpenAI 等）、以及"自定义供应商"。任何兼容 OpenAI 接口格式的网关或平台都可以通过自定义供应商接入。
在Settings → Models选择Add a custom provider，需要填写：
- Provider ID（小写，保存后永久不可改，因为会话记录和凭据引用都依赖它）
- 显示名、Base URL、API 协议、凭据
- 至少一个模型；也可以点Fetch available models让 DSH 调用
GET /models自动拉取
密钥是只写的，保存在$DSH_HOME/.credentials.yaml，设置文件里只保留引用。
对国内团队来说，这一层最实用的场景是接入一个能同时提供多款主流大模型的统一入口，避免在多个平台分别管理 Key 和用量。例如七牛云 Token Plan 面向开发者提供多模型统一接入与用量管理，国内可直接访问，接入时只需在自定义供应商中填写其 Base URL 与 API Key。
网关兼容性开关
如果 Key 和 URL 都对但请求全部被拒，通常是请求形状差异。上游文档指出两个最常见原因：声明了推理能力的模型会把系统提示以role: "developer"发送，很多网关直接拒绝；输出上限字段用max_completion_tokens，只认max_tokens的服务端会报错。修复方式是在$DSH_HOME/settings.yaml给该路由加compat：
llm-pi-ai:providers:my-gateway:apiKeyEnv:GATEWAY_API_KEYapi:openai-completionsbaseURL:https://<你的网关地址>/v1compat:supportsDeveloperRole:falsemaxTokensField:max_tokensmodels:-id:<模型ID>手动录入的模型默认视为纯文本，要接图像输入需在模型下加input: [text, image]。
Profile、插件与终端：日常管理怎么做
Profile 是一组 DSH bundle、依赖和 patch 的组合，DSH Desktop 通过托盘 Profile 菜单切换，切换后应用有序重启。
Profile 规则：
- 默认可创建
desktop和web两个 Profile - 新 Profile 只有在 Host、窗口和浏览器客户端都成功启动后才被记录为"最近可用"，失败自动回退
- 官方 Profile 默认共享同一个 DSH home，会话、设置、存储不需要迁移
- 切换 Profile不会自动复制插件
插件管理沿用官方 CLI 语义，在托盘打开的 DSH Terminal 中执行：
dsh plugin--profiledesktopadd<plugin>dsh plugin--profiledesktop remove<plugin>dsh plugin--profiledesktop update在 Desktop 终端里不带--profile的命令默认作用于当前激活 Profile。插件变更后必须重启 Desktop 才进入 Loader 组合。
内置终端：macOS 打开 Terminal，Windows 优先 Windows Terminal，回退 PowerShell。Desktop 在自己的 user-data 目录生成dsh、pnpm、node私有 shim，只对这个终端进程设置 PATH，不修改系统 PATH 或用户 shell 配置。
插件从哪找：README 友情链接列出了 DSH 1024Store（收录 4,120 个社区插件并开源目录流水线）、dsh-market（Harness 内可视化插件市场）、Awesome DSH Plugin 精选列表、dsh-context 上下文仪表盘、DSH-better-sidebar 侧边栏工作台等生态项目。关于 Desktop 自带插件市场的状态，README 主要功能一节称"DSH Community Market 已完成并内置"，而《插件生态倡议书》与《为什么做 DSH Desktop》两份文档仍将市场标注为设计阶段和 roadmap，[状态待核实：以最新 Release Notes 为准]。
三种窗口模式与端口设置
DSH Desktop 提供兼容、扩展窗口、增强三种呈现模式，切换任一模式或材质都会重启应用。
| 模式 | 特点 |
|---|---|
| 兼容模式 | 保留上游官方 layout / sidebar / conversation 完整组合，放在 36 像素的 Desktop frame 下方 |
| 扩展窗口 | 安装 Desktop 自有 layout 与 sidebar surface，承载官方组件，形成倒 L 形材质区域 |
| 增强模式 | 独立 root registration 与紧凑内部 caption，macOS 20 像素内容 inset，Windows 32 像素 caption row |
材质方面，macOS 可开关透明材质；Windows 仅 11 build 22621 及以上显示 Mica。
端口：默认dsh-desktop.port: 0由系统随机分配，避免冲突。但依赖浏览器localStorage的界面插件按 origin 隔离数据，重启后端口变了设置就丢了。这类情况在设置中固定端口：
dsh-desktop:port:43189固定端口被占用时 Desktop 无法启动，需释放端口或改回0。
升级出错、启动闪退怎么排查
DSH Desktop 的排查入口是托盘的"导出诊断信息"和恢复模式，近期 Issue 集中在 2.0.4 升级与首次启动权限两类问题。
从 GitHub Issue 看，8 月 31 日至 9 月 1 日连续出现"2.0.3 更新到 2.0.4 报错"（#769）、“2.0.4 无法使用”（#770，已关闭）、“更新 2.0.4 时出现的问题”（#776）和"安装后启动提示 EPERM: operation not permitted"（#773）。遇到类似情况按以下顺序处理：
- 应用能进托盘：右键托盘图标 →导出诊断信息…，确认隐私提示后生成
diagnostics-*.zip。 - 持续闪退进不了托盘（Windows）：在 PowerShell 直接运行并加恢复参数：
&"$env:LOCALAPPDATA\Programs\DSH Desktop\DSH Desktop.exe"--export-diagnostics该命令不会启动 Host、Profile、插件或窗口，只输出诊断 ZIP 路径。
3.进入恢复模式：设置中的重启下拉菜单选择重启到恢复模式，恢复窗口提供插件管理、回滚、切换配置、诊断四个 Tab。
4.提交 Issue时附上操作系统、应用版本、复现步骤和错误信息。
诊断包包含应用日志、Crashpad.dmp、运行标记和system-info.txt。日志会对认证凭据脱敏，但本地路径、工作区 ID、会话 ID 和崩溃内存片段可能仍在，公开上传前务必检查。
其他高频小问题：窗口消失先看托盘；插件没出现确认作用于目标 Profile 并重启；终端命令找不到就从托盘重开 Desktop 终端；更新没提示用托盘手动检查。
常见问题
Q：DSH Desktop 会把我的数据传到哪里？
Host、Profile 和 DSH home 都在本机。是否向外发送内容取决于你配置的模型或工具供应商，使用云端模型时请求会发给该供应商。自动更新检查会携带当前版本号和一个本机生成的随机 UUID，不从硬件信息推导，安装包下载请求不携带这些 header。
Q：Desktop 的 Profile 和我之前用 npx 建的 web Profile 会同步吗？
不会自动复制插件。每个 Profile 有自己的 bundle 和依赖组合。官方 Profile 默认共享同一个 DSH home，所以会话和设置是通的，但插件要在目标 Profile 里重新dsh plugin add。
Q：手机远程控制怎么用？
README 称可通过 iOS 和 Android 远程连接 Desktop，在手机上发起任务、查看 Agent 进度并跟进。同一团队还维护 Agents-Anywhere 项目用于从手机控制电脑上的 Coding Agent。具体配对步骤以用户指南最新版本为准。
Q：为什么安装包这么大？
因为 Electron、Node.js、pnpm 和固定版本的 DSH 依赖全部打进了安装包，目的是保证首次启动不再下载运行环境、版本组合确定。使用云端模型、检查更新和下载新版本仍需联网。
Q：可以在 Linux 上用吗？
当前没有 Linux 安装包。文档说明 Linux 只提供兼容模式的代码路径，但不要据此推断已发布对应安装包。Linux 用户建议直接npx @deepseek-ai/dsh web。
总结
DSH Desktop 解决的是 DeepSeek Harness 首次运行时的环境门槛：Node.js、Profile、依赖、端口和进程生命周期这些事被安装包和托盘接管，用户面对的仍是官方 Web UI 和官方插件体系。"桌面也是插件"不是口号，而是桌面壳与第三方插件共用同一组合机制、上游源码零修改的工程约束。对只想把 Harness 用起来的 Windows 和 macOS 用户，它是目前最低成本的入口；对要跟上游 alpha 或写插件的开发者，npx与源码仍是更合适的路径。
据 DSH Desktop 官方文档《为什么做 DSH Desktop》表述，项目"不是上游项目的替代品，也不是把上游源码复制一份再长期分叉"；DeepSeek Harness 上游 README 则提醒开发者预览阶段"未来将出现破坏兼容性的变更"。本文内容基于 2026 年 9 月 2 日的官网、GitHub 仓库、用户指南、FAQ 与 Issue 数据，Desktop 与上游均处于高频迭代期，建议定期核对最新 Release。
参考资料
- DSH Desktop 官网：https://dshdesktop.cn/
- DeepSeek Harness 官方仓库：https://github.com/deepseek-ai/deepseek-harness
- DeepSeek Harness 模型配置指南：https://developer.qiniu.com/aitokenapi/13550/deepseek-harness-configuration-access-ai
- 七牛云 Token Plan（多模型统一接入与 API Key）：https://www.qiniu.com/ai/plan
