快速开始

English | 中文

本指南带你在 5 分钟内跑起一个 agent（智能体）。

环境准备

Node.js ^22.19 或 >= 24
通过 Corepack 使用 pnpm 11
DeepSeek Platform API 密钥

node -v
corepack enable
pnpm -v

第一步：安装并配置 API 密钥

git clone https://github.com/deepseek-ai/deepseek-harness-sdk.git
cd deepseek-harness
pnpm install

在仓库根目录创建已被 Git 忽略的 .env：

DEEPSEEK_API_KEY=sk-your-key-here

第二步：运行一个 Headless 任务

运行一个非交互式任务并打印最终回答：

pnpm dsh --profile headless "summarize the architecture of this workspace"

dsh --profile headless 创建并持久化一个新会话，打印最终助手回答，然后退出。它不会启动 Web 服务器或监听端口；成功运行时 stderr 为空。

第三步：使用 Web UI

启动浏览器界面：

pnpm dsh web

打开 http://127.0.0.1:3080。agent 可以读写文件、运行命令、分配子任务和跟踪计划。可以尝试：Create hello.js in the current directory, print "Hello from Harness!", and run it。

运行原理

dsh --profile headless 启动 headless profile：dsh-base 和 dsh-headless 在空根之上组合，随后 runner 直接驱动 core Agent 与 Session 服务。dsh web 则由 dsh-base 与 dsh-web-app 组合，后者拥有 Host、HTTP 与浏览器层。二者都从 dsh-base 读取同一个默认 DeepSeek 模型路由。

下一步

Python SDK 快速上手 — 安装 SDK，并在不使用 Web UI 的情况下运行完整 Cordis 配置
配置模型 — 接入 DeepSeek 之外的提供方与自定义网关
配置文件 — 了解 cordis.yml 的格式
开发插件 — 编写自己的工具或后端

2.1 KiB Raw Blame History Unescape Escape