跳到主要内容
AI教程

DeepSeek Harness Studio 教程：零代码管理插件、Preset 与本地 AI 工作区

本教程带你安装并使用 DeepSeek Harness Studio，了解其 Electron 桌面工作区、插件中心、Preset 广场、应用中心和视觉增强能力，并介绍源码启动、开发命令、安全设置及常见进阶用法。

AI我搜编辑部阅读约 16 分钟
DeepSeek Harness Studio 教程：零代码管理插件、Preset 与本地 AI 工作区

DeepSeek Harness Studio 是什么

DeepSeek Harness Studio 是由赋范空间开发的 DeepSeek Harness 桌面增强项目。它使用 Electron 承载 Web 工作区，并由桌面主进程自动启动和管理本地 dsh web 服务，让用户无需通过命令行即可使用和扩展 Harness。

DeepSeek Harness Studio 视觉增强、插件市场、Preset 广场、零代码一键部署、插件自动推送与 AI 智能推荐

它既适合希望直接安装桌面客户端的普通用户，也适合需要阅读、修改和构建完整源码的开发者。项目提供 macOS Apple Silicon 与 Windows x64 开发预览包，同时开放桌面应用、Web 界面、CLI、功能包、Python SDK、原生模块、示例及构建脚本。

当前发布的是开发预览版。桌面安装包只通过项目的 GitHub Releases 提供，不应从第三方下载站获取。

核心能力概览

  • Electron 桌面工作区：支持应用窗口、系统托盘、单实例运行、外部链接处理和受控的 preload 通信接口。

  • 本地 Harness Host：桌面主进程负责启动 dsh web、等待服务就绪，并在应用退出时关闭 Host 进程。

  • 插件发现与推荐：按照精选、最近更新、生态热度和使用场景浏览公开插件，也可按名称、功能或作者搜索。

  • Agent 智能找插件：通过自然语言说明需求，由 Agent 查询公开 dsh-plugin 目录并给出候选及推荐理由。

  • 公开插件中心：安装前检查确定版本、包完整性、Bundle 声明、权限、风险与本机兼容性，并管理插件的启用、停用、更新和卸载。

  • Preset 广场：安装由角色、Skills、工具和运行规则组合而成的 Agent Preset，并直接用它创建新会话。

  • 应用中心：启动拥有独立界面、数据目录和运行流程的完整 AI 应用。

  • 视觉增强：使用百炼 qwen3.8-max 理解附件或工作区图片，再把可追溯的视觉观察交给当前 Agent。

  • 中文模型控制：在输入区选择会话权限与 DeepSeek 思考模式。

  • 桌面外观：提供三套内置皮肤，并支持使用本地图片生成背景和适配界面配色。

哪些能力仍在规划中

独立 MCP、Skills 与工具管理，自定义 Agent 与多 Agent 协作，后台任务与会话恢复，项目规则、Hooks 与长期记忆，Git、Worktree 与代码审查，浏览器和桌面自动化，以及手机远程与消息通道仍属于规划能力。使用时不要把这些路线图项目误认为当前已经可用的功能。

方式一：直接安装桌面预览版

如果你只想使用应用，而不准备修改源码，可以直接下载桌面安装包。预览版运行时无需另行安装 Node.js 或 pnpm。

在 macOS arm64 上安装

  1. 从项目 GitHub Releases 下载并解压 ZIP。

  2. 把 DeepSeek Harness.app 拖入“应用程序”目录。

  3. 核验下载来源与 SHA-256 后，在首次启动前执行以下命令。

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

如果应用位于其他目录，请将命令中的路径替换为实际路径。由于当前预览包尚未经过 Apple 公证，这一步只应对从项目官方 GitHub Releases 获取并完成校验的安装包执行，不要对来源不明的应用使用。

在 Windows x64 上安装

  1. 下载 DeepSeek-Harness-Desktop-Windows-x64-0.1.0-rc.10-Setup.exe。

  2. 运行安装程序并按界面提示完成安装。

  3. 启动 DeepSeek Harness Studio，进入工作区。

正式发布流程与预览版相互独立。README 说明正式版本将使用与 Desktop 版本一致的标签，并在平台签名验证完成后发布安装文件和 SHA256SUMS。

方式二：从源码启动开发环境

准备开发环境

源码开发需要以下版本：

  • Node.js ^22.19.0 || >=24.0.0

  • pnpm 11.7.0

安装依赖和启动桌面开发环境不要求预先填写 API Key。只有在应用内实际调用模型或特定外部服务时，才需要配置相应凭证。

克隆并启动项目

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

dev:desktop 会构建必要模块并启动 Electron 桌面应用。开发启动器会在相关源码或构建输入发生变化时重新构建。

如果增量构建出现异常，或者你修改了需要完整重建的模块，可以执行：

pnpm run dev:desktop:rebuild

常用开发命令

  • pnpm run dev:desktop：构建必要模块并启动桌面开发环境。

  • pnpm run dev:desktop:rebuild：强制完整重建后启动。

  • pnpm run build：构建 Host、客户端、Web 与桌面端。

  • pnpm run package:desktop：为当前平台生成未封装桌面应用。

  • pnpm run typecheck：运行 TypeScript 类型检查。

  • pnpm run test：运行 Vitest 单元测试。

基本使用：创建和控制会话

配置模型与凭证

启动桌面端后，在设置页配置准备使用的模型服务和凭证。不要把 API Key 写入源码或提交到 Git。模型与 API Key 由设置页统一管理，输入区则用于查看当前 DeepSeek 模型并调整当前会话。

选择会话权限

输入区提供三档中文权限：

  • 只读：适合代码阅读、分析、解释和不需要修改文件的任务。

  • 工作区写入：允许 Agent 修改当前工作区，适合日常开发任务。

  • 完全访问：提供更高权限，启用前必须确认风险。

输入区的权限选择作用于当前会话；通用设置只决定以后新会话的默认权限。建议从满足任务需要的最低权限开始。

调整 DeepSeek 思考模式

当前会话可选择 关闭思考、深度思考 或 最大思考。界面不会显示 DeepSeek 不支持的速度档位。简单问答可关闭思考，复杂调研、代码分析或多步骤任务可根据需要提高思考级别。

发现和安装插件

从插件发现页浏览

  1. 从左侧导航进入插件发现。

  2. 查看目录精选、最近更新、生态热门或场景分类。

  3. 按插件名称、功能关键词或作者搜索。

  4. 查看简介、版本、作者和更新时间。

  5. 选中插件后进入插件中心执行安装。

场景分类覆盖 Agent 与工作流、Web UI、浏览器与搜索、视觉与媒体、记忆与上下文、模型与服务、开发工具以及集成与通知。

用自然语言让 Agent 找插件

如果不知道准确包名，可以在插件发现中输入需求。例如：

找一个适合桌面宠物场景的插件，并说明每个候选的版本、作者、更新时间和推荐理由。

应用会把需求作为 /find-plugins 请求交给当前 Agent。Agent 只读查询公开 dsh-plugin 目录，并返回相关候选。推荐结果属于公开目录元数据，不代表插件已经通过本机安装检查。

搜索与安装是两个独立步骤。确认包名后，仍应通过插件中心检查版本、Bundle 声明、权限、风险和兼容性。

安装与管理插件

  1. 进入插件中心并选择目标插件。

  2. 检查确定版本、能力、权限、兼容性与风险说明。

  3. 确认安装，由应用下载并校验包身份、完整性和 Bundle 声明。

  4. 安装完成后，桌面端会重启 Harness Host 并验证运行状态。

  5. 在已安装区域通过管理菜单启用、停用、更新或卸载插件。

卸载插件默认保留其配置与数据。如果还要删除数据，需要再次单独确认，这可以降低误删配置的风险。

使用 Preset 广场创建标准化工作流

Skill 用于告诉 Agent 一类任务应该怎样完成，Plugin 或 MCP 提供实际工具与外部服务连接，而 Agent Preset 会把角色、Skills、工具和运行规则装配为一套可重复使用的工作方式。

安装和运行 Preset

从左侧导航打开Preset 广场。

  1. 按名称、用途或作者搜索，也可根据下载量或更新时间排序。

  2. 打开详情，查看角色、Skill、工具、外部依赖和来源说明。

  3. 点击安装。桌面端会校验来源、大小、摘要和归档路径，然后写入本地用户 Preset 目录。

  4. 进入已安装，点击“用于新会话”。

  5. 在带有对应角色和工作规则的新会话中提交任务。

Preset 安装完成后不需要重启 Host。用户 Preset 可以删除并重新安装，系统 Preset受到保护。涉及安装、删除和新建会话的本机操作只在 Desktop 中执行；浏览器开发模式主要用于界面查看和验收，不会修改本机 Preset。

六套内置工作流

  • AI WebApp：通过需求澄清、规格整理、TDD、类型检查、构建和浏览器验收交付可运行 Web 产品。

  • PPT Office：生成八页、四主题、带语义动画的单文件 HTML 演示文稿；当前不生成 .pptx。

  • 视频生成：完成调研、简报、设计规范、分镜、源码和 16:9 MP4 渲染；环境需要 FFmpeg 与 ffprobe。

  • 内容工厂：把长文转为一至十张风格统一的图文卡片；真实生图需要本机 Codex CLI 已登录并具备 ImageGen 能力。

  • AI 报表：只读分析本地 Excel，输出不依赖 CDN 的单文件交互 HTML，并只在报告中嵌入聚合数据。

  • 飞书数字员工：把自然语言转为真实飞书任务；首次使用需要配置飞书应用凭据和默认负责人。

Preset 使用示例

以 AI 报表为例，可以先安装该 Preset，然后用它创建新会话并提交：

请只读分析工作区中的销售数据 Excel，核对数据基线，生成一个可离线打开的交互式 HTML 报告，并说明每项聚合指标的来源。

任务是否能够完整执行仍取决于工作区文件、Preset 声明的依赖以及本机环境。开始前应查看详情中的外部要求。

使用应用中心与 FF–LLM Wiki

AI 应用与插件、Preset 的定位不同。插件增加工具或局部界面能力，Preset 组织角色和工作流程，而应用拥有独立界面、专属数据与端到端运行流程。

启动企业知识库

  1. 打开应用中心。

  2. 选择内置的 FF–LLM Wiki。

  3. 点击“打开应用”，由 Desktop 管理本地运行环境并在系统浏览器中打开应用。

  4. 导入或管理企业资料。

  5. 执行文档解析、Wiki 编译、知识图谱构建、向量化与索引。

  6. 在智能问答中检查带来源引用的回答。

FF–LLM Wiki 的文档、Wiki、图谱和 SQLite 数据保存在 DSH Home 下的应用专属目录，不会混入当前项目工作区。知识编译、浏览和本地检索不要求模型密钥；使用 DeepSeek 生成式 RAG 前，需要在 Harness 凭证中心配置自己的 DEEPSEEK_API_KEY。

应用不会携带开发团队的 API Key。问答仅使用当前检索命中的证据片段并保留来源；模型不可用时，会明确降级为本地检索结果。

开启视觉增强

DeepSeek 文本模型本身不能直接理解图片。视觉增强会让内置的百炼 qwen3.8-max 先读取图片，再将识别结果作为可追溯的视觉观察交给 Agent，不会替换当前 DeepSeek 主模型，也不会改变当前权限和会话流程。

配置步骤

  1. 点击输入框左侧的“视觉增强”开关。

  2. 首次启用时配置百炼 API Key。

  3. 使用一张真实图片完成凭证验证。

  4. 在对话中添加截图、照片、图表或包含文字的图片，或者让 Agent 按路径读取工作区图片。

支持的工作区图片类型包括 PNG、JPEG、WebP 和 GIF。凭证只保存在本机受保护的凭证文件中。可用于分析产品截图、报错界面、设计稿、数据图表、照片和 OCR 内容。

视觉任务示例

请分析附件中的报错截图，提取错误文本，指出最可能相关的代码模块，并先给出只读排查步骤。

为了提高结果的可核查性，建议要求 Agent 区分“图片中直接观察到的内容”和“根据上下文作出的推断”。

个性化桌面外观

进入设置 → 背景，可以选择“官方原版”“大肥鱼拟人”或“云端猫咪”三套内置外观。也可以选择本地图片，并调节主体焦点与界面玻璃层。

自定义图片会在本机裁切为 1920×1080 WebP 并适配界面配色，原图不会上传。处理私人照片或内部设计素材时，这种本地处理方式更适合保护数据。

源码阅读与二次开发

项目目录重点

  • apps/desktop/：Electron 主进程、preload、Host 生命周期及桌面构建脚本。

  • apps/web/：Web 工作区入口与桌面端组合。

  • apps/cli/：dsh CLI、运行配置和 Agent Preset。

  • packages/：Agent、模型、工具、会话、插件和客户端能力包。

  • native/：原生沙箱辅助模块。

  • python/：Python SDK 与相关运行时。

  • examples/：可运行示例和配置。

  • scripts/：构建、检查、生成和发布脚本。

  • website/：项目文档站源码。

  • vendor/：固定版本的 Cordis 基础源码。

建议阅读顺序

  1. apps/desktop/src/main.ts：理解窗口、托盘和本地 Host 的整体组合。

  2. apps/desktop/src/host-supervisor.ts：查看 dsh web 的启动、就绪检测与退出管理。

  3. apps/desktop/src/preload.ts：了解 Renderer 可以访问的固定桌面接口。

  4. apps/web/：阅读桌面窗口加载的 Web 工作区。

  5. apps/cli/ 与 packages/：继续追踪 CLI 和 Harness 各项能力的实现。

进阶使用建议

按最小权限执行任务

代码解释、资料检索和设计评审优先使用只读权限。只有明确需要修改项目文件时才启用工作区写入。完全访问应保留给确实需要更高系统权限、且你已经理解操作范围的任务。

把发现、校验和执行分开

Agent 推荐插件后，不要直接把推荐理由当作安全结论。先在插件中心核查版本、发布者、更新时间、权限、Bundle 声明和兼容性，再决定是否安装。对于 Preset，也应先阅读外部依赖和来源说明。

先检查工作流依赖

不同内置 Preset 有不同要求。例如视频生成需要 FFmpeg 与 ffprobe，内容工厂的真实生图需要已登录且具备 ImageGen 能力的 Codex CLI，飞书数字员工需要飞书应用凭据，FF–LLM Wiki 的生成式 RAG 需要用户自己的 DeepSeek API Key。

在提交代码前运行检查

pnpm run typecheck
pnpm run test
pnpm run build

类型检查、单元测试和完整构建覆盖的目标不同。修改桌面 Host 生命周期、preload 接口或跨包类型后，建议至少依次运行这三项命令。

保护凭证和本地数据

不要把模型、百炼、飞书或其他服务的凭证提交到 Git。使用应用提供的设置页和凭证中心管理密钥，并在共享日志、截图或项目压缩包前检查是否包含敏感配置。

项目关系与许可证

DeepSeek Harness Studio 基于 deepseek-ai/deepseek-harness 的 Harness 核心、Cordis 插件体系和 Web 界面继续开发。本仓库主要维护 Electron 桌面入口、本地 Host 管理、桌面交互和配套开发脚本。

项目采用 MIT License。使用或再分发前，还应查看仓库中的第三方组件许可证说明。

结语

DeepSeek Harness Studio 把本地 Harness 工作区、插件发现与安装、Preset 工作流、完整 AI 应用和图像理解集中到了桌面界面中。普通用户可以从官方 Releases 直接开始，开发者则可通过 pnpm 启动完整源码环境。实际使用时，优先遵循最小权限、官方来源下载、安装前校验和凭证不入库四项原则。