2-1 先搞清楚:DSH 到底是什么
用一句话说:
Zotero 帮你"存"文献,DSH 帮你"干活"。 读文献、跑生信分析、画图、写论文、改稿、做组会 PPT —— 这些都能让 DSH 里的 AI 帮你做,而且它是在你自己电脑的文件夹里干活,产出的是真实文件。
几个你会反复看到的词:
| 词 | 大白话 |
|---|---|
| DSH Desktop | 装在电脑上的一个 App(有窗口、有托盘图标),打开就能用 |
| DeepSeek Harness (DSH) | 真正在后台干活的"AI 引擎",DSH Desktop 是它的桌面外壳 |
| Agent(智能体) | 就是那个会跟你对话、能读写你文件、能跑命令的 AI 助手 |
| 工作区(Workspace) | 你授权给 AI 的文件夹。只在这个文件夹里它能动文件 |
| 会话(Session) | 一次聊天记录。换项目就新建一个会话 |
| 技能(Skill) | 一份"操作说明书",告诉 AI 遇到某类任务该怎么专业地做(比如"怎么做差异表达分析") |
| 插件(Plugin) | 给 DSH 加功能的小扩展包,像手机装 App |
⚠️ DSH Desktop 是社区开源项目(MIT 许可),不是 DeepSeek 官方出品,但底层用的是官方 DeepSeek Harness。完全免费,如果有人让你付钱买这个软件,直接拒绝。
2-2 下载(认准这两个入口)
网上有两个同源的社区桌面版,都免费、都开源、随便选一个就行。我建议用第一个(功能更全,内置插件市场):
| 推荐度 | 入口 | 说明 |
|---|---|---|
| ⭐ 首选 | https://www.dshdesktop.cn/ GitHub:https://github.com/anywhere-labs/deepseek-harness-desktop | 就是你发的 anywhere-labs/dsh-desktop(会跳转到这个仓库)。支持 Windows x64 + macOS(Intel/Apple 芯片通用),内置插件市场和设置向导 |
| 🔁 备选 | https://www.dshdesktop.com/zh/ GitHub:https://github.com/dataelement/dsh-desktop | 同生态的另一条线,多一个「PPT 生成」特色功能(16 套模板) |
下载时选哪个文件:
| 你的电脑 | 下载这个 |
|---|---|
| Windows 10/11(绝大多数笔记本) | DSH Desktop Setup ... .exe(Windows x64) |
| Mac(M1/M2/M3/M4 芯片) | ... arm64.dmg 或标着 Universal 的 dmg |
| Mac(Intel 芯片,2019 年前的老机型) | ... x64.dmg |
| Linux | ❌ 暂时没有 Linux 版(下面有说明) |
💾 安装包有几百 MB 是正常的 —— 它把运行环境都打包进去了,你不需要另外装 Node.js、Python 环境之类的东西。
⏳ 官网下载如果很慢,就用 GitHub 的 Releases 页面下(找带 Latest 标记的正式版)。
2-3 Windows 安装图解
第 1 步 · 下载安装包
点官网的下载按钮 → 文件一般会存到 下载 (Downloads) 文件夹 → 文件名类似 DSH-Desktop-Setup-2.0.10.exe。
第 2 步 · 双击运行
如果出现蓝色的 "Windows 已保护你的电脑"(SmartScreen 提示):
- 点左边的小字 「更多信息」
- 再点右下角 「仍要运行」
为什么会有这个提示?因为这是个新发布的开源项目,微软的"发布者信誉"还在积累中。这是正常现象,不是病毒提示(官方 README 里也专门说明了)。
第 3 步 · 跟着安装向导点
| 向导页面 | 你会看到什么 | 怎么选 |
|---|---|---|
| 欢迎 | "欢迎使用 DSH Desktop 安装向导" | 点 下一步 |
| 安装位置 | 默认 C:\Users\你的用户名\AppData\Local\Programs\DSH Desktop | 直接下一步(不用改) |
| 附加任务 | 创建桌面快捷方式 | 都勾上 → 下一步 |
| 准备安装 | 摘要 | 点 安装 |
| 完成 | "安装完成" | 点 完成,程序会自动打开 |
第 4 步 · 第一次启动会比较慢 要初始化运行环境,等 10~60 秒,然后会弹出设置向导。此时先别急着关窗口。
2-4 macOS 安装图解
第 1 步 · 下载 .dmg 文件
第 2 步 · 双击打开 DMG
会弹出一个窗口,里面是 DSH Desktop 图标和 Applications 文件夹。
第 3 步 · 把图标拖进 Applications 用鼠标把左边的 App 图标拖到右边的 Applications 文件夹上,然后关掉这个窗口。
第 4 步 · 从"启动台"打开 DSH Desktop
如果弹窗说 "无法打开,因为 Apple 无法验证开发者":
- 方法 A:右键(或 Control + 点击)App 图标 → 选 打开 → 再点 打开
- 方法 B:
系统设置 → 隐私与安全性→ 往下找到那条提示 → 点 仍要打开
第 5 步 · 等待初始化,弹出设置向导
2-5 首次启动:跟着向导点
第一次打开会有一个 设置向导(Setup Wizard),它会问你几个偏好。照着下表选就行:
| 向导选项 | 建议选择 | 为什么 |
|---|---|---|
| 窗口模式 | 扩展窗口 | 界面最完整、最好看 |
| 系统材质 | Windows 11 → Mica;Mac → 透明 | 好看;老系统会自动关闭,不影响使用 |
| 插件市场 | 开启 | 以后一键装插件要用 |
| 通知 | 开启 | 长任务跑完会弹通知,你可以去干别的 |
| 用系统默认浏览器自动打开 | 关闭 | 直接在 App 窗口里用就好,不用多开一个浏览器 |
| Web 访问范围 | 仅本机(127.0.0.1) | 🔒 重要!别开"局域网访问",开了之后同一个 WiFi 下任何人都能操作你的电脑 |
| 不想选 | 也可以直接 跳过 | 之后随时能在设置里改 |
向导没走完之前,主界面不会启动 —— 所以它让你点几步,就点几步。
2-6 配置模型(最重要的一步)
AI 的"大脑"不在软件里,要连接一个模型服务。没有这一步,App 打开了也用不了。
操作路径:
设置(⚙️)→ 模型 → 添加提供方 / 自定义提供方
最省事的方案:用 DeepSeek 官方
- 浏览器打开 https://platform.deepseek.com/ → 注册账号
- 进「API Keys」→ 创建一个 Key → 复制(一串
sk-开头的字) - 回到 DSH → 在 「输入 API 密钥」 框里粘贴 → 点 「获取可用模型」
- 在模型列表里勾一个(见下表)→ 保存并继续
| 场景 | 推荐模型 | 说明 |
|---|---|---|
| 日常问答、跑脚本、看图 | DeepSeek V4 Flash | 便宜、快,够用 |
| 写长论文、长文献综述 | DeepSeek V4 Pro | 更聪明但更贵,重要场合再切 |
| 看图片/图表 | Flash Vision 版 | 需要选带视觉能力的模型 |
💰 关于花钱:模型是按用量计费的(按字数/长度算),不是包月。日常读写文献一个月一般几十块以内。想省钱就:
- 默认用便宜模型,只在关键环节切贵的
- 不要让 AI 反复"重跑一遍"整个分析
- 分析代码本地跑,别把几十 MB 的数据丢给 AI 看(数据用脚本处理,AI 只看结果)
如果现在不方便申请,向导里有 「稍后配置」,以后再回来填。
如果用的是其他模型服务:选「自定义提供方」,填 模型 ID 和 baseUrl(服务商官网会给出),再填 API Key。
2-7 五个基础操作(必须会)
#① 添加工作区(告诉 AI 能在哪个文件夹干活)
- 点左侧/顶部的 添加工作区
- 会弹出系统的文件夹选择框
- 新建一个专属文件夹,比如:
- Windows:
D:\科研\我的第一个项目 - Mac:
~/科研/我的第一个项目
- Windows:
- 选中它 → 确认
🔒 安全边界:AI 只被允许在你添加的工作区里读写文件。别把整个 C 盘或桌面根目录加进去。
#② 新建会话
点 新建会话 → 选刚才那个工作区 → 开始打字。
一个项目一个会话,聊天记录会一直在。换课题就新建一个,不要一个会话用一年。
#③ 先做一个"体检"
新会话里打这句话,测试模型通不通:
你好,请用一句话介绍你自己,并告诉我你现在的工作目录是什么。
能正常回话 = 模型通了。
#④ 打开终端(后面装技能要用)
- 方式 A:右键点击系统托盘的 DSH Desktop 图标 → 选 Open DSH Terminal
- 方式 B:设置里也有入口
Windows 上会优先打开 Windows Terminal(没有的话回退到 PowerShell)。
这个终端里可以用 dsh 命令管理插件。它不会修改你的系统环境变量,很安全。
#⑤ 关窗口 ≠ 退出
点窗口的 ❌ 只是把窗口收进托盘,AI 还在后台待着。
- 左键点托盘图标 → 重新打开窗口
- 右键点托盘图标 → 菜单:切换 Profile、打开终端、检查更新、退出
- 真正退出 → 菜单里选 退出
2-8 装插件 / 更新 / 出问题了怎么办
#装插件
方法一(推荐):App 里打开 插件市场(DSH Community Market,已内置)→ 搜索 → 点安装 → 重启 App。
方法二:托盘 → Open DSH Terminal → 打命令:
dsh plugin add 插件名 # 安装
dsh plugin remove 插件名 # 卸载
dsh plugin update # 更新全部
⚠️ 插件装完必须重启 App才生效。 📌 具体装哪些插件?我在 ③ DSH 插件区 里已经按"先装什么、后装什么"排好了,直接照着 3-7 的清单走。
#更新软件
托盘图标 → 检查更新(Check for Updates…) → 确认后它会下载 → 你选"重新启动并安装"。 (后台每 6 小时也会自动检查一次,但不会偷偷装,会先问你。)
#出问题了
| 症状 | 怎么办 |
|---|---|
| 窗口不见了 | 看系统托盘(右下角小图标区),点一下图标就回来了 |
| 插件装完没反应 | 确认是不是装到了当前 Profile,然后重启 App |
| 终端命令找不到 | 从托盘重新打开 DSH Terminal(它不改系统 PATH,只在那个终端里生效) |
| 界面打不开/一直闪退 | 用安全模式启动:它会临时屏蔽所有第三方插件。启动参数加 --safe-mode |
| 想给开发者报 bug | 托盘右键 → 导出诊断信息…,会生成一个 diagnostics-*.zip |
| 完全卡死进不了托盘 | 在 PowerShell 里运行:& "$env:LOCALAPPDATA\Programs\DSH Desktop\DSH Desktop.exe" --export-diagnostics |
#Profile 是什么(简单了解就行)
DSH 有 default / desktop / web 几套 Profile(可以理解为"不同的配置抽屉")。托盘 → Profile 菜单可以切换。
✅ 对你的建议:日常科研就用默认的那个,不要来回切。切换时插件不会自动搬过去。
#Linux 用户怎么办
目前没有 Linux 桌面版。如果你平时在 Linux 服务器上跑生信流程:
- ✅ 正确姿势:DSH Desktop 装在你的 Windows/Mac 笔记本上,需要操作服务器时,在会话里让 AI 给你写命令,你复制到服务器的终端里跑;或者让 AI 帮你写
ssh/scp/sbatch脚本。 - ✅ 服务器上装
nextflow/conda/snakemake这些流程,AI 可以帮你写 YAML 和脚本,本地编辑、服务器执行。 - ❌ 不要指望把 DSH Desktop 装到服务器上当 GUI 用。