DeepSeek Harness ​

使用说明

订阅套餐（Token Plan）专属 API Key 仅限在 AI 编程工具和智能体工具中进行交互式使用，不可用于 API 调试、工作流平台或其他非交互式场景。Key 与 Base URL 请参见 快速开始 → 接入方式一览。

DeepSeek Harness（命令行工具名为 dsh）是一个开源 Agent Harness，提供文件编辑、Shell、网页检索、Skills、计划、子代理和工作流等能力。

开发者预览 ​

DeepSeek Harness 处于开发者预览阶段，正在快速迭代，未来可能会出现破坏兼容性的变更。

运行本项目前，请先阅读安全说明。

1. 运行 ​

通过 npm 运行 ​

安装 Node.js。当前官方源码要求 Node.js ^22.19.0 或 >=24.0.0，建议安装满足要求的 Node.js LTS 版本。安装完成后，打开终端执行：

sh
npx @deepseek-ai/dsh web

该命令默认会在 http://127.0.0.1:3080 启动 Web UI，并在本机使用默认浏览器打开页面。如果浏览器没有自动打开，请手动访问上述地址。通过 SSH 启动时，终端只会打印宿主机 URL，本地转发地址由 SSH 客户端或编辑器持有。传入 --no-open 可仅运行服务器而不打开浏览器：

sh
npx @deepseek-ai/dsh web --no-open

从源码运行 ​

如需从仓库源码运行：

sh
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

pnpm run build 会准备仓库产物，pnpm dsh web 会直接使用这些已构建产物启动 Web UI，不会重新构建。

2. 配置 SCNet 模型 ​

启动 Web UI 后，打开左下角的 设置 → 模型，选择 添加自定义提供方，创建 SCNet 自定义提供方并填写相关的API Key、密钥、协议等。 DeepSeek Harness 模型配置页面DeepSeek Harness 模型配置页面

OpenAI 兼容协议 ​

推荐优先使用 OpenAI 兼容协议，按以下内容填写：

配置项填写内容
显示名称例如SCNet
API 协议openai-completions
API 地址https://api.scnet.cn/api/llm/v1
API 密钥填写 SCNet API Key
Model填写 模型列表 中的模型名称

配置完成后保存，在模型选择器中选中刚刚添加的模型，再新建会话进行测试。

Anthropic 兼容协议 ​

如果 SCNet 模型需要使用 Anthropic 兼容协议，也可以创建自定义提供方并填写：

text
API 协议: anthropic-messages
Base URL: https://api.scnet.cn/api/llm/anthropic

API Key 和模型名称仍使用 SCNet 控制台及模型列表中的内容。协议类型必须与 Base URL 匹配，否则可能出现接口路径或请求格式错误。

3. 常见问题 ​

使用 openai-responses 协议时对话报错 ​

问题现象

将 API 协议设置为 openai-responses 后，发送对话请求时出现报错：

DeepSeek Harness 使用 openai-responses 协议时的对话报错

解决方法

  1. 打开 DeepSeek Harness 左下角的 设置 → 模型。
  2. 找到已经添加的 SCNet 自定义提供方。
  3. 将 API 协议由 openai-responses 修改为 openai-completions。
  4. 保存配置，并新建会话后重新发送消息。
配置项错误配置推荐配置
API 协议openai-responsesopenai-completions
API 地址https://api.scnet.cn/api/llm/v1https://api.scnet.cn/api/llm/v1