deepseek-harness/packages/sdk/README.zh.md

description, kind

description	kind
SDK 能力家族的包映射：JSON-RPC 协议格式，以及供进程外 SDK 使用的 TypeScript 客户端与服务器。	package-group

sdk/：从另一进程驱动 Harness 运行时

English | 中文

概述

SDK 家族让另一进程通过按换行分帧的 JSON-RPC 驱动完整的 DeepSeek Harness 运行时。协议包定义公开消息，TypeScript 客户端用具名 profile 和有序 patch 启动 dsh，服务器则通过 stdio 接受 SDK 请求。客户端可以打开会话、发送提示词，并观察会话事件、agent 状态变化与 subagent 完成事件。TypeScript 客户端与 Python SDK 使用同一种协议，而这些包不会创建开发者项目，也不定义其他应用。

目录

• 包
• 相关文档
• 开发备注

---

包

每个包 README 描述你可用该包部分完成的事情。

包	职责
protocol/	协议格式：按换行分帧的 JSON-RPC 传输，以及具名的请求、结果与通知类型
client/	TypeScript 客户端：启动运行时子进程，通过高层与协议层 API 驱动 agent 轮次
server/	jsonrpc 插件：通过 stdio 为进程外 SDK 客户端提供服务

---

相关文档

先从 Python SDK（客户端约定的姊妹实现）开始，再看可运行应用与组边界背后的决策记录。

• Python SDK — 说同一种协议的 Python 对侧实现，并随附捆绑运行时。
• SDK 应用组合包 — 启动 JSON-RPC 服务器的 dsh --profile sdk 应用。
• 架构 — 打包后的 Python 客户端为何启动相同的具名 profile。
• SDK 项目工具链移除 — 本组为何从不创建、配置或构建开发者项目。
• SDK subagent 提供方 — harness 内部消费 TypeScript 客户端的例子。

开发备注

无。