DeepSeek Harness(DSH) 是 DeepSeek 官方出品的 AI Agent 桌面应用(官方页面标注为预览版),可以理解为「把 DeepSeek 的 Agent 能力装进一个有界面的客户端」,而不是只有命令行。左侧是工作区列表——每个工作区对应一块活儿(默认工作区、某个项目、某类日常任务),下面挂着历史会话;顶部入口是新会话、插件、自动化任务。中间是对话与输入区,可以直接描述要构建的内容,也可以调用指令、引用文件。它的可玩之处主要在插件这一层:官方插件里已经给了「智能体团队(多智能体协作与共享任务看板)」「语音输入(在本机用 SenseVoice 转写录音,首次使用需安装依赖)」「终端(限制每条命令最多跑多久、最多输出多少内容)」「Agent 循环(控制 Agent 派发工具调用的方式)」「Subagent(设置递归层级、数量和模型)」「网页搜索(设置 DeepSeek 的搜索提供方)」,每一项都是一个开关,改的是 Agent 的行为边界而不是提示词。对开发者最实用的是轨迹(Trace)视图:把一次会话按 Turn / Tool Call 摊开,带时间条,点开任意一步能看到 Summary、Payload、Result、Schema、Timing——也就是「它到底执行了什么命令、返回了什么、花了多少毫秒」,还能导出。模型侧默认走 deepseek-v4-flash 一类档位。除桌面端外也提供命令行启动方式(npx @deepseek-ai/dsh web)。仓库 MIT 开源,并且已经进了 Homebrew 官方 cask 仓库,macOS 用户可以一行装。
核心亮点
- DeepSeek 官方客户端,MIT 开源,且已收录进 homebrew/cask(
brew install --cask deepseek-harness) - 工作区 + 会话管理:按项目/任务分块,历史会话挂在对应工作区下
- 官方插件改的是行为边界:智能体团队、终端超时与输出上限、Agent 循环、Subagent 层级与模型、网页搜索提供方
- 语音输入插件在本机用 SenseVoice 转写,不必把录音传给别人家服务
- 轨迹(Trace)视图:按 Turn / Tool Call 摊开,可看 Payload、Result、Timing 并导出,排查 Agent 行为最省事
- 自动化任务入口,可把重复流程挂起来跑
- 同时提供桌面 App 与命令行启动方式(npx @deepseek-ai/dsh web)
适用人群
已经在用 DeepSeek 模型、想把 Agent 从终端挪进图形界面的人;需要审查「Agent 到底执行了哪条命令」的开发者;以及做多智能体编排、想少写一点脚手架的国内用户。
安装前请注意
- 平台限制比较硬:Homebrew cask 的清单里写明依赖 macOS Ventura(13) 及以上、只提供 arm64 构建,Intel Mac 装不上这个 cask;Windows 侧官方给的是 x64 安装包,要求 Windows 10 及以上;没有 Linux 版,也没有 WinGet 包。
- 它还在预览阶段:cask 跟踪的版本号是 0.2.0-rc.2,官方页面自己标「预览版」,界面与插件接口都可能变;Homebrew 分析数据里 30 天装机量只有几百,属于早期工具,重要工作流别把宝全压上去。
- 认准官方源:GitHub 上有个同名但非官方的桌面项目(
ningbainb/deepseek-harness-desktop,star 数还不低),它不是 DeepSeek 官方实现,下载时请核对deepseek-ai组织与deepseek.com域名;官方安装包直链是download.deepseek.com/desktop/dsh-latest-macos-arm64.dmg与dsh-latest-windows-x64.exe。 - 桌面端会自动更新(cask 里
auto_updates: true),想固定版本要自己留意。
极速安装方式
方式一:macOS Homebrew
brew install --cask deepseek-harness
Windows 用户没有 WinGet 包,请到官方下载页取
dsh-latest-windows-x64.exe(需 Windows 10 及以上、64 位)。macOS 注意:官方 cask 只有 Apple Silicon 构建,且要求 macOS 13 Ventura 及以上。