auto_ai 知识库

Appearance

DeepSeek Harness（dsh）是 DeepSeek 官方于 2026 年 8 月开源的 Agent 运行环境（MIT 协议），核心设计是"万物皆插件"（everything-is-a-plugin）：模型、搜索、文件操作、Shell、第三方服务全部以插件形式接入。可以把它理解为 DeepSeek 版的 Claude Code 式编程 Agent 入口，当前处于 Developer Preview 阶段，迭代极快。

工具概述 ​

  • 定位：通用 Agent 运行环境 / 编程 Agent harness（vibe coding 入口），提供 Web UI 与插件生态
  • 开发者：DeepSeek AI（deepseek-ai 组织，GitHub 15k+ commits，活跃度极高）
  • 底层：基于 Cordis 插件系统构建——元框架只负责插件的加载、卸载与依赖管理，Harness 所有具体组件都是 Cordis 插件；该设计来自北京大学与 DeepSeek 联合论文《A Programming Paradigm for Spatiotemporal Composability》
  • 协议：MIT（2026-08 从 BSL 调整为 MIT，主包均 MIT）
  • 技术栈：TypeScript 97% + CSS/Python 少量
  • 当前版本：0.1.3-alpha.1（2026-09-04），官方明示 Developer Preview：THERE WILL BE COMPATIBILITY-BREAKING CHANGES

核心功能 ​

  1. Agent 运行环境：像 Claude Code 一样在项目里跑编程 Agent，可执行文件/Shell 操作、多轮任务、会话管理
  2. 万物皆插件：语言模型接入是插件、搜索是插件、文件操作与 Shell 工具是插件、第三方服务也是插件——按需组合、可卸载替换
  3. Web UI：dsh web 启动本地界面（默认 http://127.0.0.1:3080），作为主要上手路径
  4. 插件生态：官方仓库带 dsh-plugin 话题标签的第三方插件可被发现；插件即代码，可自行开发
  5. 会话与架构文档化：随仓库附带 AGENTS.md、架构文档，面向 Agent 协作开发

安装与配置 ​

前提 ​

  • Node.js（必须）：node -v、npx -v 验证；没有则安装 LTS 版

方式一：npm 一行启动（推荐） ​

powershell
npx @deepseek-ai/dsh web
  • 首次自动下载包；启动后自动打开浏览器访问 Web UI（默认 http://127.0.0.1:3080）
  • --no-open 参数：只起服务不自动开浏览器

方式二：源码运行（研究/改造用） ​

powershell
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install        # 需先 npm install -g pnpm
pnpm run build
pnpm dsh web        # 使用构建产物启动，无需重复 build

官方文档 ​

https://deepseek-harness.github.io/deepseek-harness/

基本操作 ​

  1. 启动：npx @deepseek-ai/dsh web → 浏览器打开 Web UI
  2. 接入模型：在 UI 中配置模型插件——DeepSeek 官方 API（API key）或经插件接本地模型/第三方聚合 API（如 S3AI 这类统一路由）
  3. 装插件：按插件仓库说明安装（dsh-plugin 标签便于检索）
  4. 跑任务：在 Web UI 中给 Agent 下达任务（写代码、改文件、调工具），Agent 按需调用已装插件

进阶技巧 ​

  • 开发插件：按官方文档创建插件包并打 dsh-plugin 标签发布，可被社区发现
  • 源码调试：仓库是 pnpm monorepo（apps/packages/plugins 分层），跟随 CONTRIBUTING.md 与架构文档
  • 安全边界：运行前阅读官方 SAFETY.md——Agent 具备文件/Shell 执行能力，接入不可信插件或授予过宽权限有风险
  • 跟踪版本：alpha 迭代快，升级前看 release 变更，配置可能不兼容

优缺点对比 ​

维度DeepSeek HarnessClaude Code（同型参照）DeepSeek-TUI（社区）lm-evaluation-harness 评测路径
定位官方 Agent 运行环境（插件化）Anthropic 官方编程 Agent社区终端 TUI Agent（Rust）模型评测框架（非 Agent）
架构Cordis 插件，万物皆插件官方工具链专为 DeepSeek-V4 优化评测管线
安装npx @deepseek-ai/dsh web官方安装器Rust 编译pip install lm_eval
成熟度Developer Preview（破坏性变更）生产级社区爆火（曾登 GitHub 热榜）生产级
适合尝鲜 Agent 插件生态稳定日常编程DeepSeek 重度终端用户模型选型评测

常见误区 ​

  1. 以为它是"DeepSeek 模型本身"：Harness 是运行环境/框架，模型需另行接入（API 或本地部署，见 DeepSeek昇腾算力集群 的算力背景）
  2. 把它当生产工具依赖：官方明示兼容性会被破坏，适合实验与学习，不适合关键业务
  3. 混淆"Harness"与"评测 harness"：社区也常用 lm-evaluation-harness 评测 DeepSeek 模型（也叫"DeepSeek harness"），那是评测框架，与本工具是两回事

一句话总结 ​

Harness 是运行环境而非模型本身，核心设计是"万物皆插件"、底层为 Cordis；官方明示 Developer Preview 会有破坏性变更，适合尝鲜插件生态而非关键业务。

相关概念 ​

  • [AI-Agent-概述与核心组成](/学习笔记/AI技术/AI Agent/AI-Agent-概述与核心组成)
  • [AI-Agent-类型与适用场景](/学习笔记/AI技术/AI Agent/AI-Agent-类型与适用场景)
  • [AI-Agent-多智能体架构](/学习笔记/AI技术/AI Agent/AI-Agent-多智能体架构)
  • [AI-Agent-主流框架对比](/学习笔记/AI技术/AI Agent/AI-Agent-主流框架对比)
  • AI基础概念-MCP协议
  • AI基础概念-MCP生态与服务器
  • 提示词工程-Agent提示词技能
  • [AI-Agent-学习路径与资源](/学习笔记/AI技术/AI Agent/AI-Agent-学习路径与资源)