前言¶

DeepSeek Harness（dsh）把智能体运行时拆成插件组合：官方仓库的定位是「一切皆插件」，日常入口则是 npx @deepseek-ai/dsh web 或源码里的 pnpm dsh web。对已经熟悉 Node.js 和命令行的人来说，这条路径够用；对更多想先把工作区、插件和会话放进一个窗口里的人来说，门槛会集中在三件事：本机要先装运行时，插件散落在 npm 与 GitHub 上不好找，装完还要自己核对版本、权限和兼容性。

社区目录里把 deepseek-harness-studio 收在「通知与集成」分类。仓库由 fufankeji 维护，README 写明出品方是赋范空间。它不是再往现有 dsh 进程里塞一个通知通道，而是用 Electron 把 DeepSeek Harness 的 Web 工作区、本地 Host 和桌面窗口合在一起，让插件发现、安装、Preset 和工作区可以在桌面端完成。本文按社区目录页、GitHub 仓库 README、Releases 与官方 deepseek-ai/deepseek-harness 交叉核对后整理。

这是什么¶

deepseek-harness-studio 是面向 DeepSeek Harness 的开源桌面端。社区目录给出的一句话是：零代码桌面端，一键启动，支持 Windows 与 macOS；内置插件发现、热点插件推送、一键安装与管理、AI 智能推荐和视觉增强。

仓库在 GitHub 上的地址是 fufankeji/deepseek-harness-studio，主要语言是 TypeScript，许可证为 MIT。本次查阅时 GitHub 显示 239 颗星。它基于官方 deepseek-ai/deepseek-harness 的 Harness 核心、Cordis 插件体系和 Web 界面继续做桌面层：本仓库负责 Electron 入口、本地 Host 生命周期、桌面交互和配套脚本，并不替代官方 Harness。

有两点需要先说清楚。第一，社区插件目录 deepseek-harness-plugin.com 是独立站点，和 DeepSeek / 幻方没有官方从属关系，不能把它当成官方应用商店。第二，README 里的「赋范官方」只表示由赋范桌面端开发团队内置和维护，不代表 DeepSeek Harness 官方。

核心功能¶

仓库把能力分成「已支持」和「规划中」。下面只展开 README 标明已经可用的部分；规划项会在注意事项里单独列出，避免把路线图写成现成功能。

桌面窗口和本地 Host¶

Studio 用 Electron 承载 DeepSeek Harness 的 Web 工作区，桌面主进程负责启动、等待并在退出时关闭本地 dsh web 服务。窗口侧提供系统托盘、单实例运行、外部链接处理和 preload 通信接口。Web 工作区仍然保留会话、工作区、模型、工具、Skills 和插件这些 Harness 能力，只是换了一个桌面壳。

从 GitHub Releases 安装的开发预览包会带上运行所需环境，README 写明运行桌面端无需另行安装 Node.js 或 pnpm。需要改源码时，仍可克隆完整仓库在本地启动。

插件发现、智能推荐和插件中心¶

不知道该装什么时，从左侧进入「插件发现」。应用会读取公开目录，按精选、最近更新、生态热门和场景分类展示插件，也支持按名称、功能或作者搜索。场景分类覆盖 Agent 与工作流、Web UI、浏览器与搜索、视觉与媒体、记忆与上下文、模型与服务、开发工具、集成与通知。

只知道需求、说不出包名时，可以把自然语言交给当前 Agent。应用把它作为 /find-plugins 请求发出，Agent 只读查询公开 dsh-plugin 目录，返回候选包名、版本、作者、更新时间和匹配理由。推荐结果只是目录元数据，真正安装仍要进「插件中心」做兼容性检查。

插件中心面向 npm 上带 dsh-plugin 标签、并符合 DeepSeek Harness Bundle 规范的包。安装前会校验确定版本、产物完整性、Bundle 声明和本机兼容性；确认后下载并重启 Harness Host 做运行验证。已安装区域可以按系统、公开目录和本地来源查看，通过菜单启用、停用、更新或卸载。卸载默认保留配置与插件数据，清理数据需要再确认一次。

Preset 广场和六套内置工作流¶

README 把能力分成三层：Skill 教 Agent「怎么做」，Plugin / MCP 提供可执行工具，Agent Preset 则把角色、Skill、工具和运行规则打成一套可重复使用的工作方式。Preset 广场与插件发现、插件中心平级，流程是：发现 → 查看能力组成和前置条件 → 一键安装 → 在「已安装」里选「用于新会话」。安装或删除用户 Preset 不必重启 Host；系统 Preset 受保护。浏览器开发模式只用于查看界面，不会改本机 Preset。

当前内置六套真实场景工作流，合计 6 套 Agent Preset、8 个 Skills、1 个图像生成 Plugin。飞书数字员工另外接入飞书 MCP 与时间解析 MCP，PPT Office 使用内置动效运行适配器：

安装包交付的是运行所需的精简 Preset、Skills 与工具适配，不会把案例源码、输入数据或生成成品写进用户环境。

应用中心和视觉增强¶

应用中心用来启动拥有独立界面、专属数据和自己运行流程的完整 AI 应用，而不是在插件列表里辨认技术包。首个内置应用是 FF–LLM Wiki：把文档解析、Wiki 编译、知识图谱、向量化和可追溯问答串成流水线，由 Desktop 管理本地运行环境，在系统浏览器中打开。数据写入 DSH Home 下的应用专属目录，不混入当前项目工作区。应用不会携带赋范团队的 API Key；知识编译、浏览和本地检索可以先跑，使用 DeepSeek 生成式 RAG 前需要在 Harness 凭证中心配置自己的 DEEPSEEK_API_KEY。

DeepSeek 文本模型本身不能直接理解图片。打开「视觉增强」后，内置的百炼 qwen3.8-max 会先读取对话附件或工作区里的 PNG、JPEG、WebP、GIF，再把可追溯的识别结果交给 Agent，不替换当前 DeepSeek 主模型、权限和会话流程。首次启用要用一张真实图片验证百炼 API Key，凭证只保存在本机受保护的凭证文件中。

另外，输入区提供中文权限档位（只读、工作区写入、完全访问）和思考模式（关闭思考、深度思考、最大思考）。通用设置只决定后续新会话的默认权限；启用完全访问前必须确认风险。外观可在「设置 → 背景」切换「官方原版」「大肥鱼拟人」「云端猫咪」，也可选用本地图片；自定义图片在本机裁切为 1920×1080 WebP 并适配配色，不上传原图。

安装与启用¶

社区目录给出的安装命令如下，在已经可用的 DeepSeek Harness 终端里运行：

dsh plugin add github:fufankeji/deepseek-harness-studio

如需可复现安装，目录页建议固定 commit 哈希：

dsh plugin add github:fufankeji/deepseek-harness-studio#commit

把 #commit 换成实际提交哈希。这条命令走的是 dsh 的 GitHub 插件安装路径：CLI 会解析仓库并写入当前 profile。仓库本身是一份完整的桌面开发环境，日常使用路径以 GitHub Releases 里的安装包为主，不要和下文的桌面预览包混成同一步。

下载桌面预览包¶

README 写明：桌面安装包只通过本仓库的 GitHub Releases 发布，不使用第三方下载站。本次查阅时，最新预览是 DeepSeek Harness Studio 0.1.0-rc.9（Pre-release），提供 macOS Apple Silicon 的 ZIP 和 Windows x64 的 Setup.exe。当前均为未签名开发预览；正式版本计划提供完成平台签名的 macOS .dmg 和 Windows x64 .exe。

macOS arm64¶

1. 从 Releases 下载并解压预览 ZIP。
2. 把 DeepSeek Harness.app 拖入「应用程序」目录。
3. 当前预览包尚未经过 Apple 公证，首次打开前在终端执行：

xattr -dr com.apple.quarantine "/Applications/DeepSeek Harness.app"
open "/Applications/DeepSeek Harness.app"

如果应用没有放在「应用程序」目录，把路径换成实际位置。这条命令只应用于从本仓库 Releases 下载并核验过 SHA-256 的预览包。Release 说明还写了：不要下载 GitHub 自动生成的 Source code.zip / Source code.tar.gz，那是源码不是安装包。当前 macOS 包仅支持 Apple Silicon（arm64）。

Windows x64¶

下载 DeepSeek-Harness-Desktop-Windows-x64-0.1.0-rc.9-Setup.exe 后直接运行安装程序。预览安装程序未经 Authenticode 签名，Windows 可能弹出 SmartScreen，按「更多信息 → 仍要运行」处理；不要为此关闭 Defender。0.1.0-rc.9 的说明提到：本版修复了 FF–LLM Wiki 首次启动时内容目录尚未创建导致的启动失败。

从源码启动（开发）¶

下载源码、安装依赖和启动桌面开发环境不需要预先填写 API 密钥。真正调用模型时，再在设置里配置所选服务与凭证，不要把密钥提交到 Git。

环境要求：

• Node.js ^22.19.0 || >=24.0.0
• pnpm 11.7.0

git clone https://github.com/fufankeji/deepseek-harness-studio.git
cd deepseek-harness-studio
pnpm install
pnpm run dev:desktop

需要强制完整重建时使用 pnpm run dev:desktop:rebuild。

典型用法¶

下面几条都来自仓库 README 写明的桌面操作路径，可以按界面复现，不是额外编出来的案例。

1. 找插件并安装。 打开桌面端，从左侧进入「插件发现」，按精选 / 最近更新 / 场景浏览，或直接搜索名称和作者。未安装的插件进入安全安装流程；已安装的转到插件中心管理。也可以在发现页用自然语言描述需求（README 里的验收例子是「找一个桌面宠物插件」），看完候选和匹配理由后，再回插件中心确认安装。
2. 用 Preset 开新会话。 进入 Preset 广场，按用途或作者搜索，打开详情核对角色、Skill、工具和外部依赖，点击安装。Desktop 会校验来源、大小、摘要和归档路径，再写入本地用户 Preset 目录。到「已安装」里点「用于新会话」，即可带着这套工作方式开始任务。
3. 打开 FF–LLM Wiki。 应用中心 → 选择 FF–LLM Wiki →「打开应用」→ 导入资料、构建 Wiki 与知识图谱 → 在智能问答里核对带来源的答案。左侧快捷入口默认关闭，可在「显示在侧边栏」里打开。
4. 给当前会话补上读图。 在输入框左侧打开「视觉增强」，按提示用一张真实图片验证百炼 API Key。之后可以把截图、报错界面、图表或工作区图片交给 Agent；主模型仍是当前 DeepSeek 文本模型。
5. 改权限和思考深度。 在输入区选择 只读 / 工作区写入 / 完全访问，以及 关闭思考 / 深度思考 / 最大思考。完全访问会作用于当前会话，启用前先看风险提示。

适用场景与注意事项¶

更适合这几类使用方式：

• 希望少碰 Node.js 和命令行，直接用窗口管理 DSH 工作区、会话和插件。
• 需要从公开 dsh-plugin 目录里搜索、校验后再安装，而不是自己拼 GitHub 地址。
• 想用现成 Preset（Web 产品、HTML 演示、视频、图文卡片、Excel 报告、飞书任务）开新会话。
• 主模型仍用 DeepSeek 文本模型，但偶尔要把截图或工作区图片变成可追溯的视觉观察。

使用前注意这些边界：

• 平台。 当前预览包是 macOS arm64 和 Windows x64。README 没有把 Linux 桌面安装包列为已发布资产。
• 预览状态。 0.1.0-rc.9 是未签名 Pre-release。macOS 可能被隔离机制拦截，Windows 可能出现 SmartScreen。正式签名安装包尚未作为当前下载物提供。
• 规划中、尚未作为可用功能写出的能力包括：独立 MCP / Skills / 工具管理，自定义 Agent 与多 Agent 协作，任务规划、后台运行与会话恢复，项目规则、Hooks 与长期记忆，Git / Worktree 与代码审查，浏览器与桌面自动化，以及手机远程与消息通道。这些项在 README 里标记为规划中，本文不把它们当成已经能用的功能。
• 外部依赖。 视频生成需要本机 FFmpeg 与 ffprobe；内容工厂生图需要已登录且具备 ImageGen 的 Codex CLI；飞书数字员工需要飞书应用凭据；视觉增强需要百炼 API Key；FF–LLM Wiki 的生成式 RAG 需要用户自己的 DEEPSEEK_API_KEY。
• 权限与来源。 社区目录写明：插件以当前 dsh 进程的权限运行，安装时可能执行代码。无论走 dsh plugin add 还是装桌面预览包，安装前都应检查源代码仓库和许可证；桌面包只从本仓库 Releases 获取，并核验 SHA-256。不要把来源不明的安装包拿来跑 xattr 解除隔离。

小结¶

deepseek-harness-studio 把 DeepSeek Harness 的 Web 工作区和本地 Host 收进 Electron 窗口，并在桌面端补上插件发现、插件中心、Preset 广场、应用中心和视觉增强。它由 fufankeji / 赋范空间维护，MIT 许可，基于官方 Harness 继续做桌面层，但不是 DeepSeek 官方发行版。

目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-studio/

GitHub：https://github.com/fufankeji/deepseek-harness-studio