DeepSeek Harness · dsh
由浅入深学习 DeepSeek Harness
这是一份基于本仓库源码与官方文档整理的中文学习手册，带你从论文理念到源码细节，再到动手扩展，完整理解 DSH 这个"一切皆插件"的 Agent 框架。
关于本手册的依据
DSH 建立在 Cordis 之上，论文为 A Programming Paradigm for Spatiotemporal Composability。本仓库以两种形态"同步发布"了论文的实质：① vendor/cordis 等 vendored 参考实现；② 仓库自有文档 docs/cordis-primer.md、docs/cordis-tutorial/、docs/cordis-api/。本手册以仓库内这些文档与源码为权威依据，论文摘要仅作形式化背景。
DSH 是什么
DeepSeek Harness（dsh）是 DeepSeek 开源的 Agent 运行框架（agent harness）。它的核心特征是一切皆插件：模型适配器、工具注册表、会话日志、甚至 Agent 循环本身都是可从配置替换的插件。它由 Cordis 驱动——一个把"效果（effect）"和"协效果（coeffect）"提升为运行时机制、并把二者统一进单一 Context 类型的插件元框架。
一句话定位：可审计、可热重载、可逐层打补丁的 Agent 运行时，其每个能力都是一个可替换的插件。
学习路线（四层，由浅入深）
第一层 · 理念
论文与 Cordis 理念
时空可组合性、可逆效果、反应式协效果、统一上下文、组件与动态组合演算。
第二层 · 架构
DSH 整体架构
分层组合、Agent 循环（turn/step/round）、会话日志事件溯源、能力接缝三角色。
第三层 · 源码
核心包源码深入
core/session、tools、agent-loop、llm、scope 逐包拆解，带真实类型与源码定位。
第四层 · 实践
动手扩展
Cordis 教程精要、加插件/工具/LLM 适配器、仓库代码导航与运行命令。
完整目录
如何使用
左侧侧边栏按顺序阅读，每节底部有"上一节 / 下一节"。读时有任何疑问直接在对话里问我——我会据此补充或展开。所有代码引用都标注了仓库内真实路径，方便你对照源码。
前置知识
- 了解 LLM/Agent 的基本概念（模型、工具调用、对话上下文）。
- 能读懂 TypeScript 语法（
interface、type、声明合并）——不必精通，每处都会解释。 - 了解 Node.js / npm 包的基本概念。