基于 DeepSeek Harness 的智能体应用开发实战手册https://guotao0628.github.io/zh-CNhttps://guotao0628.github.io/shutongbuddy/brief/https://guotao0628.github.io/shutongbuddy/brief/DeepSeek Harness（命令行简称 dsh）是 DeepSeek 官方开源的智能体基座，其核心设计哲学只有一句话——万物皆插件：模型适配、工具调用、会话管理，乃至驱动智能体运转的 Agent 循环本身，都是可以……Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/author/https://guotao0628.github.io/shutongbuddy/author/郭涛，资深技术实践者、畅销书作者；李勇永，地图学与地理信息系统博士，长期在高校从事 Python 编程、面向对象程序设计与 GIS 应用教学。Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/preface/https://guotao0628.github.io/shutongbuddy/preface/设想一位刚入学的大学生，面对一门全新的专业课：教材、课堂笔记、历年试卷与错题散落在不同的文件夹里，复习时既不知从何下手，也难以判断自己真正薄弱的知识点在哪里。这恰恰是无数学习者备考时的真实困境。智能体技术的出现，为这一困……Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/part1/ch1/https://guotao0628.github.io/shutongbuddy/part1/ch1/本章目标只有一个：让你在最短时间内把 DeepSeek Harness 跑起来，并完成第一个智能体任务。跑通之后，我们再在第 2 章回过头解释背后发生了什么。Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/part1/ch2/https://guotao0628.github.io/shutongbuddy/part1/ch2/第 1 章你已经把 Harness 跑了起来。这一章回答一个问题：你启动的那个进程，内部到底长什么样？理解这一章，后面的安装、接模型、写插件都会变成"顺理成章"的事。Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/part2/ch3/https://guotao0628.github.io/shutongbuddy/part2/ch3/第 1 章用的是最省事的路径。本章把安装部署这件事讲完整：两种安装方式、五种运行 Profile、命令行语法，以及必须认真对待的安全基线。Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/part2/ch4/https://guotao0628.github.io/shutongbuddy/part2/ch4/Harness 的模型接入层是"万物皆插件"最好的广告牌：添加一个模型提供商，只是注册一个适配器；切换一个模型，不需要重启服务。本章把 DeepSeek V4 Pro/Flash、Kimi（Moonshot AI）以及任……Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/part3/ch5/https://guotao0628.github.io/shutongbuddy/part3/ch5/本章以一个贯穿始终的真实项目学习插件开发：为大学生备考助手 ShuTongBuddy 开发一组 DeepSeek Harness 插件。这个插件包将在第 8 章被 ShuTongBuddy Studio（Web 备考助手……Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/part3/ch6/https://guotao0628.github.io/shutongbuddy/part3/ch6/第 2 章看了架构全景，第 5 章学会了自己动手。本章聚焦一个问题：一个"智能体"在 Harness 里究竟由哪些可替换的部件构成？ 读完你会得到一张"能力地图"——想实现任何智能体行为，先查地图找机制，而不是改循环。Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/part4/ch7/https://guotao0628.github.io/shutongbuddy/part4/ch7/第一个实例不急着写插件——先用 Harness 开箱即用的能力，完成一个真实任务：对大学生的备考资料库做一次"体检"，产出一份结构化报告。你会发现，仅靠内置工具与一个好模型，事情已经能做成八成；剩下两成，再用一个自定义工……Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/part4/ch8/https://guotao0628.github.io/shutongbuddy/part4/ch8/终章实例把前七章攒成一件完整作品：一个 Web 端的大学生备考助手 ShuTongBuddy Studio。前端跑在浏览器里，界面布局参考 Codex 风格；后端用 FastAPI 编排，智能体引擎就是 DeepSeek……Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/epilogue/https://guotao0628.github.io/shutongbuddy/epilogue/如今，智能体技术正以前所未有的速度演进，诸多颇具前景的工程模式既来自开源社区，也源于前沿模型开发者，共同塑造着未来智能体系统的设计范式。本书所依托的 DeepSeek Harness，正是这一浪潮中的一个典型样本。Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/appendix/https://guotao0628.github.io/shutongbuddy/appendix/MISSINGCREDENTIAL → 存 Key 或补环境变量；UNKNOWNMODEL → 选已配置模型或补录；发现模型 401 → 查 Key 或手写模型；网关全拒 → compat.supportsDevelop……Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/glossary/https://guotao0628.github.io/shutongbuddy/glossary/《DeepSeek Harness 应用开发实践》核心术语速查：插件、上下文、会话、Turn/Step、Profile、能力接缝、PTC、压缩、子智能体等。Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/downloads/https://guotao0628.github.io/shutongbuddy/downloads/下载《DeepSeek Harness 应用开发实践》的 PDF、EPUB、Markdown，并查看当前站点版本与更新记录。Tue, 15 Sep 2026 12:21:13 GMThttps://guotao0628.github.io/shutongbuddy/errata/https://guotao0628.github.io/shutongbuddy/errata/《DeepSeek Harness 应用开发实践》在线书勘误提交方式、更新日志与出版进度。Tue, 15 Sep 2026 12:21:13 GMT