Agent 实战教程Prism-Shadow/deepseek-harness-book

DeepSeek Harness 实战指南
📘 《从零开始玩转 DeepSeek Harness》
从安装和第一次任务开始，带你学会让 DeepSeek Harness（简称 dsh）调用工具、读写文件，并把它扩展成自己的 Agent Harness。

下载最新版 PDF
｜
在线阅读

📖 这本书写什么

DeepSeek Harness（简称 dsh）是一套由插件组装而成的 Agent Harness，用来组织模型、上下文、工具和任务运行过程。本书从安装和第一次任务讲起，通过调研、办公、内容创作、市场投研和代码审查等真实案例，带你逐步学会使用 dsh、扩展 dsh，并理解它的工作原理。关键步骤配有实际运行截图和示例文件，可以跟着正文操作。

🎯 你将学会什么

- 🚀 快速上手： 安装 dsh，接入模型，读懂任务结果和执行轨迹。
- 🔍 调研办公： 完成资料调研和市场投研，处理 Excel、Word、PPT、PDF 等常见文件。
- 🎨 内容创作： 生成海报、短剧分镜、求职材料和概念图。
- 🤝 多人协作： 接入飞书，并使用 AgentTeams 组织多个 Agent 完成代码审查。
- 🧩 扩展能力： 编写 Skill、接入 MCP，并安装或开发插件。
- ⚙️ 理解原理： 掌握 Agent Harness、工具调用、上下文管理和 Cordis 插件系统。

🖼️ 书中案例

| 短剧画面 | 活动海报 | 自进化概念图 |
| --- | --- | --- |
| dsh 生成短剧关键帧 | dsh 生成社区读书会海报 | dsh 复用演化后的 Skill 生成概念图 |

📚 内容导航

| 章节 | 主要内容 | 配套 Demo |
| --- | --- | --- |
| 🚀 第一部分　玩转 dsh |  |  |
| 第 1 章 让 Agent“活”起来 | 认识 Agent、Harness、dsh 与 Alive Harness。 |  |
| 第 2 章 初识 dsh | 安装 dsh，接入模型，完成第一次任务。 |  |
| 第 3 章 定制自己的 dsh | 创建 AI 助手，用插件修改并保存主题。 |  |
| 第 4 章 让 dsh 完成一次调研 | 拆分调研任务，核验材料并生成报告。 | Demo |
| 第 5 章 用 dsh 完成日常办公 | 处理 Excel、Word、PPT 和 PDF。 | Demo |
| 第 6 章 让 dsh 成为飞书里的数字秘书 | 连接飞书，处理文档、任务、日程和审批。 | Demo |
| 第 7 章 让 dsh 设计活动海报 | 用 Design 插件生成并调整活动海报。 | Demo |
| 第 8 章 让 dsh 制作短剧 | 编写剧本，生成分镜并制作短剧。 | Demo |
| 第 9 章 让 dsh 帮你找工作 | 分析岗位，优化简历并进行模拟面试。 | Demo |
| 第 10 章 用 dsh 构建市场投研助手 | 定义信号，回测策略并生成市场报告。 | Demo |
| 第 11 章 用 dsh 和 AgentTeams 组建 OPC 代码审查团队 | 用 AgentTeams 并行审查仓库更新。 | Demo |
| 🧩 第二部分　扩展 dsh |  |  |
| 第 12 章 扩展 dsh 的能力 | 使用 Skill、MCP 和插件扩展 dsh。 | Demo |
| 第 13 章 让 dsh 通过自进化画出概念图 | 通过多轮评分改进并复用绘画 Skill。 | Demo |
| ⚙️ 第三部分　拆解 dsh |  |  |
| 第 14 章 Harness 的工作原理 | 理解消息、会话、工具和上下文管理。 |  |
| 第 15 章 dsh 的核心：Cordis | 从问候插件逐步练习生命周期、服务、事件、配置和工具调用。 | Demo |

👥 适合谁，怎么读

如果你第一次接触 dsh，建议从第 1 章开始顺序阅读。第 1 章先解释 Agent、Harness 和 dsh 的关系，第 2 章再带你完成安装、模型接入与第一次任务。后面的案例都默认你已经知道这些基础操作。

如果你已经能正常使用 dsh，可以直接挑第一部分的实战案例。想做办公自动化，可以读第 5 章和第 6 章；想看多 Agent 调研和审查，可以读第 4 章和第 11 章；想做求职、投研或内容生产，可以读第 7 章到第 10 章。

如果你想把 dsh 改成更适合自己的工具，先读第 12 章。它会从 Skill 和 MCP 讲到插件开发。想理解内部机制，再读第 14 章和第 15 章。

🛠️ 本地构建

构建网站

在仓库根目录运行：

python3 -m pip install -r requirements-site.txt
python3 scripts/prepare_site.py
mkdocs serve

构建 PDF

运行：

./scripts/build_typst_pdf.sh

脚本会先检查目录、章节标题和图片引用，再使用 typst/main.typ 排版全书，并在 output/pdf/ 中生成 PDF。

🔗 相关链接

- 下载最新版 PDF
- 本书在线阅读
- DeepSeek Harness 官方介绍
- DeepSeek Harness 官方源码