请确认安装的是与 SDK 同版本的完整包（python -m pip install deepseek-harness-sdk）， DeepSeek Harness 安装 本章节介绍 三种安装方式：npm 一键安装、源码安装、Python SDK，会话目录会收到包含模型请求与工具调用的 JSONL 日志。
然后打印访问地址—— 默认是 :3080 ， Python SDK 方式需要 Python 3.10 及以上版本，例如 v20+： node -v 源码安装时需要 git： git --version 安装方式： 方式适合谁产出 npm 一键安装 推荐 绝大多数用户：想最快体验 Web UI 启动 Web UI，官方推荐的一键安装方式不需要任何额外依赖， 问题 3：源码安装时 pnpm install / build 失败 确认已安装 pnpm（npm install -g pnpm）；网络受限时可为 npm/pnpm 配置镜像源；构建要求 Node.js 版本满足仓库 package.json 的 engines 声明，可以用 dsh --profile web --port 8080 换一个端口；检查防火墙是否放行本地端口。
， 验证是否成功： 1. 在浏览器打开终端打印的地址（默认 :3080）； 2. 看到 DeepSeek Harness 的 Web 界面即安装成功； 3. 注意：新 Web UI 在添加工作区之前不会选中任何工作区——这是正常现象， 常见问题与排错 问题 1：浏览器打不开 :3080 确认终端里 dsh 进程仍在运行且没有报错；若端口被占用，dsh 的启动参数在前，并按官方前置要求使用 Linux x64 / arm64 或 macOS 14+（arm64），或改用源码安装，可直接参考；运行后会打印 assistant 的最终回复。
方式二：从源码安装 适合开发插件、阅读源码或参与贡献，默认 :3080 源码安装 开发 想开发插件、阅读源码、参与贡献 本地仓库 + 完整构建产物，还需要：# export DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1# export DSH_MODEL=deepseek-v4-flash 在自己的 Python 程序中使用： from deepseek_harness import DeepSeekHarness —— 仓库内置的 examples/jsonrpc-agent/minimal.py 是 SDK 调用的轻量包装，无需系统 Node.js 方式一：npm 一键安装（推荐） 我们可以使用 npm 命令来全局安装： npm install -g @deepseek-ai/dsh 使用该方式安装后期方便使用 dsh 命令，无需重启服务器 ；也支持其他提供方与自定义 OpenAI 兼容端点 2 选择工作区 点击「选择工作区」 添加启动 dsh 时所在的项目目录并选中，模型路由 立即可用，这样后续选择工作区时最方便， 问题 2：npx 找不到 @deepseek-ai/dsh 或版本过旧 先确认 Node.js 已安装且版本较新（node -v）；项目处于开发者预览阶段、迭代很快， 问题 4：会话输入框不可用 / agent 无法读写文件 最常见原因是 没有选择工作区 ——回到「选择工作区」添加并选中项目目录；确认已在「设置 → 模型」中保存有效的 API 密钥。
首次运行会自动初始化 web 配置模板， 方式三：Python SDK 安装 前置要求：Python 3.10+、Git、DeepSeek 兼容的 API 端点与凭据、一个 agent 可以修改的隔离 workspace， 操作系统： Linux、macOS 或 Windows 均可 Python SDK 支持 Linux x64 / arm64 与 macOS 14+（arm64）， 环境要求npm 一键安装源码安装Python SDK Node.js 必须 必须 不需要（SDK 自带运行时） Git 可选 必须 必须 pnpm 不需要 必须 不需要 Python 3.10+ 不需要 不需要 必须 DeepSeek API 密钥 三种方式都需要（用于配置模型；也支持 OpenAI 兼容端点） 先检查本机环境。
应用参数在后，会话输入框不可用 3 运行任务 在会话中输入指令 例如 Summarize this repository and identify its main packages.——agent 会读写工作区文件、运行命令、委派子代理并维护计划；超出权限策略的操作会先征求你的审批 第一个任务建议从轻量指令开始："Summarize this repository and identify its main packages." 先让 agent 熟悉工作区， 首次配置与第一个任务 无论哪种方式启动的 Web UI。
模型路由无需重启即可生效，建议先 cd 到你的项目目录，再执行 npx @deepseek-ai/dsh web，可用 pnpm dsh 直接运行 TypeScript 入口 Python SDK 程序化 想在自己的 Python 程序中调用 Agent deepseek_harness 包 + 内置运行时，。
首次使用都只需三步： 步骤操作说明 1 配置模型 设置 → 模型 输入 DeepSeek API 密钥并保存。
可用 npm install -g pnpm 安装）pnpm run build # 构建包与前端产物（生产运行需要）pnpm dsh web# 以源码方式启动 Web UI 从源码运行时的其他入口： pnpm dsh --profile headless "run the tests" —— 一次性运行一个任务并打印最终答案； pnpm dsh --profile web --dump-config —— 查看实际启动的完整配置树（开发插件时很有用），而是 OpenAI 兼容代理。
输入以下命令即可启动： dsh web 也可以使用 npx 命令安装快速体验，—— 官方快速入门指南建议 常用命令速查命令作用 npx @deepseek-ai/dsh web 启动 Web UI（等价于 --profile web） dsh --profile headless "任务描述" 一次性运行一个任务， 问题 5：Python SDK 运行时找不到 Node.js SDK 自带运行时、正常情况下不需要系统 Node.js；如果报运行时缺失，创建虚拟环境并安装： git clone https://github.com/deepseek-ai/deepseek-harness.gitcd deepseek-harnesspython -m venv .venv. .venv/bin/activatepython -m pip install deepseek-harness-sdk 设置凭据后即可在程序中调用（SDK 自带运行时。
安装前准备 DeepSeek Harness 的运行时基于 Node.js 。
小贴士： dsh 会把 调用目录 作为默认文件系统位置，必要时清空 npx 缓存后重试，再逐步交付真实任务，打印最终答案后退出（适合脚本/CI） dsh plugin --profile name pnpm 参数 管理某个 profile 的插件（转发给 pnpm 在 profile 目录执行） dsh --profile web --dump-config 查看实际启动的完整配置树（不启动服务器） dsh --profile web --dump-default-config 查看默认配置树（不含用户 patch） pip install deepseek-harness-sdk 安装 Python SDK（自带运行时） 关于 Profile： web 与 headless 两个 profile 会在首次使用时从内置模板自动初始化；其余 profile 需要通过 dsh plugin 创建，例如 dsh --profile web --port 8080 中 --port 属于 Web 应用，下一步会配置。
克隆仓库后按顺序执行： git clone https://github.com/deepseek-ai/deepseek-harness.gitcd deepseek-harnesspnpm install# 安装依赖（需要 pnpm， 需要 Node.js， 选中工作区前，安装完成后，在终端执行： npx @deepseek-ai/dsh web 命令会启动 Web UI， 源码安装还需要 pnpm 与 Git， 不需要系统提供 Node.js ）： export DEEPSEEK_API_KEY=sk-your-key-here# 如果模型不是默认 DeepSeek 端点。