DeepSeek_Harness_桌面版安装教程（超级详细）

摘要DeepSeek HarnessDSH开源不到一周GitHub Star 已经冲破 14 万。但官方只提供 Web 版想跑起来得开终端敲命令、等服务启动、切浏览器配 API Key终端一关全白搭。折腾过的开发者都知道这个上手门槛把不少人挡在了门外。社区很快出了桌面版把这些步骤全封装进一个安装包下载双击就能用。有大神把DSH整理成了桌面版那文章把 DSH 桌面版的完整安装流程整理成 5 步保姆级教程末尾附 2 个实测值得装的插件。Windows 用户可以直接照着走macOS 用户步骤一致。DSH 是什么为什么需要桌面版先花 30 秒说清楚 DSH 是什么。DeepSeek Harness 是 DeepSeek 官方的 AI 智能体运行时框架。你给它一个目标它能自己拆任务、调工具、按步骤执行。AI 圈有个公式Agent Model Harness模型管怎么想Harness 管怎么干。DSH 的核心理念是Everything is a Plugin模型、工具、界面全都能替换。今天要装的桌面版就是这套插件生态里的一个第三方开源项目由 anywhere-labs 维护MIT 协议。官方默认的启动方式是这样的注意DSH Desktop 是社区项目不是 DeepSeek 官方产品。遇到问题优先查 GitHub Issues别找 DeepSeek 官方客服。5 步安装 DSH 桌面版第 1 步下载安装包两个下载入口选哪个都行官网dshdesktop.cn按系统选版本、GitHub Releasesgithub.com/anywhere-labs/deepseek-harness-desktop/releases附 SHA-256 校验支持 Windows x64 和 macOSApple SiliconmacOS 12。Windows 运行 exe 安装程序按向导走完macOS 打开 DMG 把 DSH Desktop 拖进 Applications。第 2 步首次启动双击图标启动。第一次启动会创建默认 Profile 并自动拉起 Harness 服务耗时比平时稍长属于正常现象。启动后应用在系统托盘常驻。服务的启动、停止、恢复全部由应用自行管理不需要开终端、不需要开浏览器、不需要管 3080 端口。第 3 步配置模型 API Key点继续或进入设置 → 模型设置在 DeepSeek 卡片中填入 API Key。没有 Key 的去 DeepSeek 开放平台注册创建。这里除了使用deepseek的官网模型也可以去魔芋AI平台调用其他模型尝试一下不同模型下DSH的能力魔芋API平台魔芋AI大模型网关I全球大模型一站式调用及服务平台三条安全纪律记一下规则说明别截图API Key 截图发群里 钱包裸奔别发人Key 相当于密码不随意复制给他人别进 Git配置文件加进 .gitignore别推到公开仓库第 4 步配置工作区在工作区面板添加项目文件夹。DSH 只在该工作区范围内读写文件。建议为每个项目单独建文件夹比如dsh-demo别把用户主目录或下载目录整体划进去。第一次用的话直接新建一个空文件夹最安全。 会话参数保持默认就行#### 第 5 步验证跑通发一条简单指令验证一下 能正常返回目录信息桌面版就跑通了。从下载到跑通整个流程不到10分钟。### 4 种 Agent 模式怎么选新建会话时可以选 Agent 模式内置四种。这里帮你理清楚别选错了。模式 工具范围 适合谁 一句话 标准模式 全套工具 新手首选 文件编辑、命令行、检索、技能调用、子代理协作全开 PTC 模式 全套工具 进阶用户 多步任务打包一次性跑完批量处理效率更高 极简模式 仅命令行文件编辑 谨慎选择 去掉了多余工具但很多实用功能会缺失 创造模式 标准模式高权限 开发者实验 能改 DSH 运行环境可开发插件和自定义模式 有个坑要注意**模式在会话开始后锁定中途不能切换**。想换模式得新建会话。 日常写代码、做项目直接选标准模式够用。批量处理多步任务选 PTC。极简模式除非你清楚自己在干什么否则别碰。创造模式留给写插件的开发者。### 2 个值得装的插件清单DSH 的核心是一切皆插件。官方搭骨架社区长血肉。装插件的方式很简单直接在对话框发指令Agent 会自己装好。也可以用命令行装 下面2个是社区 Star 数靠前、实测好用的插件。#### 插件 1dsh-web-ui约 3.7k Star**一句话**界面全家桶一个插件补齐官方 Web UI 缺的所有东西。 官方 Web UI 最大的槽点就是太素了一个纯聊天框。这个插件一次装齐任务看板、Git 图谱、右侧面板、移动端远程控制、Token 统计、皮肤中心。 其中任务看板dsh-task-board最实用五列看板待规划/待办/进行中/已完成/已失败卡片能直接交给真实 DSH 会话执行跑完自动更新状态还支持cron定时任务。**适合**所有人。如果只装一个插件装这个。#### 插件 2modlens约 2.6k Star**一句话**给纯文本 DeepSeek 模型装上眼睛能看图了。 DeepSeek 是纯文本模型最大的短板就是看不了图。你贴一张报错截图、丢一个 UI 设计稿它只能干瞪眼。ModLens 装好后注册一个bashmodlens_read_image工具图片粘贴进聊天框会被转成 OCR 文本、布局信息和语义证据再喂给 DeepSeek 处理。注意锁版本号别用bashlatest DSH 版本更新频繁不锁版本容易碰到 breaking change。 **适合**需要贴截图让 AI 分析报错、识别 UI 设计稿、读流程图文字的开发者。这是补齐 DeepSeek 视觉短板的核心插件。### DSH 桌面版 vs 通用智能体该选哪个文章最后说清楚一个定位问题。DSH 和 WorkBuddy 这类通用智能体不是一回事。 DSH 是一套开源的智能体底座所有能力靠插件拼装。你想要视觉能力就装 modlens想要任务看板就装 dsh-web-ui想改界面就换皮肤。自由度拉满但前提是你愿意折腾。 WorkBuddy 这类通用智能体开箱即用拿来就做办公任务查资料、做 PPT、写文档不需要装插件不需要配环境。 简单说**想折腾、想自定义整套能力的上 DSH。只想高效完成办公任务的通用智能体够用没必要花精力折腾部署。**