DeepSeek Harness（鲸娘）是什么？一文看懂"一切皆插件"的开源 AI Agent 框架

一、它是什么

（一）一句话定义

DeepSeek Harness（dsh）是由 DeepSeek AI 开发的开源 agent harness（智能体框架）。所谓 harness，就是套在大模型外面、让它能真正”干活”的那层运行框架——负责编排对话、调用工具、管理会话与沙箱。它和 Claude Code、Codex CLI 是同一赛道的东西，区别在于 dsh 把”可扩展”做到了极致。

项目采用 MIT 许可、以 TypeScript 编写，2026 年 8 月开源后迅速冲到 21 万+ Star。官方口号只有一句话：Everything is a Plugin（一切皆插件）。

（二）名字与吉祥物

命令名是 dsh，社区给它起了个中文昵称”鲸娘”——呼应 DeepSeek 的鲸鱼形象。它目前处于开发者预览（Developer Preview）阶段，迭代很快，官方明确提示”未来可能出现破坏兼容性的变更”，运行前建议先读它的安全说明（SAFETY）。

二、核心特性：一切皆插件

（一）插件化架构

dsh 的架构哲学是”一切皆插件”。在别的工具里，模型、工具、会话存储、沙箱往往是写死的内核；而在 dsh 里，这些全部是插件，可以自由替换、组合、插拔。带来的直接好处是：想换模型、接新工具、改沙箱隔离策略、迁移会话存储，都不必改内核，装个对应插件即可。

中央是 agent 内核，四周的积木块（模型 / 工具 / 技能 / 会话 / 沙箱 / 存储）都可拔插替换——这就是”一切皆插件”

（二）Cordis 与”时空可组合性”

这套插件化能力，底层由 Cordis 驱动。其设计理念来自论文《A Programming Paradigm for Spatiotemporal Composability》（时空可组合性编程范式）。通俗讲，它把”组件在何时、何处、如何组合”抽象成可组合的单元，才让”一切皆插件”从口号变成工程现实。对普通使用者来说，你只需要记住结论：扩展 dsh，就是往里面插插件。

三、它能做什么

作为一个 agent harness，dsh 的典型用途包括：

• AI 编程助手：在本地起一个带 Web UI 的智能体，读写代码、跑命令、调试，体验接近 Claude Code / Codex CLI；
• 可编排的工具调用：通过插件接入各类工具与 MCP 服务，让 Agent 完成检索、执行、生成等任务；
• 多模型自由切换：模型也是插件，可在不同提供商 / 不同模型间切换，甚至搭配免费路由；
• 可扩展的安全研究 / 自动化工作流：借助插件与沙箱，把重复流程交给 Agent 跑。

一句话，它是”给 AI Agent 用的运行底座”，具体能干什么，取决于你给它插了哪些插件、接了哪个模型。

四、如何安装与启动

（一）环境要求

只需要 Node.js（v18+）与 npm。可先自查版本：

node --version
npm --version

（二）npx 一键运行（推荐）

官方最省事的方式，是一条命令直接拉起本地 Web UI：

npx @deepseek-ai/dsh web

首次运行会自动下载安装，随后在 http://127.0.0.1:3080 启动 Web UI，本机环境下还会自动用默认浏览器打开。通过 SSH 远程启动时，它只打印宿主机 URL（因为端口转发由你的 SSH 客户端或编辑器持有）；若只想跑服务、不弹浏览器，加 –no-open。

一条 npx 命令 → 本地 Web UI，无需复杂配置即可开跑

（三）从源码运行

想改代码或研究实现，可从源码构建：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

其中 pnpm run build 会准备仓库产物，pnpm dsh web 直接使用已构建产物、不会重复构建。

五、零成本上手：配置免费 API

（一）为什么要配第三方

dsh 本体是免费的，但它要”接一个大模型”才能干活。DeepSeek 官方 API 需要付费，于是社区摸索出用第三方免费 API 提供商来零成本跑通的路子——除了注册拿 Key，其余交给 dsh。下面三家是教程里最常见的组合。

三家免费 API 提供商像三条线路，经统一路由汇入 dsh；解锁挂锁代表”免费接入”

（二）三家免费提供商

获取 Key 的通用步骤：访问各家控制台 → 注册 / 登录 → 创建 API Key → 复制备用（OpenRouter 的 Key 形如 sk-or-v1-xxxxx）。

（三）填 Key 与配置 Provider

Key 一般写进 dsh 的环境变量文件 ~/.dsh/.env：

# ~/.dsh/.env
OPENROUTER_API_KEY=sk-or-v1-xxxxx
AGNES_API_KEY=sk-xxxxx
OPENCODE_API_KEY=sk-xxxxx

再在 ~/.dsh/settings.yaml 里声明 provider 与模型（节选示意）：

llm-pi-ai:
  providers:
    openrouter:
      displayName: "OpenRouter (Free Routes)"
      apiKeyEnv: OPENROUTER_API_KEY
      api: openai-completions
      baseURL: https://openrouter.ai/api/v1
      models:
        - id: openrouter/free
          name: "OpenRouter Free Router"
          contextWindow: 200000
          maxTokens: 32000

agent-default-model:
  provider: openrouter
  model: openrouter/free

配置完成后重启 dsh（dsh web），在模型选择器里挑免费模型即可测试。你也可以直接在 Web UI 的 Settings → Models → Add provider 里图形化填 Key。

六、常见问题与注意事项

七、同类方案对比

把 dsh 放进”AI 编程 Agent / harness”这条赛道里横向看：

• vs Claude Code / Codex CLI：同属可跑代码任务的 Agent 工具；差异在于 dsh 把”一切皆插件”作为一等公民，模型 / 工具 / 存储 / 沙箱都可替换，扩展自由度更高。
• vs OpenCode：都偏开源、可自托管、可接多家模型；dsh 的插件化底座（Cordis）与本地 Web UI 是其特色。
• vs 通用 Agent 框架（LangChain 等）：那些是”造 Agent 的库”，dsh 是”开箱即用、可插拔的 Agent 运行框架”，定位更偏终端用户与工程集成。

需要注意：dsh 尚处开发者预览，成熟度与生态仍在快速建设中，稳定性和文档完整度会随版本波动。

八、谁开发的 & 项目现状

由 DeepSeek AI 官方开源，仓库 deepseek-ai/deepseek-harness，MIT 许可，TypeScript 实现，2026-08-13 创建后热度极高。官方文档在 deepseek-harness.github.io/deepseek-harness，主页 deepseek.com/harness；社区反馈走 GitHub Discussions，插件仓库可打 dsh-plugin 话题，另有企微群与公众号。当前处于开发者预览、快速迭代阶段。

九、市场前景与意义

dsh 的意义有两层。技术上，它把”一切皆插件”和 Cordis 的时空可组合范式落到一个真实、高热度的开源项目里，为 Agent 框架的可扩展性提供了一个值得研究的参照系。生态上，作为 DeepSeek 亲自下场的 Agent harness，它把”模型 + 框架 + 工具”串成闭环，配合社区”接免费第三方 API 零成本上手”的玩法，大幅降低了普通开发者体验顶级 Agent 工作流的门槛。对想在本地跑、可自由换模型、又不被单一厂商锁定的开发者来说，这是一个值得关注的选项。

“鲸娘”驱动代码编辑器、金币飘走——零成本接入让顶级 Agent 工作流触手可及

十、总结

DeepSeek Harness（dsh / 鲸娘）是一款以”一切皆插件”为核心理念的开源 AI Agent 框架：装好 Node.js、一条 npx @deepseek-ai/dsh web 就能起本地 Web UI；模型、工具、会话、沙箱皆可插拔；再配上 OpenRouter 等第三方免费 API，几乎零成本就能跑起来。

如果你只想记住三句话：

• 是什么：DeepSeek 开源的、插件化的 agent harness（智能体运行框架）。
• 凭什么：一切皆插件 + Cordis 时空可组合 + 一条命令起 Web UI + MIT 开源。
• 怎么用起来：npx 安装 → 在 ~/.dsh 填 Key 与 provider → 挑一个免费模型开跑；但记得它仍是开发者预览，先读安全说明。

项目地址：github.com/deepseek-ai/deepseek-harness · 文档：deepseek-harness.github.io/deepseek-harness · 协议：MIT

在撰写本文的过程中，我主要参考了 DeepSeek Harness 官方仓库 README（中 / 英）与 docs、项目主页 deepseek.com/harness，以及社区流传的一篇”安装配置 + 免费 API 接入”教程。文中第三方免费 API 的模型与端点以该教程为准，可能随其政策变化；Star 数等指标以仓库公开信息为准。配图均为 AI 生成的概念插画，不代表官方素材。