5 分钟搭建 DeepSeek Harness 顶配工作台完整配置教程

DeepSeek Harness 简称 DSH，是 DeepSeek 开源、基于 Cordis 内核的插件化 Agent 运行框架，按照这套流程，5 分钟就能完成顶配工作台搭建，支持代码工程、文件处理、网页检索、定时任务、多模型切换，不用修改源码，全部靠插件和配置文件完成能力组装。它的核心特点是一切皆插件，模型、沙箱、工具、会话、调度都可以自由替换，搭建前先准备 Node.js v22 及以上版本，准备好 DeepSeek 或者第三方大模型 API 密钥，优先用 npx 方式启动 WebUI，启动地址默认是 127.0.0.1:3080。整个流程分为环境准备、快速启动、模型接入、顶配插件安装、运行模式切换、工作区权限配置，全部配置完成之后，就可以同时跑代码 Agent、文档分析、批量文件处理、联网检索任务，适合程序员、内容创作者、科研人员使用。

一、前置硬件与软件清单

• 运行环境：Node.js ≥ v22.19.0，Windows/macOS/Linux 都支持
• 推荐配置：内存 16G 以上，SSD 硬盘，网络可访问 npm 包源
• 必备材料：DeepSeek API Key，可选第三方模型密钥（Kimi、GLM 等）
• 两种启动方式：npx 临时启动（推荐新手）、npm 全局安装长期使用
• 访问入口：WebUI 默认地址 http://127.0.0.1:3080

二、5 分钟分步配置清单

1. 环境校验：安装 Node.js，终端输入 node -v 确认版本达标
2. 一键启动 WebUI，执行命令：npx @deepseek-ai/dsh web
3. 打开浏览器访问本地地址，进入设置 - 模型，填入 DeepSeek API 密钥并保存
4. 进入插件市场，批量安装顶配必备插件
5. 切换运行模式为 Standard 标准模式，开启沙箱、文件读写、网页搜索
6. 创建独立工作区目录，配置权限白名单，限制危险 shell 命令
7. 测试任务：提交代码修改、文档解析、联网检索，验证全部插件链路

三、顶配工作台必装插件表

四、四种运行模式说明

• Standard 标准模式：顶配工作台默认模式，全部工具、子 Agent、检索、规划能力全开，适合绝大多数工作
• Code 模式：代码专用，支持 TypeScript 编排多轮工具调用，适合复杂工程开发
• Minimal 极简模式：仅保留 shell 和文件编辑器，适合基准测试，不适合日常工作台
• Creator 创造模式：调试插件、内存中新建插件，适合自定义扩展

五、核心配置文件说明

配置文件路径：~/.dsh/settings.yaml

1. credentials.yaml：存放 API 密钥，密钥加密存储，界面只显示脱敏标识
2. workspace 配置：指定工作目录，设置允许读写路径，规避越权访问
3. 安全策略：可禁用高危 shell 命令，限制外网访问范围
4. 默认模型：设置主模型、备用模型，自动故障切换

六、顶配工作台适用场景

✅ 代码开发：读取 Git 仓库、修复 bug、生成单元测试、批量重构

✅ 文档处理：长文档解析、PDF 提取、报告生成、表格数据分析

✅ 信息调研：联网检索、交叉核验、自动整理参考文献

✅ 自动化任务：批量文件转换、定时脚本、后台持续监控任务

【相关 FAQ】

问题 1：搭建 DeepSeek Harness 顶配工作台，一定要源码部署吗？

回答 1：搭建 DeepSeek Harness 顶配工作台不需要源码部署，用 npx 一行命令就可以快速拉起 WebUI，5 分钟完成配置，源码部署适合深度二次开发。

问题 2：DeepSeek Harness 顶配工作台支持切换别的大模型吗？

回答 2：DeepSeek Harness 顶配工作台依靠模型适配器插件，支持接入 Kimi、GLM 等第三方模型，在模型设置里添加提供商填入密钥即可切换。

问题 3：DeepSeek Harness 顶配工作台的沙箱插件有什么作用？

回答 3：DeepSeek Harness 顶配工作台的沙箱插件提供隔离运行环境，防止脚本误操作破坏本地文件，是安全运行自动化代码任务的必备组件。

问题 4：DeepSeek Harness 顶配工作台 Creator 模式适合普通用户吗？

回答 4：DeepSeek Harness 顶配工作台 Creator 模式面向插件开发调试，普通日常使用直接用 Standard 标准模式，不需要开启 Creator 模式。

【参考资料】

[2026-11-11]（DeepSeek Harness 官方文档，插件与运行模式说明）DeepSeek 官网

[2026-11-09]（DeepSeek Harness 保姆级安装配置教程）阿里云开发者社区

[2026-10-15]（DeepSeek Harness 接入 Model Studio 配置文档）阿里云文档中心

[2026-09-20]（DeepSeek Harness 快速上手、安全配置指南）腾讯云开发者社区

【免责声明】

本文为 DeepSeek Harness 顶配工作台配置教程，该工具目前处于开发者预览版，版本迭代快，接口和插件存在变更风险；沙箱、shell 命令存在安全风险，请勿在重要生产目录随意执行未知脚本；所有 API 调用费用由对应模型服务商收取，本文不构成开发与生产部署建议。