2026年8月13日DeepSeek 正式推出其首款 Agent 产品 ——DeepSeek Harness v0.1 开发者预览版并同步以 MIT 协议在 GitHub 开源。官方给出了一个简洁的定义Model Harness Agent。模型负责理解与推理Harness 负责将模型能力落地到真实环境中完成从理解需求到交付结果的完整闭环。一、核心定位与产品形态Harness 并非一个开箱即用的终端应用而是一套面向开发者的Agent 运行基础设施。它内置了项目管理、长周期任务协作、多智能体编排、上下文管理、联网检索与外部技能调用等能力。目前 v0.1 仍是开发者预览版启动后通过浏览器访问http://127.0.0.1:3080使用暂无桌面应用。官方在启动时会提示核心插件和基础接口在未来几个月会快速演化。发布后 12 小时内其 GitHub 仓库已获得超过 5 万 Star。在竞争格局上Harness 的直接对标产品是 OpenAI Codex 与 Anthropic Claude Cowork。但与这些更侧重于“即用型工具”的产品不同Harness 的差异化在于其底层架构的开放程度——它试图将 Agent 的每一个环节都拆解为可替换的模块。二、架构设计“一切皆插件”Harness 最核心的设计原则是“一切皆插件”Everything is a plugin。该框架基于Cordis插件元框架构建。Cordis 仅负责插件的加载、卸载与依赖关系管理不承载任何 Agent 的具体能力。模型适配器、工具注册表、会话管理、沙箱实现、Agent 循环乃至用户界面全部以独立插件形式存在。开发者无需修改 Harness 源码即可在配置层替换或扩展任一能力。Cordis 的设计思想源自一篇由北京大学与 DeepSeek 联合署名的论文其核心概念是“时空可组合性”。“时间”维度指插件卸载后其注册的服务、事件与副作用能够自动撤销“空间”维度指插件可以声明依赖并在其他组件变化时重新建立协作关系。根据对公开技术资料的分析这套机制在工程层面主要通过以下方式实现唯一的修改入口所有对系统状态的修改都必须经由ctx上下文对象完成而ctx上的每个操作内部都是副作用追踪的封装。这确保了任何注册行为都会被框架追踪不存在绕过追踪的路径。生命周期状态机每个插件实例带有状态管理。在已卸载的插件上创建副作用会直接抛出异常从时间上杜绝了资源泄漏。服务查找机制访问ctx上的服务如ctx.tools、ctx.llm时通过 Proxy 代理拦截访问沿当前插件层级向上查找服务提供者。作用域隔离由此自然实现子层可见父层服务反之则不行。这套机制的价值在模型适配场景中体现得比较直接Harness 定义了一份通用的llm服务接口系统内可同时存在多个实现该接口的插件——一个适配 DeepSeek 自家模型另一个适配第三方模型厂商。上层 Agent 循环无需改动替换插件即可切换模型提供商。三、运行模式Harness 预置了四种运行模式每种模式默认加载不同的插件集合模式适用场景标准模式功能完整的通用开发场景PTC 模式程序化工具调用模型生成代码来编排多轮工具调用适合复杂自动化任务极简模式仅保留 Shell 与文件编辑工具用于模型基准测试与最小化复现创造模式运行时检查、内存内调试插件用于自定义新的运行模式其中极简模式已被 DeepSeek 用于 Terminal Bench 等基准测试场景。四、关键机制轨迹TrajectoryHarness 提供了名为“轨迹”Trajectory的功能用于解决 Agent 运行过程“黑盒化”的问题。Agent 运行过程中模型看到的系统提示词、思维链、工具调用与结果、子 Agent 调度等信息均以仅追加append-only的格式写入会话日志而非经过润色的摘要。这些原始事件级记录支持回放与检索可用于排查任务失败原因与追踪 Token 消耗。五、使用方式环境要求Node.jsv22.19 及以上或 v24 系列包管理器源码安装需要 pnpm快速启动npx deepseek-ai/dsh web命令执行后浏览器打开http://127.0.0.1:3080在设置中配置 API Key 即可使用。后期嫌这个命令太长可以在工作区项目里修改package.json{scripts:{dsh:npx deepseek-ai/dsh web --trusted-host localhost}}这样下次就可以这样运行了npmrun dsh源码安装适用于二次开发gitclone https://github.com/deepseek-ai/deepseek-harness.gitcddeepseek-harnesspnpminstallpnpmrun buildpnpmdsh web如果输入y后仍然卡住怎么办可能的原因和解决方法网络问题导致下载慢npm 默认从国外源下载如果网络不稳定下载可能会卡住。可以先按Ctrl C终止当前命令然后切换到国内镜像源重试npmconfigsetregistry https://registry.npmmirror.com npx deepseek-ai/dsh webNode.js 版本不匹配检查版本是否符合要求v22.19node-v如果版本过低使用 nvm 切换到更高版本后重试。npx 缓存问题如果多次重试仍卡住可以清理 npx 缓存后重新执行npx clear-npx-cache# 或手动删除缓存目录# Windows: rm -rf %LOCALAPPDATA%\npx-cache# Mac/Linux: rm -rf ~/.npm/_npx如果确认后下载成功但启动后仍然无法使用检查是否在浏览器中打开了http://127.0.0.1:3080部分用户反映会自动弹窗但有时需要手动打开。如果端口被占用可以尝试指定其他端口如果支持的话。**亲测**我用http://127.0.0.1:3080部分功能有问题用http://localhost:3080才正常最省事的做法在提示处直接输入y回车等待下载完成。通常下载完成后会自动启动服务终端会显示“Server running at http://127.0.0.1:3080”之类的提示。Python SDKHarness 同时提供了 Python SDK支持在程序中调用和编排 Agent 能力。设置完模型和密钥后就可以用了我这里搭配的模型是GLM5.2很快就分析完了在下方可以看到任务消耗的 Tokens、当前的上下文占用、以及整个对话的 Tokens 消耗信息。暂时还没用它来完成编码工作这个评测等后面再介绍吧这才是v0.1版本还是很看好它的DeepSeek牛逼六、现状与适用人群v0.1 是开发者预览版生产环境使用需谨慎评估。其界面与交互对非开发者不够友好目前更适合以下人群需要深度定制 Agent 运行时的开发者希望对比不同模型在相同工具环境下表现的评测者有意参与插件生态建设的社区贡献者对于寻找“开箱即用”型产品的普通用户目前的 Harness 可能尚未达到理想状态。
)
