DeepSeek Harness 详细介绍

[ikaijua]

DeepSeek Harness 详细介绍

DeepSeek Harness（命令行工具名 dsh）是 DeepSeek AI 开源的 agent harness（智能体运行时），采用基于 Cordis 的「一切皆插件」架构。它同时提供 CLI 与本地 Web UI，覆盖 LLM、MCP、LSP、ACP、沙箱、Skills、子代理、会话、工具、计划、调度、Shell、Web 等完整子系统——不是只套了一个模型的薄壳，而是一个真正可扩展的运行时框架。

定位。 DeepSeek AI 于 2026 年 8 月 13 日开源（v0.1，MIT），首发 24 小时 GitHub 破 7 万星；10 月 3 日新版加入实验性 Claude Code Mods 兼容层。当前为开发者预览版。
招牌能力。 一切皆插件 + 四种运行模式；能把 Claude Code / Codex 收编为子代理；每次运行全程可追踪。
评价。 被社区称为「Agent 领域的 Linux 时刻」——架构原创性强（Hacker News 高赞），但成熟度仍不及 Claude Code / Codex。
价格。 完全免费、MIT 开源；用自家 DeepSeek 模型 API 按量付费，也支持任意厂商模型。
注意。 开发者预览版，破坏性变更随时可能发生；Claude Code Mods 兼容层是实验性的，暂不能无缝运行所有 Mods。

下面按「产品介绍 → 上手指南 → 资源」分楼层展开。

目录

产品介绍

1. 什么是 DeepSeek Harness？
2. 核心亮点
3. 核心概念
4. 子系统一览
5. 什么时候选 DeepSeek Harness？
6. 注意事项

上手指南

7. 安装与运行
8. 典型用法

资源

9. 相关资源
10. 许可证

点击目录可跳转至对应楼层；若页内点击无反应，可在新标签页中打开链接。

[ikaijua]

什么是 DeepSeek Harness？

DeepSeek Harness（命令行工具名 dsh）是 DeepSeek AI 开源的 agent harness（智能体运行时），采用基于 Cordis 的「一切皆插件」架构。它同时提供 CLI 与本地 Web UI，覆盖 LLM、MCP、LSP、ACP、沙箱、Skills、子代理、会话、工具、计划、调度、Shell、Web 等完整子系统——不是只套了一个模型的薄壳，而是一个真正可扩展的运行时框架。

⚠️ 开发者预览版。 DeepSeek Harness 于 2026 年 8 月 13 日开源（v0.1，MIT），首发 24 小时内 GitHub 破 7 万星。此后以周更速度迭代（RC.8 → 0.1.2-rc.1 → 0.1.7-rc 系列），官方明示会有破坏兼容性的变更，请将 CLI/API 视为不稳定。

2026-10-03 新版（国庆更新）：

• 加入实验性 Claude Code Mods 兼容层：Anthropic Claude Code 的部分扩展功能理论上可经适配后在 DSH 里运行
• 强化插件化与跨平台能力
• 负责人崔添翼回应：做兼容层主要是验证「Claude Code Mods 的扩展能力是否为 DSH 插件能力的一个子集」；目前还无法让所有 Mods 无缝运行，未来技术上有可能

[ikaijua]

核心亮点

• 一切皆插件。 整个运行时基于 Cordis（一个成熟的 IoC 风格插件框架）构建。LLM、MCP、LSP、会话、工具、计划、沙箱、调度、Web 等所有子系统都是一个 Cordis 插件，使用统一的 event / service / effect 模型协作。连 Agent 主循环本身都是可替换的插件。
• 开箱即用的 CLI + Web UI。 运行 npx @deepseek-ai/dsh web 即可在 http://127.0.0.1:3080 启动 Web UI；不需要单独的「headless」或「GUI」构建。
• 四种运行模式（presets）。 标准模式（完整工具集）；Code/PTC 模式（模型生成一段 TypeScript 程序，一次编排多轮工具调用，大幅降低 token 消耗）；极简模式（只留 shell + 文件编辑，官方跑模型基准用）；创造模式（运行时检查 + 在内存中试验插件，自造新模式）。
• 原生看图。 模型适配器可直接发送图片请求；对不支持视觉输入的模型，自动走 OCR / 颜色统计 / 像素扫描等工具把图片拆成结构化信息——等于给纯文本模型拼出「土法视觉」。
• 收编竞对为子代理。 Claude Code 和 Codex 可以按 Profile Bundle 安装，在 DSH 的工作流里当具体任务的执行者（Codex 还支持非交互权限模式和多个命名实例）。
• 每次运行全程可追踪。 模型看到的一切写入 append-only 会话日志（系统提示、推理、工具调用与结果、子代理调度、上下文注入），Trajectory 视图按来源检视，可恢复、分叉、搜索、回放。
• 中英双语架构文档。 docs/ 目录下提供完整的中英双语文档：架构、agent 生命周期、工具执行管线、能力接缝、Cordis 入门、防守式编程模式等。
• 40+ 一方子包。 core / llm / mcp / lsp / acp / sandbox / skill / subagent / session / tools / plan / goal / schedule / web / shell / terminal / workflow / jobs / hooks / guard / feedback / compaction / context / attachment / identity / credentials / e2b / runtime-diagnostics / typert / client / host / sdk / extensions / bundle / boot / storage / preset 等。
• 插件生态快速成型。 内测期社区约 300 个插件，开源后突破 1000 个；官方内置插件 100+，Plugin Store 已预留。
• MIT 协议。 源代码、文档、工具全部 MIT。

[ikaijua]

核心概念

• Plugin（Cordis） — 最基本的单元。一个插件声明 events、services、effects，并可以 await 其它插件的 services。
• Service — 可注入的能力。插件通过 this.someService 获取并 await。
• Event — 类型化的生命周期钩子，用于插件间消息传递以及运行时诊断。
• Effect — 长时间运行的副作用（如工具调用、沙箱子进程），注册到生命周期系统中。
• Capability seams（能力接缝） — 新能力接入的明确位置（LLM provider、tool、transport、storage 等）。详见上游 docs/capability-seams.md。

正是这些原语组合起来，使整个架构是「一切皆插件」，而不是把功能硬编码成流水线。

[ikaijua]

子系统一览

子系统	包	作用
核心运行时	core、runtime-diagnostics、compaction	插件生命周期、错误与追踪、上下文压缩
LLM 与工具	llm、tool-catalog、tool-execution-pipeline	抽象 Provider、工具注册、沙箱化工具执行
智能体编排	agent、subagent、plan、goal	Agent 生命周期、子代理、计划、目标追踪
技能与记忆	skill、feedback、context	可复用技能、反馈循环、工作上下文
会话与任务	session、session-query、jobs	长会话、查询接口、调度任务
外部集成	mcp、lsp、acp、client	MCP server、语言服务、ACP、客户端集成
沙箱与执行	sandbox、e2b、subprocess、shell、terminal	沙箱化代码/工具执行、子进程、Shell/终端
UI 与 Web	web、host、interaction	Web UI、宿主运行时、用户交互
存储与身份	storage、credentials、identity、attachment	持久化、密钥、身份、附件
扩展面	extensions、sdk、hooks、guard	自定义插件、SDK、钩子、护栏
工作流	workflow、schedule、boot、bundle	工作流定义、定时任务、启动、打包
诊断	runtime-diagnostics、compaction、typert	追踪、压缩策略、类型

完整子系统图参见上游 docs/architecture.md。

[ikaijua]

什么时候选 DeepSeek Harness？

适合	不一定适合
想要一个由 DeepSeek 维护、MIT 协议、真正基于插件的 agent 运行时（而非硬编码的流水线）。	想要一个今天就能直接拿来用的 CLI 编程智能体——Claude Code / Codex / Kimi Code / Antigravity 目前更成熟。
需要把 agent 运行时嵌入或扩展，并且希望接口面是 Cordis 插件。	依赖稳定、文档齐备的 CLI API——上游 dsh CLI 当前仍标「开发者预览」。
需要原生支持 MCP、LSP、ACP 的运行时。	只需要一个聊天 UI，不需要定制运行时。

[ikaijua]

注意事项

• 仍是开发者预览版。 从 8 月 13 日 v0.1 到现在 0.1.7-rc 系列，文档、CLI、API 都在快速变化，破坏性变更随时可能发生；不适合直接承载每日生产工作流。
• Claude Code Mods 兼容层是实验性的。 目前无法让所有 Mods 在 DSH 中无缝运行，官方定位是验证插件能力边界。
• 文档略落后于代码。 多数文档都是中英双语且质量不错，但部分新包可能还没完整覆盖。
• npm 分发在加速但 API 未稳定。 @deepseek-ai/dsh 已迭代到 0.1.7-rc 线，但 dsh CLI 接口仍可能变化；升级前注意核对迁移说明（如 Session 日志格式升级、设置与预设迁移）。
• 没有官方云服务。 这是一个自托管、本地优先的运行时（截至本文写作时 DeepSeek 暂未提供 harness 本身的托管服务）。
• 插件供应链是双刃剑。 一个工具插件能碰文件和外网，一个存储插件掌握完整会话——进入生产环境前要过插件来源验证、权限边界、依赖冲突这几关。

[ikaijua]

安装与运行

启动 Web UI（推荐第一次尝试）

# 需要 Node.js
npx @deepseek-ai/dsh web

该命令会在 http://127.0.0.1:3080 启动 Web UI。--host / --port 等参数参见上游 Web UI 指南。

从源码运行

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

[ikaijua]

典型用法

• 独立的 agent 运行时。 在终端运行 dsh 或打开 Web UI，把它当 Claude Code / Codex 一样使用——区别在于每个能力都是插件。
• 按模式切换干活方式。 日常编码用标准模式；批量操作/复杂任务编排用 Code/PTC 模式（省 token）；跑模型基准用极简模式；开发插件/自造预设用创造模式。
• 把 Claude Code / Codex 装成子代理。 按 Profile Bundle 安装后，在 DSH 工作流里把竞对产品当具体任务的执行者调度；reportDelivery 机制会回传结果并唤醒等待中的父任务，多 Agent 协作不用干等。
• 嵌入到你自己的产品里。 因为整个运行时就是一组 Cordis 插件，你可以只引入需要的子包，跳过其它部分（例如去掉 Web UI、headless 跑）。
• 扩展自己的 LLM / 工具。 新增一个 provider 或 tool，只需写一个 Cordis 插件，注册一个 service 和一个 effect；运行时负责生命周期、事件总线、连接。
• 规约驱动 / 工作流驱动的执行。 用 workflow、plan、goal、schedule 等包，跑多步骤、定时或目标驱动的任务，并能跨重启存活。

[ikaijua]

相关资源

• GitHub 仓库
• 架构文档（上游）
• Cordis 入门（上游）
• Agent 生命周期（上游）
• 工具执行管线（上游）
• 社区 Discord

[ikaijua]

许可证

MIT —— 详见 LICENSE。