桌面端 yxccai/dsh-desktop

DSH Desktop

DeepSeek Harness 的非官方开源桌面应用，目标是提供更简单、更顺手的桌面体验。

亮点

官方 DSH Web 外面套一层桌面外壳 —— 功能照单全收，安全，还容易跟上新版本

DSH Desktop 不重新实现任何功能，只是把官方 DSH Web 装进原生桌面窗口：

- 一键启动：不用开浏览器标签页，不用记 URL，不用敲命令行 —— 双击桌面图标，进入的就是官方 Web 那套运行时环境。
- 功能继承：官方 DSH Web 作为宿主运行时，加载它完整的 UI 和插件系统，会话、工作区数据、插件生态全部保留；内置插件里的 Web 插件市场组件，一处就能同时管理桌面版和 Web 版的插件。
- 安全隔离：渲染进程拿不到 Node.js、文件系统或任意命令的直接访问权限；Electron 沙箱、contextIsolation、仅限回环地址的导航，再加一层白名单 IPC，共同构成隔离边界。
- 升级简单：官方 DSH 发布新版本时，桌面版只需升个版本号、重新打包。原有的 DSH_HOME、会话、Agent Presets 和持久化插件原样沿用，不受影响。

底子保持精简 —— 只加几项实用的桌面增强

基础版本不堆功能，保留官方 Web 的体验，只补上桌面场景里最有用的几项：

- 项目面板：在聊天旁边列出每次回复实际改动或生成的文件。多标签预览支持 Markdown、HTML、源代码、diff、CSV、PDF、图片和文本，可分屏编辑，保存时按原子写入并处理冲突。Git 工作区显示真实状态，支持按文件丢弃改动；非 Git 目录改用内容快照（不会 git init，也不会往项目里写任何东西）。每次回复都会记录一份可恢复的快照，恢复前总会先把当前状态存成恢复点。
- 内置插件（可选安装）：内置插件以可选目录的形式提供，不预装。目前已上架：多套配色主题（深海蓝、极光绿紫、玫瑰晚霞粉、暖沙琥珀，每套都有浅色和深色模式）、自定义图片背景（原生文件选择器，透明度可调，随时关闭），以及轻量写作助手（起草、改写、总结、翻译）。都支持按需安装、停用和卸载。
- Windows 系统通知（可选）：智能体等待审批、完成任务或出错停止时，弹出原生通知 —— 不用一直盯着页面。随时可在「设置 → 插件 → 内置插件」里开关，默认关闭。

可扩展、有创意 —— 精简底座上的完整插件生态

底座保持轻量，扩展能力直接可用：

- 内置插件持续增加：官方精选插件通过可信渠道分发，带完整性校验，安装、禁用、卸载都不会碰你的内容。
- 社区插件市场：内置一份固定且经过校验的社区市场组件。启用后，进入「设置 → 插件 → 插件市场」即可浏览 awesome-dsh-plugin.com —— 集中安装、更新、卸载社区插件，自带 pnpm，无需全局安装任何东西。安装内容进入共享的 DSH_HOME，桌面版和浏览器版都能用。
- 按需扩展：需要时从内置目录和社区目录添加能力；不需要时，基础体验保持精简。

下载

两种使用方式

| 方式 | 适合谁 | 你会得到什么 |
| 一键安装包 | 大多数用户 | 双击即可安装运行，无需环境。数据是你自己的（DSH_HOME、会话、插件），但 DSH 由桌面版自带的运行时启动 |
| 连接模式 | 装了 Node.js、想用完整官方 DSH 的用户 | 不只是数据 —— DSH Web 本身也由你用系统 Node 启动（npx 拉取最新版本）；桌面版只作为外壳连接，绝不使用自带运行时 |

两种方式共用同一份数据（DSH_HOME、会话、插件），可以随时切换。开发者也可以从源码运行；npm start 使用 auto 模式，优先用系统环境。

一键安装包

从 GitHub Releases 下载：

- Windows x64 Setup
- SHA-256 校验和

macOS（测试版）

Apple Silicon（M 系列）：

- macOS arm64 DMG
- macOS arm64 ZIP

Intel（x64）版本会在 runner 跑完后出现在 Releases 页面。

首次启动时，在 Finder 里按住 Control 点击应用，选择 打开。如果 macOS 仍然拦截，去 系统设置 → 隐私与安全性 → 仍要打开。签名和公证计划在后续版本中提供。

截图

感知会话的项目面板

带完整上下文文件变更的项目面板

会话快照与按文件回滚

会话快照与回滚控件

托管插件中心

DSH Desktop Plugin Center

社区插件市场

内置的社区市场组件挂载到共享的 DSH_HOME 之后，会管理桌面端和 Web 端已经装好的插件，还能随时浏览并安装新加入的社区插件：

Community plugin market - plugin management

Community plugin market - plugin install

工作原理

DSH Desktop 会自动挑一个可用的运行时：

1. 连接已有的 DSH 服务。
2. 复用全局安装的 dsh。
3. 复用系统的 npx/npm 环境。
4. 回退到内置的 DSH 运行时。

老用户通常可以继续用原来的 DSH_HOME、会话、Agent Presets 和持久化插件。新用户不用先装 DSH 或 Node.js。

项目面板

对话真正改动或生成的文件，会显示在对应回复的下方。点一下，就在右侧多标签预览里打开，带文件名和关闭按钮；聊天布局会收窄，而不是被盖住。预览支持 Markdown、HTML、源代码、diff、CSV、PDF、图片和文本，还支持分屏编辑，保存是原子的，并且能识别冲突。Git 工作区会给出真实的状态 / diff / 丢弃操作；普通的非 Git 目录则改用 DSH Desktop 的内容 blob 快照，不会执行 git init，也不会往项目里写元数据。两种模式都保留回合改动、全上下文 diff、单文件撤销和可恢复快照；恢复快照前，会先把当前状态记成一个恢复点。

Office 文件目前调用系统应用打开；原生 DOCX/XLSX/PPTX 渲染还在计划中。

Web 插件市场（可选）

DSH Desktop 内置了社区插件市场 @sanqi-normal/dsh-webui-market-plugin（MIT，源码放在 resources/market-plugin），按需挂载到共享的 DSH_HOME，于是 DSH Web GUI 多出一个 Settings → Plugins → Plugin Market 标签页，可以浏览 awesome-dsh-plugin.com，把社区插件装进 web 配置档或从中卸载。

- 两个地方都能管：桌面端 Plugin Center 窗口（Web 插件市场标签页）和 Web 设置桥（GUI 里的内置插件标签卡片）。安装、启用、禁用、卸载都是对 $DSH_HOME/cordis.patch.yml 加 $DSH_HOME/node_modules/@sanqi-normal/dsh-webui-market-plugin 的互斥事务操作；$DSH_HOME/profiles/web 永远不会被改动。
- 没有全局 pnpm 也能用：应用自带 pnpm，并提供一个 PATH shim（src/pnpm-runtime.js），所有 DSH 进程都会继承它。所以即使在 Windows 上从没装过全局 pnpm，网页内安装也能成功（npx／全局／自带启动都一样）。从终端手动启动的 DSH 服务，也会回退到 $DSH_HOME/bin 下的自带 pnpm。如果 pnpm 确实不可用，市场会给出清楚的提示，而不是甩一堆控制台乱码。
- 常见安装问题自动处理：允许 git 托管的构建脚本（dangerously-allow-all-builds）；迁移过的配置档复用其记录的 pnpm store（npm_config_store_dir）；lockfile 缺少 tarball 完整性信息时（旧版 pnpm 写下的裸 GitHub archive URL），改写成 github: 语法并重试一次。
- 第三方警告：市场插件由社区作者编写，运行在 DSH 进程内，拥有宿主权限（文件、网络、命令）。只安装你信任的来源。桌面应用自带一份固定、经过摘要校验的副本，拒绝操作外来或被篡改的内容，但对第三方插件的行为不承担责任。
- 需要重启：改动在 DSH web 服务重启后生效；正在进行的会话不会中断。
- 来源与复现：resources/market-plugin/VENDORED.md —— Host 部分是上游代码加上两个 DSH Desktop 可移植性补丁（自带 pnpm 的 PATH shim 和人类可读的 pnpm 错误信息），Client 部分是 MIT 协议下重新设计的原创 UI。

插件兼容性

基于官方 DSH/Cordis 服务、Host 工具、UI 插槽、主题和持久化 Presets 构建的插件，兼容性通常最好。依赖固定 DOM 结构、浏览器扩展或开发 HMR 的插件，需要单独测试。

连接模式（用完整的官方 DSH Web，而不只是你的数据）

一键安装器会保留你的数据（DSH_HOME、会话、插件），但 DSH 进程由桌面自带的固定版本（rc.6）以 Electron-as-Node 启动。连接模式更进一步：DSH Web 本身也由你用自己系统的 Node 启动（npx 拉取最新官方版本），桌面只作为外壳连接 —— 数据、进程、版本全由你掌控。

DSH Desktop 只是一个外壳 —— 默认按 auto 顺序挑选运行时（连接已有服务 → 全局 dsh → 系统 npx → 自带运行时）。如果你想让 DSH Web 由自己系统的 Node 启动，就用连接模式：

完整步骤

1. 安装 Node.js（连接模式的前提）：从 nodejs.org 下载 LTS 版本并安装。

2. 安装桌面应用（二选一）：
- 下载一键安装器并安装；
- 或者从源码运行（开发者）。

3. 用系统 Node 启动 DSH Web（在终端里操作；保持窗口打开）：

npx @deepseek-ai/dsh web --host 127.0.0.1 --port 3080

4. 把桌面端配置成只连接、不启动服务： json { "launchMode": "connect", "url": "http://127.0.0.1:3080" }

配置文件位于 <userData>\config.json（Windows 默认路径：C:\Users\<username>\AppData\Roaming\dsh-desktop-shell\config.json；如果设置了 DSH_DESKTOP_HOME，则以它指向的位置为准）。

5. 启动桌面端 —— 它会检测 3080 端口上的 DSH 服务并直接连接，跳过内置运行时。

这样你的 DSH 就跑在真正的 Node 上（process.execPath 是 node.exe），桌面端只负责提供窗口、项目面板、内置插件和系统通知 —— 不再有 Electron-as-Node 内置运行时，上游一发布更新你就能拿到。

注意：在 connect 模式下，DSH Web 由你的终端启动和管理 —— 关掉终端服务就停了；桌面端不会替你启动它。

从源码运行 powershell
git clone https://github.com/yxccai/dsh-desktop.git
cd dsh-desktop
npm ci
npm run check
npm test
npm start

npm start 默认使用 auto 模式：优先用你系统里的 dsh 或 npx，所以同样不会强制使用内置运行时。

平台支持

- Windows x64：提供 Setup 构建，已测试。
- macOS Intel / Apple Silicon：未签名的测试构建以预发布形式发布。首次启动时，在 Finder 里按住 Control 点击应用，选择 打开；如果 macOS 仍然拦截，去 系统设置 → 隐私与安全性 → 仍要打开。签名与公证已在计划中。
- 后续版本可能会考虑支持更多平台。

开发 powershell
npm ci
npm run check
npm test
npm start

更多信息：

- 更新日志
- 安全
- 贡献指南
- 运行时准备

许可

本项目采用 MIT 许可证。DeepSeek Harness、Electron 及其他依赖仍遵循各自的许可证。