fei-hang/DeepSeekHarnessSDK

README 摘要

DeepSeek Harness Java SDK Java SDK for DeepSeek Harness — 一个“一切皆插件”的开源 Agent 运行时。本 SDK 将运行时作为子进程管理，并通过基于标准输入/输出（stdio）的新行分隔 JSON-RPC 2.0 协议与之通信。 - 内置 Windows x64 运行时二进制，开箱即用，无需额外安装 - 支持任意 OpenAI 兼容的第三方模型提供方（通过自动生成的 pi-ai 适配器路由） - 会话持久化、会话延续、子代理结果收集 - 启动即 initialize 握手，失败时输出退出码与 stderr 尾部，便于诊断 环境要求 - JDK 17+ - Windows x64（内置运行时为 dsh-jsonrpc-agent-pkg-win-x64.exe ） - 使用自定义模型提供方时需要一个 OpenAI 兼容的 API 地址与 API Key - 目前只支持windows 安装 将本项目安装到本地 Maven 仓库： 然后在你的项目中引入依赖： 快速开始 完整示例见 src/main/java/com/deepseek/harness/example/Example.java 。 配置项（ HarnessConfig ） 可用 HarnessConfig.builder() （推荐）或 HarnessConfig 上的 setter： 字段 说明 默认值 provider 模型提供方标识。 deepseek-official 使用内置适配器；其他值会自动生成 OpenAI 兼容路由 deepseek-official model 模型名，例如 deepseek-v4-flash deepseek-v4-flash maxTokens 单次生成的最大 token 数（自定义提供方路由的默认值） 32768 cwd 工作区目录：agent 的 bash/文件系统工作目录，也是会话持久化命名空间来源 进程当前目录 sessionRoot 会话持久化根目录 ./.harness-sessions apiKey API Key（写入 DEEPSEEK API KEY 环境变量传给运行时） 无 baseUrl 自定义提供方的 OpenAI 兼容 API 地址（ deepseek-official 不需要） 无 cordis 自定义 cordis.yml 路径（覆盖内置/生成的配置） 内置配置 systemPrompt 系统提示词（写入 DSH SYSTEM PROMPT ） 无 runtimeBin 自定义运行时可执行文件路径 内置二进制 addEnvironment(k, v) 追加任意环境变量传给运行时进程 无 自定义模型提供方 内置运行时只打包了 deepseek-official 适配器。配置其…

分类