DeepSeek Harness 插件指南

什么是 DeepSeek Harness 插件？

Harness 运行时中的可组合能力

DeepSeek Harness 是 DeepSeek AI 开源的 Agent Harness。官方架构把组件视为插件：插件可以通过共享 context 注册服务、工具、模型服务商、会话行为、界面元素、运行时 hook 或其他能力。

当社区 registry 提供 Harness 安装记录并指向面向插件系统的源码时，本站将该仓库视为 DSH 插件。只调用 DeepSeek API、集成其他 Agent 框架，或名称中含有“DeepSeek”的包属于其他生态。

核心架构

Context、可逆 effects、profiles 与 bundles

Harness 使用 Cordis context 作为插件边界。基础 TypeScript 插件导出 apply(ctx) 函数；通过 context 注册的能力受插件生命周期约束，插件销毁时运行时可以清理它们。

import type { Context } from '@deepseek-ai/dsh'

export function apply(ctx: Context) {
  ctx.effect(() => {
    // 启动资源或订阅事件。
    return () => {
      // 插件停止时释放资源。
    }
  })
}

插件可以通过 injection 声明所需服务，并使用类型化 Config 与 Schemastery schema 定义配置。官方指南建议验证配置，并在必填值无效时立即失败。

插件与 MCP

选择符合任务的扩展边界

两者可以组合。Harness 插件可以管理 MCP 连接，或为可移植 MCP 服务增加客户端专属控制。涉及文件系统、shell、浏览器或凭据时，优先选择能完成任务的最小信任边界。

何时使用插件

从能力及其访问范围出发

开始使用

从干净 Harness profile 到一个已检查插件

1. 1
   启动官方 Web 体验

   按当前仓库要求准备环境，再运行 DeepSeek AI 文档中的命令。

   npx @deepseek-ai/dsh web

2. 2
   配置模型与工作区

   在 DSH Web 的 Settings → Models 中配置模型，并选择 Agent 可以访问的工作区。

3. 3
   打开插件来源

   核对 GitHub owner、仓库、package、bundle manifest、profile 说明、许可证、最近活动与兼容报告。

4. 4
   检查记录的安装命令

   下面是常见社区 registry 形式。使用维护者推荐的确切来源和版本。

   dsh plugin --profile web add github:OWNER/REPOSITORY

5. 5
   验证狭窄结果

   一次只测试一个陌生插件，检查日志和网络访问，并在依赖它之前确认恢复或移除路径。

审查与发布

让来源身份、运行时 effects 与恢复路径保持可见

本目录是独立发现入口。收录、stars 与最近活动都不构成安全审计、官方背书或兼容承诺。