🧬DSH 科研工具手册
Zotero × DSH Desktop × 生物信息学
🖥️ 第 2 部分 · 共 7 部分

② DSH Desktop 安装(手把手)

从下载安装到配置模型,手把手把 AI 装进电脑 · 本部分 8 小节

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 提示):

  1. 点左边的小字 「更多信息」
  2. 再点右下角 「仍要运行」

为什么会有这个提示?因为这是个新发布的开源项目,微软的"发布者信誉"还在积累中。这是正常现象,不是病毒提示(官方 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 官方

  1. 浏览器打开 https://platform.deepseek.com/ → 注册账号
  2. 进「API Keys」→ 创建一个 Key → 复制(一串 sk- 开头的字)
  3. 回到 DSH → 在 「输入 API 密钥」 框里粘贴 → 点 「获取可用模型」
  4. 在模型列表里勾一个(见下表)→ 保存并继续
场景推荐模型说明
日常问答、跑脚本、看图DeepSeek V4 Flash便宜、快,够用
写长论文、长文献综述DeepSeek V4 Pro更聪明但更贵,重要场合再切
看图片/图表Flash Vision 版需要选带视觉能力的模型

💰 关于花钱:模型是按用量计费的(按字数/长度算),不是包月。日常读写文献一个月一般几十块以内。想省钱就:

  • 默认用便宜模型,只在关键环节切贵的
  • 不要让 AI 反复"重跑一遍"整个分析
  • 分析代码本地跑,别把几十 MB 的数据丢给 AI 看(数据用脚本处理,AI 只看结果)

如果现在不方便申请,向导里有 「稍后配置」,以后再回来填。

如果用的是其他模型服务:选「自定义提供方」,填 模型 ID 和 baseUrl(服务商官网会给出),再填 API Key。

2-7 五个基础操作(必须会)

#① 添加工作区(告诉 AI 能在哪个文件夹干活)

  1. 点左侧/顶部的 添加工作区
  2. 会弹出系统的文件夹选择框
  3. 新建一个专属文件夹,比如:
    • Windows:D:\科研\我的第一个项目
    • Mac:~/科研/我的第一个项目
  4. 选中它 → 确认

🔒 安全边界:AI 只被允许在你添加的工作区里读写文件。别把整个 C 盘或桌面根目录加进去。

#② 新建会话

点 新建会话 → 选刚才那个工作区 → 开始打字。

一个项目一个会话,聊天记录会一直在。换课题就新建一个,不要一个会话用一年。

#③ 先做一个"体检"

新会话里打这句话,测试模型通不通:

code
你好,请用一句话介绍你自己,并告诉我你现在的工作目录是什么。

能正常回话 = 模型通了。

#④ 打开终端(后面装技能要用)

  • 方式 A:右键点击系统托盘的 DSH Desktop 图标 → 选 Open DSH Terminal
  • 方式 B:设置里也有入口

Windows 上会优先打开 Windows Terminal(没有的话回退到 PowerShell)。

这个终端里可以用 dsh 命令管理插件。它不会修改你的系统环境变量,很安全。

#⑤ 关窗口 ≠ 退出

点窗口的 ❌ 只是把窗口收进托盘,AI 还在后台待着。

  • 左键点托盘图标 → 重新打开窗口
  • 右键点托盘图标 → 菜单:切换 Profile、打开终端、检查更新、退出
  • 真正退出 → 菜单里选 退出

2-8 装插件 / 更新 / 出问题了怎么办

#装插件

方法一(推荐):App 里打开 插件市场(DSH Community Market,已内置)→ 搜索 → 点安装 → 重启 App。

方法二:托盘 → Open DSH Terminal → 打命令:

sh
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 用。