前言¶
在使用 DeepSeek Harness（DSH）进行智能体开发时，调试 HTTP 请求通常依赖外部工具，或者需要在 Agent 代码中手动编写请求。这种方式缺乏统一的执行审计链路，且无法在调试界面与 Agent 工具链之间共享上下文。
dsh-api-client 插件旨在解决上述问题。它提供了一套 Agent 原生 HTTP 工具，同时保留了 Postman 级别的调试体验，使 Human 与 Agent 可以共用同一套 HTTP Executor 与审计体系。
插件简介¶
这是一个 DSH 原生插件，由 Beatther-c 维护。其核心定位是：
- Human UI：Postman 级别的 API 调试界面。
- Agent Tools：Agent 原生可调用的 HTTP 工具。
- 兼容性：支持 Postman Collection v2.1 导入。
Human 与 Agent 共享同一套 HTTP 执行引擎，高风险方法会自动进入 Approval 流程。
核心功能¶
1. Postman 级调试体验¶
插件提供了完整的 HTTP 请求编辑与响应查看能力：
* 树形结构：支持 Collection / Folder / Request 三级目录管理。
* 编辑器：支持 Params / Headers / Auth / Body 编辑，内置 JSON Editor。
* 响应查看：提供 Pretty / Raw / Preview 三种视图模式。
* 方法支持：涵盖 7 种标准 HTTP 方法。
2. Agent 原生工具¶
插件暴露了一组 DSH 原生工具，Agent 可直接调用：
* api_client_request：发起请求。
* api_client_run_request：运行请求。
* api_client_list_collections：列出集合。
* api_client_list_requests：列出请求。
* api_client_get_request：获取请求详情。
* api_client_get_last_response：获取最后一次响应。
3. 安全与策略¶
- 环境与密钥：支持
shared/secrets/目录，配合SecretRef引用分工。History 与 Agent Context 全链路脱敏，History 永不持久化密钥明文。 - SSRF 防护：默认采用 fail-closed 策略，拒绝访问 localhost、私网地址，支持 blocked hosts/ports 配置，并具备 DNS rebinding 防护。
4. 原生集成¶
- UI 适配：支持官方 Slot 优先 + DOM fallback 双路径 UI 适配（基于 feature-detect）。
- 配置与主题：集成至 Settings 配置页，主题跟随 DSH。
安装与启用¶
使用前需确保 DeepSeek Harness 版本满足要求。
# 需要版本 >= 0.1.2-rc.1
dsh plugin --profile web add dsh-api-client
安装后，DSH Sidebar 的「New Session」下方会出现 API Client 入口。
典型用法¶
Human 侧操作¶
- 点击 Sidebar 入口进入主视图。
- 新建或导入 Postman Collection。
- 编辑请求参数与 Body，点击 Send。
- 在 History 或 Response Viewer 中查看结果。
- 在 Environment 管理变量与 secret（界面恒脱敏显示）。
- 在 Settings → Plugins → API Client 中调整超时、网络策略或权限。
Agent 侧操作¶
Agent 可以直接在会话中调用 api_client_* 工具来执行 HTTP 请求，或者将当前脱敏后的调试上下文通过「交给 Agent」功能送入新的会话中进行分析。
注意事项¶
- 依赖要求：插件依赖 DeepSeek Harness >= 0.1.2-rc.1。
- 权限安全：插件以当前 DSH 进程权限运行，SSRF 默认 fail-closed。安装前建议检查源码。
- 许可证：遵循 MIT License。
- 生态归属：该插件收录在 SkillHub 社区目录，与 DeepSeek 官方无从属关系。
总结¶
dsh-api-client 将传统的 API 调试工具与 Agent 工具链进行了原生整合。对于需要频繁调试接口的智能体开发者，它提供了一套既符合 Human 习惯又符合 Agent 工具规范的解决方案。
