DeepSeek Harness

项目简介

DeepSeek Harness 是 DeepSeek AI 开发的开源智能体框架（agent harness），基于 Cordis 插件系统构建，源代码随开发者预览一同发布。在 DeepSeek Harness 中，每一项智能体能力都以插件形式实现，可以替换或重新组合；每一次运行都会记录在只追加的会话日志中，便于追溯。

核心功能

• 一切皆插件：模型、工具、技能、会话、沙箱、存储、循环、调度和界面均由 Cordis 插件提供，可在配置中选择、替换或扩展，无需改动 DeepSeek Harness 源码。
• Cordis 内核负责插件的挂载、卸载与依赖管理，插件之间通过 Cordis 服务与事件协同工作。
• 每次运行都可追溯：模型看到的一切都会记录在只追加的会话日志中，包括系统提示、推理、工具调用与结果、子智能体调度以及每一次上下文注入。
• 轨迹视图可按来源查看这些记录，恢复、分叉、搜索和重放都基于同一事件流。
• 多种运行模式：标准模式包含完整工具集；代码模式通过 Code Mode SDK 暴露工具，让模型在一个 TypeScript 程序中组合多步操作；最小模式只保留 shell 与文件编辑器两个工具；创造者模式支持检查当前运行时、在内存中测试 Cordis 插件并组合成新模式。
• 提供 Web 界面与命令行运行时，可通过 npx @deepseek-ai/dsh web 快速启动。

适用场景

• 构建和定制智能体框架，用于文件编辑、shell 命令、文件与网络搜索、技能、规划、目标、子智能体和流程等任务。
• 在最小环境中以两工具编码智能体对模型进行基准测试。
• 在创造者模式中创建自定义智能体预设，并试验 Cordis 插件。
• 通过会话日志检查、恢复、分叉、搜索和重放智能体运行过程。

快速开始

• 安装 Node.js，然后运行 npx @deepseek-ai/dsh web 启动 Web 界面，默认在本地 127.0.0.1:3080 打开。
• 如需从源码运行，先克隆仓库，进入目录后依次执行 pnpm install、pnpm run build，再执行 pnpm dsh web；pnpm run build 准备构建产物，pnpm dsh web 直接使用这些产物而不再重新构建。

部署与要求

• 使用 npm 启动方式需要安装 Node.js。
• 从源码运行需要 pnpm、仓库检出代码，以及由 pnpm run build 准备好的构建产物，之后才能执行 pnpm dsh web。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。