DeepSeek Harness 是什么？dsh 智能体框架入门指南
2026-08-18
DeepSeek Harness 是什么
DeepSeek Harness（通常简写为 dsh）是 DeepSeek AI 开发的开源智能体框架（agent harness），目前处于开发者预览阶段。它负责把大语言模型变成一个真正的智能体：能读写文件、执行命令、调用工具，并跨会话持续工作。一条命令即可启动：npx @deepseek-ai/dsh web，会在本机打开 Web UI。源码位于 github.com/deepseek-ai/deepseek-harness。
为什么智能体框架不等于聊天窗口
聊天窗口只做一件事：发文字、收文字。而框架给模型一个完整环境：工作区访问权限、可调用的工具、会话存储，以及决定它能做什么的边界。这在实际使用中差别很大。在 DeepSeek Harness 里，模型只是众多组件之一，框架负责协调其余一切——沙箱、审批策略、会话日志，以及判断任务何时完成的智能体循环。
一切皆插件
框架的核心设计原则非常明确：一切皆插件。模型、工具、技能、会话、沙箱、存储、调度，乃至 UI，全部作为插件挂载在 Cordis 内核之上。Cordis 负责插件的挂载、卸载与依赖解析，且所有注册都是可逆的——插件卸载时，它注册的内容会被自动清理。因为能力都是插件，你可以只改配置就替换或扩展任意能力，完全不需要改动 DeepSeek Harness 源码。
Profile 与 Bundle
Profile 是保存在 Harness 主目录下的具名组合，web 与 headless 作为模板内置。Bundle 是贡献一层配置的 npm 包，通过在 package.json 中声明 dsh.bundle 字段来标识。安装插件时，npm 包用 dsh plugin --profile web add <包名>，GitHub 仓库用 dsh plugin --profile web add github:owner/repo。从 GitHub 安装会拉取源码，再由包的 prepare 脚本在本地构建，pnpm 会要求你显式允许这次构建。建议固定 commit（github:owner/repo#sha），只安装你信任的来源。完整步骤见安装指南。
每次运行都可追溯
模型看到的一切都会写入追加式的会话日志：系统提示、推理过程、工具调用与结果、子智能体调度、上下文注入。Trajectory 视图让你按来源检查每次运行，并可在同一事件流上继续、分叉、搜索或回放。对排查智能体行为的开发者来说，这份记录决定了你是靠猜还是在回放。
dsh 插件从哪里来
插件发布在 npm 或以 GitHub 仓库分享，多数带 dsh-plugin 话题以便被发现。dshplugins.cc 追踪整个生态：收录带该话题的插件，每日记录 Star 与下载量，并为每个插件提供安装命令与基于真实信号的健康评分——许可证、社区采用、文档完整度与分发量。你可以从插件目录开始，或按分类浏览。
FAQ
DeepSeek Harness 免费开源吗？ 是的，源码公开在 deepseek-ai GitHub 组织下，目前处于开发者预览。
需要 DeepSeek API Key 吗？ 不一定。模型层本身是适配器插件，具体取决于你配置的模型提供商。
它稳定吗？ 还不稳定。DeepSeek 说明预览版仍在面向开发者测试，核心插件与 API 会持续演进。
怎么安装插件？ 在源码目录执行 dsh plugin --profile web add <包名> 或 dsh plugin --profile web add github:owner/repo，详见安装指南。
结语
DeepSeek Harness 是一个开发者预览阶段的智能体框架，其整个表面都由可替换的插件组成。想试的话，先运行 npx @deepseek-ai/dsh web，再从目录里装几个插件。最快的路径是安装指南，而每个插件页上的健康评分能帮你在引入第三方代码前，做一个基于真实数据的快速判断。