【agent应用】DeepSeek Harness (dsh)介绍及安装部署使用指南

DeepSeek Harness (dsh) 是一个为构建、运行和调试 AI 智能体Agent而设计的开源框架。它的核心理念是“一切皆插件”旨在解决传统 Agent 框架“黑盒”且难以定制的问题。 核心架构一切皆插件传统 Agent 框架通常有一个固定的“核心”你只能在外部添加工具无法修改核心本身。而 DeepSeek Harness 的架构完全不同它的“核心”只是一个空壳所有能力都是可以自由替换和重组的插件。1. ️ Cordis 内核一个“什么都不干”的底层框架Harness 的底层是一个名为Cordis的插件框架。它就像一个精密的“接线板”和“调度中心”只负责三件事加载与卸载插件。管理插件之间的依赖关系。提供服务与事件机制让插件之间可以相互协作。Cordis 本身不承载任何 AI 能力从而保证了系统的极度灵活与纯净。2. 插件提供能力所有模块都可插拔在 Cordis 内核之上Harness 的所有功能都以插件形式存在。 DeepSeek Harness 插件化架构⚙️ Cordis 内核仅负责加载、卸载与依赖管理 模型适配器 工具注册表 会话与存储 沙箱与权限 Agent 循环 调度与任务️ 用户界面Web / TUI 更多插件...3. ⚙️ 配置层自由组合像搭乐高一样拼装 Agent这是“一切皆插件”给开发者带来的最大便利你无需修改 Harness 的任何一行源码仅仅通过修改配置文件就可以选择、替换或扩展任何一个插件。你可以像搭乐高积木一样自由组合出符合自己需求的 Agent。4. 理论基石Cordis 的“时空可组合性”这套灵活的架构并非凭空而来它有坚实的理论基础——Cordis 论文提出的“时空可组合性”编程范式时间可组合性 (可逆效应)当一个插件被卸载时系统能完整地回滚它产生的所有副作用就像它从未运行过一样。这为实现热插拔和热替换 (HMR)提供了安全保障。空间可组合性 (反应式余效应)当系统上下文发生变化时能主动通知所有相关的组件。这让插件之间可以基于事件进行响应和协作。 运行有迹可循告别 Agent “黑盒”Agent 的思考过程往往难以追踪而 DeepSeek Harness 通过其会话日志系统解决了这个问题。1. 仅追加的会话日志系统会以“仅追加”的方式记录下一次运行中模型“看到”和“做过”的一切输入系统提示词 (System Prompts)。思考模型的思维链 (Chain of Thought)。行动每一次工具调用及其结果。调度子 Agent 的调度情况。上下文每一次上下文注入的内容。2. Trajectory 视图这些记录会形成一个完整的事件流你可以在 Web UI 的Trajectory 视图中清晰地按来源查看这些信息。更重要的是会话恢复、分叉、检索与回放等功能都基于这同一份数据确保了 Agent 行为的完全可审计、可复现。运行过程记录Agent 运行系统提示词思维链工具调用与结果子 Agent 调度上下文注入 仅追加的会话日志Trajectory 视图会话恢复执行分叉过程回放 四种运行模式应对不同场景DeepSeek Harness 内置了四种运行模式本质上是四种不同的插件组合预设。模式核心特点适用场景标准模式功能完整的编码 Agent包含文件编辑、Shell、文件与网页检索、Skills、计划、子代理等全套工具。日常的复杂编程与自动化任务。PTC 模式具备标准模式的全部能力并允许模型生成一个TypeScript 程序来组合多步工具调用。需要模型进行复杂规划和逻辑编排的任务。极简模式仅提供持久 bash与str_replace_editor两个核心工具。最小化环境下的模型基准测试。创造模式用于创建自定义 Agent 预设。具备标准模式能力并提供运行时检查、插件实验和创作指导。高级开发者探索和构建自己的专属模式。 快速开始Ubuntu24.04上安装了下1. 快速体验 (通过 npx)这是最快捷的方式适合初步体验。在已安装 Node.js 的环境中直接运行以下命令即可启动 Web UInpx deepseek-ai/dsh web该命令会启动 Web UI默认访问地址为http://127.0.0.1:3080。如下图所示注如果下载时网络超时可以做如下配置。npmconfigsetregistry https://registry.npmmirror.com2. 源码安装 (推荐开发者)如果你想进行深度开发或阅读源码推荐从源码安装gitclone https://github.com/deepseek-ai/deepseek-harness.gitcddeepseek-harnesspnpminstallpnpmrun buildpnpmdsh web 总结DeepSeek Harness 不仅仅是一个工具更是一种构建 Agent 的新范式。它将控制权完全交还给开发者通过“一切皆插件”的架构让你能够精确掌控Agent 的每一个环节并清晰地洞察其运行的每一步。对开发者它提供了一个极致灵活、可定制的“工坊”。对社区它开创了一个真正由社区驱动、共同演进的生态系统。