DeepSeek Harness s使用教程
截至2026年10月初，DeepSeek Harness 的最新公开版本是 v0.2 预览版，并已提供开箱即用的 macOS 和 Windows 桌面端安装包。需要注意的是，Harness 自发布以来迭代非常快。从 v0.1 开发者预览版（8月13日）到 v0.2 预览版（9月29日），中间经历了多个版本。因此，在实际使用时，建议通过官方渠道确认是否为最新版本。DSH目前处于 developer preview 阶段，官方明确警告"会有破坏兼容性的改动"（breaking changes）。
DeepSeek Harness是什么？
DeepSeek Harness（简称 dsh）是 DeepSeek AI 开源的一个智能体（Agent）执行框架。它的核心理念是 "一切皆插件"，旨在提供一个高度可扩展、可自由组合的软件支撑框架，帮助 AI 智能体管理和执行复杂任务。
"Cordis 微内核"是 DeepSeek Harness (DSH) 的底层运行时基石。它是一种极简的"插件容器"，其核心思想是 "一切皆插件"，内核自身不实现任何业务功能，只负责为插件提供运行环境和管理规则。
DeepSeek Harness 的进化路径：从"一切皆插件"的架构基础，逐步走向"Agent 按需创造插件"的智能化未来。"创造模式"的推出，表明它正在从"你手动配置"向"它主动帮你配置"的方向迈进------创造模式生成的插件默认为会话级，重启后可能丢失------目前还处于早期阶段。
官方文档站
https://deepseek-harness.github.io/deepseek-harness/guide/quickstart
DSH 要求 Node.js 24.x及以上 ，在CMD / PowerShell窗口中输入命令：
node -v
如果低于24.x，需要先去 Node.js 官网升级。
安装 使用方式：
DeepSeek Harness 目前处于开发者预览版，官方提供了多种使用方式，对于初学者而言，推荐如下两种：
1. 快速体验
如果你只想快速体验，最便捷的方式是使用 npx 命令。前提是你的电脑上已安装 Node.js 22 或更高版本。
在命令行终端中执行以下命令：
npx @deepseek-ai/dsh web
报错 ERR_TLS_CERT_ALTNAME_INVALID 表明 npm 在与 registry.npmjs.org 建立安全连接时，证书验证失败了。
更换国内镜像源（推荐）
直接连接 npm 官方源容易因网络波动导致连接失败，切换到国内镜像源是最高效的方法。
切换到淘宝镜像源
npm config set registry https://registry.npmmirror.com/
清理缓存后重试
npm cache clean --force
现在请直接重新运行原来的命令：
npx @deepseek-ai/dsh web
直接输入 y，然后按回车即可。
终端里出现 dsh web: http://127.0.0.1:3080/?token=... 就说明服务已经跑起来了。 恭喜，启动成功了！后面的 token 是本次启动的临时安全令牌，不要泄露给其他人。因为服务运行在本机，浏览器通常会自动打开。
参见下图：
执行后，终端会打印出一个本地访问地址（默认为 http://127.0.0.1:3080），用浏览器打开该地址即可进入 Web UI 界面。默认浏览器如果没有自动打开，手动把上面那个带 token 的完整链接复制到浏览器地址栏即可。
进入 Web UI 后，点击左下角 设置 (Settings) → 模型 (Models)。
你需要在这里填入 DeepSeek 官方 API Key（在 platform.deepseek.com 获取），或者接入其他兼容 OpenAI 协议的模型端点。不配置模型的话，DSH 无法执行任何任务。参见下图：
在终端按 Ctrl + C 停止
重新运行 npx @deepseek-ai/dsh web
2. 通过安装包使用（桌面端）
官方为 macOS 和 Windows 系统提供了开箱即用的桌面端安装包，你可以直接从官方网站下载安装。
https://www.deepseek.com/harness/
安装比较简单，双击下载的安装包文件，按照安装向导提示完成安装。
安装完成后，桌面会出现 DeepSeek Harness 图标，双击即可启动。
特别提示：
官方桌面端与网页版共用 ~/.dsh，所以你之前在网页版里配置的模型、创建的工作区和聊天记录，在桌面端启动后都能直接看到和使用。但需要注意的是部分第三方桌面端使用独立数据目录。
处理日常工作、编写代码
DeepSeek Harness 可以胜任日常工作处理与代码编写，它被定位为一款主打编程和办公场景的 AI 生产力工具。
基础功能先跑起来，插件按痛点补。 你完全可以从"零插件"状态开始，用基础的文件读写和命令执行能力处理日常工作，等某个环节反复出现、觉得麻烦了，再去找对应的插件。
DeepSeek Harness 的插件是一个官方与社区共建的混合生态。官方不仅提供了基础的插件框架和规范，也亲自开发并开源了核心插件，同时大力鼓励社区贡献，第三方插件是其生态的核心特色。在安装插件时，留意其来源和作者，可以帮助你更好地评估和选择。
日常工作处理
DeepSeek Harness 能帮你处理多种日常办公任务：
· 文件整理与数据分析：支持导入文档、表格、PDF 等多种格式文件，完成资料整理、数据分析和图表生成。
· 文档与演示文稿制作：可以根据需求生成演示文稿，协助完成各类文档工作。
· 信息检索与验证：能够进行信息检索、核实数据并标注来源。
· 自动化重复任务：内置的自动化任务插件，可以把重复性工作设为定时任务，减少手动操作。
代码编写与软件开发
在编程方面，它具备完整的编码 Agent 能力，可以深度参与软件开发流程：
· 项目修改与代码运行：可以修改项目文件、直接运行代码，并协助完成开发任务。
· 自动调试与测试：能够自动运行项目测试用例、定位程序报错并输出修复方案，形成从开发到测试的闭环。
· 运行模式适配：提供标准模式（功能完整的编码 Agent）、PTC （程序化工具调用）模式（用代码组合多轮工具调用，适合复杂任务）等多种预设，适应不同开发场景。
· 插件生态扩展：基于"一切皆插件"的理念，拥有庞大的插件生态。例如，有专门的代码学习插件（提供代码编辑器、多语言执行等功能），也有开发者模式插件，能让 AI 自动完成"写计划 → 写代码 → 编译 → QA → 修复"的全流程。
· 第三方工具集成：甚至可以将其他 AI 编程工具（v0.2.1-alpha.1 版本中新增了Claude Code Mods实验性兼容层，尚无法保证全面可用）接入 Harness，作为子代理派发任务。