DeepSeek Harness · 一切皆插件

插件提供全部 Agent 能力 Cordis 只管理加载与依赖

DeepSeek Harness 把「能做什么」做成可插拔模块:模型适配、工具、技能、会话、沙箱、存储、循环、调度和 UI 都是插件。先用 DeepSeek 网页版与 DeepSeek-V4 对齐需求,再在 Harness 配置里替换对应插件。

内核

Cordis

加载 / 卸载 / 依赖

能力

全是插件

含模型与 UI

配置

自由组合

不必改源码

生态

dsh-plugin

GitHub topic 发现

插件覆盖的能力面

从模型到 UI,DeepSeek Harness 没有特权内核功能

官方表述:所有 Agent 能力均由插件提供。这意味着 DeepSeek-V4 适配、工具集甚至界面,都可以被替换或扩展。

模型插件

模型是 Agent 的灵魂,但在 Harness 里也是插件。你可以按配置切换适配器,把 DeepSeek-V4 或其他提供方接到同一套工具与会话日志上。

DeepSeek-V4 模型插件

工具与技能

文件编辑、Shell、检索、Skills 等以插件注册到工具表。标准模式给出完整组合,极简模式可裁到 bash + 编辑器以便评测。

DeepSeek Harness 工具

会话与 Trajectory

会话日志仅追加:系统提示、思维链、工具结果、子 Agent 调度与上下文注入同源可回放,便于调试「模型到底看见了什么」。

DeepSeek 会话日志

沙箱与存储

沙箱、文件系统与持久化同样是插件。替换沙箱策略时不必改 Agent 循环,只需在配置层切换实现。

DeepSeek Harness 沙箱

循环、调度与子 Agent

Agent 循环、任务调度与子代理编排可组合。PTC / Code 模式进一步让模型用 TypeScript 程序串联多步工具。

DeepSeek Agent 循环

UI 也是插件

Web UI 并非不可替换的外壳。dsh web 拉起浏览器界面,本身也在插件树中,可按 profile(如 web / headless)叠加不同包。

DeepSeek Harness Web UI
运行时如何叠起来

一次 dsh 启动 = 有序插件树

官方架构把运行中的 dsh 描述为启动时由多层配置组成的插件树。理解分层,有助于你扩展而不是 fork。

01

Profile 配置

Profile 是命名组合:列出叠加的 bundle、树外插件以及用户自己的 cordis.patch.yml。web 与 headless 以模板形式提供。

02

dsh-base

几乎每个 profile 的第一层:模型适配、工具、持久化、沙箱与审批策略、设置、凭据、遥测等基础能力。

03

dsh-web-app / headless

web-app 叠加浏览器应用;headless 叠加无服务器的一次性运行器。同一套插件哲学,不同交付形态。

04

社区插件

用 dsh-plugin topic 让插件可被检索。预览阶段 API 会变,插件作者应按官方开发指南与 Discussions 跟进。

为什么这套设计重要

开源可检查,插件可改造

许可证让代码可审计;Cordis 让运行时可重组。这对 DeepSeek Agent 开发者意味着更低的 fork 成本。

01

用 inject 表达依赖

插件通过 inject 声明所需服务(如 tools、llm),Cordis 在服务就绪后再启动消费者。加载顺序由依赖决定,而不是 YAML 行号。

02

可逆副作用

监听器、工具注册与定时器随插件卸载自动清理。需要显式释放的资源用 effect 登记 disposer,避免热替换后泄漏。

03

先对话,再改插件

不确定要换模型还是换工具时,先在 DeepSeek 网页版用 DeepSeek-V4 把任务边界问清楚,再回到 Harness 改配置,避免盲目改插件。

插件组合之前,先用 DeepSeek 网页版对齐目标

DeepSeek-V4 帮你把任务说清楚;Harness 插件负责把能力接进真实环境。

插件 FAQ

写 DeepSeek Harness 插件前要知道的事

结合官方文档口径:插件形态、配置组合,以及和 DeepSeek 网页版的分工。

01 插件长什么样?

常见形态是导出 apply(ctx) 的 TypeScript 模块;也可以是带 apply 的对象,或提供服务的 Service 子类。框架加载时把共享上下文 ctx 传入。

02 如何把插件挂进运行时?

在 cordis.yml / overlay / patch 中登记模块路径或包名。官方教程强调插件路径在部分场景需绝对路径,并以 profile 叠加而不是改核心包。

03 UI 真的能换掉吗?

官方把 UI 列为与模型、工具同级的插件能力。你可以在配置层选择或扩展界面,而不必修改 DeepSeek Harness 源码。

04 和直接用 DeepSeek 网页版冲突吗?

不冲突。网页版适合快速对话与 DeepSeek-V4 推理;插件适合把验证过的流程固化成工具链。本站 CTA 会先带你进入网页版对话。

05 预览版插件会不会经常坏?

会有破坏性变更,这是官方大写警告。把插件当作可演进实验,关注 Discussions,不要假设 API 长期稳定。

06 在哪里看架构细节?

官方仓库 docs/architecture.md、Cordis primer 与开发指南。本页是面向检索与产品理解的介绍,不替代上游文档。

从对话到可插拔 Agent

需要本地工具与沙箱时再启用 dsh;现在可以先进入 DeepSeek 网页版。