DeepSeek Harness TypeScript SDK

English | 中文

DeepSeek Harness（dsh，DeepSeek 开源的 AI agent harness）的 TypeScript / Node.js SDK：以子进程方式驱动运行时，通过 stdio 上的换行分隔 JSON-RPC 运行 agent turn。这是一个独立实现，参考了上游仓库的 packages/sdk/{protocol,client}，并对齐官方 Python SDK（python/sdk）的 API 设计。

运行时会继承 DEEPSEEK_BASE_URL、DEEPSEEK_API_KEY 等标准 DeepSeek Harness 环境变量，因此既可以直连真实模型端点，也可以把这些变量指向本地代理。

安装

npm install @openma/deepseek-harness-sdk

快速开始

import { DeepSeekHarness } from '@openma/deepseek-harness-sdk'

await using harness = new DeepSeekHarness()
const result = await harness.run('Say hi.')
console.log(result.finalResponse)

DeepSeekHarness 惰性启动运行时子进程并在多次调用间复用。像上面那样使用 await using，或在结束时显式调用 close()，确保子进程始终被回收。

特性

• 高层 turns API —— DeepSeekHarness.run() 发送 prompt，返回最终 assistant 响应、结束原因和整段活动区间的事件/通知流
• 低层协议客户端 —— HarnessClient 提供原始 JSON-RPC 请求、通知订阅和 session 树过滤
• 忠实还原官方协议 —— 独立镜像上游 wire 类型与 run 语义，与官方 Python SDK（PyPI 的 deepseek-harness-sdk）API 对齐
• 健壮的进程所有权 —— 惰性启动、协议 shutdown、stdin-EOF → SIGTERM → SIGKILL 收尾阶梯，附退出码 + stderr 尾部诊断