vibeinging/dsh-desktop · 上手攻略
- 仓库：vibeinging/dsh-desktop
- 链接：https://github.com/vibeinging/dsh-desktop
- 分类：AI 开发工具 · DeepSeek Agent 桌面客户端
- 作者：Tom
- 更新：2026-10-04
一、是什么
DSH Desktop（Bundle Edition）是一个社区维护的 DeepSeek Harness 桌面发行版。它直接运行官方 DeepSeek Harness npm 运行时与官方 dsh-web-app，并预装一组经过固定和验证的社区 Bundle。用户无需手动安装 Node.js、配置插件或维护多套插件状态，打开应用即可从同一个 DSH Profile 开始工作。
核心定位：把官方 DSH Web + 社区插件生态，打包成一个开箱即用的桌面应用。
底层技术栈： - Electron 作为极薄的桌面 Host（仅负责窗口、文件选择、更新、托盘） - DeepSeek Harness（dsh）作为 Agent、Session、Tool、Skill、MCP、Profile 的核心运行时 - Cordis 插件体系提供插件化基础
主窗口即官方 DSH Web，Session、Agent、Tool、Skill、MCP、设置和历史全部由 DSH 自己管理，不存在第二套 Chat 界面。
二、解决什么问题
| 痛点 | DSH Desktop 的方案 |
|---|---|
| 官方 dsh 需要 Node.js 环境 + 命令行操作 | 下载安装包，双击即用，不需要 Node.js |
| 插件分散，难以管理 | 内置插件市场，一站式发现/安装/更新/卸载 |
| 官方 Web 界面功能有限 | 内置文件树、代码/Markdown 编辑、Git、终端、多 Tab |
| 多窗口协作困难 | 内置会话窗口团队（@vibeinging/dsh-session-teams） |
| 无法远程访问 | 内置手机远程（ds-harness-remote@0.4.1），支持 Android / Remote Web / 另一台 Desktop |
| Git 多仓库管理不便 | 内置 Git Worktree 支持 |
三、快速安装
方式一：下载安装包（推荐普通用户）
macOS Apple Silicon（M 系列芯片）
1. 前往 官网下载页 或 GitHub Releases
2. 下载 DSH Desktop-{版本}-arm64-public.dmg
3. 挂载 dmg，将 DSH Desktop.app 拖入「应用程序」
4. 首次运行若遇 Gatekeeper 提示，右键打开或去「系统设置 → 隐私与安全性」允许
Windows x64
1. 下载 DSH-Desktop-{版本}-x64-Setup-public.exe
2. 双击运行，选择安装范围与客户端目录（建议非系统盘）
3. 等待安装完成，点击「完成」启动
⚠️ 注意事项
- 安装目录只保存应用程序本身；Profile、插件、Session 等数据在独立数据目录（默认 ~/.dsh），更换安装位置不会迁移或删除这些数据
- macOS Intel / Linux 暂无正式安装包，需从源码运行（见下文）
方式二：从源码运行（开发者）
# 需要 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"
初始配置
- 启动应用后，选择一个工作目录（或直接创建新会话）
- 打开侧栏文件树、Git 或终端
- 在输入框中附加文件或文件夹
- 进入 Settings → Models，添加模型 Provider 并填入 API Key
四、核心用法
4.1 基础会话
主窗口即官方 DSH Web，直接在输入框对话即可。Agent 读文件、跑命令、维护计划等操作均在此完成。
4.2 内置 Bundle（开箱即用）
新 Profile 默认包含以下 Bundle，无法卸载：
| Bundle | 类型 | 用途 |
|---|---|---|
@vibeinging/dsh-work-product-host-ipc |
desktop-adapter | 桌面基础服务（窗口/IPC/文件对话框/托盘） |
@vibeinging/dsh-desktop-profile-host |
desktop-adapter | Profile 文件系统与 CLI 运行时 |
@vibeinging/dsh-desktop-chrome |
desktop-adapter | 无 Host 权限，可卸载 |
@vibeinging/dsh-project-tools |
desktop-adapter | 项目工具 |
@vibeinging/dsh-canvas-tools |
desktop-adapter | Canvas 工具 |
@vibeinging/dsh-structured-ui-tools |
desktop-adapter | 结构化 UI 工具 |
@vibeinging/dsh-model-inheritance |
portable | 模型继承 |
@vibeinging/dsh-product-bridge |
desktop-adapter | 产品桥接 |
@vibeinging/dsh-office-tools |
desktop-adapter | Office 工件支持 |
@vibeinging/dsh-client-ui-worktree |
portable | Git Worktree 支持 |
@linxin666/dsh-client-ui-task-board |
portable | 任务看板 |
ds-harness-remote@0.4.1 |
portable | 手机远程访问 |
dsh-multimedia-webui-input |
portable | 多媒体附件输入 |
dsh-better-sidebar |
portable | 增强侧栏、编辑器、Git、终端 |
dshmarket |
portable | 插件市场 |
@vibeinging/dsh-session-teams |
portable | 会话窗口团队协作 |
4.3 插件管理
图形界面（推荐） - Settings → 插件市场 → 发现、安装、更新、停用、卸载插件
CLI 方式
# 查看已安装插件
dsh plugin --profile web list
# 安装插件
dsh plugin --profile web add -w <package>@<exact-version> --save-exact --ignore-scripts
# 卸载插件
dsh plugin --profile web remove <package>
4.4 皮肤个性化
从插件市场安装皮肤中心（@linxin666/dsh-client-ui-skin-center），数十款皮肤试穿即生效，不落盘可还原：
dsh plugin --profile web add @linxin666/dsh-client-ui-skin-center
4.5 手机远程
- 打开侧栏 Remote
- 登录 dsh.r2049.cn（第三方服务）
- 为当前电脑启用远程访问
- 之后可通过 Remote Web、Android App 或另一台 Desktop 继续同一 Workspace 和 Session
⚠️ 安全注意：当前默认连接 dsh.r2049.cn 第三方服务，设备身份与凭据保存在 DSH_HOME。项目尚无自建 Server，独立密码安全审查未完成，不需要远程能力时可直接卸载：
dsh plugin --profile web remove ds-harness-remote
4.6 Git Worktree
从当前 Session 的工作目录创建隔离 Worktree，并为新工作区建立官方 Session：
# 图形操作：在侧栏 Git 面板选择"新建 Worktree"
# 或通过 DSH Session 内置的 Git Worktree 工具
五、典型适用场景
- 本地 AI 编程助手：在本地桌面环境中运行 DeepSeek Agent，处理文件、Git、终端任务，适合不喜欢命令行界面的用户
- 多插件组合工作流：通过插件市场按需安装/组合插件（任务看板、Office 支持、结构化结果等），构建个性化 AI 工作站
- 跨设备连续工作：在一台电脑上开启 Session，出门后通过手机或另一台设备无缝继续
- 团队多窗口协作：通过会话窗口团队功能，让多个 Agent 协作完成任务并汇报结果
- 插件开发者测试：从源码运行，测试 Cordis 插件在桌面环境中的行为
六、坑与注意
⚠️ 坑 1：首次运行 Gatekeeper / SmartScreen 拦截
- 现象：macOS 提示「无法打开，因为来自未识别开发者」；Windows SmartScreen 报警
- 修复：macOS 右键打开，或去「系统设置 → 隐私与安全性」点「仍要打开」；Windows 点击「更多信息 → 仍要运行」
- 原因：桌面应用未走平台官方应用商店签名流程
⚠️ 坑 2：未选工作区前会话编辑器不可用
- 现象：打开应用后输入框灰色或无法附加文件
- 修复：先在欢迎页选择工作目录，选完后编辑器即激活
- 原因：这是 DSH 自身设计，不是应用 Bug
⚠️ 坑 3：Remote 依赖第三方服务
- 现象：远程连接不稳定或服务不可用
- 说明：当前默认连接 dsh.r2049.cn，项目明确指出「独立密码安全审查、真实双机跨网和长期稳定性验证仍未完成」
- 建议：不需要远程功能时直接卸载
ds-harness-remoteBundle
⚠️ 坑 4：macOS Intel / Linux 无安装包
- 现象：下载页找不到对应安装包
- 说明：目前只有 macOS Apple Silicon 和 Windows x64 有正式安装包；Intel Mac 和 Linux 只能从源码运行（需要 Node.js ≥ 24）
⚠️ 坑 5：插件市场可见 ≠ 已审查
- 说明：插件市场会显示来源、版本、兼容性和权限，但「市场可见不等于本项目已经审查或默认内置」，安装前仍应查看上游说明
⚠️ 坑 6：Electron 内核版本锁定
- 说明：项目固定 DSH 0.1.5-rc.1 试用线与 alpha SDK，如需最新版 DSH 功能可能需要等待项目更新
七、与同类对比
| DSH Desktop（vibeinging） | dataelement/dsh-desktop | anywhere-labs/deepseek-harness-desktop | |
|---|---|---|---|
| 定位 | 官方 Web + 精选 Bundle 桌面发行 | 独立社区桌面版 | 强调完整桌面 Shell 与跨平台客户端 |
| 安装方式 | dmg / exe 安装包 | ⚠️ 需核实 | ⚠️ 需核实 |
| 插件生态 | 内置 dshmarket + 官方插件市场 | ⚠️ 需核实 | ⚠️ 需核实 |
| 远程能力 | 内置 ds-harness-remote | ⚠️ 需核实 | ⚠️ 需核实 |
| 与官方 dsh 关系 | 直接运行官方 npm 运行时 | 独立维护 | 独立维护 |
| 平台支持 | macOS ARM ✓ / Windows ✓ / macOS Intel 待确认 | ⚠️ 需核实 | ⚠️ 需核实 |
⚠️ 标注说明：dataelement/dsh-desktop 与 anywhere-labs/deepseek-harness-desktop 的最新状态本次未能 fetch 到，以上对比基于 vibeinging 版 README 自身声明，三个项目「代码、发行和路线互不从属」，实际情况应以各自仓库为准。
八、一句话推荐结论
DSH Desktop = 官方 DeepSeek Harness 的「桌面版一键发行包」，适合想用桌面应用体验 DSH Agent 能力、不想折腾 Node.js 环境、又希望灵活组合社区插件的用户；注意其远程能力仍依赖第三方服务，生产环境使用前请评估安全边界。
⚠️ 引用说明：本文档所有信息来自 GitHub README（中文版 + 英文版）与网络搜索补充，命令版本以 README.md 为准；远程服务安全边界、自建 Server 状态等未完成项，项目自身已在文档中明确声明。