DeepSeek AI 近期开源了 Agent 运行时框架 DeepSeek Harness（dsh）。该项目并非又一个帮助开发者调用大模型的轻量库，而是试图把 Agent 上线所需的基础能力打包成可运行系统，重点解决本地原型走向生产环境时常见的部署、权限、会话和工具管理问题。
从本地 Demo 到线上服务，Harness 想补齐中间层
素材指出，许多开发者用 Python 写出可调用工具的 Agent，在本地运行顺畅，但一旦要真正上线，就会遇到工程层面的断层。若使用 LangChain、LangGraph、AutoGen 等框架，其中一些问题要么缺少官方方案，要么需要开发者自行拼接更多组件。
DeepSeek Harness 的定位正是围绕这些断层展开。官方将其定义为“DeepSeek AI 开发的开源 Agent Harness，采用一切皆插件架构”。这里的“harness”源自工程领域，可理解为线束或安全带，意在把模型调用、工具执行、记忆管理、权限控制等原本分散的部件约束在一起，使 Agent 能够安全、有序地运行。
该项目采用 MIT 许可证，代码在 GitHub 上公开。开发者无需克隆源码，直接执行 npx @deepseek-ai/dsh web，即可启动带 Web UI 的完整 Agent 服务，默认访问地址为 http://127.0.0.1:3080。该服务内置模型连接、文件操作、shell 命令、网络搜索等工具集，以及 Session 持久化和权限策略。
“一切皆插件”：从 Cordis 到应用层的三层结构
素材披露的架构显示，DeepSeek Harness 可分为三层：底层是 Cordis 插件框架，中层是核心子系统，上层是不同应用形态。
Cordis 是整个系统的地基，负责插件注册与注销、服务依赖注入、类型化事件系统以及可逆的注册效果。所有上层功能都以 Cordis 插件形式挂载。也就是说，模型适配器是插件，工具注册是插件，Agent 循环本身也是插件，甚至日志记录和权限控制同样可被替换。系统不存在不可替换的“核心”，开发者可更换任一组件，而整体仍可继续运行。
中层核心子系统包括 Agent Loop、Tools、Session、System Prompt、LLM Adapter、Sandbox、Subagent 和 Observability 等。这些模块承担 Agent 实际运行所需的具体能力。上层则可组合为 Web UI、headless、SDK、ACP API 等运行形态，且形态并非通过代码切换，而是通过配置组合决定。
在配置层面，Harness 引入 Bundle 与 Profile 两个概念。Bundle 是一组插件配置，描述系统需要挂载哪些插件；例如 dsh-base 包含模型适配器、工具集、持久化、沙箱等基础插件。Profile 则是按顺序叠加的 bundle 列表，并允许用户叠加自定义覆盖配置。素材给出的最小化自定义 profile 示例中，仅挂载了 @deepseek-ai/dsh-base。开发者也可使用 dsh --profile web --dump-config 查看当前 profile 的完整插件树，每一行都对应可被配置覆盖的插件。
与常见 Agent 框架的差异：先跑起来，再按需挂载
素材将 DeepSeek Harness 与市面常见 Agent 框架作出区分，并给出较直接的判断：LangGraph 更偏向“先设计图，再跑”，DeepSeek Harness 则强调“直接跑，需要什么挂什么插件”。
这种差异也决定了适用边界。素材认为，DeepSeek Harness 更适合需要快速上线、希望减少基础设施拼装成本，并需要工具、会话、权限等能力内置支持的场景；不太适合强图结构编排、复杂流程预定义需求较强的场景。该判断来自素材本身，未额外扩展。
在使用门槛上，开发者需要先安装 Node.js 18 及以上版本。启动 Web UI 后，在设置中填入 API Key，即可与 Agent 对话，系统支持 DeepSeek、OpenAI 等 API。除 Web 模式外，开发者也可使用命令行模式执行一次性任务，例如 npx @deepseek-ai/dsh --profile headless "帮我列出当前目录下所有的 Python 文件"。
工程意义：把 Agent 框架从“调用层”推向“运行时”
从素材呈现的信息看，DeepSeek Harness 的价值不在于继续扩展模型调用接口，而在于把 Agent 工程落地中反复出现的公共能力内置化。它把模型连接、工具执行、会话保存、沙箱隔离、权限策略和可观测性纳入同一运行框架，降低开发者自行拼装基础设施的复杂度。
这种设计也带来更明确的工程含义：Agent 不再只是围绕 Prompt 和工具调用的脚本，而是需要被长期运行、维护、替换和审计的服务系统。插件化架构使各模块具备可替换性，也便于团队按业务需求裁剪能力，而不是被迫接受一套固定实现。
素材还提到，这是系列内容的第一篇，后续将继续深入 Cordis 插件框架、核心子系统与实际模块。对于关注 Agent 工程化的开发者而言，DeepSeek Harness 提供了一个值得观察的新样本：当模型能力逐渐趋同，围绕运行时的基础设施正在成为 Agent 产品能否稳定落地的关键变量。
原创文章，作者：点点，如若转载，请注明出处：https://www.dian8dian.com/deepseek-tui-chu-kai-yuan-agent-yun-xing-shi-harness-yi-cha
