发布日期2026-09-02 | 话题标签DSH Desktop、DeepSeek Harness、桌面客户端、Agent Harness、插件生态DSH Desktop 是由社区团队 anywhere-labs 于 2026 年 8 月 13 日开源的 DeepSeek HarnessDSH桌面客户端把官方 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 API2026 年 9 月 2 日项目数值仓库创建时间2026-08-13与上游 DeepSeek Harness 同日Star / Fork22,821 / 1,120许可证MIT完全免费最新版本v2.0.42026-08-28官网版本接口同步返回 2.0.4安装包DSH-Desktop-2.0.4-x64-Setup.exe、DSH.Desktop-2.0.4-universal.dmg开放 Issue305官网首页写明由社区独立维护的开源项目并非 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.49 月 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重新执行 npxgit pull 重建手机远程iOS / Android 远程连接需自行配置需自行配置适合谁只想用、不想配环境的用户开发者快速试用参与核心开发、需要最新特性选择建议非技术背景、或在 Windows 上不想碰 Node 环境选 Desktop。已有 Node 环境、想第一时间跟上游 alpha直接npx。想写插件、改 preset、跑基准测试源码运行。一个容易忽略的点Desktop 安装包体积明显更大FAQ 解释这是把运行时和固定版本依赖全部打进去的代价换来的是更确定的首次启动和版本组合。安装与首次启动步骤DSH Desktop 的安装流程是下载安装包、运行、走完 Setup Wizard、配置模型四步全程不需要命令行。下载安装包。从项目下载页 dshdesktop.cn 或 GitHub Releases 获取。Windows 选x64-Setup.exemacOS 选universal.dmgIntel 与 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给该路由加compatllm-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--profiledesktopaddplugindsh plugin--profiledesktop removeplugindsh plugin--profiledesktop update在 Desktop 终端里不带--profile的命令默认作用于当前激活 Profile。插件变更后必须重启 Desktop 才进入 Loader 组合。内置终端macOS 打开 TerminalWindows 优先 Windows Terminal回退 PowerShell。Desktop 在自己的 user-data 目录生成dsh、pnpm、node私有 shim只对这个终端进程设置 PATH不修改系统 PATH 或用户 shell 配置。插件从哪找README 友情链接列出了 DSH 1024Store收录 4,120 个社区插件并开源目录流水线、dsh-marketHarness 内可视化插件市场、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 与紧凑内部 captionmacOS 20 像素内容 insetWindows 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 终端更新没提示用托盘手动检查。常见问题QDSH Desktop 会把我的数据传到哪里Host、Profile 和 DSH home 都在本机。是否向外发送内容取决于你配置的模型或工具供应商使用云端模型时请求会发给该供应商。自动更新检查会携带当前版本号和一个本机生成的随机 UUID不从硬件信息推导安装包下载请求不携带这些 header。QDesktop 的 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-harnessDeepSeek Harness 模型配置指南https://developer.qiniu.com/aitokenapi/13550/deepseek-harness-configuration-access-ai七牛云 Token Plan多模型统一接入与 API Keyhttps://www.qiniu.com/ai/plan DSH Desktop 桌面版实测：Win/macOS 一键安装，“桌面也是插件“怎么理解，和 npx 起 Web UI 差在哪
发布日期2026-09-02 | 话题标签DSH Desktop、DeepSeek Harness、桌面客户端、Agent Harness、插件生态DSH Desktop 是由社区团队 anywhere-labs 于 2026 年 8 月 13 日开源的 DeepSeek HarnessDSH桌面客户端把官方 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 API2026 年 9 月 2 日项目数值仓库创建时间2026-08-13与上游 DeepSeek Harness 同日Star / Fork22,821 / 1,120许可证MIT完全免费最新版本v2.0.42026-08-28官网版本接口同步返回 2.0.4安装包DSH-Desktop-2.0.4-x64-Setup.exe、DSH.Desktop-2.0.4-universal.dmg开放 Issue305官网首页写明由社区独立维护的开源项目并非 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.49 月 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重新执行 npxgit pull 重建手机远程iOS / Android 远程连接需自行配置需自行配置适合谁只想用、不想配环境的用户开发者快速试用参与核心开发、需要最新特性选择建议非技术背景、或在 Windows 上不想碰 Node 环境选 Desktop。已有 Node 环境、想第一时间跟上游 alpha直接npx。想写插件、改 preset、跑基准测试源码运行。一个容易忽略的点Desktop 安装包体积明显更大FAQ 解释这是把运行时和固定版本依赖全部打进去的代价换来的是更确定的首次启动和版本组合。安装与首次启动步骤DSH Desktop 的安装流程是下载安装包、运行、走完 Setup Wizard、配置模型四步全程不需要命令行。下载安装包。从项目下载页 dshdesktop.cn 或 GitHub Releases 获取。Windows 选x64-Setup.exemacOS 选universal.dmgIntel 与 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给该路由加compatllm-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--profiledesktopaddplugindsh plugin--profiledesktop removeplugindsh plugin--profiledesktop update在 Desktop 终端里不带--profile的命令默认作用于当前激活 Profile。插件变更后必须重启 Desktop 才进入 Loader 组合。内置终端macOS 打开 TerminalWindows 优先 Windows Terminal回退 PowerShell。Desktop 在自己的 user-data 目录生成dsh、pnpm、node私有 shim只对这个终端进程设置 PATH不修改系统 PATH 或用户 shell 配置。插件从哪找README 友情链接列出了 DSH 1024Store收录 4,120 个社区插件并开源目录流水线、dsh-marketHarness 内可视化插件市场、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 与紧凑内部 captionmacOS 20 像素内容 insetWindows 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 终端更新没提示用托盘手动检查。常见问题QDSH Desktop 会把我的数据传到哪里Host、Profile 和 DSH home 都在本机。是否向外发送内容取决于你配置的模型或工具供应商使用云端模型时请求会发给该供应商。自动更新检查会携带当前版本号和一个本机生成的随机 UUID不从硬件信息推导安装包下载请求不携带这些 header。QDesktop 的 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-harnessDeepSeek Harness 模型配置指南https://developer.qiniu.com/aitokenapi/13550/deepseek-harness-configuration-access-ai七牛云 Token Plan多模型统一接入与 API Keyhttps://www.qiniu.com/ai/plan