跳至内容

DeepSeek Harness渐进式学习站

从 Cordis 基础到二次开发实战,24 篇文档带你掌握插件化 Agent 框架

学习路径总览

如何使用本站

  1. 按顺序学习:从 00 · 项目总览 开始,每篇文档标注了前置阅读与下一步。
  2. 查阅式学习:通过左侧侧边栏或顶部搜索直接定位主题。
  3. 动手实践:每篇文档末尾有实战练习,建议在主仓 checkout 上操作。
  4. 源码对照:文档中所有代码示例标注了源码位置 file_path:line,便于跳转查阅。

项目背景

DeepSeek Harness(dsh)是 DeepSeek AI 开源的插件化 Agent 框架,基于 vendored Cordis 构建,核心理念是"一切皆插件"——包括模型适配器、工具注册表、会话日志、Agent 循环本身都可从配置替换。

  • 主仓:github.com/deepseek-ai/deepseek-harness
  • 技术栈:TypeScript(ESM)、Node.js 22.19+/24+、pnpm workspace、Cordis 插件框架
  • 规模:54 个包组、200+ 个 npm 包、事件溯源架构、Host/Client 分离、Typert 类型图

本学习站独立于主仓,不修改主仓任何文件。文档内容基于源码分析整理,仅供学习交流。

基于 DeepSeek Harness 源码整理的渐进式学习文档