63 lines
2.1 KiB
Markdown
63 lines
2.1 KiB
Markdown
# 快速开始
|
||
|
||
[English](quickstart.md) | 中文
|
||
|
||
本指南带你在 5 分钟内跑起一个 agent（智能体）。
|
||
|
||
## 环境准备
|
||
|
||
- [Node.js](https://nodejs.org/) ^22.19 或 >= 24
|
||
- 通过 Corepack 使用 [pnpm](https://pnpm.io/) 11
|
||
- [DeepSeek Platform](https://platform.deepseek.com/) API 密钥
|
||
|
||
```sh
|
||
node -v
|
||
corepack enable
|
||
pnpm -v
|
||
```
|
||
|
||
## 第一步：安装并配置 API 密钥
|
||
|
||
```sh
|
||
git clone https://github.com/deepseek-ai/deepseek-harness.git
|
||
cd deepseek-harness
|
||
pnpm install
|
||
```
|
||
|
||
在仓库根目录创建已被 Git 忽略的 `.env`：
|
||
|
||
```sh
|
||
DEEPSEEK_API_KEY=sk-your-key-here
|
||
```
|
||
|
||
## 第二步：运行一个 Headless 任务
|
||
|
||
运行一个非交互式任务并打印最终回答：
|
||
|
||
```sh
|
||
pnpm dsh --profile headless "summarize the architecture of this workspace"
|
||
```
|
||
|
||
`dsh --profile headless` 创建并持久化一个新会话，打印最终助手回答，然后退出。它不会启动 Web 服务器或监听端口；成功运行时 stderr 为空。
|
||
|
||
## 第三步：使用 Web UI
|
||
|
||
启动浏览器界面：
|
||
|
||
```sh
|
||
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`](../../../packages/bundle/base/cordis.patch.yml) 和 [`dsh-headless`](../../../packages/bundle/headless/cordis.patch.yml) 在空根之上组合，随后 runner 直接驱动 core Agent 与 Session 服务。`dsh web` 则由 `dsh-base` 与 [`dsh-web-app`](../../../packages/bundle/web-app/cordis.patch.yml) 组合，后者拥有 Host、HTTP 与浏览器层。二者都从 `dsh-base` 读取同一个默认 DeepSeek 模型路由。
|
||
|
||
## 下一步
|
||
|
||
- [Python SDK 快速上手](./python-sdk.md) — 安装 SDK，并在不使用 Web UI 的情况下运行完整 Cordis 配置
|
||
- [配置模型](./providers.md) — 接入 DeepSeek 之外的提供方与自定义网关
|
||
- [配置文件](./config.md) — 了解 `cordis.yml` 的格式
|
||
- [开发插件](../develop/basic/) — 编写自己的工具或后端
|