dataelement/dsh-desktop
DSH Desktop 是一款面向 DeepSeek Harness 的本地优先、跨平台桌面应用，支持 macOS（Apple Silicon 与 Intel）和 Windows x64。它自动启动 Harness，将配置、插件、工作区和会话保存在应用目录外，支持官方 DeepSeek 模型及第三方模型提供商，可导入导出便携式 `.dshpreset` 预设包，并允许配对手机通过本地网络或 Cloudflare Quick Tunnel 继续会话。应用基于 `@deepseek-ai/dsh@0.1.2-alpha.4` 构建，采用 MIT 许可证，提供安全模式、故障恢复和引导式更新流程。
DSH Desktop 概览，包含便携式预设、模型提供商和手机控制
DSH Desktop 将本地 DeepSeek Harness 体验打包为已安装的桌面应用。它会自动启动 Harness，将配置文件、插件、工作区、模型设置和会话保存在应用程序目录之外，并在本地运行时就绪后立即打开完整的 Harness 界面。
[!IMPORTANT] DSH Desktop 是基于快速演进的
@deepseek-ai/dsh@0.1.2-alpha.4构建的早期预览版。macOS 版本已由 Apple 签名并公证。Windows x64 安装程序已代码签名；随着发布方逐步积累下载和安装信誉，Windows 安全警告可能会逐渐减少。
下载
从官方网站下载适用于 macOS 和 Windows 的 DSH Desktop。
安装版会在启动后不久及每六小时检查一次更新。当有新版本可用时，DSH Desktop 会先询问再下载；只有在您选择重启并安装后才会开始安装。您也可以从应用程序菜单手动检查，或跳过某个版本而不隐藏未来版本。
社区
DSH Desktop 带来的增强
DeepSeek Harness 已提供 Agent 运行时和 Web UI。DSH Desktop 补充了实用桌面产品所需的原生宿主能力：
- 无需单独的 CLI 或浏览器标签页即可启动和停止 Harness
- 使用系统原生目录选择器添加和管理项目工作区
- 支持官方 DeepSeek 模型和主流第三方模型提供商
- 将完整的自定义 Agent 预设作为便携式
.dshpreset包导入和导出，安装前进行冲突检查并显示信任警告 - 在应用升级时保留配置文件、插件、工作区、会话和模型设置
- 检测启动和前端插件故障，将诊断信息保存在
harness.log中，并提供引导式恢复操作 - 提供非破坏性的安全模式，可临时阻止第三方插件
- 允许配对的手机通过本地网络或可选的临时公共隧道继续会话
- 检查桌面更新，并将下载和安装过程置于用户控制之下
- 针对 macOS 和 Windows 适配原生菜单、标题栏行为、窗口焦点、主题和应用品牌
手机访问
从 Harness 菜单中选择**连接手机…**并扫描配对码。桌面端会要求您批准连接，之后手机才能访问会话。
Harness 本身仍运行在随机的 127.0.0.1 端口上。手机访问使用独立的配对桥接。它可以保持在本地网络中，或者当您选择远程访问时，使用临时的 Cloudflare Quick Tunnel。从桌面端断开手机连接会使移动会话失效。
安全模式和恢复
如果第三方插件干扰启动或渲染，DSH Desktop 可以根据运行时和前端证据识别相关插件，并打开引导式恢复界面。
从 Harness 菜单中选择以安全模式重启…，启动一个仅包含官方核心包的隔离配置文件。Agent、会话、模型设置和工作区仍然可用，而正常配置文件中的第三方插件则保持阻止状态。您可以从安全模式横幅中移除选定的插件或恢复正常启动。
如果无法访问正常界面，请使用 --safe-mode 启动 DSH Desktop。在 macOS 上：
open -a "DSH Desktop" --args --safe-mode
本地数据与安全
- Harness Web UI 仅在随机的回环端口上提供服务。
- 渲染器没有 Node.js 权限，并使用上下文隔离和沙箱。
- Webview、不受信任的应用内导航和意外的权限请求均被阻止。
- 外部网页链接在系统浏览器中打开。
- 用户配置文件和会话存储在 Electron 的按用户应用程序数据目录中，而非已安装应用内部。
- 手机访问需要短期配对令牌和明确的桌面端批准。
平台支持
| 平台 | 分发格式 | 状态 |
|---|---|---|
| macOS Apple Silicon | 已签名并公证的 DMG/ZIP | 支持 |
| macOS Intel | 已签名并公证的 DMG/ZIP | 支持 |
| Windows x64 | 已代码签名的 NSIS 安装程序 | 支持 |
| Windows ARM64 | — | 目前不支持 |
| Linux | — | 目前不支持 |
Harness 包含目标平台原生依赖，因此每个发布产物都在匹配的操作系统和架构上构建。
开发与架构
欢迎贡献。请从公开的工程文档开始：
- 开发指南 — 环境搭建、验证、补丁维护和目标原生打包
- 架构 — 运行时流程、持久化数据、安全边界、恢复、移动访问和更新
- 发布手册 — 签名和发布控制
- 预设包格式 — 便携式 Agent 预设契约
在提交更改之前，请运行 npm test、npm run typecheck 和 npm run build，然后测试受影响的真实应用流程。切勿在问题、日志、截图或测试数据中包含真实的 API 密钥。
相关项目
dsh-market 是 DeepSeek Harness 的社区插件市场。您可以在 Harness 界面中浏览和搜索插件、预览截图、安装或更新包、启用或禁用插件以及切换主题。
许可证
DSH Desktop 在 MIT 许可证下开源。
DeepSeek Harness 及其依赖项仍受各自上游许可证和商标政策的约束。DSH Desktop 是一个独立的社区桌面应用。