1.7 KiB
1.7 KiB
快速开始
English | 中文
本指南带你在 5 分钟内跑起一个 Agent。
环境准备
- Node.js ^22.19 或 >= 24
- 通过 Corepack 使用 pnpm 11
- DeepSeek Platform API key
node -v
corepack enable
pnpm -v
第一步：安装并配置 API key
git clone https://github.com/deepseek-harness/deepseek-harness.git
cd deepseek-harness
pnpm install
在仓库根目录创建已被 Git 忽略的 .env：
DEEPSEEK_API_KEY=sk-your-key-here
第二步：运行一个 Headless 任务
运行一个非交互式任务并打印最终回答：
pnpm run demo:headless "summarize the architecture of this workspace"
Headless 运行一个完整的模型/工具轮次，持久化会话，打印结果后退出。需要规范事件流时可使用 --output-format stream-json。
第三步：使用 TUI
启动交互式 coding agent：
pnpm run demo:tui
这个全屏 Agent 可以读写文件、运行命令、分配子任务和跟踪计划。可以尝试：Create hello.js in the current directory, print "Hello from Harness!", and run it。
回头看
headless-agent 使用 @deepseek-ai/dsh-cli-demo app；交互式 dsh surface 则以 apps/cli/config/base.cordis.yml 叠加 tui.cordis.yml overlay 组合而成，不使用 app 组合包。二者加载同一个 providerless agent spine，并通过各自的 cordis.yml 为对应 surface 选择 DeepSeek 模型和能力插件。