跳至系统架构
智能体系统图谱 / FIELD ATLAS
资料核对 ·

系统架构手册 / AGENT SYSTEMS

DeepSeek
Harness全景图

模型提出下一步,工具读写工作区,会话记住结果。沿着一次文件读取,看 DeepSeek 如何用插件组装出能动手工作的智能体。

DeepSeek Harness 分层示意图交互入口位于上层,Agent Loop 在中间协调模型与工具,工具通过运行环境访问工作区。各层由 Cordis 插件装配。 DSH / RUNTIMEEXPLODED VIEW LOOP 交互入口INTERFACE 智能体循环AGENT LOOP 工具与工作区WORKSPACE CORDIS PLUGIN RUNTIME
交互入口、循环与工作区的关系示意DSH / FIG. 01

运行时 / ARCHITECTURE

一次文件读取,怎样走完一轮对话?

点选节点,跟踪一句“项目怎么启动”如何变成有文件依据的回答。

README.md / 示例调用路径

↺ 工具返回后,循环取出新的会话记录,再次请求模型。

STEP 01 / 06

给工作区一个具体问题

桌面端或 Web 界面把用户消息交给当前会话。工作目录给文件工具提供路径起点,同一目录里的不同会话可以分别保留自己的历史。

用户问“读一下 README.md,告诉我项目用什么命令启动?”
官方架构说明 ↗
STEP 02 / 06

这次提问有一份连续记录

会话用追加事件记录交互。运行时从这些事件还原模型能看到的历史,随后加入的工具结果也会成为下一次请求的上下文。

示例中,提问进入这次会话,稍后读取 README.md 的结果也会记在同一处。
Session 会话机制 ↗
STEP 03 / 06

准备模型需要的上下文

循环领取待处理的输入,组合当前会话的提示、模型选择和可用工具说明。一次用户交互可以包含多次模型请求,每次请求及其工具调用组成一个 step。

第一步把问题和 read 的参数说明交给模型,此时还没有文件正文。
官方回合流程 ↗
STEP 04 / 06

模型决定是否需要工具

适配器把请求交给选定的模型,并将返回的文本或工具调用转成运行时统一的流式消息。需要操作工作区时,模型可以给出工具名和参数。

模型请求 read,目标路径是 README.md。文件读取在下一环节执行。
模型与流式响应 ↗
STEP 05 / 06

在授权范围内读取文件

运行时找到已注册的工具,校验调用,并按当前策略及文件访问范围处理。成功时返回内容。文件不存在或权限不足时,错误也会作为结果返回。

在这个示例里,read 可以访问工作区内的 README.md,并从文件中读到启动命令 npm run dev。
工具执行机制 ↗
STEP 06 / 06

用读到的内容完成回答

工具结果写进会话,循环据此发起下一次模型请求。模型可以继续调用工具,也可以给出答复。待处理工作清空后,这一回合结束。

第二次请求有了 README.md 的正文,模型答复“启动命令是 npm run dev”。这是示例项目的命令。
官方回合流程 ↗

启动时,能力如何装进工作区?

  1. Profile 选择运行方式

    Web 提供浏览器界面,headless 适合执行一次任务,SDK 面向程序调用,ACP 用于协议接入。每份配置都会列出要加载的组合包。

  2. Bundle 提供一组能力

    Web、headless、SDK 和 ACP 共用基础包,再加载各自的应用包。极简 SDK 单独组装。用户可以用配置补丁替换或加入插件。

  3. Cordis 挂载插件树

    插件向共享上下文注册服务、监听事件,卸载时撤销注册。模型适配器、工具表、会话日志,甚至驱动每一轮任务的循环都可以替换。

官方架构文档 ↗ · Cordis 入门 ↗

使用场景 / WORKFLOWS

把任务交给 Harness

选一个与你手头工作相近的任务,看看需要准备什么、会用到哪些工具,以及怎样验收结果。

修复仓库里的一处报错

给它什么 一个可运行的代码仓库、触发错误的输入,以及你期望看到的结果。

怎么做 在标准模式下让它先运行失败用例,再读相关实现、编辑文件并重跑测试。用代码差异视图逐行核对改动。

怎样验收 用相同输入重试。保留代码补丁、测试命令和退出结果,检查相邻功能是否仍能工作。

给销售报表补齐同比和环比

给它什么 一份至少覆盖十三个月的销售明细,指明按月份还是地区汇总,以及金额单位。

怎么做 先检查日期和缺失值,再分组计算。让它把对比期缺数或分母为零的行单独列出。

怎样验收 打开新工作簿,抽选一个地区,用原始明细复算连续两个月与去年同期的数据。

核对一份技术选型提案

给它什么 候选项目、必需功能和几项待核实的说法,例如某个版本能否恢复中断的会话。

怎么做 让它搜索上游文档和版本记录,把每项说法对应到具体版本、原文链接及适用条件。

怎样验收 检查对照表里的链接能否支撑结论,遇到文档未说明的功能,保留待验证项。

复盘一次走错方向的工具调用

给它什么 一个已有会话,以及首次出现偏差的位置,例如读错了同名文件。

怎么做 在 Trajectory 中定位那一轮,依次看当时的上下文、工具参数和返回内容。需要比较另一种做法时,从相关位置分叉。

怎样验收 记下出错的路径与调用次序,再比较两条分支的输出,确认哪一步改变了结果。

在极简环境中比较模型

给它什么 一组可独立评分的编码任务、初始文件和统一的评分规则。

怎么做 用 Minimal 预设限制工具集,为各任务分配独立的工作区和会话编号,记录模型设置与结果。

怎样验收 按同一规则汇总通过数,抽查失败轨迹,确认两个模型接触到相同的初始文件和工具。

场景依据 官方使用演示 · 轨迹与运行模式 · 基准测试说明

公开案例 / CASEBOOK

从一个悬浮时钟,到一间协作仓库

四个有原始记录的实例,分别展示界面扩展、定时触发、团队协作和移动端接入。

官网演示 · 创造模式

对话生成悬浮番茄钟

用户提出要一个番茄钟。Agent 读取插件开发技能,查询界面插槽,写出插件包并安装。官网演示最后给出了可启动的 25 分钟悬浮计时器。

查看官网演示 ↗

官网演示 · 自动化任务

让周报在周五开始整理

用户约定每周五北京时间 17:00 整理项目记录。Agent 将提示词、时区和重复周期交给 schedule_create,任务面板随即出现一条等待触发的排程。

查看定时任务演示 ↗

DeepSeek 团队 · 研究原型

在 GitHub 讨论里交付修复

Super-agent 将单个仓库接入 Harness。获准的用户可以在 GitHub 或飞书提出请求,原型为工作项分配会话和目录,完成后回到原对话回复,例如附上待审查的 PR。

阅读研究原型说明 ↗

社区实作 · 移动端

从手机接着看电脑上的会话

april-jk 的 DSH Mobile Remote 在 Web 界面增加配对入口。作者展示了从 Android 选择工作区、提交任务和查看执行进度的过程,电脑端可查看访问历史并撤销配对。

查看作者演示与测试环境 ↗
ECOSYSTEM

插件从哪里来?

DeepSeek 维护运行时和插件接口。社区作者发布组合包、整理发现目录,也把同一套能力带到新的客户端。

官方运行时

DeepSeek Harness

上游项目提供 dsh、内置插件和扩展文档。作者可发布带有 dsh.bundle 声明的包,并标明兼容的宿主版本。

官方插件索引规范 ↗
社区索引

Awesome DSH Plugin

按功能查找插件,从目录回到作者仓库核实用途与依赖。这份清单也提供可订阅的 JSON 索引,可直接添加到 Harness。

浏览社区目录 ↗
社区桌面端

DSH Desktop

Anywhere Labs 将上游 Host 和本地 Web 界面集成到 Windows、macOS 与 Linux 桌面应用,提供原生窗口、托盘与终端。

桌面项目与下载 ↗
社区移动端

DSH Go

用 Android 手机运行本机引擎,或连接电脑上的 Harness 主机。两种模式提供的附件和插件管理能力有所不同。

移动端与连接方式 ↗
如何把社区索引接入自己的 Harness?
  1. 在目标配置档(profile)的「插件 → 实验性插件」中打开「自定义插件索引」。
  2. 进入「发现 → 添加索引源」,填入社区清单提供的地址,例如 https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json。
  3. 搜索插件,查看与当前宿主兼容的版本。点「安装」后核对 npm 包或 Git 提交,再确认安装。完成后在「已安装」查看组合包,按作者说明配置和启用。
查看 0.2.2-rc.5 操作说明 ↗
PLUGIN DIRECTORY

热门插件

从不同用途选出六个受到关注的社区插件。★ 为 2026 年 11 月 20 日查询的 GitHub 仓库星标数,反映社区对仓库的关注程度。

发现与管理

dsh-market

★ 13,058

想给 Web 界面增加能力时,在可视化市场里搜索、安装或升级社区插件。其 npm 包名为 dshmarket。

作者仓库 ↗
终端交互

dsh-TUI

★ 8,023

在终端中续接会话、查看工具审批、切换侧栏。适合希望把代码变更和模型对话放在同一个命令行工作环境的开发者。

作者仓库 ↗
界面与创作

dsh-pet

★ 6,588

在 Harness 界面加入透明动画宠物。可调整大小与位置,也能用自己的视频制作动作素材并替换角色。

作者仓库 ↗
上下文诊断

dsh-context

★ 5,350

长会话逐渐占满上下文时,可查看每轮输入的构成和变化。运行多智能体任务时,还能检查参与者之间的消息。

作者仓库 ↗
消息渠道

dsh-im

★ 3,735

连接飞书、钉钉、Slack 等平台的机器人,把收到的消息送入绑定的工作区和会话,再通过对应渠道返回回复。

作者仓库 ↗
三维制作

DSH × Blender

★ 2,214

接入正在运行的 Blender,让智能体查看选中的物体、修改场景并检查渲染帧。交互模式需要在 Blender 中安装配套桥接扩展。

作者仓库 ↗