DeepSeek Harness Web UI 使用指南
从服务器运行状态开始，本指南带你完成 DeepSeek Harness Web UI 的完整使用流程：配置模型、选择工作区、运行任务，并通过 Python SDK 与 CLI 模式继续深入。dsh 进程会把启动时所在的目录作为默认文件系统位置。
四步上手 Web UI
按照根目录 README 的说明启动 Web UI（npx @deepseek-ai/dsh web），命令会打印访问地址。之后依次完成以下步骤即可开始与 Agent 协作。
配置模型
打开「设置 → 模型」，输入 DeepSeek API 密钥并保存。模型路由会立即可用，无需重启服务器。也支持其他提供方与自定义 OpenAI 兼容端点。
选择工作区
点击「选择工作区」，添加启动 dsh 时所在的项目目录并选中它。dsh 进程会把启动时所在的目录作为默认文件系统位置；选中工作区前，会话输入框不可用。
运行任务
启动一个会话并发送任务描述。Agent 可以读取和编辑工作区文件、运行命令、委派工作并维护计划。如果某项操作需要审批，Web UI 会先询问你。
继续使用
配置其他模型提供方、用 Python SDK 在程序中编排、以无头模式单次执行任务，或者开发自己的 Cordis 插件扩展 Agent 能力。
运行第一个任务
在工作区就绪后，向会话输入框发送第一条任务，例如让 Agent 分析当前仓库：
Summarize this repository and identify its main packages.
Agent 能做什么
读写工作区文件
Agent 可以读取、创建和编辑工作区内的项目文件，理解代码结构并直接落地修改。
运行命令
Agent 可以在工作区中运行 Shell 命令，执行构建、测试与脚本任务。
委派与计划
Agent 可以将工作委派给子 Agent，并维护执行计划，持续跟踪任务进度。
权限审批
根据当前权限策略，需要审批的操作会先通过 Web UI 询问你，确保安全可控。
不止 Web UI：Python SDK 与无头模式
Web UI 之外，Python SDK（Python 3.10+）可在自己的程序中调用同一套 API；无头模式则在终端一次性运行全新会话并打印最终回复。
# 安装 Python SDK（deepseek-harness-sdk，Python 3.10+）
python -m pip install deepseek-harness-sdk
# 在自己的程序中使用 SDK
from pathlib import Path
from deepseek_harness import DeepSeekHarness
with DeepSeekHarness(
provider="deepseek-official",
model="deepseek-v4-flash",
cwd=str(Path("/absolute/path/to/workspace")),
session_root=str(Path("/absolute/path/to/sessions")),
) as harness:
result = harness.run(
"Summarize this repository.",
session_id="example-001",
)
print(result.final_response)# dsh 命令的其他用法 dsh web # Web UI（--profile web 的别名） dsh --profile headless "job" # 一次全新会话，打印最终回复后退出 dsh --profile <name> # 启动指定 profile dsh plugin --profile <name> ... # 通过 pnpm 管理该 profile 的插件
深入了解
常见问题
Web UI 启动后如何配置模型？
打开「设置 → 模型」，输入 DeepSeek API 密钥并保存即可。模型路由立即可用，无需重启服务器。也可以配置其他提供方或自定义 OpenAI 兼容端点。
为什么会话输入框不可用？
在选中工作区之前，会话输入框不可用。点击「选择工作区」，添加启动 dsh 时所在的项目目录并选中即可解锁。
dsh 进程的默认文件系统位置是什么？
dsh 进程会把启动时所在的目录作为默认文件系统位置。全新的 Web UI 不会预先选中任何工作区，需要手动添加。
除了 Web UI 还有哪些使用方式？
dsh 命令支持无头模式（dsh --profile headless "task"，一次性运行会话并打印最终回复）与指定 profile 启动；Python SDK（pip 安装 deepseek-harness-sdk）可在自己的程序中调用同一套 API。