Administrator
发布于 2026-08-17 / 123 阅读
0
0

DeepSeek Harness 本地安装与使用指南

DeepSeek Harness(简称 DSH)是 DeepSeek AI 于 2026 年 8 月开源的 Agent 运行框架,目前处于开发者预览阶段。它的核心思路是把大模型与可扩展的执行环境结合起来:模型负责理解与推理,框架负责让 Agent 真正操作本地环境、调用工具并持续执行任务。

项目基于 Cordis 插件架构,模型适配、工具、会话、沙箱、存储、主循环等能力都以插件形式存在,开发者可在配置层面直接替换或扩展。它支持接入 DeepSeek 及多家模型提供方,并提供多种运行模式。整体定位更偏向开发者工具,而非面向普通用户的成品应用。

适合什么场景

如果你需要让大模型真正读写本地文件、执行命令、拆分任务并在授权范围内持续工作,而不是只停留在对话层面,可以考虑试用这个框架。它比较适合:

  • 想自己搭建 Agent 执行环境的开发者

  • 需要本地可控、可扩展运行时的场景

  • 希望对比不同模型在相同工具环境下表现的基准测试

  • 有一定二次开发或插件扩展需求的人

目前仍是预览版,接口和插件可能还会有较大调整,不适合直接用于生产环境的关键流程。

环境要求

  • 操作系统:Windows 10+、macOS 10.15+ 或主流 Linux(x64/arm64)

  • Node.js:建议 v22.19 及以上,或直接使用 v24 系列

  • 包管理器:源码安装需要 pnpm(可用 npm install -g pnpm 安装)

  • 网络:首次启动需要从 npm 拉取依赖

  • API Key:DeepSeek 或其他兼容提供方的密钥(可在启动后于界面中配置)

  • 可选:Python 3.10+(使用官方 Python SDK 时)、Git

硬件要求不高,普通笔记本即可运行 Web 界面。建议单独准备一个练习目录作为工作区,避免误操作重要文件。

安装与启动

快速体验(推荐先试这个)


首次运行会下载相关包,确认后等待完成。终端会输出本地地址(默认 http://127.0.0.1:3080),用浏览器打开即可。关闭终端后服务一般会停止。

更多参考:

https://developer.aliyun.com/article/1755802?spm=a2c6h.12883283.index.119.5f1f4307lnds9z

https://wenxin.baidu.com/search/13006422030524031592?enter_type=a_61673_title


评论