DeepSeek Harness 教程：开篇导读

DeepSeek Harness 教程（开篇导读）

DeepSeek Harness 是深度求索（DeepSeek AI）开源的 Agent Harness（智能体框架），MIT 许可证、TypeScript 编写，核心理念是「一切皆插件」（Everything is a Plugin）：模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等能力全部由插件组合，不改源码即可在配置层定制自己的 Agent。官方公式：Agent = Model + Harness。

教程结构

本教程按「概念 → 安装 → 上手 → 进阶」展开：先理解 Harness 定位，再学四种安装方式与桌面版使用，随后用 Web UI 跑通第一个任务，最后深入模型配置、Python SDK 与插件体系。

适合人群

• 开发者 / 工程师：想要能力边界可控、组件可替换的本地 AI 编码助手，而非黑盒产品。
• AI / ML 从业者：关注 Agent 架构——底层 Cordis 插件系统有论文支撑，PTC 模式支持用 TypeScript 程序编排工具调用。
• 效率工具爱好者：希望通过 Web UI、headless 命令行或 Python SDK 把 Agent 嵌入工作流。
• 研究人员：需要可观测的 Agent——每次运行写入仅追加会话日志，可在 Trajectory 视图回放。
• 注重开源可控的用户：MIT 协议，配置层自由组合，本地配置与插件实现均可检查。

前置要求

无需 AI 研究背景。走桌面版路线不要求命令行；npm / 源码路线需要命令行基础与 Node.js 24.9+；了解 API Key 的概念（知道如何申请 DeepSeek API Key）即可；进阶章节会用到插件与配置文件概念；Git 仅在源码安装时可选需要。操作系统支持 Linux、macOS、Windows，桌面版提供 Windows 64 位与 macOS Apple 芯片安装包。

官方资源

参考来源与说明

本文根据 runoob 公开教程的核心信息进行原创整理与改写，原文地址：DeepSeek Harness 教程。具体细节以 DeepSeek Harness 官方文档为准。