DeepSeek Harness 2026-08-13 晚发布 v0.1 开发者预览版，仍处快速迭代期，官方明示未来会出现破坏兼容性的变更。本文基于发布当天的官方 README + providers 文档 + 媒体实测整理，引用前请复核最新版本。

发布背景

• 2026-08-13 晚 DeepSeek 正式发布并开源首款 AI Agent 编程工具 —— DeepSeek Harness（dsh）v0.1 开发者预览版，MIT 协议，GitHub 仓库 deepseek-ai/deepseek-harness
• 与 DeepSeek-V4-Pro-0813 模型正式版同步推出
• 发布半小时 GitHub 星数破万，截至发稿已超 3 万星
• 被视为 DeepSeek 从基础模型/API 提供商向 AI 编程执行层延伸、补齐"Vibe Coding"入口的关键一步

产品定位

官方公式：Model + Harness = Agent

• 模型负责思考推理，Harness 负责实际执行
• 是一套将模型接入文件系统、终端、网页、代码工具和其他 Agent，统一处理上下文管理、工具调用与任务执行的 Agent 运行框架
• 精准对标 OpenAI Codex 和 Anthropic Claude Code / Claude Cowork
• 团队负责人：崔添翼（前 Jane Street 工程师，2026 年 3 月加入 DeepSeek），项目 2026 年 5 月立项，8 月 2 日招募内测用户

核心架构：一切皆插件

DSH 建立在 Cordis 插件元框架之上（理念源于北大与 DeepSeek 联署论文《A Programming Paradigm for Spatiotemporal Composability》）。

模型适配器、工具注册、技能、会话、沙箱、存储、Agent 循环、任务调度、UI 等所有能力均由插件组合而成，可自由替换、灵活重组。开发者无需改源码，通过新增/替换插件即可实现任意模块定制。

Cordis 内核两大核心特性：

• 时间可组合性：插件卸载后能完整撤销其副作用
• 空间可组合性：插件依赖变化时能动态重新处理依赖

→ 支撑 Agent 运行时热插拔插件，甚至自我开发/安装/卸载插件（自进化雏形）。

四种运行模式

模式	说明
标准模式	完整工具组合（文件编辑、Shell、检索、技能、规划、子 Agent、工作流等）
PTC 模式	程序化工具调用（Programmatic Tool Calling）：模型生成 TypeScript 代码，把多轮工具操作合并为一次执行
极简模式	仅保留 Shell 与文件编辑两个工具，最小环境模型基准测试
创造模式	检查运行时、内存中试验 Cordis 插件，创作新的自定义模式

安装部署

前置要求

• Node.js 开发工具链
• 无原生 Electron App，通过浏览器访问 Web UI

快速体验（npx）

npx @deepseek-ai/dsh web

启动 Web UI，默认地址 http://127.0.0.1:3080

源码安装

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

核心命令

• dsh --profile <name>：启动指定配置文件
• 支持 Web UI / TUI / Headless 等运行方式

配置大模型

基础配置（Web UI：设置 → 模型）

• 配置 DeepSeek 官方模型：DeepSeek 卡片填入 API Key 保存即可
• API Key 只写：保存后只显示脱敏描述符，密钥存 $DSH_HOME/.credentials.yaml，settings 只保留凭据引用
• 模型变更下一次请求时生效，无需重启

添加目录提供方

选"添加提供方"，选 Anthropic / OpenAI 等已安装目录中的提供方，填 API Key。目录自动提供端点、协议、模型列表。

原生认证的提供方（Bedrock / Vertex / Azure / Codex）需各自原生凭据（AWS / ADC / api-version / OAuth），只填 API Key 无法配置。

添加自定义提供方

适用于公司网关、自建服务器、目录外的提供方：

字段	说明
Provider ID	小写，永久性（请求/会话/凭据引用都依赖它，改名需新建）
基础 URL	端点地址，如 https://gateway.example/v1
API 协议	OpenAI 兼容 / Anthropic 兼容
凭据	API Key 或环境变量引用（apiKeyEnv: GATEWAY_API_KEY）
模型	至少一个模型 ID

模型发现：调用 OpenAI 兼容 GET /models 端点；服务不提供则手动输入模型。

settings.yaml 配置示例

llm-pi-ai:
  providers:
    my-gateway:
      apiKeyEnv: GATEWAY_API_KEY
      api: openai-completions
      baseURL: https://gateway.example/v1
      models:
        - id: legacy-chat
        - id: vision-preview
          input: [text, image]   # 视觉模型需声明模态

关键配置点

• 视觉模型：自定义 provider 下需手动声明 input: [text, image]，否则按纯文本处理，发图会被拒
• defaultInput：路由级图片回退值，默认 [text]
• 双协议支持：DeepSeek 同时提供 Anthropic 兼容（api.deepseek.com/anthropic）与 OpenAI 兼容（api.deepseek.com）端点
• 协议判断口诀：域名判断 Provider，路径判断 Protocol

排错速查

错误	解决
MISSING_CREDENTIAL	模型页存 key 或提供引用的环境变量
UNKNOWN_MODEL	选已配置模型，或向自定义 provider 加缺失模型
获取可用模型返回 401	查 key；模型发现走 OpenAI 兼容 GET /models
图片发送前被拒	模型未声明图片模态，加 input: [text, image]

特色功能

Trajectory（轨迹）—— Agent 自带黑匣子

模型看到的一切（系统提示词、推理过程、工具调用与结果、子 Agent 调度、上下文注入）均写入只增不改的会话日志，支持按来源追溯、恢复、分叉、搜索、回放。

插件生态

• 发布不到 24 小时收录 288 个插件仓库（GitHub 打 dsh-plugin 标签即可被发现）
• 示例：dsh-plan-execute（双模型路由，plan 用推理模型、执行用执行模型省成本）、dsh-vision（给纯文本模型桥接视觉模型）
• 连 WebUI 界面本身也是 UI 插件，可随意修改
• 不锁死 DeepSeek 模型，支持自定义 provider、base URL、协议

与 Claude Code 的区别

维度	Claude Code	DeepSeek Harness
性质	Claude Code 编程助手 CLI 开源（GitHub anthropics/claude-code），但模型推理服务商业闭源（Claude 模型需官方 API/订阅）	DeepSeek 开源（MIT）Agent 框架 / 基建
架构哲学	封装完整的成品工具箱	一切皆插件，模块化可重组
可定制性	可自定义 Skill、MCP 等外围；本体源码在 GitHub 可查	模型、工具、技能、会话、存储、沙箱、UI 全可替换
内核	助手源码开源，但模型与生态服务闭源	Cordis 内核只负责插件加载/卸载/依赖管理
运行时	固定	支持运行时热插拔插件且状态不崩
生态	官方插件/marketplace + GitHub 开源仓库	开源插件生态（dsh-plugin），发布即 288 仓库
模型	Anthropic 自家模型也可接任意 Anthropic 兼容模型	不锁死，可接任意 Anthropic/OpenAI 兼容模型

行业评价

辨析：Claude Code 编程助手 CLI 本体是开源的（GitHub anthropics/claude-code，TypeScript/Python，140K+ Star），但闭源的是 Anthropic 的模型推理服务。两者的开源维度不同：Claude Code 开的是"客户端工具"源码，DeepSeek Harness 开的是"整个 Agent 框架 + 生态"。

• 多数观点认为 v0.1 短期"替代 Claude Code"为时尚早
• 更重要意义：DeepSeek 从单纯模型提供商转向争夺模型之上的开发者入口
• 反对声音：部分认为它更像为展示 Cordis 内核而预设 100+ 一方插件的科研成果，而非面向普通用户的 Agent 产品

社区与支持

• GitHub Discussions：反馈 / bug 报告
• 插件仓库加 dsh-plugin 话题便于被发现
• Discord / 企微群 / 微信公众号

参考来源

• 官方 README：github.com/deepseek-ai/deepseek-harness
• 官方模型配置文档：docs/user/guide/providers.zh.md
• IT 之家：DeepSeek Harness 公测报道
• 36氪 / 量子位 / 品玩 实测体验文