跳至内容
DSH 文档

DSH 文档

DeepSeek Harness(DSH)是 DeepSeek AI 开源的 agent harness。这里围绕运行、插件扩展和故障定位组织文档:先找到影响当前问题的配置与机制,再按页面标明的版本核对接口。

第一次运行 DSH,从安装与运行开始;想学习 Agent 的实现原理,可选从零实现 Agent课程。该课程固定在历史教学版本 0.1.0-rc.6,与当前安装路径分开使用。

从这里开始

想连续动手,进入任务型教程:项目记忆、检查插件与 Python 应用共用一个固定示例;精确机制查询仍从下方分类进入。

按问题查文档

能打开界面,但任务还没有成功

安装与运行先区分 Web UI、CLI 和桌面版的环境与 Profile。服务已启动只能说明界面入口可用;继续用配置模型核对模型设置,再按使用 Web UI完成一个只读任务。

如果失败,先分清是页面无法访问、模型请求失败,还是工具调用失败,再到常见问题 FAQ查对应症状。把三种失败都归为“安装问题”,容易反复重装却没有检查真正失败的环节。

包已经安装,插件却没有出现

Profile 与 Bundle说明配置如何组合,安装插件区分包管理与插件激活。先核安装目标 Profile、包是否声明 Bundle,以及重启后是否生效;不要仅凭包出现在依赖列表里就认定功能可用。

自己开发扩展时,从插件开发进入服务、事件与工具示例。已经加载但工具不可用,再查工具流水线的注册和执行环节;选现成扩展则从插件分类或资源导航进入。

读懂术语,还需要判断谁能看到工具

术语表的应用示例用父子 Agent、同名工具和轮次计数解释几个容易混淆的边界。知道父子关系,不等于知道工具的可见性;知道一个 turn 完成,也不等于知道调用了几次模型。

初次接触架构,可先读什么是 DSH、一切皆插件和Cordis 五个概念,用关键概念速览查名词。继续追踪一次任务时,依次对照插件树、LLM 接缝、Agent 循环与会话日志;技术专题提供按问题组织的阅读链。

输出一致,为什么仍然是一次失败

文件系统工具事故复盘展示了一个具体陷阱:UNKNOWN_TOOL 被写入预期快照后,重放一致也会让测试通过。页面区分历史根因与后续版本行为,给出配置、工具注册、结构化结果和实际效果的检查顺序。

其中的 Node.js 小实验只演示对象真值与结果断言,不代替完整 Loader 的运行。若想动手理解插件生命周期,可继续做第一个插件与可逆副作用;更多历史案例见事故复盘,使用经验和作品可在社区交流。

版本说明

DeepSeek Harness 目前处于公开预览阶段,后续版本仍可能包含不兼容变更。部分源码解析对应 0.2.2-rc.1,从零实现 Agent 课程对应 0.1.0-rc.6;页面会分别标明适用版本。使用与版本有关的安装命令、API 或安全设置时,请同时查看官方文档与 Releases。

官方来源

需要深入查看版本、命令、API 或安全边界时,可以从以下源码与文档继续阅读:

中文教程、版本解读与插件发现可继续使用本站和 DSH 插件导航。

固定版本参考