多形态使用

除了图形化的 Web UI，DeepSeek Harness 还提供 headless、CLI/TUI、Python SDK 与 TypeScript SDK 等多种形态，方便你把 Agent 嵌入不同工作流。

四种启动入口

命令	形态	适用场景
dsh web	Web UI	日常开发，图形化交互
dsh --profile tui	TUI	终端党，键盘流操作
dsh --profile headless "任务"	Headless	单次任务，跑完自动退出
Python SDK	程序化	嵌入工作流 / CI/CD

Web UI

默认入口，启动后访问 http://127.0.0.1:3080。适合日常开发与可视化观察 agent 的执行过程。

# 默认端口 3080
dsh web

# 端口被占用时指定端口
dsh --profile web --port 8080

Headless 模式

一次性运行一个任务，打印最终答案后退出，非常适合脚本与 CI/CD。

dsh --profile headless "修复所有失败的测试"

Python SDK

把 Agent 嵌入自己的 Python 程序，SDK 自带运行时、无需系统 Node.js。

pip install deepseek-harness-sdk

from deepseek_harness import DeepSeekHarness

with DeepSeekHarness(
    provider="deepseek-official",
    model="deepseek-v4-flash",
    cwd="/path/to/project",
) as harness:
    result = harness.run("修复所有失败的测试")
    print(result.final_response)

仓库内置的 examples/jsonrpc-agent/minimal.py 是 SDK 调用的轻量包装，可直接参考；运行后会话目录会收到包含模型请求与工具调用的 JSONL 日志。

TypeScript SDK

面向 TypeScript / JavaScript 项目，可在 Node.js 应用中程序化调用 Agent，与 Python SDK 能力对等，适合前后端统一技术栈的团队。

接入第三方模型

Harness 支持近 40 家模型提供商，除 DeepSeek 外，还可接入 Anthropic、OpenAI、Google、Kimi、MiniMax 等。

方式	操作
目录内厂商	Settings → Add provider → 选厂商 → 填 API Key → 保存
自定义厂商	Add custom provider → 填 Provider ID + Base URL + 凭证 + 模型
手动改配置	直接编辑 $DSH_HOME/settings.yaml（Web UI 之外的方式）