myYangyunfan/dsh_desktop · 上手攻略

  • 仓库：myYangyunfan/dsh_desktop
  • 链接：https://github.com/myYangyunfan/dsh_desktop
  • 分类：developer-tools · AI-harness-desktop
  • 作者：Tom
  • 更新：2026-08-19

是什么

DSH Desktop（DeepSeek Harness Desktop）是将 DeepSeek 官方 CLI 工具 dsh（DeepSeek Harness）封装为开箱即用桌面客户端的项目。打包内置完整 Node.js 运行时 + npm CLI + 全部官方插件，双击即启动 dsh web UI，无需用户自行安装任何环境。适合不想折腾命令行、直接在 Windows/macOS 桌面上使用 DeepSeek Agent 的用户。

本质是 Electron 壳包一个 dsh web 服务，原生窗口承载，配套托盘、通知、桌面宠物等桌面能力。

解决什么问题

  • 痛点：dsh 官方 CLI 需要 Node.js 环境、手动安装配置，对非开发者不友好
  • 解决：下载即用，便携版可放 U 盘；安装版提供开始菜单/桌面快捷方式
  • 附加价值：会话管理（归档/恢复/删除）、余额实时显示、桌面宠物、崩溃自愈、自动更新

快速安装

系统要求

  • Windows 10/11（x64 或 ARM64，如 Surface Pro X）
  • macOS 12+（Intel 或 Apple Silicon）

下载方式

从 GitHub Releases（推荐，单文件，无大小限制）：

设备 下载文件
Windows x64（绝大多数 Intel/AMD） DSH-Desktop-<版本>-win-portable-x64.exe（免安装）或 -win-setup-x64.exe（安装版）
Windows ARM（如 Surface Pro X） DSH-Desktop-<版本>-win-portable-arm64.exe
Mac Intel DSH-Desktop-<版本>-macos-x64.dmg
Mac Apple Silicon（M1-M4） DSH-Desktop-<版本>-macos-arm64.dmg

文件名格式：DSH-Desktop-{版本}-{portable|setup}-{x64|arm64}.exe（Windows）或 .dmg（macOS）。

从 Gitee 镜像（国内访问快，但安装包拆为 3 个分片，需下载后双击 merge.bat 合并）：

DSH-Desktop-0.3.9-portable-x64.exe.part1
DSH-Desktop-0.3.9-portable-x64.exe.part2
DSH-Desktop-0.3.9-portable-x64.exe.part3
→ 双击 merge.bat 自动合并

macOS 首次打开（未签名，会报"无法验证开发者"）：

xattr -dr com.apple.quarantine "/Applications/DSH Desktop.app"

核心用法

启动

  • 便携版：直接双击 .exe，自动启动并打开桌面窗口
  • 安装版：从桌面快捷方式或开始菜单启动

首次启动后，会自动拉起 dsh web 服务（默认监听本地端口），桌面窗口内加载 UI。后续启动自动复用上次端口。

数据目录

系统 路径
Windows 便携版 .exe 同级目录下 data\
Windows 安装版 %APPDATA%\DSH Desktop\
macOS ~/Library/Application Support/DSH Desktop/

强制指定 dsh 配置目录：设置环境变量 DSH_HOME。

内置插件一览

插件 功能
dsh-session-manager 会话归档/恢复/删除管理
dsh-better-sidebar 侧边栏增强
dsh-super-injector 开发注入/热重载工具链
dsh-vision OpenAI 兼容识图（OCR/看图/读图表）
dsh-side-session 侧边会话浮窗，三档上下文
billion-context-dsh 上下文压缩（compaction）增强
dsh-navbar 导航栏替换
dsh-hub 插件中枢：更新引擎/全局记忆/图谱与市场
harness-pet 桌面宠物

本地构建开发版

git clone https://github.com/myYangyunfan/dsh_desktop.git
cd dsh-desktop
npm install
npm run fetch-runtime   # 内置 node.exe + npm CLI
npm run dist            # 构建 Windows x64 portable + NSIS → dist/
npm run dist:arm64      # 交叉构建 Windows ARM64
# macOS（需在 macOS 上执行）
npm run dist:mac -- --x64    # macOS Intel
npm run dist:mac -- --arm64  # macOS Apple Silicon

网络受限时使用国内镜像：

$env:ELECTRON_MIRROR='https://npmmirror.com/mirrors/electron/'
$env:ELECTRON_BUILDER_BINARIES_MIRROR='https://npmmirror.com/mirrors/electron-builder-binaries/'

触发 GitHub Actions 云端构建（推 tag 自动发布）：

git tag v0.4.0 && git push origin v0.4.0

典型适用场景

  1. DeepSeek 新手用户：不想装 Node.js，直接下载双击用 dsh
  2. Windows 用户：dsh 官方以 Linux/macOS 为主，Desktop 客户端填补 Windows 体验
  3. 便携办公：便携版放 U 盘，插任何 Windows 电脑即用 dsh
  4. 会话管理需求：需要归档/恢复/对比历史对话，而非浏览器 tab 堆积

坑与注意

  • ⚠️ Gitee 分片版本号滞后：README 示例为 v0.3.9，GitHub Releases 可能已有更新版本，建议优先从 GitHub 下载最新单文件
  • ⚠️ macOS 未签名：Apple Silicon Mac 首次打开需手动 xattr 绕过 Gatekeeper
  • ⚠️ ARM Windows 版本：仅针对 Surface Pro X 等 ARM 设备，常规 x64 Windows 不要下 arm64 版
  • Gitee 单文件限制 100 MB，分片合并后与 GitHub 单文件功能完全一致
  • 桌面宠物/侧边浮窗等为可选插件，设置中可一键关闭，不影响核心功能

与同类对比

DSH Desktop 原生 dsh CLI Jan（开源桌面 AI）
环境依赖 无（内置 Node） 需自行装 Node.js 内置模型/无需 API Key
平台 Windows/macOS Linux/macOS 主要 Windows/macOS/Linux
会话管理 归档/恢复/删除 仅归档 本地文件管理
桌面能力 托盘/通知/宠物 无 基础
更新方式 自动更新 手动 npm 手动

DSH Desktop 定位是零门槛桌面壳，而不是另一个 AI 对话客户端（如 Jan/OpenWebUI）。它的核心价值是把 dsh CLI 变成"双击即用的应用"。

一句话推荐结论

想零配置在 Windows/Mac 上用 DeepSeek Harness CLI？DSH Desktop 是目前最省心的打包方案，双击即用、自动更新、插件全家桶一步到位。

  • 来源：https://github.com/myYangyunfan/dsh_desktop（README + Releases）
  • ⚠️ 版本标注：本文基于 README 内嵌版本 v0.3.9；建议下载前核对 GitHub Releases 最新版本