DeepSeek Harness 终于有了官方桌面端。它最大的变化是自带运行环境:不需要先装 Node.js,也不用每次开终端启动服务。装好、配好账号或 API Key,就能让它读取本地文件、修改代码、整理资料和执行命令。目前仍是开发者预览版,最新版本为 0.1.7-rc.2。
安装:下载地址不在 GitHub Release
桌面端安装包走的是 DeepSeek 官方分发域名 download.deepseek.com,GitHub Release 附件里没有挂安装包,只看 Release 页面容易漏掉。官方桌面端 README 的“上传更新”部分写明:正式分发使用 download.deepseek.com,安装包位于 dsh-desk/bin//。
Windows x64 下载地址为 download.deepseek.com/dsh-desk/bin/win-x64/deepseek-harness-0.1.7-rc.2-win-x64.exe;Apple 芯片 Mac 下载地址为 download.deepseek.com/dsh-desk/bin/mac-arm64/deepseek-harness-0.1.7-rc.2-mac-arm64.dmg。后续更新只需替换其中的版本号。官方更新清单 nightly.yml 标注了 version: 0.1.7-rc.2,并提供文件大小和 SHA-512 校验值——企业内网分发前建议先核对校验值。
Windows 用户下载 .exe 后双击运行,按向导选择安装目录。新安装建议使用空目录,完成页可直接启动。覆盖安装时若提示应用仍在运行,需要先从系统托盘退出再继续。Mac 用户下载 .dmg 后双击打开,把应用拖到“应用程序”,再从“应用程序”启动。
首次配置:登录还是 API Key
欢迎页有两个入口:登录和添加 API Key,选一种完成配置即可继续使用。
直接登录更省事:点击“登录”后客户端会打开系统浏览器完成账号授权,授权成功返回客户端;如果窗口没有自动切回来,可以点击完成页的打开客户端入口。登录后可在“设置 → 账号与余额”查看充值余额、赠金余额和用量。
已经在调用 DeepSeek API 的,可以在欢迎页点击“添加 API Key”,粘贴密钥后点“保存并继续”。没有密钥的,登录 DeepSeek 开放平台后在 API Keys 页面创建,地址是 platform.deepseek.com。
欢迎页也有“稍后配置”,可以先进入界面,但要开始请求模型仍需完成登录或配置有效 API Key,后续可在“设置 → 模型”里调整。需要注意:账号登录和 API Key 在模型列表中分成不同的提供方。两种方式都配过的,发任务前先确认选中了哪一组,避免把账号额度和 API 调用额度混在一起。
工作区:本地文件读写的实际边界
进入主界面后先选工作区。工作区对应电脑上的一个文件夹,任务需要读取的资料和生成的文件都放在里面。第一次打开时应用会尝试创建默认工作区;想处理自己的项目,就在侧边栏选择“添加工作区”,通过系统文件夹选择窗口选中目录,选好后会打开会话,再从输入框附近的模型选择器中选一个可用模型。
这里有一个容易被忽略的边界:工作区对应本地文件夹,但不自动等于严格的文件访问隔离。初次体验建议用单独的测试目录,不要直接选整个用户目录。这一点在官方资料中没有给出隔离机制的细节说明,属于工程上的保守建议。
一个可复现的任务示例是生成单文件 HTML 动画:提示词要求创建一个可直接打开的单文件 HTML,展示“孙悟空开飞机,鹈鹕坐在乘客位”的 2D 动画,包含起飞、平稳飞行、遭遇气流和恢复平稳四个阶段,提供播放/暂停、重新开始和触发气流按钮,使用内联 SVG、Canvas 或 CSS,不依赖外部资源,适配桌面和手机,交付文件名为 pelican-wukong-flight-deepseek.html。当时使用 DeepSeek V4 Pro High 在本地 Harness 中完成,界面记录用时 9 分 49 秒。从交付说明看,它使用 Canvas 绘制,安排了四个阶段和三个按钮,角色的金箍、猴脸、金箍棒以及鹈鹕的长喙和喉囊都写进了交付说明。
插件:桌面端内直接安装
想在 Harness 里继续查看、修改生成的文件,可以加一个 Better Sidebar。它在原生右侧栏上增加了编辑、文件管理和任务查看能力,还提供可以同时展开的底部工作台。DSH 0.1.7 已经自带图片、PDF、表格和 Office 文档预览,终端也由 DSH 提供;Better Sidebar 当前版本把这些能力交还给内置功能,主要保留自己的 Markdown、HTML 和代码编辑能力。
桌面端可以直接在界面里安装。0.22.0 要求 DSH 0.1.7-rc.1+,本文使用的 0.1.7-rc.2 在支持范围内;旧版 DSH 用户需要按 README 的版本表选择插件版本。安装步骤:点击主界面左侧“插件”,再点右上角“添加插件”;在“包名或地址”里输入 dsh-better-sidebar@0.22.0;将“安装源”选为“npm 官方源”,点击“安装”;等界面显示“已安装”后点击“立即启用”,回到插件列表确认开关已打开。启用后“设置”里会多出一个“侧边卡片”入口,可以调整侧边栏的显示内容和默认行为。
想继续找插件,可以装 DSH Market。它把社区插件集中到客户端里,支持搜索、分类浏览和点击安装,也可以查看已安装的插件。安装方法相同:打开左侧“插件 → 添加插件”,在“包名或地址”里输入 dshmarket,选择“npm 官方源”,点击“安装”,完成后点“立即启用”。启用后打开“设置 → 插件市场”即可看到页面,本次安装后显示的版本是 v1.66.2。
企业内网与离线场景的注意事项
官方资料没有提供内网代理、私有源或离线部署的专门说明,以下属于工程层面的建议,需要结合实际情况验证:
第一,安装包来源要固定。桌面端安装包只从 download.deepseek.com 获取,内网分发前用 nightly.yml 中的 SHA-512 校验值核对文件完整性,避免中间环节被替换。
第二,插件安装依赖 npm 官方源。Better Sidebar 和 DSH Market 的安装步骤都要求选择“npm 官方源”,在完全隔离的内网环境中这一步会失败。如果确实需要离线使用,需要提前评估插件是否必需,或准备内部镜像方案。
第三,账号登录会打开系统浏览器完成授权,这条链路在无外网环境下不可用;此时只能走 API Key 方式,并且需要确认 API 出口是否可达。
第四,工作区选择要克制。由于工作区与本地文件夹直接对应,且官方未说明严格的访问隔离机制,建议为每个项目单独建目录,不要用整个用户目录或包含敏感配置的仓库根目录作为工作区。
第五,当前是开发者预览版,版本迭代较快,覆盖安装前先从系统托盘退出应用,避免安装失败。
小结
桌面端把安装和启动的门槛降下来了:不用装 Node.js,不用开终端起服务,装好配好就能用。配置上建议直接用登录账号方式;使用时一定要养成先选工作区的习惯。插件生态已经能在客户端内完成安装和启用,但 npm 官方源这一依赖在内网场景下需要额外规划。