DeepSeek Harness Studio

August 28, 2026 · View on GitHub

非官方社区项目：一个面向 Windows 的 DeepSeek Harness 桌面客户端。

界面采用现代智能体产品的分栏布局，真正复用官方 @deepseek-ai/dsh 运行时，而不是静态聊天页面。

Release 下载安装版

DeepSeek Harness Studio

安装使用

直接下载最新版（Windows 10/11）：

历史版本见 Releases。

使用 DeepSeek 原生视觉（2 步）：

  1. 在 Harness 模型设置中配置 DeepSeek API Key；
  2. 打开模型选择器，选择 DeepSeek-V4-Flash-Vision-Exp，粘贴图片即可直接识图。模型选择器会定期读取 DeepSeek 官方模型目录，后续新模型无需客户端写死。

需要将其他视觉 API 接给纯文本模型时，仍可使用“插件 → 生态组件 → ModLens”，并在 Studio「偏好设置 → 视觉能力」配置阿里千问或其他多模态端点。

读 PDF / Word / Excel： 聊天输入框只收图片（PNG/JPG/WebP/GIF），读文档请用「文件路径 + read_document 工具」，例如直接发「读取 D:\资料\报告.docx 的内容」。详见 docs/COMPONENTS_CN.md。

模型切换说明： 原生视觉模型和 ModLens 识图后都可以在同一会话切回普通文本模型。历史图片会被转换为“图片已省略”的文字占位并保留已有文字结论；输入框中尚未发送的新图片需使用原生视觉模型或带 (modlens vision) 的模型。

插件启动保护： v1.07.4 起，应用启动和插件变更后都会验证 Harness 是否真正可用；故障组件会被定位并持久隔离，不会再因安装其他组件而被意外重新启用。

跨设备插件安装： v1.07.5 起，所有运行路径都按当前设备动态生成；npm 官方源发生连接重置、超时或 DNS/网络错误时，会自动切换国内 npm 镜像重试。

通用 pnpm 失败恢复： v1.07.6 起，即使 DSH 隐藏了底层网络错误、只返回 pnpm failed in profile directory，也会自动切换国内镜像；插件错误输出使用连续 UTF-8 解码，不再出现成串乱码。

新版应用图标： v1.07.7 起，Windows 应用、安装程序和快捷方式统一使用 DeepSeek 鲸鱼背景与 HARNESS STUDIO 标识；小尺寸图标采用独立的鲸鱼 + HS 构图。

无需全局 pnpm： v1.07.7 修复 Windows Path/PATH 重复键导致 DSH 忽略 Studio 内置 pnpm 的问题；两次 DSH 转发均失败时还会直接调用安装包内置 pnpm，不要求目标电脑预装 Node.js 或 pnpm。

更新线路互斥： v1.07.8 起，同一时间只运行一个安装包下载任务；自动模式严格按“国内镜像失败 → GitHub 官方”顺序回退，也可选择仅国内镜像、仅 GitHub 或仅自定义镜像。启动安装前会停止 Harness 并释放安装目录。

国内镜像默认： v1.07.9 起，新安装和未设置下载线路的用户默认使用“仅国内镜像”，不会同时请求 GitHub；如有需要仍可手动选择自动回退或仅 GitHub 官方。

动态模型发现： v1.08.0 起，模型选择器通过 DeepSeek 官方 GET /models 自动发现可用模型，5 分钟缓存后重新检查；不再假定只有 Flash 和 Pro，并原生支持 deepseek-v4-flash-vision-exp 图片输入。

真实搜索与桌面控制： v1.09.0 起，智能体可调用 DeepSeek 官方 web_search 搜索实时互联网内容并给出来源。Windows 桌面控制默认关闭，可在「偏好设置 → 智能体能力」启用；截图、窗口读取、点击、滚动、输入和快捷键均逐次要求批准。详见 真实世界智能体使用说明。

升级方式： 在「偏好设置 → 软件更新」检查并下载更新，点「安装并重启」后按安装向导完成覆盖安装（可自定义安装目录）。

已实现

  • 原生无边框桌面窗口、启动动画、运行状态与故障恢复。
  • 官方 Harness Web UI：会话、工作区、模型设置、工具调用、权限、Skills、子智能体等能力由 Harness 提供。
  • DeepSeek 官方实时搜索：使用已有 DeepSeek API 配置调用 web_search，回答可携带真实网页来源。
  • 可选 Windows 桌面控制：截图、窗口、鼠标、滚轮、文字与受限快捷键；默认关闭并对每个操作单独请求批准。
  • DeepSeek 动态模型目录：模型选择器读取认证后的官方 /models 清单并定期刷新，接口失败时使用最后成功结果或安全兜底；原生视觉模型直接接收 DSH 图片附件。
  • 社区插件中心：支持 npm 包、github:owner/repo、GitHub URL 和本地插件目录；展示实际安装版本、DSH bundle 与加载模块健康状态，并提供启动诊断、安全隔离、筛选、启停、更新、修复、卸载、安装目录和完整活动日志。
  • 精选生态组件：内置 ModLens 视觉、ModSearch 联网搜索、PPTFast、文档读取和 DSH Backup 的版本化一键接入入口。
  • ModLens 视觉 API 设置：默认「阿里千问 Qwen-VL」（阿里云百炼 DashScope，国内直连），其余 Gemini、Anthropic、Claude CLI、OpenAI 兼容等多模态端点折叠进「高级选项」；检测引擎状态并在保存后自动重启 Harness；API Key 不进入项目或 Git。
  • Token 余额显示：顶栏实时显示 DeepSeek 账户余额，点击可刷新；读取 ~/.dsh/.credentials.yaml 中的 DEEPSEEK_API_KEY。
  • DSH Skill 管理：导入、发现和移除包含 SKILL.md 的本地技能包；Harness 可热刷新并通过 /skill-name 调用。
  • 插件启用 / 停用 / 卸载：直接管理 ~/.dsh/profiles/web 的依赖与 bundles。
  • 安装过程日志、可信来源提示，以及插件变更后的 Harness 自动重启。
  • 默认工作区、本地端口、Windows 开机启动和运行时路径管理。
  • 零配置新会话：首次启动自动创建并注册 %USERPROFILE%\Documents\DeepSeek Harness\Workspace。
  • 智能路径识别：聊天中出现 E:\project、C:/work/app、UNC 路径或具体文件时，自动识别并注册已有目录；显式路径优先于默认工作区。
  • 安装版与免安装版 Windows 可执行文件。
  • 应用内更新：启动后可自动检测 GitHub Releases；下载自动走系统代理（环境变量优先，其次 Windows 系统代理），同一时间仅运行一个下载任务，支持严格顺序的国内镜像 → GitHub 自动回退，以及仅镜像、仅 GitHub、仅自定义线路，安装包始终强制验证 SHA-256；更新采用「下载安装包 + 安装向导」方式，可自定义安装目录。
  • DeepSeek 官方 Harness 随附的鲸鱼图标，用于窗口和可执行文件。

开发运行

环境要求：Windows 10/11、Node.js 24、npm。首次安装依赖：

npm install
npm run dev

浏览器中单独预览桌面壳层：

npm run dev:web

从源码构建

npm test
npm run dist

输出位于 release/：

  • DeepSeek-Harness-Studio-Setup-1.09.0-x64.exe：推荐的安装向导，可自定义安装目录并覆盖升级现有版本。
  • DeepSeek-Harness-Studio-Portable-1.09.0-x64.exe：免安装版。

构建脚本会先运行 npm run runtime:prepare，把当前 Node.js 24 运行时复制到打包资源中，因此成品不依赖用户系统 PATH；该大型二进制不提交到 Git。Harness 本身作为 production dependency 一同打包。

文档

版本说明

插件导入

插件中心最终调用官方命令：

dsh plugin --profile web add <source>
dsh plugin --profile web update <package> --latest
dsh plugin --profile web install
dsh plugin --profile web remove <package>

启停开关会修改：

%USERPROFILE%\.dsh\profiles\web\package.json

内置的 @deepseek-ai/dsh-base 与 @deepseek-ai/dsh-web-app 不允许停用或卸载。社区插件拥有的权限取决于其代码及 Harness composition，安装前应审查来源。GitHub 插件的 prepare 构建脚本可能被 pnpm 拦截，此时安装日志会显示需要添加到 allowBuilds 的包名。

配置与故障排查

  • 主智能体 API、模型供应商与主题：进入 Harness 内部的“设置”。
  • DeepSeek 原生视觉：在 Harness 内部配置 DeepSeek 官方 API Key，打开动态模型选择器并选择 DeepSeek-V4-Flash-Vision-Exp，即可直接粘贴图片。
  • ModLens 视觉 API（可选）：若需把阿里千问 Qwen-VL 等其他视觉端点桥接给纯文本模型，进入 Studio 右上角“偏好设置 → 视觉能力”配置。
  • Studio 偏好：窗口右上角齿轮。
  • 实时搜索：先配置 DeepSeek 官方 API Key，直接要求“搜索今天/最新的……并附来源”；Harness 会展示 web_search 工具卡片。
  • 桌面控制：在「Studio 偏好设置 → 智能体能力」启用，保存后 Harness 自动重启。选择支持图片的模型后，可要求“查看当前桌面并……”，每个真实操作都需要你批准。
  • Harness 数据：%USERPROFILE%\.dsh。
  • 默认 Web profile：%USERPROFILE%\.dsh\profiles\web。
  • 默认地址：http://127.0.0.1:3080，只监听本机。
  • 默认工作区：%USERPROFILE%\Documents\DeepSeek Harness\Workspace。不需要预先选择目录即可开始第一段对话。
  • 消息内路径：建议使用绝对路径或引号包裹带空格的路径，例如 “E:\My Project”。不存在的目录不会被客户端擅自创建，仍交由智能体按消息要求处理。
  • 端口冲突时，在 Studio 偏好里改用 1024–65535 范围内的其他端口。

工程结构

electron/
  main.cjs                  Electron 主进程与 IPC
  preload.cjs               安全的渲染层桥接
  lib/runtime-manager.cjs   Harness 生命周期与就绪探测
  lib/plugin-manager.cjs    社区插件清单、导入、启停与卸载
  lib/modlens-manager.cjs   ModLens Provider 配置、状态诊断与安全代理
  lib/update-manager.cjs    GitHub Release 检测、下载与完整性校验
packages/
  dsh-desktop-control/      自包含、逐次授权的 Windows 桌面工具
src/
  App.jsx                   桌面界面
  styles.css                视觉系统与动效
tests/                      Node 内置测试
assets/runtime/node.exe     随应用分发的 Node.js 运行时
build/app.ico               Windows 可执行文件图标
build/update-config.json    发行版默认更新仓库

品牌说明

本项目是非官方社区客户端，与 DeepSeek 官方不存在隶属、赞助或背书关系。DeepSeek 名称、商标与图标归其权利人所有。本工程用于包装其开源 Harness；对外分发或商业使用前，请自行确认已获得适当的品牌授权。详见 THIRD_PARTY_NOTICES.md。

参与贡献

欢迎提交 Issue、功能建议与 Pull Request。开始前请阅读 CONTRIBUTING.md；安全问题请按 SECURITY.md 中的方式私下报告。

开源首发、社区短文案、英文简介与发布检查清单见 docs/PROMOTION_CN.md。宣传图片位于 docs/assets/，可运行 npm run promo:build 重新合成。