Maoshou121's Blog Maoshou121's Blog

从零开始使用 DSH 指北：DeepSeek Harness 桌面端懒人教程

只讲 DeepSeek Harness 桌面端：三步上手，下载安装（Windows / macOS）、填 API Key 或登录、选工作区、批准操作、懒人用法与常见问题，全部按官方资料核对。

计算阅读时间 16 阅读

📌 本文依据 DeepSeek 官方下载页与官方 GitHub 仓库整理，核对日期 2026-10-28。DeepSeek Harness 还在快速迭代，界面文字如有出入，以官方为准。

⚡ 太长不看：三步上手

  1. 下载：打开 DeepSeek 官方下载页，下载 DeepSeek Harness 桌面端并安装。
  2. 填 Key：首次打开时，填入 DeepSeek 开放平台 的 API Key，或直接登录 DeepSeek 账号。
  3. 开工：选一个文件夹作为工作区，用一句中文告诉它要做什么。

一、它是什么

DeepSeek Harness（简称 DSH）是 DeepSeek 官方推出的开源 AI 智能体。桌面端可以在后台运行、读写你电脑上的本地文件，帮你完成耗时较长、步骤较多的任务。

⚠️ 预览版提醒 - 官方标注为「开发者预览」，功能和界面会频繁变化。 - 它会执行 AI 生成的命令、修改你授权给它的文件。官方安全说明建议：重要文件先备份；只给它需要的文件夹；不认识的插件别装；批准操作前看清楚。

二、下载

官方下载页目前提供两个版本：

系统 要求 官方下载文件 大小
macOS Apple 芯片（M 系列），macOS 13 或更高 dsh-latest-macos-arm64.dmg 约 265 MB
Windows x64 dsh-latest-windows-x64.exe 约 289 MB

💡 Linux 用户：官方下载页暂未提供 Linux 桌面版。

💡 Intel 芯片的 Mac：下载页只写了 Apple 芯片版本。

💡 找不到入口？ 下载页上方是 DeepSeek Harness 桌面端，下方的「DeepSeek 客户端」是手机聊天 App，别下错了。

三、安装

Windows

  1. 双击 dsh-latest-windows-x64.exe。
  2. 安装程序会显示安装目录，一般保持默认即可。
  3. 点击「安装」，等进度条走完。
  4. 完成页默认勾选「立即启动」，点完成就会打开应用。

💡 安装只针对当前用户，不需要管理员权限。官方仓库说明正式安装包使用 EV 代码签名证书签名。

macOS

  1. 双击 dsh-latest-macos-arm64.dmg。
  2. 把 DeepSeek Harness 图标拖进「应用程序（Applications）」文件夹。
  3. 在「启动台」或「应用程序」里打开它。

四、首次打开：填 API Key 或登录

首次启动会弹出欢迎窗口，二选一：

  • 登录 DeepSeek 账号：按提示登录即可。
  • 填 API Key：
  • 打开 platform.deepseek.com，注册 / 登录。
  • 在 API Keys 页面新建一个 Key 并复制。
  • 回到欢迎窗口粘贴，点「保存并继续」。

💡 暂时没 Key？点「稍后配置」，之后在 设置 → 模型 里再填，保存后立即生效，不用重启。

🔒 Key 保存在你电脑本地的 ~/.dsh/ 目录中，界面上只显示脱敏后的信息。不要把 Key 发给别人。

🇨🇳 中国大陆用户：API 调用按用量计费，请在开放平台查看价格与余额。如果你的网络需要代理，请参考官方网络代理指南：DSH 不读取系统代理，需要设置 HTTPS_PROXY 环境变量，或开启代理软件的 TUN 模式。

五、选一个工作区

  1. 点击输入框上方的 选择工作区。
  2. 选中一个文件夹。
  3. 选好后输入框才会亮起，可以打字。

💡 懒人建议：新建一个专用文件夹（比如桌面上的 AI工作台），把要处理的文件拖进去，再选它当工作区。不要直接选整个用户目录。

六、发出第一个任务

点 新建会话（New Session），输入：

看看这个文件夹里有哪些文件，用表格列出文件名、类型和大小。

它会自己列计划、读文件，然后给你结果。

七、批准操作

遇到需要权限的操作（比如运行命令、修改文件），界面会先停下来问你。

  1. 读一遍它要做什么。
  2. 看得懂、没风险，就批准。
  3. 看不懂或者涉及删除，就拒绝，再让它解释。

⚠️ 退出应用时，如果还有任务在跑，应用会提醒你：退出会中断正在运行的任务，定时任务也不会执行。

八、懒人用法

把文件放进工作区，复制下面任意一句：

想做的事 直接这么说
整理杂乱文件 「按文件类型把这个文件夹里的文件分到不同子文件夹，先给我看计划再动手。」
表格处理 「读取 销售.xlsx，按月汇总金额，生成一张新表。」
写文档 「根据 笔记.txt 写一份 Word 格式的周报。」
做 PPT 「把 方案.md 做成 8 页左右的 PPT。」
读代码 「总结这个项目的结构，告诉我主要模块各做什么。」
定时任务 在左侧栏 Automation tasks 里设置

💡 官方说明桌面端自带 Python 运行环境和常用的 Excel、Word、PPT 处理库，不需要你另外安装。

💡 技巧：让它「先给计划再动手」，安全又省心。

九、常见问题

Q：输入框是灰的，打不了字？ 还没选工作区，或者还没填 Key / 登录。

Q：提示 MISSING_CREDENTIAL？ 没有配置模型密钥。到 设置 → 模型 填入 API Key 并保存。

Q：能用别家的模型吗？ 可以。设置 → 模型 → 添加模型提供商，可以选内置的第三方提供商，也可以填 OpenAI 兼容接口。详见官方模型配置指南。

Q：联网慢、连不上模型？ DSH 不读取系统代理。请按官方网络代理指南设置代理环境变量（只支持 HTTP 代理，不支持 SOCKS），或开启代理软件的 TUN 模式。

Q：卸载 Windows 版后，会话和 Key 还在吗？ 在。官方说明卸载程序不会删除 ~/.dsh 目录（会话、设置、凭据、插件都在这里）。想彻底清除，需要手动删掉这个目录。

Q：想反馈问题？ 到 GitHub Discussions 提交。

十、官方链接