DeepSeek Harness 教程：从入门到插件开发
2026-08-16 13:48:06阅读 8
DeepSeek Harness（dsh）是 DeepSeek AI 开发的开源 agent 框架，采用一切皆插件的架构。本教程带你从零开始：安装、配置、理解核心概念，直到开发自己的插件。建议新手按顺序阅读第 1–3 章，进阶读者可直接跳转对应章节。
第 1 章 快速开始
- 1.1 什么是 DSH — 定位、核心特性、发布背景与关注渠道
- 1.2 环境要求 — Node.js、Python 与系统支持
- 1.3 安装与首次启动 — npx 一条命令启动 Web UI
- 1.4 第一个任务 — 配置密钥→选工作区→跑通会话
- 1.5 Python SDK — 程序化调用快速上手
第 2 章 安装与配置
- 2.1 安装详解 — $DSH_HOME 目录结构与升级卸载
- 2.2 Profile 是什么？ — 核心组织单元一篇看懂
- 2.3 配置层与 patch — 叠加规则详解
- 2.4 模型配置 — provider 与 API 凭据管理
- 2.5 Agent Preset — 内置预设与自定义切换
第 3 章 核心概念
- 3.1 Agent 循环 — 会话、轮次与步骤
- 3.2 会话与记忆 — 持久化与会话恢复
- 3.3 系统提示词 — Persona 与变量机制
- 3.4 AGENTS.md — 项目指令文件怎么写
- 3.5 工具清单 — 内置工具与执行流水线
- 3.6 Skill 技能 — SKILL.md 格式与使用
第 4 章 进阶能力
- 4.1 子代理 Subagent — 委派任务给子 Agent
- 4.2 工作流 Workflow — 脚本编排与扇出
- 4.3 目标 Goal — 持久化与自动续行
- 4.4 MCP 集成 — stdio 与 HTTP 配置
- 4.5 沙箱与安全 — 三种权限模式
第 5 章 扩展开发（一切皆插件）
- 5.1 插件机制与 Cordis — 组合框架入门
- 5.2 编写 Skill — 自定义技能教程
- 5.3 插件开发 — 从零编写第一个插件
- 5.4 创建 Agent Preset — 自定义预设教程
- 5.5 发布插件 — npm 生态与发布流程
第 6 章 参考
- 6.1 CLI 命令参考 — dsh 常用命令速查
- 6.2 配置参考 — settings.yaml 字段详解
- 6.3 官方文档地图 — 文档站与仓库全貌
- 6.4 术语表 — 核心概念速查
第 7 章 帮助与排错
- 7.1 常见问题 FAQ — 安装/模型/使用/配置
- 7.2 排错指南 — 按症状查修复
- 7.3 资源与社区 — 官方与生态入口
从哪开始 → 1.1 什么是 DeepSeek Harness
