先建立正确心智模型

DeepSeek Harness 是什么?

用模型、工具、权限、Session 与 Agent Loop 的关系,快速理解 DeepSeek Harness 的职责边界。

官方事实适用 0.1.0-rc.56 分钟核验于 2026-08-14

DeepSeek Harness(命令名 dsh)是 DeepSeek AI 开发的开源 Agent Harness,不是 DeepSeek 模型本身。它把模型、工具、权限、Session、持久化与运行界面组合成一个能完成任务的系统。

模型负责推理,Harness 负责让模型在受控环境中使用工具、保存状态并完成任务。

它处在技术栈的哪一层

当模型只收到一段文本时,它只能生成下一段文本。Harness 在模型外围补齐执行任务需要的环节:

  1. 把文件、Shell、网页检索等工具描述给模型;
  2. 执行模型选择的工具,并把结果记入 Session;
  3. 按权限策略决定哪些操作能直接执行、哪些需要确认;
  4. 继续 Agent Loop,直到任务完成、失败或被用户停止;
  5. 保存事件日志,让会话可以恢复、回放或 fork。

“一切皆插件”意味着什么

DeepSeek Harness 底层使用 Cordis。模型适配器、工具注册表、Session log、Agent Loop 等能力都通过插件向共享 ctx 注册服务、事件和可撤销 effect。

这不只是“能装几个扩展”。更重要的是,同一种能力可以被替换、组合和卸载:你可以更换模型提供方、工具实现、Shell、文件系统策略或 UI,而不必重写整个运行时。

最短启动

npx @deepseek-ai/dsh web

默认 Web 地址是 http://127.0.0.1:3080。进入界面后仍需配置模型凭据并选择工作区。

当前成熟度

项目目前标注为 Developer Preview。官方明确提醒可能发生破坏兼容性的变更,所以教程、插件与配置都应绑定版本和核验日期。DSH101 当前追踪 CLI 0.1.0-rc.5master@47f943859b

接下来怎么走

证据与修订

一手来源

本页叙事经过压缩;命令、行为与风险边界以以下官方源码或文档为准。