夜雨聆风2026 年 8 月 13 日，DeepSeek 发布了 DeepSeek Harness 开发者预览版，源代码随版本一同公开。这次发布明确了一个核心公式：Agent = Model + Harness。对正在构建自主 agent 的开发者而言，同一个模型搭配不同的 harness，编码能力可能出现显著差异，harness 的工程化水平正在成为效果提升的关键杠杆。
这个预览版具体提供了什么
Harness 是连接模型与环境的插件化运行时，设计上遵循两条原则：一切皆插件，每次运行可追溯。所有能力——包括 models、tools、skills、sessions、sandbox、storage、loops、scheduling 甚至 UI——都以插件形式存在。插件基于 Cordis 插件系统运行，kernel 负责挂载、卸载和依赖管理，插件之间通过 services 和 events 协作。
开发者不需要改动 harness 源码，只需编写配置文件就能选择、替换或扩展任意组件。可追溯性方面，模型看到的一切（系统提示、推理过程、工具调用及结果、子 agent 调度、每次上下文注入）都记录在 append-only 的 session log 里。Trajectory 视图支持按来源检视这些记录，并提供 resume、fork、search、replay 能力，全部基于同一套 event stream。
怎么开始跑起来
安装只靠一条命令：
- `npx @deepseek-ai/dsh web` 直接启动 Web 界面。
- 或从源码构建：`git clone https://github.com/deepseek-ai/deepseek-harness`，然后按仓库 README 进行本地安装。
首次运行前需要配置模型 API 密钥等环境变量，具体参数见官方文档。社区生态也已起步，包括社区插件目录、dshplugin.online 插件索引站、dsh-index.xlings.org 插件与 agent profile 包索引，以及第三方桌面版 deepseek-harness-desktop。
四种运行模式分别适合什么场景
- Standard mode：提供完整工具集的编码 agent，含文件编辑、shell、文件与网页搜索、skills、planning、goals、subagents、workflows。适合日常开发辅助任务。
- Code mode：在 Standard 基础上通过 Code Mode SDK 暴露工具，允许模型用 TypeScript 程序编排多步操作。适合需要复杂流程控制的自动化场景。
- Minimal mode：只保留持久化 bash 和 str_replace_editor 两个工具，用于在极简环境下跑基准测试，评测模型基础能力。
- Creator mode：面向创作自定义 agent 预设，支持运行时检视、在内存中测试 Cordis 插件，并把插件组合成新模式。适合插件开发者与预设作者。
哪些场景不适合用它
- 预览版行为与 API 可能变动，尚未达到生产环境稳定性要求，关键业务系统慎用。
- 需要一定的配置能力和插件开发经验，对非开发者不友好，没有图形化配置向导。
- 高度依赖外部模型 API，在完全离线或网络受限的环境中无法运行核心功能。
- 社区插件数量仍有限，部分工具或 skills 可能需要自行实现，集成成本较高。
- Minimal 模式工具极少，不适合需要文件操作、网络搜索等复杂任务的实际工作。
容易踩的三个坑
- 插件依赖声明缺失：Cordis 插件通过 services 和 events 协作，若配置文件中未列出某个插件的依赖，可能导致能力静默失效，排查时不易定位。建议先对照官方文档理清插件依赖关系。
- 误以为模式之间工具集通用：不同模式默认加载的插件集合不同，Standard 模式的工具在 Minimal 模式下不可用，切换模式时需显式重新指定所需插件。
- session log 存储位置未配置：默认 append-only log 可能写入临时目录，重启后丢失，长时间运行还会占用大量磁盘空间。需提前设置持久化存储路径并规划日志清理策略。
下一步，访问 DeepSeek Harness 官方发布页，用 npx 命令快速跑通 Standard 模式，然后对照 dshplugin.online 上的插件索引尝试替换工具或模型，逐步构建自己的 agent 预设。