README

DSH Desktop



  DSH Desktop by Dataelem（DSH 客户端）是 Dataelem 团队基于 DeepSeek Harness 框架打造的桌面 Agent 应用，提供开源版与企业版。
  官方网站：www.dshdesktop.com



  简体中文 · English · 日本語 · Русский · Español · Português



  
  
  


!DSH Desktop 的 Preset、模型提供方、手机控制与可编辑 PPT 生成功能

基于 DeepSeek Harness，增强主流模型适配、Word / Excel / PPT 模板、启动异常恢复与工作台，提供开箱即用的桌面体验。

 下载安装

请前往官方网站下载 DSH Desktop。

DSH Desktop 会自动检查更新。新版本会先进行灰度测试，确认稳定后再向所有用户全量推送。

 加入社区


  使用微信扫描下方二维码，加入 DSH Desktop 微信交流群。
  
  也可以加入 DSH Desktop Discord 社区。


 DSH Desktop 带来了什么

DeepSeek Harness 提供 Agent Runtime、Web UI 和基础模型接入能力。DSH Desktop 复用这些基础，重点增强以下体验：

- 主流模型适配：优化模型提供方配置与首次接入，补充模型搜索、图片输入及推理能力配置，并改善第三方模型兼容性。
- Office 三件套模板：提供 Word 原生套版、Excel 案例工作簿及 PPT 可编辑模板，结合业务技能生成 DOCX、XLSX、PPTX；桌面端随附 Python 和 Office 处理依赖。
- 启动异常与插件故障恢复：结合启动和前端诊断定位问题，提供引导恢复、安全模式及修复 Agent 入口，尽量保留用户会话与配置。
- 工作台：集中浏览、安装和打开工作台应用，支持市场安装与本地导入，并复用 Harness 会话交互。
- Agent Preset 迁移：通过 .dshpreset 包导入导出自定义 Preset，安装前检查冲突并提示信任风险。
- 手机连接：扫码配对后，通过局域网或可选公网隧道在手机上继续会话。
- 原生桌面体验：自动管理 Harness 启停，集成系统目录选择、原生菜单与窗口；应用升级保留用户数据，并提供自动更新检查。

 Office 三件套

提供 Word、Excel、PPT 三种制作模式。选择模板并提供材料，即可让 Agent 按模板制作可继续编辑的文件。

- Word：沿用原生模板的版式与样式，适合通知、纪要、报告等文档，输出 DOCX。
- Excel：基于案例工作簿整理数据、制作分析与图表，输出 XLSX。
- PPT：内置 16 套模板、192 种版式，输出可编辑 PPTX，也支持导入个人模板。内置模板预览使用英文，生成内容支持中文和英文；预览语言不决定输出语言。

桌面端随附 Python 和 Office 处理依赖，无需另行安装这些运行环境。PPT 模板模式的自动提示词仅在当前会话启用该模式时生效。

 工作台

工作台把面向具体业务的操作界面与 Agent 会话结合起来，让常用任务不再只有聊天入口。

你可以在工作台市场浏览、收藏和安装应用，也可以导入本地开发的工作台。打开后，在业务界面中操作，并结合关联的 Agent 会话完成任务；安装或更新后，按界面提示重启即可加载。移除工作台不会删除已有会话和项目文件。

 手机连接

从 Harness 菜单选择“连接手机…”，再扫描配对二维码。

- WiFi 下扫码即可连接。
- 互联网隧道需要再输入电脑上显示的 6 位连接密码。默认是 5 分钟、只存在内存里的临时密码；只有在「连接手机」窗口勾选同意后，才会在本机生成长效密码。

Harness 本身始终运行在随机的 127.0.0.1 端口。手机访问由独立的配对 Bridge 提供。Cloudflare Quick Tunnel 是常态长连接路径；免费 Pinggy 是 Cloudflare 不可用时（如中国大陆）的备用通道，大约 60 分钟后失效。桌面端断开连接后，手机会话随即失效。

Cloudflare 启动失败时会尝试 Pinggy。若已显示 Cloudflare 配对链接，但手机无法打开，可点击“扫码打不开？换一条线路”切换到 Pinggy。

 安全模式与故障恢复

如果第三方插件导致启动或页面渲染异常，DSH Desktop 会结合 Runtime 与前端证据定位相关插件，并打开引导式恢复界面。

从 Harness 菜单选择“以安全模式重启…”，可暂时屏蔽第三方插件，同时保留 Agent、会话、模型配置和工作区。你可以在管理界面停用问题插件，再重启正常模式验证；停用不会删除插件和用户数据，之后可以重新启用。

恢复页面会检查插件是否有兼容更新；有可用版本时，可升级对应插件，安全模式还支持批量升级。需要帮助时，鼠标悬停“微信群”即可显示二维码，点击 Discord 则会打开社区链接。

当正常界面无法进入时，也可以通过 --safe-mode 启动。例如 macOS：

sh
open -a "DSH Desktop" --args --safe-mode


 本地数据与安全边界

- 会话与配置保存在本机用户数据目录，应用升级不会覆盖这些数据。
- 内置侧栏浏览器与应用权限隔离；普通外链交由系统浏览器打开。
- 手机通过扫码配对连接；互联网连接还需要输入电脑上显示的连接密码。
- Agent 的文件与命令操作受权限控制，请谨慎批准敏感操作，并只安装可信插件。

 平台支持

| 平台 | 分发形式 | 状态 |
| --- | --- | --- |
| macOS Apple Silicon | 已签名并通过公证的 DMG/ZIP | 支持 |
| macOS Intel | 已签名并通过公证的 DMG/ZIP | 支持 |
| Windows x64 | 已完成代码签名的 NSIS 安装包 | 支持 |
| Windows ARM64 | — | 当前不支持 |
| Linux | — | 当前不支持 |

Harness 包含目标平台原生依赖，因此每一种正式安装包都在对应操作系统与架构上构建。

 开发与架构

欢迎参与贡献。工程说明已拆分为独立文档：

- 开发指南 — 本地环境、验证、补丁维护与原生平台打包
- 运行架构 — 启动流程、持久化数据、安全边界、故障恢复、手机连接与更新
- 发布手册 — 签名与正式发布控制
- Preset 包格式 — 可移植 Agent Preset 契约

提交修改前请运行 npm test、npm run typecheck 和 npm run build，并实际操作受影响的应用流程。请勿在 Issue、日志、截图或测试数据中提交真实 API Key。

 友情链接

dsh-market 是 DeepSeek Harness 社区插件市场，可在 Harness 界面中浏览和搜索插件、查看截图

Top issues

Latest release

中文 | English

本版本重点提升 Safe Mode 和启动稳定性，并改进故障报告、安装器及 Windows 环境下的兼容性。

新增功能

- 故障报告：将待处理报告汇总为每次启动最多一个确认弹窗；用户同意后最多发送 5 份报告，避免重复打扰。

 体验优化

- 故障诊断：相同诊断错误在 10 分钟内去重，减少重复捕获与报告。
- Office 集成：Office 运行时资源缺失或配置无效时，发出警告并停用 Office 功能，不再阻断 Harness 启动。
- 安装器：恢复安装完成后自动启动应用，同时避免强制提升安装器权限。

 问题修复

- Safe Mode 与会话启动：确保 Safe Mode 配置包含可用的默认模型；缺少模型选择时回退到 DeepSeek 官方默认模型，避免会话控制器卡住。
- 凭据与会话持久化：遇到无效或旧版凭据键时跳过并警告；损坏的会话日志不再导致异常退出，并可隔离后继续列出其他会话。
- 锁文件恢复：自动清理超过 10 秒的陈旧凭据和 Profile 写入锁，避免异常退出后下次启动等待超时。
- Windows 沙箱与显卡回退：为安装目录授予 Chromium AppContainer 所需的读取权限；显卡回退时放宽 GPU 沙箱限制，同时保留 Renderer 沙箱，改善受限权限或驱动环境下的启动兼容性。

 其他变更

- Ha