桌面客户端 JiaosSir/DSH-desk

DSH-desk

基于 DeepSeek Harness + Tauri 开发的 Windows 桌面应用。
极简轻量，告别庞大安装包

特点与优势

- 开箱即用：免安装 Node.js、免配置 pnpm、不用碰命令行，双击即用。
- windows系统功能集成：开机自启开关、快捷键展示、重启 DeepSeek Harness、一键打开日志目录、检查更新（安装版启动自动检查，发现新版本可一键静默更新并自动重启）；dsh审批事件会镜像为系统通知。
- 与网页版数据互通：桌面端与网页版共享同一份用户数据（~/.dsh 下的 profile、会话、凭证），两边切换无缝衔接。
- 插件生态完全复用：内置dsh-market插件市场，沿用 Harness 的 profile 与插件机制，社区插件照常安装使用。
- 插件翻车能自救：引擎升级后若某个插件对不上新版本导致 dsh 起不来，用插件安全模式一键停用全部第三方插件即可正常启动；设置区会列出是哪个插件、并支持直接删除（插件不会被卸载）。
- 安装轻量、启动快：sidecar 以单个归档文件随安装包分发；首次运行在本地解压并显示进度，之后每次启动秒开，升级版本自动刷新。
- 安全边界清晰：WebView 仅放行本地内嵌页面与本机 Harness 源，外部链接一律移交系统浏览器打开；凭证只存在用户本地的 Harness 目录中，桌面壳不读取其内容。

系统要求

| 项目 | 要求 |
| 操作系统 | Windows 10 / 11，x64 |
| WebView2 Runtime | Evergreen（Windows 11 自带；Windows 10 缺失时安装器会自动引导安装） |
| 管理员权限 | 不需要（每用户安装） |

下载与安装

所有安装包只从 GitHub Releases（唯一发布渠道）下载：

方式一：安装版（推荐）

1. 下载 DSH-desk__x64-setup.exe；
2. 双击安装（免管理员权限，可自选安装目录，缺省为当前用户的 Programs 目录）；
3. 从开始菜单或桌面快捷方式启动。

方式二：便携版

1. 下载 DSH-desk-portable--x64.zip；
2. 解压到任意目录（建议放在固定位置，如 D:\DSH-desk）；
3. 双击 dsh-desk.exe 即可运行。

与 CLI 版 dsh / 网页版共存

- 桌面端与网页版共享同一份用户数据：~/.dsh 下的 profile、会话、凭证、插件。
- 桌面端永远使用随包自带的引擎（自带 Node + @deepseek-ai/dsh），独立于命令行安装的 dsh。
- 建议桌面端与你常用的 dsh CLI 版本保持同一 rc 版本（当前 0.1.5-rc.1），避免版本交错导致 profile 依赖反复重装（详见 FAQ）。

升级与卸载

- 升级：
- 安装版：应用启动时自动检查新版本，发现新版本时侧边栏出现「下载更新」按钮（可关闭本次提示）；也可在设置区「桌面」分区 → 「检查更新」手动检查。下载完成后点「立即安装」——应用会自动退出、静默覆盖安装并自动重启；~/.dsh 中的 profile、会话、凭证原样保留，升级后首次启动自动刷新引擎版本。
- 便携版：应用内检查更新会提示前往 GitHub Releases 下载最新压缩包，解压后覆盖到原目录即可（便携版不做应用内自动更新、不做启动自动检查）。
- 卸载：通过「设置 → 应用 → 已安装的应用」卸载，或重跑安装包选择卸载；卸载不会删除 ~/.dsh 中的个人数据（如需彻底清理，手动删除该目录）。
- 便携版：删除解压目录即完成卸载。

插件安全模式

插件是按引擎版本工作的。引擎升级后，对不上新版本的插件会让 dsh 直接拒绝启动（fail-loud，不会静默降级），表现为应用停在错误页——安全模式就是这种情况下的自救入口。

它做什么：停用全部第三方插件层，只保留 Harness 安装层与桌面桥，让 dsh 先能起来。

| | 入口 |
| 进入 | 错误页 「以安全模式重启」；或托盘菜单 「进入插件安全模式」；或设置区「桌面」分区 →「插件安全模式」→「进入安全模式」 |
| 退出 | 托盘菜单 「退出插件安全模式」；或设置区「桌面」分区 →「退出安全模式」 |

- 不会卸载插件：它们仍留在 profile 的依赖里，只是不再加载；退出安全模式即恢复，不需要重新下载。
- 看得到元凶：安全模式生效后，设置区「桌面」分区会列出所有被停用的插件并给出「删除」按钮（两步确认）——这就是「哪个插件让 dsh 起不来」的答案，可以直接卸载。删除不需要重启引擎。
- 应用自带的插件（随装市场）由应用自己管版本，列表里会标注「删除后会在下次启动自动装回」。

建议顺序：先在安全模式里更新或删掉那个不兼容的插件，再退出安全模式——反过来先退出，等于用旧版本再启动一次，必然又失败。详见 FAQ。

隐私

- 零遥测：sidecar 强制 DSH_TELEMETRY_DISABLED=1；无统计、无上报、无广告。
- 本地日志：在 ~/.dsh/desktop/logs/（或 DSH_HOME 环境变量定义的路径），可通过托盘菜单或错误页「打开日志目录」直达；日志仅用于排查问题，可随时删除。

桌面特性速览

| 特性 | 说明 |
| 托盘菜单 | 显示/隐藏窗口、重启 DeepSeek Harness、进入/退出插件安全模式、打开日志目录、退出 |
| 全局快捷键 | 缺省 Ctrl+Alt+D 唤起/隐藏（改键：编辑 ~/.dsh/desktop/config.json 的 hotkey，重启应用生效；非法值自动回退缺省） |
| 系统通知 | DeepSeek Harness 收到审批请求时镜像通知，审批操作仍在窗口内完成 |
| 插件安全模式 | 插件与引擎不兼容导致 dsh 起不来时一键停用全部第三方插件；设置区列出问题插件并可直接删除 |
| 开机自启 | 设置区「桌面」分区开关，默认关 |
| 窗口记忆 | 尺寸/位置自动记忆，下次启动恢复 |
| 单实例 | 二次启动自动聚焦已有窗口 |

相关链接

- 上游项目：DeepSeek Harness（MIT）
- 常见问题：docs/FAQ.md
- windows系统功能桥接插件：packages/dsh-desk-bridge
- 开源许可：LICENSE（MIT）