DSH Desktop
DSH Desktop 插件集成版（DSH Desktop Bundle Edition）—— 把官方 DSH Web、社区插件和桌面能力装进一个开箱即用的应用。
对话、文件、Git、终端、任务、Worktree 与插件市场，都运行在同一个 DSH Profile 中。
English
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 图片等能力。
|
插件市场
在官方设置页里发现、安装、更新、停用和卸载插件。界面、CLI 和应用重启都以同一个 Profile 为准。
|
任务、附件与 Worktree
任务看板、文件和文件夹附件、Git Worktree、项目工具、Office 与结构化结果都由独立 Bundle 提供，可以按需组合。
|
桌面 Host 与恢复
应用负责窗口、原生文件选择、更新、启动和恢复。正式安装包通过右上角按钮提示更新，悬停可看更新日志，点击后才下载、预检 Profile 并安装；Profile 或 Client 出错时进入恢复页。
|
可复现的默认环境
新 Profile 从随包固定产物离线初始化；普通启动不重写已有 Profile，也不会把用户卸载的插件悄悄装回来。
|
手机远程
登录并启用当前电脑后，可以从 Android、Remote Web 或另一台 Desktop 继续同一 Workspace 和 Session。Host 只建立出站连接，不开放公网监听端口。
|
明确的服务边界
当前账号、设备目录、信令和中继由第三方服务提供；连接方式、安全边界和停用方法见手机远程说明。
|
界面
对话、问题卡片与审批
对话、工具审批、问题卡片、排队消息和历史回放都留在官方 Session 中。
官方设置里的插件市场
插件市场使用官方设置 Slot，不替换设置页面，也不另建插件数据库。
Git Worktree 工作区
从当前 Session 的工作目录创建隔离 Worktree，并为新工作区建立官方 Session。
默认内置：手机远程
新 Profile 默认包含精确固定的 [email protected]，与 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/[email protected]。它让 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。
开始使用
- 从 Releases 下载适合的平台安装包。
- 启动应用，选择一个工作目录或直接创建会话。
- 在侧栏打开文件、Git 或终端；在输入框添加文件和文件夹。
- 需要更多能力时，打开“设置 → 插件市场”。
模型凭据由 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 合同；在其他宿主中缺少这些能力时应直接报告。
可选示例：皮肤中心
应用默认保持官方 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 也是独立社区项目。各项目的代码、发行和路线互不从属，用户可以按界面、插件方式和平台产物选择。
相关项目
与 DeepSeek Harness 的关系
DSH Desktop 是基于 DeepSeek Harness 与 Cordis 插件体系构建的独立社区项目。“DeepSeek Harness”仅用于说明兼容性和技术来源。本项目与深度求索不存在隶属、合作、授权或背书关系。
许可证
项目代码使用 MIT License。第三方组件、固定 tarball、原生二进制和视觉资产的来源与分发条件见 THIRD_PARTY_NOTICES.md。
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)
评论