deepseek-harness-tutorial (ht426/deepseek-harness-tutorial)
Searching Database…
这是什么?
一份系统组织的 DeepSeek Harness(dsh)中文教程,依据官方源码编写、按教学顺序编排,从“dsh 是什么”一路讲到编写你自己的 dsh 插件。
这是官方 dsh 文档,还是独立教程?
它是一份由第三方独立编写的教程,充当教学路线图;官方 deepseek-ai/deepseek-harness 仓库仍是确切类型和 API 的权威参考。
我该怎么使用这份教程?
如果你不熟悉代理(agent)概念,先从零基础导读开始,然后按顺序学完 14 章——每一章对应 dsh 源码中一个具体的包/模块,并在前一章的基础上展开。
开始之前我需要了解什么?
你应该已经掌握现代 JavaScript/TypeScript,并安装了 Node.js(^22.19 或 >=24)和 pnpm;对“LLM 调用 + 工具调用”有基本了解会有帮助但并非必需,因为零基础导读会补上这块。
跟着这份教程学,dsh 的 API 稳定吗?
不稳定——dsh 仍处于开发者预览阶段,其接口可能很快发生破坏性变更;教程会跟随当前官方源码的实际形态。
这份教程是写给谁的?
想理解 dsh 源码和模块边界的开发者、要添加工具/模型适配器/Web UI 节点的插件作者,以及在 dsh 之上组装自己代理应用(CLI / Web / ACP / JSON-RPC)的集成者。
dsh(DeepSeek Harness)的核心是什么?
dsh 是一个秉持“一切皆插件”原则构建的代理框架,搭建在 Cordis 插件框架之上,包含核心代理循环、LLM 适配器、执行能力(shell、沙箱)、工具(fs、web、mcp)、编排(子代理、工作流)和一个持久化层。
教程的章节是怎么安排的?
一份零基础导读加 14 章正文,涵盖整体架构、环境搭建、Cordis 框架、核心代理循环、LLM 集成、执行/工具能力、编排、上下文与人机协作、持久化、启动/打包、外部接口以及如何扩展 dsh,最后附术语表。
Cordis 是什么?为什么第 3 章如此重要?
Cordis 是 dsh 所依赖的底层插件框架;第 3 章讲解它的插件、Context、服务、事件和副作用,README 称其为后续所有章节的基础。
这里没讲到的确切 API 细节去哪里查?
直接查阅官方 deepseek-ai/deepseek-harness 仓库,因为这份教程是学习路线图,而不是权威的 API 参考。
What are similar projects?
oh-dsh, learn-harness-engineering, dsh-handbook, dsh_desktop, DSH-Plugins-Marketplace, Minke, dsh-lowtide, dsh-routing-suite
Which topics is it in?
cordis, study-guide, chinese-language, dsh, agent-framework, harness, plugin-system, dsh-plugin, deepseek-harness, deepseek, beginner-friendly, guide