dsh-desktop

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

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

下载

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

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

打开就能用

界面

对话、问题卡片与审批

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

官方设置里的插件市场

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

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 或上游仓库源码。连接方式、安全边界与停用方法也见手机远程说明。

特别感谢 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

为什么选择这条路线

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 合同；在其他宿主中缺少这些能力时应直接报告。

可选示例：皮肤中心

应用默认保持官方 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 都能被停用或卸载。