README.md

September 2, 2026 · View on GitHub

DeepSeek Harness 实战指南

📘 《从零开始玩转 DeepSeek Harness》

从安装和第一次任务开始,带你学会让 DeepSeek Harness(简称 dsh)调用工具、读写文件,并把它扩展成自己的 Agent Harness。

在线阅读:dshbook.penguin.ooo Language: Chinese GitHub Stars
下载最新版 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理解 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。

🔗 相关链接