DeepSeek Harness – DeepSeek AI发布的开源AI Agent运行时框架

DeepSeek Harness（简称 dsh）是 DeepSeek AI发布的开源 AI Agent 运行时框架，采用 MIT 许可证。其核心理念可概括为一句话：Model + Harness = Agent——模型只负责生成文本和决策下一步，而 Harness 为模型提供工作空间、工具注册表、沙箱环境、审批策略、追加式会话日志，以及持续推进工作的执行循环，将 AI 从”思考者”转变为”行动者”。

DeepSeek Harness核心特点与优势

表格

特点	说明
一切皆插件	模型适配器、工具注册表、技能库、会话管理、沙箱、存储后端、Agent 主循环、调度器、甚至 UI 本身——所有能力均以独立插件形式存在，可通过配置替换或扩展，无需修改框架源码
Cordis 内核驱动	基于 Cordis 元框架实现”时空可组合性”：插件支持运行时热插拔与完全回滚，加载/卸载插件无需重启进程，AI 自身也可开发、测试和替换插件
能力三层拆分	每个能力严格分离为 Service（接口定义）、Provider（具体实现）、Consumer（消费者）。例如将文件系统 Provider 从本地目录切到远程沙箱，所有依赖文件操作的工具自动跟随切换，无需改一行代码
分层配置级联	支持 Bundles（功能包）、Profiles（运行配置）、Patches（细粒度覆盖）的堆叠组合，类似 CSS 层叠规则，可在官方包之上做精确覆盖
模型完全无关	默认内置约 40 家第三方模型厂商（OpenAI、Anthropic、Google、Kimi 等），也可注册自定义适配器，切换模型零代码改动
完整事件流记录	保存 turn/start、step/start、用户消息、实际请求模型、系统提示词、工具定义、原始流式响应等完整事件，而非仅保留最终消息；上下文压缩也以 replacement 事件覆盖，原始历史不丢失
Agent 预设系统	通过 Preset 决定某个会话中 Agent 能使用的工具、提示词、技能、子 Agent 和工作流，同一进程内可同时运行写作 Agent、编码 Agent、研究 Agent，各自看到不同的能力组合

DeepSeek Harness技术原理

DeepSeek Harness 的架构建立在 Cordis 插件框架之上，其设计哲学是”时空可组合性”：

空间组合：哪些插件处于激活状态，通过 YAML 配置文件（cordis.yml）声明式挂载。
时间组合：插件可在运行时动态加载或卸载，卸载时会自动清理自身创建的状态、副作用、内存分配和事件监听器，连带停用其依赖的其他插件而不影响系统其余部分。
服务与事件机制：插件通过声明式服务接口和类型化事件进行协作，所有组件对等存在，不存在”特权核心”。

执行循环采用”先记录意图，再执行副作用”的设计：模型可以编写一段 TypeScript 将多个工具调用编排为程序，中间数据留在运行环境，仅最终结果进入模型上下文。

前端界面本身也是第二棵插件树：应用启动后加载一组 UI 插件，页面先声明侧边栏、对话区、输入区、设置区等标准挂载位，各插件再注册自己的组件进去。

DeepSeek Harness核心功能

工具生态

文件搜索（glob、grep，基于 ripgrep）
终端操作（打开、读取、发送信号、后台运行）
网页获取与搜索
LSP（语言服务器协议）查询
字符串替换编辑器（类似 Claude Code 的 str_replace_editor）
子 Agent 与工作流编排（ralph、workflow）
任务调度（定时创建未来会话）
后台作业管理（job_kill、job_list、job_output）
待办事项（todo_write）

会话与记忆

可重建的会话历史与完整事件追溯
跨会话长期记忆（通过插件实现本地文件持久化 + 分层上下文注入 + LLM 自我整理，非传统向量数据库 + RAG）
目标与计划管理（create_goal、update_goal）
会话事件查询与搜索

运行模式

Standard（标准模式）：完整工具集，适合日常写代码、修 Bug、分析项目
Code（代码模式）：通过 Code Mode SDK 将工具暴露给模型，支持大批量搜索、并行读取和多步骤自动处理
Minimal（极简模式）：仅保留 bash 和编辑器两个工具，用于基准测试和简单修改
Creator（创造模式）：用于开发新的 Agent 预设或插件

集成能力

支持 MCP（Model Context Protocol）和 Skill 统一为 Cordis 插件
提供 Web UI（dsh web 启动于 localhost:3080）和 Headless 运行器
支持通过 npx @deepseek-ai/dsh web 一键启动

DeepSeek Harness应用场景

编程与代码生成：作为可深度定制的编码 Agent，支持代码库审查、Bug 修复、自动化代码迁移，对标 Claude Code 但拥有更高可配置性
多 Agent 编排与协作：在同一 Harness 进程中运行多个具有不同能力组合的 Agent，处理写作、编码、研究等不同任务
长任务自动化与项目管理：利用目标、计划、调度、工作流等机制完成需要多步骤、跨会话的复杂任务
模型评估与基准测试：提供稳定、最小化的工具表面，确保不同运行之间的评估一致性
内部平台嵌入：将可检查的 Agent 循环嵌入企业自有 UI 或后台系统，作为基础设施层提供服务
插件生态开发：开发者可发布 dsh-plugin 主题下的插件，已有内测用户在短时间内开发了约 300 个插件，涵盖界面皮肤、长期记忆、跨会话自我进化等
企业工作