DeepSeek Harness (DSH) 业务桥接插件介绍

前言¶

DeepSeek Harness (DSH) 采用了「一切皆插件」的架构理念。业务系统接入 DSH agent 能力时，通常需要针对 SDK 或内部通信协议进行定制开发。newspringwei/dsh-biz-bridge 插件通过标准 HTTP 协议，将 DSH 的 agent 能力开放给外部系统，让业务方通过简单的 HTTP 请求即可获取流式或回调响应，无需理解 DSH 内部细节。

插件概览¶

• 插件名称：newspringwei/dsh-biz-bridge
• 功能定位：DeepSeek Harness 业务桥接插件
• 维护者：NewSpringWei
• 许可证：MIT

核心能力¶

该插件主要提供以下能力：

• 标准 HTTP 协议接入：对外暴露 RESTful 接口，业务系统通过 HTTP 调用。
• 响应模式：支持 流式 (SSE) 和 回调 两种响应模式。
• 上下文复用：通过 session_id 参数实现多轮对话上下文保持。
• 任务调度与存储：任务调度与日志存储于 SQLite 数据库。
• 附件双向转接：
  • 入站：业务方提交 URI，插件负责拉取附件并落盘。
  • 出站：agent 产出的文件会被发现、登记，并提供签名下载接口。
• 安全校验与约束：
  • 入口校验：支持签名认证、SSRF 防护、路径越界检测、越权校验、附件体量与完整性检查。
  • Agent 约束：支持移除工具、沙箱只读模式等能力约束。
• 便携部署：支持生成自带运行时的便携部署包。

安装与启用¶

在安装前，请确保环境满足以下要求：

• Node.js：^22.19.0 || >=24.0.0
• DSH 环境：机器上已安装 DSH 并有 dsh 命令可用。

安装步骤如下：

1. 获取安装包。可以从仓库的 release 目录获取 dsh-biz-bridge-0.1.3.tgz，或自行构建。

    ls release/dsh-biz-bridge-0.1.3.tgz

2. 使用 dsh plugin 命令安装插件。建议创建一个独立的 profile bizbridge。

    dsh plugin --profile bizbridge add ./release/dsh-biz-bridge-0.1.3.tgz

3. 启动服务。

    dsh --profile bizbridge

启动日志中出现 `activation rescue` 与 `activated` 即表示成功。

使用与测试¶

服务启动后，可通过以下工具页面进行接入测试：

• 接入测试页：http://127.0.0.1:42731/bizbridge/static/client.html
• 密钥工具页：http://127.0.0.1:42731/bizbridge/static/utils.html

在测试页中，可以进行流式/回调模式的请求测试，并测试附件的双向转接功能。

若需生成便携部署包（将 Node + DSH + pnpm + 插件打包），可使用 tools/bundle/ 目录下的工具。

安全与注意事项¶

• 信任模型：该插件面向可信业务系统，需私钥签名认证。通道是可信的，但转发的内容可能来自上游，内容层仍按不可信处理。
• 当前版本状态：版本 0.1.3 处于草创期，接口可能调整，不建议用于生产关键链路。
• 未配置 Client：若未配置 clients.json 和对应的公钥，所有 API 请求将返回 401，只有静态页面可达。
• 独立性：插件进程与 web/GUI 互不干扰。

结语¶

该插件为业务系统提供了一条通往 DSH agent 能力的标准化 HTTP 路径。更多配置细节、API 定义及安全边界说明，请参考其官方目录页或GitHub 仓库。