DeepSeek Harnesss使用教程

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,作为子代理派发任务。

相关推荐
吴名氏.2 小时前
Java转AI Agent教程(第十五周)政策时效:过期政策不该被召回,也不能被删掉
java·人工智能·python·ai·ai agent
小七-七牛开发者15 小时前
周 1 上线 | DSH 喜提原神进场动画,Anthropic 启动 IPO 路演;黄仁勋辞任;微软全球大宕机超 24 小时
ai·大模型·agent·token·工作流·claudecode·ai coding
GISer_Jing16 小时前
GitHub热点I
后端·ai·langchain
QuZhengRong17 小时前
【AI】Agent 全栈进阶|AgentScope 沙箱源码解析
python·学习·ai·agent·沙箱
梯度下降者20 小时前
让AI的“隐形思维“也能越练越强,这项突破或将重写推理效率的边界
ai·强化学习·潜在推理·代理概率·停止门
我才是银古21 小时前
chat-demo 源码解析与 DeepSeek 全家桶 API 能力盘点
ai·demo·deepseek
装不满的克莱因瓶1 天前
【从零搭建】AI大模型之ReactAgent智能体对接MCP实战
java·人工智能·ai·springai·mcp·springaialibaba
cpolar技术支持1 天前
容器数是 6 个、6 个、还是 6 个,可服务早被换掉了:用一个 5.5MB 的 Go 单文件把机器每周的变化记下来,再给它套一层别人看不懂的入口
python·docker·ai·cpolar
万俟淋曦1 天前
[ROS 系列学习教程] 建模与仿真 - 使用 ros_control 控制六轴串联机械臂
人工智能·ai·机器人·ros·机械臂·robotics·具身智能
效率工作实验室1 天前
企业级AI Agent平台选型指南:主流厂商能力对比与落地场景解析
ai·企业级ai·agent平台选型·agent平台能力对比·企业智能体落地场景