DeepSeek Harness 学习手册：从入门到插件开发

​

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 资源与社区 — 官方与生态入口​