官网 · 下载最新版 · 手机远程 · 开始使用 · 安装插件
下载
各平台直链与文件大小见官网下载页；首跑常见问题（Gatekeeper、SmartScreen、API Key、国内下载）见官网 FAQ。
客户端安装目录只保存应用程序。Profile、插件、Session 和其他 DSH 数据由独立的数据目录管理；更换客户端安装位置不会迁移或删除这些数据。
打开就能用
界面
对话、问题卡片与审批
对话、工具审批、问题卡片、排队消息和历史回放都留在官方 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
为什么选择这条路线
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 都能被停用或卸载。
插件选择、权限和离线边界见插件市场选择与桌面接入。
从源码运行
需要 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。
