### [DeepSeek Harness零基础教程：安装、首次运行、多模态、Skills、插件与卸载](https://www.zuoshipin.com/article/23706) **Published:** 2026-08-23T03:45:39 **Author:** 天才交易员 **Excerpt:** DeepSeek Harness（DSH）零基础图文教程：从 npx 一键启动、源码安装、模型与工作区配置，到… **从 npx 一键启动到工作区、Goal/Plan、图片输入、PPT Skill、插件管理和安全卸载，一篇跑通 DSH。** DeepSeek Harness（简称 DSH）不是一个单纯的聊天网页，而是一套开源 Agent Harness：它把模型、工具、Skills、会话、沙箱、存储和界面组织成可组合的插件。对新手来说，最直观的理解是——它像一盒“赛博乐高”，你可以先用默认 Web UI 跑起来，再按任务逐步添加能力。 ![DeepSeek Harness 零基础安装与使用教程配图 1](https://admin.zuoshipin.com/wp-content/uploads/2026/08/658f0243-9dd3-11f1-a884-fa163e47d677.webp) DeepSeek Harness 的整体界面与使用入口 **开始前提醒：**官方项目仍处于开发者预览阶段，版本迭代快，可能出现不兼容更新。首次体验建议使用独立测试目录、最小权限和可回滚文件，不要直接把重要项目交给 Agent 全自动修改。 ## 一、DeepSeek Harness 是什么？适合谁用 DSH 的核心价值，是把“模型会思考”与“模型能执行”连接起来。模型负责理解目标和生成计划，Harness 则负责提供文件、终端、搜索、浏览器、子代理、持久会话等运行能力，并通过权限策略决定哪些操作需要确认。 ![DeepSeek Harness 零基础安装与使用教程配图 2](https://admin.zuoshipin.com/wp-content/uploads/2026/08/66124020-9dd3-11f1-8e9d-fa163e47d677.webp) 插件化 Harness 将模型、工具与工作流连接起来 ![DeepSeek Harness 零基础安装与使用教程配图 3](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6683fec8-9dd3-11f1-ad23-fa163e47d677.webp) DSH 的任务执行与界面展示 它更适合希望在本地项目中使用 Agent、需要观察工具调用过程、想组合不同模型和插件的开发者与内容创作者。若你只是偶尔问答，普通聊天产品更省事；若你希望 Agent 真正读写工作区、运行命令和维护计划，DSH 的可扩展结构更有吸引力。 ## 二、安装前准备：Node.js、终端与独立工作区 先在终端检查 Node.js 与 npm： ``` node -v npm -v ``` 若命令没有返回版本号，请先安装 Node.js 的长期支持版。Windows 可使用 PowerShell 或 Windows Terminal，macOS、Linux 使用系统终端即可。随后新建一个专用测试目录，用于第一次运行和权限验证。 ![DeepSeek Harness 零基础安装与使用教程配图 4](https://admin.zuoshipin.com/wp-content/uploads/2026/08/66f17a43-9dd3-11f1-905c-fa163e47d677.webp) 运行前检查本机 Node.js 环境 ![DeepSeek Harness 零基础安装与使用教程配图 5](https://admin.zuoshipin.com/wp-content/uploads/2026/08/675f5d39-9dd3-11f1-ba6d-fa163e47d677.webp) 准备一个独立、可控的工作区目录 官方项目入口已收录到站内导航：[DeepSeek Harness 导航页](https://www.zuoshipin.com/link/23248.html)。后续查看项目地址、功能简介和相关教程，建议从这个前端页面进入。 ## 三、最快安装：一条 npx 命令启动 Web UI 零基础用户优先使用官方推荐的 npm 启动方式： ``` npx @deepseek-ai/dsh web ``` 首次运行需要下载依赖，时间取决于网络和磁盘速度。终端出现服务地址后，在浏览器打开 `http://127.0.0.1:3080`。该地址默认只供本机访问，不应在不了解认证和网络边界时直接暴露到公网。 ![DeepSeek Harness 零基础安装与使用教程配图 6](https://admin.zuoshipin.com/wp-content/uploads/2026/08/67d4384d-9dd3-11f1-97f7-fa163e47d677.webp) 使用 npx 启动 DeepSeek Harness ![DeepSeek Harness 零基础安装与使用教程配图 7](https://admin.zuoshipin.com/wp-content/uploads/2026/08/683999a4-9dd3-11f1-bf71-fa163e47d677.webp) 终端输出本地 Web UI 地址 ![DeepSeek Harness 零基础安装与使用教程配图 8](https://admin.zuoshipin.com/wp-content/uploads/2026/08/68a496ae-9dd3-11f1-ad37-fa163e47d677.webp) 在浏览器打开 127.0.0.1:3080 如果 3080 端口被占用，可尝试： ``` npx @deepseek-ai/dsh web --port 3081 ``` ## 四、源码安装：适合二次开发与插件调试 需要阅读源码、调试插件或跟踪最新代码时，再使用源码方式： ``` git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web ``` 这条路线要求本机已经安装 Git 和 pnpm。若安装 Git 源码插件时 pnpm 提示构建脚本被阻止，应先阅读终端给出的 `allowBuilds` 提示、确认依赖来源，再按官方说明允许构建，不要为了省事全局放开未知脚本。 ![DeepSeek Harness 零基础安装与使用教程配图 9](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6912d37a-9dd3-11f1-8531-fa163e47d677.webp) 克隆官方仓库并进入项目目录 ![DeepSeek Harness 零基础安装与使用教程配图 10](https://admin.zuoshipin.com/wp-content/uploads/2026/08/69c2c191-9dd3-11f1-85d6-fa163e47d677.webp) 安装依赖与执行生产构建 ![DeepSeek Harness 零基础安装与使用教程配图 11](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6a3b2402-9dd3-11f1-826c-fa163e47d677.webp) 从源码启动 DSH Web ## 五、第一次使用：配置模型、选择工作区、发送任务 打开 Web UI 后，先进入设置页配置模型与密钥。密钥应保存在 DSH 的配置界面或环境变量中，不要写进提示词、截图、公开仓库或文章。保存后选择工作区；官方说明中，未选择工作区前会话输入区可能保持不可用。 ![DeepSeek Harness 零基础安装与使用教程配图 12](https://admin.zuoshipin.com/wp-content/uploads/2026/08/e6791309-9dd4-11f1-b578-fa163e47d677.webp) 在设置中配置可用模型 ![DeepSeek Harness 零基础安装与使用教程配图 13](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6aa6449b-9dd3-11f1-988d-fa163e47d677.webp) 选择 DSH 可以访问的工作区 ![DeepSeek Harness 零基础安装与使用教程配图 14](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6b19921e-9dd3-11f1-9709-fa163e47d677.webp) 创建会话并选择模型与推理强度 第一个任务建议足够小，例如“阅读这个目录并总结主要文件，不做任何修改”。先验证读取与总结，再逐步允许写文件或执行命令。这样更容易判断模型、工具和权限是否正常。 ![DeepSeek Harness 零基础安装与使用教程配图 15](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6bb39595-9dd3-11f1-96cf-fa163e47d677.webp) 用只读任务验证模型与工作区 ## 六、Goal、Plan 与审批：让 Agent 可控地执行 复杂任务先写清目标，再让 Agent 生成计划。Goal 负责定义最终结果，Plan 把工作拆成可检查步骤；当 Agent 准备运行终端、修改文件或调用高风险工具时，界面会依据当前权限策略请求批准。 ![DeepSeek Harness 零基础安装与使用教程配图 16](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6c24e6db-9dd3-11f1-ae77-fa163e47d677.webp) 用 Goal 明确任务边界与完成标准 ![DeepSeek Harness 零基础安装与使用教程配图 17](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6c901fd9-9dd3-11f1-b045-fa163e47d677.webp) 用 Plan 拆分多步骤任务 ![DeepSeek Harness 零基础安装与使用教程配图 18](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6cf88099-9dd3-11f1-b94e-fa163e47d677.webp) 在工具调用前检查命令与影响范围 **不要盲目开启“完全访问”。**建议只开放当前任务目录，逐条检查删除、覆盖、上传、安装依赖和外部网络请求；涉及账号密钥、生产环境或客户数据时，使用隔离环境。 ## 七、多模态输入：Harness 支持图片，不等于模型一定看得懂 DSH 的输入管线可以承载图片、文件引用、Goal 与 Plan 等上下文，但最终能否理解图片，仍取决于你选择的模型适配器是否支持视觉输入。若模型是纯文本接口，上传图片也不会自动获得视觉能力。 ![DeepSeek Harness 零基础安装与使用教程配图 19](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6d6b5fc7-9dd3-11f1-b858-fa163e47d677.webp) 会话输入支持图片与上下文附件 ![DeepSeek Harness 零基础安装与使用教程配图 20](https://admin.zuoshipin.com/wp-content/uploads/2026/08/fd838776-9dd4-11f1-a593-fa163e47d677.webp) 多模态能力需要模型端与 Harness 端同时支持 多图任务要控制图片数量与尺寸。超大图片、长历史和大量附件会迅速占用上下文，增加延迟与 Token 消耗。建议先压缩图片、一次处理一个明确问题，必要时开启新会话。 ![DeepSeek Harness 零基础安装与使用教程配图 21](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6de11255-9dd3-11f1-bf26-fa163e47d677.webp) 大图与多图任务需控制上下文体积 ## 八、Skills 实战：让 DSH 按固定流程生成 PPT Skill 可以把专业流程、提示词约束、文件规范和工具用法封装起来。以 PPT Master 为例，可让 Agent 阅读其 `SKILL.md`，再按规范生成演示文稿。安装或使用第三方 Skill 前，应先检查仓库、脚本与权限要求，确认没有危险命令和不必要的数据上传。 ![DeepSeek Harness 零基础安装与使用教程配图 22](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6e5acf43-9dd3-11f1-9ab4-fa163e47d677.gif) 读取并安装 PPT 类 Skill 的完整流程 ![DeepSeek Harness 零基础安装与使用教程配图 23](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6ec4eeb6-9dd3-11f1-b6a7-fa163e47d677.webp) 调用 Skill 生成结构化演示文稿 不要把陌生仓库地址直接交给拥有高权限的 Agent 自动执行。更稳妥的顺序是：先只读审查 `SKILL.md`，列出需要的命令、依赖和写入位置；确认后再在专用工作区安装。 ## 九、插件系统：从“能对话”扩展到“能完成工作” DSH 基于 Cordis 构建“Everything is a Plugin”的架构。模型适配器、工具、Skills、会话、沙箱、存储、Agent Loop、调度和 UI 都可以由插件提供。插件由配置和依赖关系装配，既方便扩展，也意味着插件来源与权限必须认真审核。 ![DeepSeek Harness 零基础安装与使用教程配图 24](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6f34bad5-9dd3-11f1-965a-fa163e47d677.webp) Cordis 驱动的插件化架构 ![DeepSeek Harness 零基础安装与使用教程配图 25](https://admin.zuoshipin.com/wp-content/uploads/2026/08/6fd6802e-9dd3-11f1-8ab7-fa163e47d677.webp) 插件可扩展界面、工具与模型能力 官方 CLI 的插件管理形式为： ``` dsh plugin --profile web add ``` 想了解更多已整理扩展，可继续阅读站内的 [DeepSeek Harness 插件推荐与实测](https://www.zuoshipin.com/article/23582)，以及 [DeepSeek Harness 多模态与子代理更新解析](https://www.zuoshipin.com/article/23336)。 ## 十、Trace 与 Token：看懂 Agent 到底做了什么 Trace 页面可以追踪助手回复、工具调用、上下文注入与用量信息。遇到结果不符合预期时，不要只看最后一句回答，应沿时间顺序检查：模型收到了什么、调用了哪个工具、参数是什么、工具返回了什么，以及是否因为权限或上下文压缩而丢失信息。 ![DeepSeek Harness 零基础安装与使用教程配图 26](https://admin.zuoshipin.com/wp-content/uploads/2026/08/703dc4a6-9dd3-11f1-ab1a-fa163e47d677.webp) Trace 页面展示工具调用与上下文链路 ![DeepSeek Harness 零基础安装与使用教程配图 27](https://admin.zuoshipin.com/wp-content/uploads/2026/08/70ab0289-9dd3-11f1-b5f9-fa163e47d677.webp) 通过 Token 与调用记录定位成本和异常 如果你关心上下文成本，可参考站内的 [Agent Token 经济学与上下文管理](https://www.zuoshipin.com/article/23662)，先从缩短历史、减少重复附件和拆分任务入手。 ## 十一、常见故障排查 | 现象 | 优先检查 | | --- | --- | | node / npm 找不到 | 安装 Node.js LTS，重开终端并检查 PATH | | 3080 无法打开 | 确认进程仍在运行、终端无报错，或改用其他端口 | | 无法发送消息 | 先配置模型，再选择工作区 | | 模型鉴权失败 | 检查 API Key、接口地址、模型名与账户额度 | | 上传图片但模型不识图 | 确认模型适配器本身支持视觉输入 | | 源码构建失败 | 核对 Node/pnpm 版本、依赖网络与官方仓库最新说明 | ## 十二、更新与卸载：先停服务，再决定是否清理数据 **npx 快速体验：**回到终端按 `Ctrl+C` 停止进程即可，通常没有单独的全局程序需要卸载。下次运行 npx 会按 npm 机制解析版本。 **源码安装：**停止服务后，可移除你明确克隆的 `deepseek-harness` 项目目录。删除前先确认其中没有自己新增的插件、配置或工作成果。 **配置与会话：**`~/.dsh` 可能保存配置、凭据、profiles 和会话数据。只有在确定不再需要并完成备份/导出后才考虑删除；不建议把“删掉整个目录”当作普通卸载步骤。 ![DeepSeek Harness 零基础安装与使用教程配图 28](https://admin.zuoshipin.com/wp-content/uploads/2026/08/711719b7-9dd3-11f1-8b1f-fa163e47d677.webp) 卸载前停止服务并备份配置与会话 ## 十三、FAQ：零基础最常问的 5 个问题 ### 1\. DeepSeek Harness 是免费的吗？ 项目采用 MIT 许可证开源；但你连接的模型 API、搜索服务或第三方插件可能产生费用。 ### 2\. 一定要安装到本地吗？ 官方 Web UI 通过本机 Node.js 进程运行。npx 是最省事的本地体验方式，源码方式更适合开发。 ### 3\. 为什么页面打开后不能输入？ 通常是尚未配置模型或未选择工作区。先完成这两项，再创建会话。 ### 4\. DSH 支持图片吗？ Harness 可以承载图片输入，但模型端也必须具备视觉能力；纯文本模型无法因此自动识图。 ### 5\. 能不能让 Agent 自动安装所有插件？ 技术上可以自动执行，但不建议对未知仓库开放全权限。应先审查插件来源、脚本、依赖和写入范围，再逐步授权。 **下一步：**先从 [DeepSeek Harness 站内导航入口](https://www.zuoshipin.com/link/23248.html) 启动官方项目，再用一个独立测试目录完成“配置模型—选择工作区—只读总结—批准单次工具调用”的最小闭环。 **Categories:** AI资讯 ---