小塔维护版 持续整理、构建与部署；正文保留上游作者和社区贡献者的原始成果。

小塔 · DeepSeek Harness 实战指南

📘 《从零开始玩转 DeepSeek Harness》· 小塔维护版

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

下载最新版 PDF ｜在线阅读

版本说明：这是由小塔维护、构建并部署的社区版本。书稿正文与案例源自 Prism-Shadow/deepseek-harness-book 及其社区贡献者；本仓库保留完整 Git 历史与上游来源，不代表 DeepSeek 官方立场。

📖 这本书写什么¶

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

🎯 你将学会什么¶

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

🖼️ 书中案例¶

短剧画面	活动海报	自进化概念图

📚 内容导航¶

章节	主要内容	配套 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。

部署到 Cloudflare Pages¶

配置 Cloudflare 凭据后运行：

./scripts/deploy_cloudflare.sh

默认 Pages 项目为 deepseek-harness-book，正式域名为 deepseek-harness.zailing.ai。