diguike/book-deepseek-harness

README 摘要

一切皆插件 DeepSeek Harness 源码精读、Mini 实现与插件开发实战 这本书讲 DeepSeek 官方开源的 agent harness dsh 本身是怎么设计的——不是怎么用它写代码，是它凭什么能让主循环、模型适配器、会话日志都变成配置里的一行。 dsh --profile web --dump-config 会打印出你这台机器上将要启动的整棵插件树。490 行 YAML、129 个插件行。模型适配器是一行，会话日志是一行，主循环 agent-loop 也是一行。 任意一行都能被你自己的一行 YAML 顶掉。 为什么读这本书 如果你用过 Claude Code 或 Codex，想给它加点东西，最后发现只能挂一个 hook——那你已经碰到这本书要解决的问题了。你能扩展的，是人家预留给你的那几个洞。 dsh 给了另一个答案：没有内核，所以没有洞，因为没有墙。 这本书做四件官方文档不做的事： 1. 把设计取舍和代价讲透 。「没有内核」放弃了什么，「日志是唯一真相源」谁在付账 2. 横向对比与选型判断 。dsh 和 Claude Code / Codex / OpenClaw 的分野，以及为什么 LangGraph 压根不在同一个抽象层 3. 源码走读 + 亲手重建 。用 TypeScript 写一个能跑的迷你实现，约 3500 行 4. 把工程方法提炼成能搬走的清单 。dsh 是人和 agent 共同维护 50 万行代码的公开样本 写给谁 - 在公司搭 agent 平台的人 （第一优先）——第 4、13、14、18 章能直接变成设计文档和 PR - 已在用 CC / Codex、想扩展却碰壁的中高级工程师 ——技术栈 TypeScript / Node - 从传统后端转 AI 的工程师 ——第 2 章做概念对齐，附录 D 补 TypeScript 缺口 不适合：想找「用 AI 写代码技巧」的人；想要中文 API 手册的人（官方文档更准）。 怎么读 目的 路线 时间 只做选型 1 → 3 → 4 半天 系统学架构 全书顺读，5–11 章跟着写 mini-dsh — 只要工程方法 1 → 19 → 20 → 21 — 搭内部平台 1、3、4 打底，跳 13、14、18 — 模型 API key 不是必需的，但有更好。 第 1、11、15 章的核心数据来自 DeepSeek 官方端点——端到端事件流、十变量的前缀缓存实验、六轮调用的真实用量轨迹，都带缓存命中数字。没有 key 也能跟着做： examples/mock-llm-server 把本机 claude CLI 包成 OpenAI 兼容端点，两条 patch 接上去。 目录 前言 第一部分 它为什么长这样 - 第 1 章 主循环也只是配置里的一行 - 第 2 章 agent harness 的系…

分类