认识 DeepSeek Harness
理解 Agent = Model + Harness，以及这个框架在解决什么问题。
DeepSeek Harness（简称 dsh）是由深度求索（DeepSeek AI）开发、于 2026 年 8 月正式开源的 Agent Harness（智能体框架），采用 MIT 许可证，代码以 TypeScript 编写。
Agent = Model + Harness —— 模型负责“思考与生成”，Harness 负责把模型接入文件系统、终端与工具链，让 AI 真正在现实环境里“动手干活”。
DeepSeek Harness 采用“一切皆插件”的开放架构：模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力均由插件组合而成，可以自由替换和灵活重组——无需改动源码，即可在配置层定制你自己的 Agent。
谁适合阅读本教程
- 开发者 / 工程师：想要一个能力边界完全可控、每个组件都可替换重组的本地 AI 编码助手。
- AI / ML 从业者：对 Agent 架构感兴趣——底层由 Cordis 插件系统驱动，事件驱动设计有论文支撑。
- 效率工具爱好者：希望用 Web UI、headless 命令行或 Python SDK 把 Agent 嵌入工作流。
- 研究人员：需要可观测的 Agent——每次运行都写入仅追加会话日志，可在 Trajectory 视图回放。
- 注重开源可控的用户：MIT 协议、配置层自由组合、无遥测、无云端锁定。
阅读前需要具备的基础
本教程不要求 AI 研究背景或深度学习知识，但建议具备以下基础：
| 能力 | 要求程度 | 说明 |
|---|---|---|
| 命令行基础操作 | 必须 | 能在终端执行命令、设置环境变量 |
| Node.js 基础 | 必须 | 通过 npx / pnpm 安装并启动 dsh |
| 基本 API 概念 | 了解即可 | 知道什么是 API Key、如何申请 DeepSeek API Key |
| 插件 / 配置文件概念 | 了解即可 | 进阶章节（插件开发、配置层组合）会用到 |
| Git 基础 | 可选 | 从源码安装、参与贡献时会用到 |
操作系统要求：Linux、macOS 或 Windows（安装 Node.js 后即可运行）。
核心特性
一切皆插件
Cordis 内核只负责插件的加载、卸载与依赖管理；模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等能力均由插件提供。
运行有迹可循
模型看到的一切（系统提示词、思维链、工具调用与结果、子 Agent 调度）都写入仅追加的会话日志，可在 Trajectory 视图回放。
四种运行模式
标准、PTC、极简、创造四种预设模式，覆盖从日常开发到基准测试、插件试验的全场景。
多形态使用
Web UI（默认 http://127.0.0.1:3080）、headless、CLI、Python SDK、TypeScript SDK 五种形态。
工具与扩展丰富
文件编辑、Shell、检索、Skills、计划、目标、子代理、工作流；事件驱动扩展点，任何能力都可被 patch 替换。
开放可控
MIT 开源；Profile + 组合包分层叠加配置，--dump-config 可查看实际启动的完整配置树；无特权内核。
模型无关
填入 DeepSeek API 密钥即可用，支持其他提供方与自定义 OpenAI 兼容端点，模型路由无需重启。
研究就绪
完整可观测的事件流与配置树，面向 Agent 架构研究的开放设计（底层 Cordis 有学术论文支撑）。
相关资源
| 资源 | 链接 |
|---|---|
| 官网 | deepseek.com/harness |
| GitHub 仓库 | github.com/deepseek-ai/deepseek-harness |
| 官方文档 · 快速入门 | deepseek-harness.github.io |
| npm 包 | @deepseek-ai/dsh（npx @deepseek-ai/dsh web 一键启动） |
| 插件社区 | GitHub topics: dsh-plugin |
| 社区支持 | GitHub Discussions |