dsh-desktop

<h1 align="center">DSH Desktop</h1>

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

<p align="center"><a href="README.en.md">English</a></p>

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 数据由独立的数据目录管理；更换客户端安装位置不会迁移或删除这些数据。

打开就能用

  <h3>官方对话与 Agent</h3>
  <p>主窗口就是官方 DSH Web。Session、Agent、Tool、Skill、MCP、设置和历史由 DSH 自己管理，没有第二套 Chat 页面。</p>
  <h3>Better Sidebar 工作台</h3>
  <p>内置文件树、代码与 Markdown 编辑、Git、终端、网页与扩展 Tab。0.18.0-alpha.0 对接当前 alpha SDK，并保留多仓库、Worktree、Vue 文件和本地 Markdown 图片等能力。</p>
  <h3>插件市场</h3>
  <p>在官方设置页里发现、安装、更新、停用和卸载插件。界面、CLI 和应用重启都以同一个 Profile 为准。</p>
  <h3>任务、附件与 Worktree</h3>
  <p>任务看板、文件和文件夹附件、Git Worktree、项目工具、Office 与结构化结果都由独立 Bundle 提供，可以按需组合。</p>
  <h3>桌面 Host 与恢复</h3>
  <p>应用负责窗口、原生文件选择、更新、启动和恢复。正式安装包通过右上角按钮提示更新，悬停可看更新日志，点击后才下载、预检 Profile 并安装；Profile 或 Client 出错时进入恢复页。</p>
  <h3>可复现的默认环境</h3>
  <p>新 Profile 从随包固定产物离线初始化；普通启动不重写已有 Profile，也不会把用户卸载的插件悄悄装回来。</p>
  <h3>手机远程</h3>
  <p>登录并启用当前电脑后，可以从 Android、Remote Web 或另一台 Desktop 继续同一 Workspace 和 Session。Host 只建立出站连接，不开放公网监听端口。</p>
  <h3>明确的服务边界</h3>
  <p>当前账号、设备目录、信令和中继由第三方服务提供；连接方式、安全边界和停用方法见<a href="https://dshdesktopstation.com/remote/">手机远程说明</a>。</p>

界面

对话、问题卡片与审批

对话、工具审批、问题卡片、排队消息和历史回放都留在官方 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 或上游仓库源码。连接方式、安全边界与停用方法也见手机远程说明。

…