DSH 从零到一

深色模式

参考资料 ​

本教程的全部事实来源。撰写时基于 DeepSeek Harness 开发者预览版 0.1.0-rc.6（npm 包）与仓库 master 分支。

官方资源 ​

资源链接用途
官方网站deepseek.com/harness产品介绍与"一切皆插件"理念
GitHub 仓库deepseek-ai/deepseek-harness源码、examples、docs
官方文档站deepseek-harness.github.io用户指南与快速开始
架构文档docs/architecture.md本教程原理篇的主要蓝本
Cordis 入门docs/cordis-primer.md五核心概念
Cordis 教程docs/cordis-tutorial/官方渐进式教程 01–07
Agent 生命周期docs/agent-lifecycle.mdturn/step 时序图
扩展 cookbookdocs/cookbook/加工具/适配器/包/聊天节点
配置目录docs/config-catalog.md每个插件可配字段（生成）
Cordis APIdocs/cordis-api/ctx/事件/服务 API（生成）
示例examples/headless-agent、web-schedule 等

Cordis 及其设计论文 ​

资源链接
Cordis 仓库cordiverse/cordis
设计论文A Programming Paradigm for Spatiotemporal Composability

npm 包（教程锁定的版本） ​

json
{
  "@deepseek-ai/dsh": "0.1.0-rc.6",
  "@deepseek-ai/dsh-llm": "0.1.0-rc.6",
  "@deepseek-ai/dsh-tools": "0.1.0-rc.6",
  "@deepseek-ai/cordis": "4.0.1"
}

教程正文引用的源码锚点 ​

主题位置
Context 代理与派生vendor/cordis/src/context.ts
五种分发模式实现vendor/cordis/src/events.ts
effect 与 fiber 状态机vendor/cordis/src/fiber.ts
服务解析 provide/getvendor/cordis/src/reflect.ts
会话词汇表packages/core/session/src/types.ts
会话不变量packages/core/session/src/invariant.ts
Agent 接口与事件packages/core/agent/src/runtime-types.ts
驱动引擎packages/core/agent-loop/src/agent.ts、tool-calls.ts
LLM 词汇表packages/llm/llm/src/types.ts
组装器packages/llm/llm/src/assembler.ts
DeepSeek 适配器packages/llm/llm-deepseek/src/adapter.ts、translate.ts
工具注册表与管线packages/core/tools/src/index.ts

版本与时效性声明 ​

DeepSeek Harness 处于开发者预览阶段，迭代迅速，未来存在破坏兼容性变更。本教程：

  • 所有 Demo 均使用锁定版本（见上）并实际运行验证；
  • 原理与架构描述以仓库 master 分支的 docs/architecture.md 为准；
  • 若你使用的版本更新，API 细节可能变化，但架构思想（一切皆插件、接缝、事件瀑布、追加式日志）是稳定的——遇到差异时优先对照官方文档最新版。

本教程的工程 ​

  • 教程站点：本仓库 docs/（VitePress + mermaid）
  • 渐进式 Demo：demos/
  • 教学版项目：final-project/

基于 DeepSeek Harness（开发者预览版 0.1.0-rc.6）与 Cordis 撰写

教学用途 · 遵循 MIT 协议精神 · 一切皆插件