桌面插件集成版 vibeinging/dsh-desktop

DSH Desktop

DSH Desktop 插件集成版（DSH Desktop Bundle Edition）—— 把官方 DSH Web、社区插件和桌面能力装进一个开箱即用的应用。
对话、文件、Git、终端、任务、Worktree 与插件市场，都运行在同一个 DSH Profile 中。

DSH Desktop（插件集成版 / Bundle Edition）是一个社区维护的桌面发行版。它直接运行官方 DeepSeek Harness npm 运行时与官方 dsh-web-app，并预装一组经过固定和验证的社区 Bundle。你不需要先搭环境、找插件或维护另一套插件状态，打开应用即可从同一个 Profile 开始工作。

官网 · 下载最新版 · 手机远程 · 开始使用 · 安装插件

下载

| 平台 | 安装方式 | 状态 |
| macOS Apple Silicon | 下载 .dmg，拖入“应用程序” | Developer ID 签名并完成 Apple 公证 |
| Windows x64 | 下载 .exe，选择安装范围与客户端目录 | 以当前 Release 页面提供的产物为准 |
| Linux x64 | AppImage | 测试邀请阶段，见 Linux 支持跟踪 Issue #19 |
| macOS Intel | 暂无正式安装包 | 可以从源码运行 |

各平台直链与文件大小见官网下载页；首跑常见问题（Gatekeeper、SmartScreen、API Key、国内下载）见官网 FAQ。

客户端安装目录只保存应用程序。Profile、插件、Session 和其他 DSH 数据由独立的数据目录管理；更换客户端安装位置不会迁移或删除这些数据。

打开就能用

官方对话与 Agent 主窗口就是官方 DSH Web。Session、Agent、Tool、Skill、MCP、设置和历史由 DSH 自己管理，没有第二套 Chat 页面。

Better Sidebar 工作台内置文件树、代码与 Markdown 编辑、Git、终端、网页与扩展 Tab。0.18.0-alpha.0 对接当前 alpha SDK，并保留多仓库、Worktree、Vue 文件和本地 Markdown 图片等能力。

插件市场在官方设置页里发现、安装、更新、停用和卸载插件。界面、命令行和应用重启都以同一个 Profile 为准。

任务、附件与 Worktree 任务看板、文件和文件夹附件、Git Worktree、项目工具、Office 与结构化结果都由独立 Bundle 提供，可以按需组合。

桌面 Host 与恢复应用负责窗口、原生文件选择、更新、启动和恢复。正式安装包通过右上角按钮提示更新，悬停可看更新日志，点击后才下载、预检 Profile 并安装；Profile 或 Client 出错时进入恢复页。

可复现的默认环境新 Profile 从随包固定产物离线初始化；普通启动不重写已有 Profile，也不会把用户卸载的插件悄悄装回来。

手机远程登录并启用当前电脑后，可以从 Android、Remote Web 或另一台 Desktop 继续同一 Workspace 和 Session。Host 只建立出站连接，不开放公网监听端口。

明确的服务边界当前账号、设备目录、信令和中继由第三方服务提供；连接方式、安全边界和停用方法见手机远程说明。

界面

对话、问题卡片与审批

官方 DSH Web 会话

对话、工具审批、问题卡片、排队消息和历史回放都留在官方 Session 中。

官方设置里的插件市场

官方 Web 设置中的插件市场

插件市场使用官方设置 Slot，不替换设置页面，也不另建插件数据库。

Git Worktree 工作区

官方 Web 中的 Git Worktree

从当前 Session 的工作目录创建隔离 Worktree，并为新工作区建立官方 Session。

默认内置：手机远程

新 Profile 默认包含精确固定的 ds-harness-remote@0.4.1，与 DSH 0.1.5-rc.1 试用线一起随包提供。打开侧栏 Remote，登录并为当前电脑启用远程访问后，就可以从 Remote Web、Android App 或另一台 Desktop 打开同一 Host 的 Workspace 和 Session，继续对话、发送图片和处理权限请求。

- 网络边界：Host 只建立出站连接，不开放公网监听端口；Remote 依次尝试 LAN、P2P、TURN 与 Relay，所有路径都承载 Noise IK 加密后的业务流量。
- 账号与数据：当前默认连接 dsh.r2049.cn 的第三方账号、设备目录、信令和中继服务；设备身份与凭据保存在 DSH_HOME。未登录并启用当前电脑时不会提供远程访问。
- 已授权设备：通过固定 Harness API 白名单控制当前 Harness，Agent 仍可按原权限运行工具；不开放直接 Shell、PTY 或通用文件 RPC。
- 卸载：升级后的现有 Profile 会补充一次这个默认 Bundle；如果你停用或卸载，应用更新不会再次恢复。

dsh plugin --profile web remove ds-harness-remote

该项目尚未提供受支持的自建 Server，独立密码安全审查、真实双机跨网和长期稳定性验证仍未完成；不需要远程能力时可以直接卸载。桌面发行包对该固定 tarball 应用带 SHA-256 校验的兼容投影，不修改官方 DSH 或上游仓库源码。连接方式、安全边界与停用方法也见手机远程说明。

手机远程能力来自 liguobao 开源的 ds-harness-remote，本项目固定其 0.4.1 版本默认内置。特别感谢原作者开源这一 Bundle，并经由 DeepSeek Harness Remote Web 为社区提供当前可用的远程入口与配套服务，让 DSH Desktop 用户可以从手机或浏览器继续工作。

默认内置：会话窗口团队

新 Profile 默认包含 @vibeinging/dsh-session-teams@0.1.1。它让 DSH 会话窗口之间可以直接协作：

- 给另一个窗口发消息：告诉当前窗口"把这件事交给 窗口名"，消息会以真实 DSH 消息的形式出现在目标窗口——目标可见、可持久、可点击回溯到源。
- 让一个窗口当队长：创建一组带角色的窗口，给它们分配任务与依赖，成员完成后以真实消息回报结果，队长用自然语言调整任务而不用记 ID。

所有团队与窗口状态通过官方 Session API 读写当前 Profile，不建立外部网络连接。不需要时可以卸载：

dsh plugin --profile web remove @vibeinging/dsh-session-teams

为什么选择这条路线

| 你关心的事 | DSH Desktop 的做法 |
| 是否依赖私有前端 | 直接加载官方 Web 与 npm 运行时，不维护私有 Chat 分叉 |
| 社区插件能否直接使用 | 普通 UI、Tool 和工作流继续使用官方 Bundle、Service 与 Slot |
| 插件状态会不会错乱 | 官方 Profile 是唯一权威；市场、设置和 CLI 操作同一份数据 |
| 默认插件是否可靠 | 固定版本、完整性、权限、依赖和许可证，并保留离线安装产物 |
| 原生能力是否过大 | 文件、窗口和 Browser Workspace 只通过按 Session 绑定的有限方法开放 |
| 启动会不会覆盖配置 | 已有 Profile 保持用户选择；失败时保留原 Profile 并进入恢复页 |
| 应用更新会不会改插件 | 更新前只读预检 Profile；不恢复用户已停用或卸载的 Bundle |

Electron 在这里是一层很薄的桌面 Host。真正的 Agent、会话和插件系统仍属于 DSH；项目自己的功能也尽量拆成 Bundle。这样，portable 插件可以同时安装到兼容的官方 Web 和 DSH Desktop，桌面专属能力才使用明确的 desktop-adapter。

开始使用

1. 从 Releases 下载适合的平台安装包。
2. 启动应用，选择一个工作目录或直接创建会话。
3. 在侧栏打开文件、Git 或终端；在输入框添加文件和文件夹。
4. 需要更多能力时，打开“设置 → 插件市场”。

模型凭据由 DSH 设置与本地环境管理。项目不会把 API Key 写入 README、截图或插件清单。

安装更多插件

普通用户直接使用“设置 → 插件市场”。插件市场会显示来源、版本、兼容性和权限；安装前仍应查看上游说明，市场可见不等于本项目已经审查或默认内置。

也可以使用官方 CLI 操作同一个 Profile：

dsh plugin --profile web add -w <package>@<exact-version> --save-exact --ignore-scripts
dsh plugin --profile web remove <package>

符合官方 DSH Bundle 与 dshClient 合同的插件，不需要专门为 DSH Desktop 重写。需要窗口、原生文件对话框或 Browser Workspace 的插件，则要显式使用 DSH Desktop 的窄 Host 合同；在其他宿主中缺少这些能力时应直接报告。

可选示例：皮肤中心

DSH Desktop 运行皮肤中心 Blue Fantasy 深色皮肤实拍

应用默认保持官方 Web 外观。想要个性化界面时，可从插件市场安装社区维护的皮肤中心（@linxin666/dsh-client-ui-skin-center）：数十款皮肤试穿即生效、不落盘可还原，官方外观随时切回。

dsh plugin --profile web add @linxin666/dsh-client-ui-skin-center

皮肤资产各自带有上游许可（部分为 CC BY-NC-SA 或含角色版权），因此皮肤中心不随应用默认内置，由用户在市场自行选择安装。

默认插件

新 Profile 默认包含 Better Sidebar、dshmarket、任务看板、附件输入、Git Worktree、手机远程、会话窗口团队，以及项目、Canvas、Office、结构化结果和模型继承等能力。所有可管理 Bundle 都能被停用或卸载。

查看新 Profile 默认安装的 16 个 Bundle

| 默认 Bundle | 类型 | 声明权限 | 官方管理方式 | 来源 |
| @vibeinging/dsh-work-product-host-ipc | desktop-adapter | dsh-work-parent-ipc、browser-workspace-host、file-dialog-host、window-host | 桌面基础服务，不提供卸载 | 本地包 |
| @vibeinging/dsh-desktop-profile-host | desktop-adapter | dsh-profile-filesystem、controlled-pnpm-runtime、dsh-cli-runtime | 桌面基础服务，不提供卸载 | 本地包 |
| @vibeinging/dsh-desktop-chrome | desktop-adapter | 无 Host 权限 | dsh plugin --profile web remove @vibeinging/dsh-desktop-chrome | 本地包 |
| @vibeinging/dsh-project-tools | desktop-adapter | product-host | dsh plugin --profile web remove @vibeinging/dsh-project-tools | 本地包 |
| @vibeinging/dsh-canvas-tools | desktop-adapter | product-host | dsh plugin --profile web remove @vibeinging/dsh-canvas-tools | 本地包 |
| @vibeinging/dsh-structured-ui-tools | desktop-adapter | product-host | dsh plugin --profile web remove @vibeinging/dsh-structured-ui-tools | 本地包 |
| @vibeinging/dsh-model-inheritance | portable | 无 Host 权限 | dsh plugin --profile web remove @vibeinging/dsh-model-inheritance | 本地包 |
| @vibeinging/dsh-product-bridge | desktop-adapter | product-host | dsh plugin --profile web remove @vibeinging/dsh-product-bridge | 本地包 |
| @vibeinging/dsh-office-tools | desktop-adapter | office-artifact-host | dsh plugin --profile web remove @vibeinging/dsh-office-tools | 本地包 |
| @vibeinging/dsh-client-ui-worktree | portable | 无 Host 权限 | dsh plugin --profile web remove @vibeinging/dsh-client-ui-worktree | 本地包 |
| @linxin666/dsh-client-ui-task-board | portable | 读取当前 DSH Session、Workspace 与完成历史、在 DSH_HOME 写入任务账本和执行记录、按用户操作或 Host cron 启动 DSH Session 任务、可选启动固定的跨平台防休眠 helper | dsh plugin --profile web remove @linxin666/dsh-client-ui-task-board | 上游仓库 |
| ds-harness-remote | portable | 连接 dsh.r2049.cn 的外部账号、设备目录、信令、TURN 与 Relay 服务、从同一账号下的 Web、Android 或另一台 Desktop 读取并控制当前 Harness 的 Workspace、Session、模型、权限、设置与凭据写入、在 DSH_HOME 保存长期 X25519 设备身份私钥和设备凭据、通过固定 Harness API 白名单运行远程请求；不开放直接 Shell、PTY 或通用文件 RPC，但 Harness Agent 仍可按原权限运行工具 | dsh plugin --profile web remove ds-harness-remote | 上游仓库 |
| dsh-multimedia-webui-input | portable | 读取用户主动选择的文件和文件夹、向当前 Session 工作区的 .dsh/tmp/attachments 写入附件、按用户二次确认清理带插件所有权标记的附件目录 | dsh plugin --profile web remove dsh-multimedia-webui-input | 上游仓库 |
| dsh-better-sidebar | portable | 读取、搜索、创建、修改和删除当前 Session 工作区文件、在当前 Session 工作区执行 Git 操作、启动和停止本地终端进程；模型终端工具默认关闭、打开用户输入的网页或外部编辑器，并接收用户主动上传的文件、用户开启后向模型注册 sidebar_open 工具，用于在当前会话侧栏打开工作区文件、文件夹或 HTTP(S) 页面；默认关闭 | dsh plugin --profile web remove dsh-better-sidebar | 上游仓库 |
| dshmarket | portable | 读取和修改当前 DSH Profile 的依赖、Bundle 顺序和启停状态、通过受控 pnpm 安装、更新和卸载用户确认的插件、访问插件目录、npm、GitHub 以及用户配置的 WebDAV 或 Gist、导出或导入包含 Profile 配置的备份 | dsh plugin --profile web remove dshmarket | 上游仓库 |
| @vibeinging/dsh-session-teams | portable | 跨当前 Profile 的可见会话窗口读取、路由并转发消息与任务（含子智能体接力）、通过官方 Session API 在 Profile 会话存储中写入团队、任务与可见窗口中继状态、按需创建顶层会话窗口，以当前工作区、模型与权限组合子智能体团队并执行调度 | dsh plugin --profile web remove @vibeinging/dsh-session-teams | 上游仓库 |

插件选择、权限和离线边界见插件市场选择与桌面接入。

从源码运行

需要 Node.js 24 或更高版本：

git clone https://github.com/vibeinging/dsh-desktop.git
cd dsh-desktop
npm install
npm run doctor
npm run dev:electron

本地构建 macOS Apple Silicon App：

npm run package:mac:dir
open "release/mac-arm64/DSH Desktop.app"

本地目录包用于开发；面向普通用户的签名安装包以 GitHub Release 为准。

数据与权限

- Profile、插件、Session 和本地运行数据默认保存在 ~/.dsh，可通过 DSH_DATA_ROOT 修改，与客户端安装目录无关；
- 官方 Web 没有产品 preload、Node 权限或通用 IPC；
- 文件与目录只有在用户主动选择或插件已声明权限时才进入当前 Session；
- 插件启动失败不会静默修改原 Profile；恢复页可重试、安全启动、移除问题插件和导出过滤后的诊断；
- 正式安装包通过官网查询更新，用随机安装 ID 统计近期活跃客户端；安装包仍来自本项目公开 GitHub Release，用户确认后才下载和安装，退出统计方式见隐私说明；
- 第三方 Bundle、原生二进制与视觉资产各自遵守上游许可证和再分发条件。

详见隐私说明、安全说明和第三方说明。

与官方桌面端和其他社区桌面的区别

DSH Desktop 选择「官方 Web 单一界面 + 官方 Profile 单一权威 + 精选社区 Bundle + 窄 Native Host」。它不追求再做一套完整前端，而是把桌面体验做成 DSH 插件生态的一个可靠发行组合。

与官方桌面端（@deepseek-ai/dsh-desktop）：官方在 DeepSeek Harness 仓库内维护自己的 Electron 桌面壳——无监听端口、与 DSH 运行时同版本锁定、使用独立的 profiles/desktop，截至本文写作尚未公开发布安装包。两者定位互补、可以共存：官方桌面端是官方的最小核心体验；DSH Desktop 今天即可下载安装，预装固定版本并通过验证的插件组合，把插件市场、版本兼容和桌面能力打包成完整发行版。两者使用不同的 Profile 目录，同时安装互不干扰。本项目也在跟进官方桌面壳的演进，并验证基于官方壳构建插件集成版的路线。

与其他社区项目：DSH Desktop by anywhere-labs 是另一个独立社区桌面发行版，更强调完整桌面 Shell 与跨平台客户端体验；dataelement/dsh-desktop 也是独立社区项目。各项目的代码、发行和路线互不从属，用户可以按界面、插件方式和平台产物选择。

相关项目

| 项目 | 关系 |
| dsh-website | 本项目官网（DSH Desktop Station · dshdesktopstation.com） |
| DeepSeek Harness | Agent、Session、Tool、Skill、MCP、Profile 与官方 Web 运行时 |
| 官方桌面端 apps/desktop | DeepSeek 官方 Electron 桌面壳（上游仓库内维护） |
| Cordis | 插件化基础 |
| DSH Better Sidebar | 默认工作区侧栏、编辑器、Git 与终端 |
| dsh-market | 默认插件市场 |
| dsh-session-teams | 默认会话窗口团队 Bundle（本项目维护，@vibeinging/dsh-session-teams） |
| dsh-web | 任务看板与皮肤中心的上游社区生态仓库（Apache-2.0） |
| ds-harness-remote | 默认手机远程 Bundle 上游（liguobao 维护，含 Remote Web 与 Android 入口） |
| dshfind | DSH 学习、分享与插件发现社区 |

与 DeepSeek Harness 的关系

DSH Desktop 是基于 DeepSeek Harness 与 Cordis 插件体系构建的独立社区项目。「DeepSeek Harness」仅用于说明兼容性和技术来源。本项目与深度求索不存在隶属、合作、授权或背书关系。

许可证

项目代码使用 MIT License。第三方组件、固定 tarball、原生二进制和视觉资产的来源与分发条件见 THIRD_PARTY_NOTICES.md。