首页
0%
dsh

DeepSeek Harness,用大白话讲给你听

它说自己是「万物皆插件」的 AI Agent 框架——每个字都认识,连起来就劝退,对吧? 别慌。这份教程用费曼学习法:生活类比、原创图解、讲完还要考你, 保证让小白也能笑着看懂。没听过 dsh?没关系, 我们用你熟悉的 Claude Code / Codex 当尺子,从头量到尾。

✅ 零基础可读 😂 有梗 · 小白友好 🧱 万物皆插件 🚗 与 Claude Code / Codex 对比 📖 每章配原创图解 ❓ 每章有费曼自查 🌐 开源教程
dsh 全景架构图:你、驾驶舱、真实世界与会话日志的关系
图 00-1 dsh 全景架构:你 ↔ 驾驶舱(循环/模型/工具流水线/作用域与委派)↔ 真实世界,每一步都被会话日志记账 —— 而这一切都是可替换的插件。
📖
选一个概念
从 dsh 的宝库里挑一个
🗣️
用大白话讲
像给 8 岁小孩讲,禁说黑话
✍️
自己复述
合上书讲一遍,卡壳=没懂
🔍
查漏补缺
回炉重看,顺便对照源码
dsh 学习路线图:费曼四步 + 四幕十二章旅程
图 00-2 学习路线图:先学会「费曼四步」,再顺着四幕十二章走一遍(约 40 分钟),每章结尾记得先自己讲一遍再看答案。
第 01 章

一分钟看懂 dsh

模型负责「想」,dsh 负责「动手 + 记录」。一张全景图建立直觉。

第 02 章

万物皆插件(乐高积木)

没有特权内核:模型、工具、日志、循环本身都是积木,可替换可叠加。

第 03 章

和 Claude Code / Codex 比一比

它们是「整车」,dsh 是「造车平台」—— 还能把前两者雇成员工。

第 04 章

Cordis 五件事

插件、上下文、注入、类型化事件、可逆副作用 —— 底层框架的五个核心概念。

第 05 章

一次对话的旅程(轮次)

从你发一句话,到模型调用工具,全程走一遍「轮次与步骤」。

第 06 章

会话日志:唯一真源

流水账 vs 余额:模型历史不单独存储,随时从日志重算。

第 07 章

能力缝:可替换的能力

接口 / 实现 / 使用方三件套:换一个实现,整个产品跟着变。

第 08 章

工具与执行流水线

工具是模型的手;每次调用都过「安检通道」:审批、守卫、溢出处理。

第 09 章

作用域:独立办公室

每个 agent 有自己的房间,还能「遮住」公共设施,互不干扰。

第 10 章

委派与扩展

子代理、后台任务、工作流脚本、技能 SOP —— 一个人干不完就招人。

第 11 章

动手:跑起来 + 写插件

装 Node、起 Web UI、写第一个组合包,亲手摸一遍整条链路。

第 12 章

术语表与下一步

官方术语速查、源码地图、官方文档入口,以及进阶路线。

ℹ️这份教程是怎么来的

本教程基于 deepseek-harness 仓库(DeepSeek AI 开源的 Agent 框架)的最新源码与官方文档撰写,核对到 0.1.0-rc.5 版本。 所有图解均为原创 SVG,纯本地资源,无任何外部依赖。

阅读建议:顺着 01 → 11 走一遍(约 40 分钟,中间允许笑出声);每一章结尾的「费曼自查」请先自己讲一遍再看答案—— 那才是费曼学习法的关键一步(也是检验你有没有真懂的时刻)。 如果你觉得哪里讲得不够明白,或者发现了错误,欢迎提 Issue / PR——也欢迎来补充冷笑话。