03 快速上手：第一个任务#
本章带你走完从打开 Web UI 到完成第一个 Agent 任务的完整流程。
Web UI 界面概览#
在浏览器中打开 http://127.0.0.1:3080 后，你会看到 DeepSeek Harness 的主界面，主要区域包括：
区域 |
位置 |
功能 |
|---|---|---|
侧边栏 |
左侧 |
工作区选择、会话列表、历史记录 |
主对话区 |
中间 |
消息展示、输入框、模式切换 |
设置按钮 |
右上角 |
模型配置、Provider 管理、界面设置 |
实时统计面板 |
会话底部 |
步数、耗时、Token 用量、缓存命中率、成本估算 |
Trajectory 按钮 |
消息右上角 |
查看完整执行轨迹（详见第 7 章） |
新会话页面显示 slogan「探索未至之境（Into the Unknown）」，旁边有「预览版」角标。首次启动可能弹出「内部测试提示」，说明 v0.1 版本仍在快速迭代中。
第一步：选择工作区#
未选择工作区时，输入框为灰色不可用状态，无法输入任何指令。
点击左侧的 Choose workspace（选择工作区）按钮，在弹出的目录选择器中：
找到并选中你希望 Agent 操作的项目目录
点击确认添加
在工作区列表中点击选中该目录（选中后会有高亮标记）
添加工作区后，输入框变为可用状态，此时可以开始与 Agent 对话。
提示：如果你在某个项目目录下执行了
npx @deepseek-ai/dsh web，启动目录会自动出现在工作区列表中，但仍需手动选中才能激活。
第二步：配置模型#
在使用前，需要先配置模型 API Key：
点击右上角的 Settings（设置）按钮
选择 Models（模型）选项卡
在 DeepSeek 卡片中找到 API Key 输入框
粘贴你的 DeepSeek API Key（从 platform.deepseek.com 获取）
点击保存
密钥安全说明#
API Key 采用脱敏存储机制：
保存后，页面上只能看到一个脱敏描述符（如
sk-***xxxx），无法查看完整密钥真实密钥存储在本地
~/.dsh/.credentials.yaml文件中settings.yaml中仅保留一个引用标识，不存储明文密钥配置修改后立即生效，无需重启服务
默认模型选择#
dsh 默认提供两个 DeepSeek 模型选项：
模型 |
定位 |
适用场景 |
|---|---|---|
|
旗舰模型 |
面向 Agent 任务优化，适合复杂编程、多步骤推理、生产环境任务 |
|
快速模型 |
响应更快、成本更低，适合日常任务、快速原型、简单问答 |
两个模型默认均按以下参数配置：
上下文窗口：100 万 Token
单次输出上限：256k Token
推理档位：
high（v4-pro/v4-flash 支持 low/high/max 三档可调）
添加其他模型提供商（可选）#
如果你想使用非 DeepSeek 模型：
点击 Add provider 可以快速添加内置支持的 Anthropic、OpenAI、Bedrock、Azure、Vertex 等厂商
点击 Add a custom provider 可以接入自定义网关或自建服务，填写小写 Provider ID、Base URL、协议、API Key 和至少一个模型即可
使用 Fetch available models 可以自动从兼容 OpenAI API 的端点拉取模型列表
注意：手动添加的模型默认按纯文本处理，如果需要视觉能力（支持图片输入），需要在
~/.dsh/settings.yaml中为对应模型添加input: [text, image]配置。
第三步：运行第一个任务#
配置完成后，我们来跑一个典型的入门任务。在输入框中输入：
总结一下这个仓库，指出它的主要模块。
然后按回车发送。
权限审批弹窗#
在执行过程中，如果 Agent 需要进行敏感操作（如执行 Shell 命令、读写文件等），界面会弹出权限审批对话框，显示：
要执行的具体操作内容
操作参数（如执行的命令、读写的文件路径）
三个选项：
Allow once（仅允许本次）
Allow always for this session（本会话始终允许）
Deny（拒绝）
这是 dsh 的安全机制，确保你对 Agent 的行为有最终控制权。对于可信的工作区，可以选择「Allow always」减少打断；对于不熟悉的操作，建议逐次审批。
观察执行过程#
Agent 开始工作后，你可以观察到：
思考过程展示：Agent 会展示它的计划和当前正在执行的步骤
工具调用可视化：每一次文件读取、命令执行都会有明确的 UI 提示
流式输出：结果会像聊天机器人一样逐字流式返回，不需要等待全部完成
等待任务完成，Agent 会输出对你选中工作区仓库的模块分析总结。
实时统计面板解读#
每个会话底部都有一个实时统计面板，透明展示本次任务的消耗情况：
指标 |
含义 |
|---|---|
Steps（步数） |
本次任务经历了多少个 Step（一次模型请求 + 工具调用） |
Time（耗时） |
模型推理总耗时（不含工具执行时间） |
Input Tokens |
发送给模型的总 Token 数（输入） |
Output Tokens |
模型生成的总 Token 数（输出） |
Cache Hit Rate（缓存命中率） |
提示词缓存命中比例，命中率越高越省钱 |
Cost（成本估算） |
本次会话的预估费用 |
这一面板体现了 dsh 的透明化设计——让你清楚知道一个任务花了多少 Token、多少钱，而不是像有些闭源工具那样把消耗隐藏起来。根据实测，完成一个典型的仓库总结任务，Token 成本通常不到 1 元人民币。
Trajectory 按钮提示#
在每一条 Agent 回复消息的右上角，你会看到一个 Trajectory（轨迹） 按钮。这是 dsh 的杀手级功能之一：
点击它可以进入轨迹视图，按来源逐条查看：
系统提示词内容
模型的思维链（Chain of Thought）
每一次工具调用的参数和返回结果
子 Agent 调度记录
每一次上下文注入的具体内容
官方的硬性设计规则是：模型看到的一切，都必须能从日志里还原出来。这意味着：
你可以精确复盘 Agent 为什么做出某个决策
支持从任意节点恢复（Resume）或分叉（Fork）会话
调试长任务、排查失败原因时非常有用
Trajectory 功能的详细使用方法将在第 7 章「轨迹与会话日志」中深入讲解。初次使用时你可以点击按钮感受一下这种「全程留痕」的设计。
常见问题快速排查#
如果遇到问题，先检查以下几点：
问题现象 |
可能原因 |
解决方法 |
|---|---|---|
输入框灰色无法输入 |
未选择工作区 |
点击 Choose workspace 添加并选中目录 |
模型下拉显示「Select model」 |
默认模型指向已删除的供应商 |
重新选择一个可用模型 |
报 MISSING_CREDENTIAL 错误 |
未配置 API Key |
去 Settings → Models 页面填写 API Key |
报 UNKNOWN_MODEL 错误 |
选中了未配置的模型 |
检查自定义供应商设置，补全模型 ID |
3080 端口被占用 |
其他程序占用了默认端口 |
启动时加 |
完成第一个任务后，你已经掌握了 dsh 的基本使用流程。下一章我们将详细介绍 dsh 的四种运行模式，以及如何根据任务场景选择合适的模式。