DeepSeek Harness 第一个任务：配置密钥→选工作区→跑通会话

本节对应官方文档站「使用 Web UI」页面（guide/quickstart），按官方流程分四步。

前置条件：已按 1.3 安装与首次启动 运行 npx @deepseek-ai/dsh web，服务器已运行。

第 1 步：配置模型

打开 设置 → 模型，在 DeepSeek 卡片中输入 DeepSeek API 密钥并保存。

• 模型路由立即生效，不需要重启服务器

• 密钥是只写的：保存后页面只显示脱敏描述符，明文密钥存储在 $DSH_HOME/.credentials.yaml，settings 只保留凭据引用

• 其他提供方（Anthropic、OpenAI 等）与自定义端点（公司网关、OpenAI 兼容代理）见官方「配置模型」指南 → 2.4 模型与凭据

第 2 步：选择工作区

点击 选择工作区：

1. 添加启动 dsh 时所在的项目目录

2. 选中它

dsh 进程会把调用目录作为默认文件系统位置；但在 Web UI 中选中工作区之前，会话输入框不可用。

第 3 步：运行任务

启动一个会话，发送官方示例提示词：

Summarize this repository and identify its main packages.

Agent 会开始工作：读取仓库文件、执行命令、按需委派子任务、维护执行计划。

第 4 步：理解发生了什么

• Agent 可以读取和编辑工作区文件、运行命令、委派工作并维护计划

• 当某个操作在当前权限策略下需要审批时，Web UI 会先询问你

• 每次会话都会持久化（默认在 $DSH_HOME/sessions），可以恢复继续

继续使用

跑通第一个任务后，按官方文档的路径继续：

• 配置模型（更多提供方与自定义端点）

• 1.5 Python SDK 快速上手

• 6.1 CLI 命令参考（其他 CLI 模式）

• 5.3 编写插件（开发插件）

常见问题速查

更多见 7.1 FAQ。

← 1.3 安装与首次启动 | 1.5 Python SDK 快速上手 →