bruc3van/dsh-desktop
一款主打安全且更尊重开发者的第三方 DSH 桌面客户端。官方 Web UI ，长任务常驻托盘，支持通知推送；内置安全市场，600+精选插件支持先审查、再安装。
安装Install
dsh plugin --profile web add github:bruc3van/dsh-desktop把 bruc3van/dsh-desktop 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
DSH Desktop
中文 | English
一款主打安全且更尊重开发者的第三方 DSH 桌面客户端。官方 Web UI ，长任务常驻托盘，支持通知推送；内置安全市场，600+精选插件支持先审查、再安装。
DSH Desktop 是一个独立的 DeepSeek Harness（dsh）Electron 客户端。窗口里呈现的是官方 Web UI 本体——不是仿制版，官方产品什么样，窗口里就是什么样；而真正的工程投入都在窗口之外：关闭窗口任务照跑、托盘常驻随点随开、Agent 跑在经过治理的执行环境里、插件安装走「先审查、再安装」的内置市场、连接与更新链路逐层加固。
[!IMPORTANT] 这是社区维护的非官方第三方项目。 本项目并非 DeepSeek 官方产品，不由 DeepSeek 开发、发布、背书或提供支持，也不代表 DeepSeek 的立场。
DeepSeek、DeepSeek Harness、dsh及相关名称、标识和商标归其各自权利人所有。桌面客户端的问题请提交到本仓库，不要联系 DeepSeek 官方支持。
发布安装包内置固定版本的官方 @deepseek-ai/dsh 运行时；普通用户无需另外安装 Node.js、pnpm 或 dsh CLI。桌面外壳、安装包、连接增强与发布签名均由本项目独立负责，不属于官方运行时的一部分。桌面客户端与官方 dsh 使用各自独立的版本号；应用的连接设置页会同时显示两个版本号，便于排查兼容问题。
为什么值得使用
先说清楚我们为什么这样做。Harness 的使用形态正在从「对话」变成「委派长任务」，而长任务的痛点全在窗口之外：任务跑着的时候不敢关标签页、关掉终端服务就停、Agent 的执行环境里找不到 node 和你 shell 里配好的工具、一个有文件读写权限的进程更新链路却裸奔。界面本身反而是最不需要重做的部分——官方 Web UI 一直在快速演进，用户要的正是它原封不动。
因此本项目把界面完整交还给官方，把全部工程投入放在窗口之外：常驻与长任务、Agent 执行环境、内置安全市场、安全加固、连接与更新。 这样做的好处是天然成立的：
| 用户需要什么 | 我们的做法 |
|---|---|
| 长任务不被终端和浏览器标签页绑架 | 关闭窗口不退出应用，服务继续后台运行；托盘常驻，随点随开 |
| Agent 要跑在你自己的环境里 | 优先复用你的实例 / PATH 上的 dsh / npx 缓存包；macOS 对齐登录 shell 的 PATH；node 始终可用 |
| 安全与隐私是底线 | 小边界 + 逐层加固：只用公开接口；更新链路防劫持；权限最小化 |
| 装插件之前想知道它安不安全 | 内置安全市场：目录每日自动采集 + 人工精选，安装前先由 Agent 审查代码 |
| Harness 的全部能力，一个都不能少 | 窗口里就是官方 Web UI 本体，不用重写界面 |
| 官方新功能要当天可用 | 跟进速度与自己的发版解耦：智能模式复用你已有的最新 dsh；内置运行时只是回退 |
| 装好就能用，不折腾环境 | 安装包自带官方运行时：不用装 Node.js、不用敲命令，双击即用 |
| 工作要在终端与桌面之间延续 | 智能模式与 CLI、浏览器共享 ~/.dsh；固定地址模式连接你自行维护的 Web UI 地址 |
这些落到产品上：
- 长任务常驻桌面。 关闭窗口不等于中断任务：应用驻留在托盘 / 菜单栏，Harness 服务继续在后台运行，随点随开；本地服务意外退出有受控重启，系统唤醒或长时间后台导致页面异常时会在确认服务可达后自动恢复。终端窗口和浏览器标签页给不了这层保障。
- Agent 执行环境经过工程治理。 Agent 本质是在你电脑上执行命令的进程，它的环境值得被认真对待：优先复用你正在跑的实例与 PATH 上的
dsh，Agent 跑在你自己的完整 shell 环境里；内置运行时下没装过这些工具的用户也能执行node、dsh和pnpm；ELECTRON_RUN_AS_NODE不会泄漏给 Agent（否则code等 Electron 工具会启动失败）；从 Finder/Dock 启动也能找到 Homebrew、~/.local/bin和写在~/.zshrc里的工具。详见内置运行时下的 Agent 执行环境。 - 安全是身份，不是特性列表里的一条。 一个能读写你文件的应用，值得用最保守的方式分发：客户端只用公开的
dsh web接口，不碰官方仓库内部；窗口开沙箱、关 Node 集成、导航锁在官方源站；打包后更新源与数据目录禁止被环境变量劫持；应用内更新下载后先校验 SHA-256 再安装；本机可信 Web UI 放行通知、剪贴板、全屏、媒体与用户主动选择的文件，远程地址保持更窄权限；外链一律交给系统浏览器。详见安全与隐私。 - 安全市场：先审查、再安装。 随安装包发布的内置市场默认关闭、开启后才联网；市场目录来自数据来源仓库的每日自动采集 + 人工精选，「安全安装」不替你执行任何命令，而是把审查提示词交给 Agent 先读代码、确认干净后再用官方命令安装。详见内置安全市场。
- 官方发版，当天就能用上。 窗口加载的是官方 Web UI 本体，不是仿制版。官方界面加功能、改交互，官方文档、教程和快捷键全部对得上，不会出现「教程里有的界面你找不到」；官方一发版，你升级自己已有的 dsh（或等应用内更新推送内置运行时），桌面端零改动、零等待。
- 双击就能用，不用懂命令行。 安装包自带官方运行时，不需要安装 Node.js、pnpm，也不需要敲任何命令；首次启动填一个 API Key 就能开始对话。对小白用户来说这就是全部；懂命令行的话，智能模式、固定地址这些进阶玩法也都在手边。
- 智能模式：复用你正在跑的实例。 依次探测：
127.0.0.1:3080上的官方实例（含~/.dsh/profiles/web/cordis.patch.yml里配置的其他端口）→ PATH 上的dsh→ npx 缓存 → 内置运行时。浏览器、CLI 与桌面端共享同一个 Harness 进程，会话状态实时同步。 - 固定地址：连接你自行维护的 Web UI 地址。 填地址直连，客户端不启动任何运行时；运行时版本、插件与环境完全由你掌控。官方 dsh 目前只面向本机使用——默认监听
127.0.0.1，暴露到网络的0.0.0.0绑定会被明确拒绝（会带来远程代码执行风险），远程或容器内实例并非官方支持场景。 - 运行时状态透明。 五种状态精确区分「谁启动了运行时」（复用你的 / 内置 / npx 缓存 / 本机安装 / 固定地址），并同时显示桌面端与内置 dsh 版本号，排障不用猜。
- 发布流水线自检。 空 PATH 打包冒烟（产物必须真的在用内置运行时）、更新链路夹具、运行环境隔离检查、Win32 选择器补丁、真实请求 e2e——一组门禁脚本拦住「能构建但不能用」的产物。详见开发指南。
快速开始
下载安装
从 GitHub Releases 下载适合当前系统的安装包并启动即可。发布版内置官方 dsh 运行时，不依赖开发环境，也不会在首次启动时执行 npm 安装。
当前安装包尚未经过正式的开发者签名认证，首次打开时系统可能会弹出提示，按下方说明操作一次即可正常使用。
首次打开被系统拦截时
macOS：把应用拖入「应用程序」后双击打开。系统会提示无法打开，去「系统设置 → 隐私与安全性」，在「安全性」区域点击「仍要打开」，输入密码即可。
极少数情况下如果提示「已损坏，无法打开」、且系统设置里没有「仍要打开」按钮，打开「终端」执行以下命令后再双击打开应用：
xattr -dr com.apple.quarantine "/Applications/DSH Desktop.app"Windows：如果 Microsoft Defender SmartScreen 弹出提示，点击「更多信息」，再点击「仍要运行」即可。
开始第一次对话
- 首次启动时，在「添加一个 API Key 开始使用」引导中填写密钥；也可以选择「稍后配置」，之后从「设置 → 模型 → DeepSeek」完成。
- 还没有 Key 时，点击输入框下方的「前往 DeepSeek 开放平台创建」，系统浏览器会打开 https://platform.deepseek.com/api_keys。该链接是本项目的桌面增强；API 账户、余额与费用由 DeepSeek 开放平台管理。
- 根据需要选择默认 Agent 预设或模型。
- 若任务需要读写文件，先添加一个项目文件夹；也可以直接新建会话。
- 描述希望 Agent 完成的结果，然后发送消息。
[!TIP] 全新数据目录下，官方 Web UI 可能默认显示英文。可从 Settings → General → Language 切换为中文。
两种连接方式
客户端同时服务两类用户，两条路径都是一等公民：
- 内置运行时：为「装好就能用」准备。安装包自带固定版本的官方运行时，不需要 Node.js、pnpm 或
dshCLI，双击即可开始对话。 - 连接已有的完整服务：为专业开发准备。你在终端里用自己的 Node 环境跑
dsh web，桌面端只作为窗口连上去，运行时版本、插件与环境完全由你掌控。官方 dsh 目前只面向本机使用（默认监听127.0.0.1，暴露到网络的0.0.0.0绑定会被拒绝），远程机器或容器内的实例不在官方支持范围内。
| 模式 | 适合场景 | 实际行为 |
|---|---|---|
| 智能模式（默认） | 大多数本机用户 | 依次尝试：复用 127.0.0.1:3080 上的官方实例 → PATH 上的 dsh → npx 缓存中的官方包 → 内置运行时。连接设置里可单独关闭其中任何一种。 |
| 自定义 | 自行维护的 Web UI 实例（官方 dsh 目前只面向本机使用） | 直接连接你填写的 Web UI 地址，不启动任何运行时。 |
在智能模式下，只要你已经在终端里跑着官方 Web UI，桌面端就会直接复用它——这正是开发者路径：会话与桌面端实时共享，而 Agent 跑在你自己的完整 shell 环境里。
智能模式只使用你机器上已经存在的东西——PATH 上的 dsh、npx 缓存过的官方包——不联网、不下载、也不替你安装 Node.js。官方 dsh web 的端口除 --port 外也可写在 web profile 补丁层（~/.dsh/profiles/web/cordis.patch.yml）里，客户端会读取并一并探测，不会因为实例挪了端口就在旁边另起一个 harness。连接设置还可以为客户端自己启动的 dsh 固定端口（默认随机 --port 0，不占 3080；保存后立刻重新拉起；被占用时不会换口）。npx 缓存里的官方包版本低于内置运行时时，连接设置里会说明（缓存仍优先使用——那是你上次 npx @deepseek-ai/dsh 留下的，重新跑一次即可刷新）。客户端启动的都是纯后台服务进程，rc.8 及以上带 --no-open，退出桌面端时一并关闭；选中的运行时启动失败会按仍启用的来源依次回退（默认最后是内置运行时）。四种来源都可以在连接设置里用多选按钮单独关闭，方便测试时固定到某一种；缺省全部开启，至少保留一种。本机官方实例仍在跑、而智能模式又不会复用它时，客户端不会另起本机已安装 / npx / 内置运行时，也不会替你结束那个进程——需要先在终端里退出。页面完全加载不出来时，启动界面会直接给出**「Web UI 连接…」**按钮。运行时选择顺序的完整细节见开发指南。
连接设置把「智能」和「自定义」分成两种方式：智能模式下只显示四个来源，点选立即生效；选「自定义」后才会出现地址栏，右侧是「保存并连接」。点「智能」会立即切回，已填地址会保留。
连接状态按谁启动了这个运行时来描述，避免「本地」和「内置」混用：
| 状态 | 含义 |
|---|---|
| 本机已运行 | 复用你自己在终端里跑起来的实例（默认 127.0.0.1:3080） |
| 客户端启动·客户端内置 | 客户端用安装包自带的运行时起的后台子进程 |
| 客户端启动·npx 缓存 | 客户端用 npx 缓存里那份官方包起的后台子进程 |
| 客户端启动·本机已安装 | 客户端用 PATH 上你自己装的 dsh 起的后台子进程 |
| 自定义地址 | 直连你填写的地址，客户端不启动任何运行时 |
填入
127.0.0.1:3080（即默认探测地址）并点击「保存并连接」时，客户端仍保持智能模式——智能模式本来就优先使用它，并且能在该实例停止时自动回落。
选「智能」即可恢复智能模式。连接设置位于官方设置弹窗的「桌面设置」。
[!TIP] 连接本机之外的实例目前不在官方支持范围内；若你确实这样做（例如自行通过 SSH 隧道转发），请使用可信网络，并在条件允许时使用 HTTPS。这里填写的是客户端直连地址，本项目不会通过第三方中转你的请求。
安全与隐私
桌面外壳和 Harness 运行时各自管理不同的数据：
| 数据 | 默认位置 | 管理方 |
|---|---|---|
| 会话、凭据、模型配置与其他官方 Harness 状态 | ~/.dsh |
官方 dsh 运行时 |
| 桌面端连接偏好 | ~/.dsh-desktop/settings.json |
桌面客户端 |
可以分别通过 DSH_HOME 和 DSH_DESKTOP_HOME 覆盖这两个目录（仅开发/未打包运行时生效；打包后见下文「更新链路防劫持」）。
客户端在安全上采取小边界 + 逐层加固的策略：
- 边界小：客户端只使用公开的
dsh webCLI 和/api协议，不修改官方仓库，也不依赖 Harness 私有内部包。 - 窗口加固：Electron 开启上下文隔离与沙箱、关闭 Node 集成，将页面导航限制在当前 Web UI 源站，外部链接交给系统浏览器打开。
- 更新链路防劫持：打包环境下，更新源地址与 GitHub API 地址、数据目录（
DSH_HOME、DSH_DESKTOP_HOME）及连接探测开关均禁止被环境变量覆盖（唯一的调试后门是DSH_DESKTOP_ALLOW_UNSAFE=1，只在刻意排查打包产物时使用，请勿在日常环境常驻）；校验更新清单中的安装包文件名，防止路径穿越写出到下载目录之外。 - 按来源分层授权：客户端管理的本机 Web UI 可使用通知、剪贴板读写、全屏、麦克风/摄像头以及用户主动触发的文件选择，避免官方 UI 与插件能力被桌面外壳误伤；自定义远程地址只放行剪贴板写入与通知。跨域子框架、USB/HID/串口、定位、屏幕捕获和存储权限升级默认拒绝；页面内越权导航与新窗口跳转仍会被拦截。
- 系统通知的平台边界：Windows 安装版使用与安装快捷方式一致的 AppUserModelID；源码开发态按 Electron 要求使用当前
electron.exe身份，Windows 仍可能要求先把该可执行文件固定到开始菜单以注册 Toast。Linux 保留 Chromium 的原生桌面通知。macOS 的系统通知中心要求有效代码签名，因此当前临时签名包会自动把同一套 Web Notification 降级为 Dock 数字角标、Dock 弹跳和可点击的应用内提醒；点击仍回到对应会话，窗口回到前台或提醒关闭后清除 Dock 提醒。 - 插件先审查、再安装：内置安全市场默认关闭、开启后才联网；「安全安装」不执行任何安装命令，而是把审查提示词交给 Agent，确认干净后再由你决定是否用官方命令安装；市场接入客户端启动的任一运行时（内置、你自己装的 dsh、npx 缓存都行），插件按普通插件的方式复制进 profile，绝不把闭包里的那份交给另一份运行时。详见内置安全市场。
使用本客户端仍需遵守 DeepSeek、模型提供方和所连接服务各自的条款与隐私政策。API Key、模型请求、费用、生成内容以及 Agent 对本机文件或命令的操作由用户和对应服务负责。本软件按 MIT 许可证「原样」提供，不承诺适用于特定用途，也不对数据丢失、服务中断、模型输出或第三方费用承担保证责任；法律另有强制规定的除外。
桌面端行为
- 关闭主窗口后，应用继续驻留在系统托盘或 macOS 菜单栏。
- 点击托盘图标可以重新打开主窗口。
- 可通过托盘菜单，或 macOS 的应用菜单 /
Cmd+Q完全退出。Windows、Linux 窗口内不显示菜单栏。 - 托盘菜单里的「重启客户端」会连同本地运行时一起重启，适合装完需要重启才生效的插件：客户端自己启动的运行时会先停止再重新拉起；接管的遗留运行时若能确认归属也会一并停止，而你在终端里自己跑的
dsh web不会被动到（这种情况下重启的只是客户端外壳）。若随后把同一地址固定为连接模式，重启时也不会动它：那已经是保存的地址，不再算接管来的智能模式实例。 - 发布版启动约 4 秒后会检查 GitHub Releases 上的新版本（12 小时内不重复自动检查）。也可在「设置 → 通用设置 → 应用更新」、托盘菜单或 macOS 应用菜单中手动检查；确认后下载安装包、校验 SHA-256 并启动安装程序，本地运行时在下载与校验通过之后、启动安装器之前才停止——下载或校验失败、安装器最终没能启动时，运行时都会保住或自动恢复。开发态默认不自动检查。
- 同一个
DSH_HOME下绝不同时跑两个写入者：客户端把自己启动的运行时记录在DSH_HOME下，下次启动优先接管仍在服务的遗留进程（复用同一个 harness，会话照常共享），接管不了才清理后重启；遗留进程既连不上也结束不掉时，客户端会拒绝启动并说明原因，而不是在它旁边再写一份——两个 harness 同时写同一份会话日志会造成永久损坏。 - 智能模式复用的
127.0.0.1:3080官方实例失联时，客户端会自动改用自己启动的运行时；固定地址连接失败不会擅自改用其他服务，但报错页会提供「切换到智能模式」出口。 - 本地 Web UI 意外退出时，客户端只会进行有限次数的重启，不会无限循环。
- 系统唤醒或长时间后台运行后若页面异常空白，客户端会在确认 Web UI 可达后自动重新加载。
- macOS 发布版会在启动本地服务前读取一次用户 shell 的
PATH（先尝试交互式登录 shell，最长 3 秒；失败再退回非交互登录 shell，最长 2 秒），只合并绝对路径目录，使 Agent 从 Finder/Dock 启动时仍能找到 Homebrew、~/.local/bin以及写在~/.zshrc里的工具目录。
内置运行时下的 Agent 执行环境
使用内置运行时时，Agent 的能力与官方 dsh 一致（同一份运行时、同一个 ~/.dsh、同样的系统级沙箱机制），执行环境按以下方式对齐到「你在终端里跑 dsh」的效果：
node、dsh、pnpm始终可用：发布版把它们发布到~/.dsh-desktop/bin，并追加到运行时的PATH末尾。没装过这些工具的用户，Agent 也能执行node script.js和市场用的dsh plugin add；装过的用户仍优先使用自己的版本。dsh走默认拒绝的网关，不会再起一个 web profile。该目录不提供npm/npx——需要它们的场景（例如用npx启动 MCP 服务）请自行安装 Node.js，或改用固定地址模式。nodeshim 依靠设置ELECTRON_RUN_AS_NODE让 Electron 以 Node 方式运行，因此经它启动的 node 进程及其子进程会带上该变量：如果你的 node 脚本里还要再启动基于 Electron 的工具，需自行清除该变量，或安装一份真正的 Node.js。- 不污染 Agent 的环境：内置运行时依靠
ELECTRON_RUN_AS_NODE跑在 Electron 的 Node 上，这是启动方式的实现细节。客户端会在运行时启动后将其从环境中摘除，只在运行时自身需要重新拉起 Node 子进程时（原生文件夹选择器、Windows ACL 沙箱执行器）临时补回，因此 Agent 执行的命令不会继承它——否则 Agent 运行任何基于 Electron 的工具（如code）都会失败。 - 文件权限：应用未启用 App Sandbox，Agent 的文件读写权限与普通用户进程相同。macOS 首次访问桌面、文稿、下载等受保护目录时会以本应用名义询问，授权按应用记账（终端里已有的授权不会自动带过来）；系统弹窗会说明用途。
- 版本固定：内置运行时版本随安装包发布，不能单独升级。需要紧跟官方最新版本时，请使用自定义地址连接自行维护的运行时——这正是「官方发版，当天就能用上」的开发者路径。
内置安全市场
客户端把随安装包发布的安全市场（dsh-desktop-safe-market）按官方 in-box bundle 的方式接入当前 profile：把插件复制到 <DSH_HOME>/profiles/node_modules、并往 profile 的 dsh.profile.bundles 里加一项——不写依赖、不改锁文件、不跑 pnpm、不联网；升级插件即升级客户端。客户端启动的任何一种运行时都能用上：内置的、你装在 PATH 上的 dsh、以及 npx @deepseek-ai/dsh web 留下的缓存。插件复制进 profile 而不是软链到闭包，它的 @deepseek-ai/* 依赖便向上解析到正在服务的那份运行时——和你用 dsh plugin add 装的插件走同一条路。设置里随之出现「安全市场」导航项，分两页：「插件」页上半是已安装面板（查看、停用/启用、卸载当前 profile 通过包安装的插件，也包括装了却没在加载的），下半是社区市场；「技能」页列出当前会话实际能解析到的技能。固定地址连接时客户端会撤回条目——那种运行时不由客户端启动（甚至可能不在本机），无从知道改动何时生效。复用本机 3080 上已在运行的实例则会保守地重新接入（只恢复名字，不换插件目录）：该实例正在服务这个 profile；它停止后客户端回落，并在下一次由自己启动运行时重新按版本门禁接入。
不想要它：连接设置里有「安全市场」开关，关掉就会立即移除市场插件，之后启动也不会再装回。就算客户端已经卸载了，市场自己的「已安装」面板也能把它卸载掉——官方 dsh plugin 命令不管这份插件，所以面板是最后的入口。
市场有三个刻意的设计：
- 目录每日自动采集、人工精选。 市场只读数据来源仓库 awesome-dsh-plugin 每日快照管线发布的
market.json：上游每天自动爬取带dsh-plugin标签的仓库，要求有简介、剔除已归档/停用的项目，再套用curated.json人工排除名单；分类与排序做均衡发牌——每类先出最强、再出次强，而不是纯按 star 让两三个分类吃掉几乎所有席位。市场在 Host 侧逐行重新校验后才交给页面。装插件本质上是在自己机器上跑别人写的代码，这份目录把「有哪些插件」和「哪些至少过了第一道人工关」分开。 - 默认关闭，开启才联网。 市场关闭时不发起任何网络请求；开启后读取一次目录快照并持久化（
$DSH_HOME/storages/safe_market.json），之后走 ETag 条件请求，连不上 GitHub 时继续用上次的目录。一个装上就开始联网的插件等于替你做了决定，这个开关把决定还给你。 - 先审查、再安装。 「安全安装」不替你执行任何安装命令：它打开一个新会话、把一段安全审查提示词填入输入框（不发送），由你按回车让 Agent 实际读仓库代码——重点检查凭据/token 访问、向第三方外传数据、远程代码执行、
postinstall等安装脚本、无对应源码的混淆文件，以及权限是否远超其声称的功能；发现可疑处必须停下来说清原因并询问你。确认干净后，Agent 才会用官方命令dsh plugin --profile web add安装。审查与安装因此绑在一起、绕不过去；发不发送由你决定，收录不代表安全背书——请自己看过再决定。
目录里已经装过的插件会标出「已安装 vX.Y.Z」，按钮也随之变成「安全升级」——走的是同一套「先审查、再动手」的流程，只是提示词第一步先让 Agent 确认上游到底有没有新版本，没有就原样不动。已装插件的日常管理则在同一页顶部的已安装面板：
卸载不是从列表里划掉：它先停用插件，再在这个 profile 里执行与官方 dsh plugin remove 相同的移除，锁文件和 node_modules 一并清掉。装成了依赖、却没写进 bundles 因而当前不会加载的插件，面板也会单独列出并标明——你机器上装过什么，这里就看得见什么，也能就地卸掉。
「技能」页列出当前会话实际能解析到的技能，并标出每个技能的来源与调用策略。它按会话寻址，因为技能发现是随各个 Agent 预设分层的——从插件根上下文读只能看到全局层，会对着一堆技能报告「没有技能」。
桌面端对这次接入与其他工程投入同样谨慎：接入失败可自愈——插件在加载期抛错会让整棵插件树启动失败、共用同一 profile 的 CLI 也会跟着起不来，因此失败即撤回并在本会话不再重试；插件目录缺失、或 profiles/node_modules 上已有非软链目录时不写 bundles，绝不写坏你的 profile；你自己装过该插件（作为 profile 依赖）且版本不低于内置时，客户端完全不插手；更旧的覆盖会改用闭包那份。运行时比客户端自带的 dsh 更旧时不接入——插件按自带的那版编译，更旧的运行时可能缺它需要的导出；更新的一律放行。插件自身还有一道自保：它的入口只经受保护的动态载入触达真正的实现，所以万一遇上不兼容的运行时，损失的只是市场本身。市场的完整设计（配置项、目录协议、安全边界与已知限制）见其仓库。
常见问题
Q：这是浏览器套壳，还是用 SDK 重新实现？
都不是：窗口加载的是官方 Web UI 本体，但客户端并不是「打开一个网页」——运行时启动与复用、连接管理、窗口与导航加固、托盘与应用内更新都做在外壳层，仓库不维护第二套产品界面（取舍与备选方案见架构文档）。Harness 生态里的桌面客户端大致分三条路线，本项目选择第三条：
| 路线 | 做法 | 结构性的代价 |
|---|---|---|
| ① 自研工作台界面（如 RongleCat/deepseek-app） | Harness 引擎跑在应用内，界面是自研的三栏工作台，不使用官方 Web UI | 官方产品表面的每个新功能都要在自己的界面里重新实现一遍 |
| ② 打包封装（如 anywhere-labs/deepseek-harness-desktop） | 基于官方仓库构建桌面端，负责服务生命周期、窗口与托盘集成、界面适配与安装包发布 | 官方更新要先合并上游、重新发版才能跟进 |
| ③ 原装直连（本项目） | 窗口直接加载官方 Web UI，工程投入放在常驻与长任务、Agent 执行环境、安全与连接上 | 不做自研界面，桌面增强以官方界面能承载的为界 |
Q：对用户来说，主要价值是什么？
- Agent 常驻在你的桌面上：关闭窗口不退出应用、托盘常驻随点随开，长任务不被终端和浏览器标签页绑架；Agent 的执行环境经过治理——复用你自己的 shell 环境与 PATH，内置运行时下
node始终可用； - 安全可信的运行方式：只用公开接口、窗口沙箱与导航锁定、更新链路防劫持加 SHA-256 校验、权限最小化——一个有文件读写权限的进程，值得这样对待；
- 官方体验，装好就能用：窗口就是官方 Web UI 本体，官方文档、教程与快捷键全部对得上；安装包内置官方运行时，不用装 Node.js、pnpm 或
dshCLI；智能模式复用你正在跑的实例并共享~/.dsh会话，固定地址模式直连你自行维护的地址。
Q：和直接用浏览器访问 Web UI 有什么区别？除了不用装 Node.js 之外
官方浏览器用法是装好 Node.js 后执行 npx @deepseek-ai/dsh web，再手动打开它给出的地址——关掉这个终端，服务就停了。客户端把这件事工程化：关闭窗口不退出应用，托盘常驻随时唤回，长任务不再依赖一个不敢关的终端；安装包自带运行时，双击即用；智能模式先探测你已在跑的实例，没有时依次用 PATH 上的 dsh、npx 缓存包在后台启动，兜底才用内置运行时；另有浏览器没有的应用内更新、连接来源与版本透明展示。
Q：为什么强调「官方发版当天就能用上」？
自研界面或魔改源码的客户端，官方更新后要等重新实现或合并上游、重新发版才能跟进；本项目的窗口直接加载官方 Web UI，官方界面怎么改，窗口里就是什么样。就版本更新路径而言：智能模式复用你已更新的 dsh、固定地址直连你自维护的最新实例，都是官方发版当天可用；内置运行时固定为发布时锁定的官方版本，随应用内更新推送，会稍晚于官方发版。
Q：内置了插件市场吗？之后还有什么计划？
内置了：随安装包发布的安全市场，设置里叫「安全市场」。它按官方 in-box bundle 的方式接入当前 profile（复制进 profiles/node_modules 并写入 dsh.profile.bundles），客户端启动的任一运行时都能用上；市场默认关闭、开启后才联网；固定地址连接时会撤回（该运行时不由客户端启动）；复用本机已在运行的实例则会保守地重新接入（只恢复条目、不换插件目录）。目录的每日自动采集 + 人工精选、以及「先审查、再安装」的完整流程见内置安全市场。官方 Web UI 自身的能力（技能、插件、交互等）仍随官方发版直接出现在窗口里。桌面外壳自身的后续工作见开发指南与 TODO：macOS/Windows 正式签名与公证、OS Keychain、语音输入，以及内置运行时的独立更新通道、运行中实例的周期探测提示等。
参与开发
源码开发需要 Node.js ^22.19.0 || >=24.0.0 和 pnpm；不需要另外安装 dsh：
git clone https://github.com/bruc3van/dsh-desktop.git
cd dsh-desktop
pnpm install
pnpm run dev
构建与门禁脚本、运行时选择细节、版本发布流程与项目当前状态见开发指南；进程模型、信任边界和设计取舍见桌面客户端架构。欢迎提交贡献与问题反馈，尤其是 Windows 使用、固定地址连接和打包方面的反馈。
相关项目
作者维护
- awesome-dsh-plugin — 用 30 秒为你的 DeepSeek Harness（DSH）找到合适的插件。这不是又一个仓库清单：GitHub 上所有打着
dsh-plugin标签的仓库由脚本每天自动抓取，再经人工逐个核实——真插件进目录，蹭热度的进黑名单，每条剔除理由公开可查；并告诉你每个插件适合谁、从哪里开始。本客户端内置安全市场的目录数据即来源于它，详见内置安全市场。 - dsh-desktop-safe-market — 先审查再安装的 DSH 市场（review-before-install DSH marketplace）。本客户端随安装包内置的「安全市场」由它实现：目录每日自动采集 + 人工精选，「安全安装」把审查提示词交给 Agent、确认干净后再用官方命令安装。配置项、目录协议与已知限制见其仓库。
官方仓库
- deepseek-harness — DeepSeek Harness: Everything is a Plugin. 官方
dsh与 Web UI 的上游项目：本客户端窗口里加载的正是官方 Web UI，随安装包分发的运行时即官方@deepseek-ai/dsh——本项目是它的非官方第三方桌面客户端。
许可证
MIT 许可证仅适用于本仓库自行维护的代码和素材。随安装包分发的官方 @deepseek-ai/dsh 及其他第三方依赖分别适用其自身许可证。本项目名称中的 “DSH” 取自 DeepSeek Harness，仅用于说明兼容对象，不表示官方关系。
相关推荐Related
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
Tencent/WeKnora
Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-m…
- Nagi-ovo/voyager Enhancement suite for Gemini, AI Studio, Claude & ChatGPT — plus a prompt manager for any web UI, DeepSeek Harness inclu…
-
anywhere-labs/deepseek-harness-desktop
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。
-
EverMind-AI/EverOS
One portable memory layer for every AI agent: local-first, Markdown-native, user-owned, and self-evolving across apps, t…
-
freestylefly/awesome-gpt-image-2
Prompt as Code | GPT-Image2 工业级提示词引擎与模板库，470+ 个案例逆向工程，20+ 套工业级模板，并提炼出Skills，持续更新中