前言¶

在 DeepSeek Harness（dsh）里调 HTTP 接口，常见做法是另开 Postman、cURL 或自建脚本。请求参数、环境变量和 agent 实际发出的报文往往不在同一条链路上，面板里调通的配置，智能体未必能原样复现。

dsh-postman-desktop 把集合、环境、请求构建、响应查看和 cURL 互转做进 Web GUI 侧边栏「发包台」，并暴露 http_request_desktop 工具，与面板共用同一套发送引擎。维护者为 zhounian6688-like，在 SkillHub 插件目录 中归类为联网工具。源码与说明见 GitHub 仓库，许可证为 MIT；当前 npm 版本为 1.0.1。

这是什么¶

本插件是 Postman 式的 HTTP 调试面板，直接集成在 DSH 的 Web profile 中。宿主要求 engines.dsh >= 0.2.1-rc.1；运行时零第三方依赖，仅使用 node: 内置模块，前端为纯 React.createElement，无前端构建步骤。

集合、环境、历史等数据全部落在单个文件 $DSH_HOME/postman-desktop/store.json（DSH_HOME 未设置时为 ~/.dsh/postman-desktop/store.json），写入权限 0600，便于备份或手改。与手机版插件 dsh-postman 的 API 前缀 /api/dsh-postman 不冲突，两者可并存，但侧边栏会出现两个入口。

核心功能¶

请求构建与响应查看¶

支持方法 GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS；可编辑 URL、Query、请求头（含常用头补全）、正文（none / raw JSON·Text·XML·HTML·JS / form-urlencoded / form-data / binary），以及 Bearer、Basic、API Key（header 或 query）、自定义 Header 等认证方式。

响应侧展示状态码、耗时、大小、重定向次数；响应头以表格呈现；正文支持 JSON/XML 美化、原始视图、图片预览、二进制提示；超过 4MB 会截断并提示。

环境变量与集合¶

多环境管理，{{变量}} 在 URL、参数、请求头、正文、认证字段中替换，支持最多 5 层嵌套。集合结构为「集合 → 文件夹 → 请求」三层树，支持新建、重命名、复制、删除、搜索；从集合打开的请求在编辑后会自动写回集合。

历史与 cURL¶

每次发送自动记录方法、URL、状态码、耗时，点击可还原完整请求进构建器，最多保留 120 条。支持粘贴 curl 解析为请求（含 -X、-H、-d、--data-raw、--data-urlencode、-F、-u、-b、-A、-e、-I、-k、-L、--url 等），也可将当前请求复制为 curl。

CDN 源站探测¶

对同一 URL 读取两次（原样与加时间戳破缓存），可选指定源站 IP 直连并保留原 Host/SNI，用于区分资源已删除与 CDN 边缘缓存仍在返回旧内容。带签名或过期参数的 URL 会单独标注。

快捷键¶

URL 输入框回车直接发送；Ctrl/Cmd + Enter 全局发送。

给 agent 的工具 http_request_desktop¶

与面板共用变量解析、认证、正文编码、重定向处理，面板调通的请求可由 agent 复现。返回纯文本摘要：状态行、响应头、正文（正文超过 20000 字符会截断）。

安装与启用¶

本包通过 cordis.patch.yml 自动挂载 dsh.bundle 与 dsh.client，一般不需要额外的 profile 配置。安装命令以 README 为准：

# 已发布到 npm 时
dsh plugin --profile web add dsh-postman-desktop

也可使用 GitHub Release 打包文件：

dsh plugin --profile web add https://github.com/zhounian6688-like/dsh-postman-desktop/releases/latest/download/dsh-postman-desktop-1.0.1.tgz

装完后刷新页面，或重启桌面版，侧边栏即可出现发包台入口。

典型用法¶

在面板中发请求¶

1. 从侧边栏进入「发包台」。
2. 选择方法、填写 URL；需要时使用环境里的 {{变量}}。
3. 配置请求头、正文或认证，回车或 Ctrl/Cmd + Enter 发送。
4. 在响应区查看状态、头与正文；需要时从历史列表一键还原某次请求。

agent 调用 http_request_desktop¶

README 中的示例：

http_request_desktop(method="POST", url="https://api.example.com/v1/users",
                     headers={"Content-Type":"application/json"},
                     body='{"name":"a"}', bodyType="json")

常用参数：url（必填，可含 {{变量}}）；method 省略时，有正文为 POST，否则为 GET；headers、body、bodyType（json / text / xml / html / urlencoded，默认 json）；form 数组存在时按 x-www-form-urlencoded 发送；environment 指定环境名或 id，省略则用当前激活环境；timeoutMs 默认 30000，上限 300000；followRedirects 默认 true；verifyTls 默认 true。

同源 HTTP 接口（供面板调用）¶

路由前缀为 /api/dsh-postman-desktop。Origin 与 Host 不一致时返回 403。主要端点包括：GET/PUT/POST 读写 store，POST .../send 发送，POST .../curl 解析 curl，GET/DELETE .../history 读写历史，POST .../probe 做 CDN 探测，GET .../health 健康检查与存储路径。

适用场景与注意¶

适合在 DSH Web 界面里做 API 调试、留存集合与环境、让 agent 与人工共用同一发送路径的场景。CDN 探测适合排查「404 是真删了还是边缘还在骗你」一类问题。

使用前须知：

1. 运行权限：HTTP 请求由 dsh 宿主进程 发出，不是浏览器所在终端的独立权限；binary 与 form-data 中 @路径 由 host 侧读取，路径须对 host 进程可访问。
2. 协议与体积：仅支持 http: / https:；请求正文上限 16MB，响应读取上限 4MB；默认超时 30s（可调 1ms–300000ms）；重定向默认最多 10 跳（可调至 20）。
3. 安全：关闭 TLS 校验（verifyTls: false）只影响当次请求的 rejectUnauthorized。安装插件前应阅读源码与 MIT 许可证，确认符合你的安全策略。
4. 生态：DSH 社区插件目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；星标与受欢迎程度以各平台页面为准，撰写时 GitHub 显示为 0 star，不代表功能完备性。

结尾¶

dsh-postman-desktop 把 Postman 式工作流收进 DSH Web GUI：一条侧边栏入口、一份 store.json、一套与 http_request_desktop 共享的发送引擎。若你正在 Web profile 里做接口联调或希望 agent 复现已调通的请求，可按上文命令安装后从发包台开始。

• 插件目录：https://www.skillhub.cn/plugins/zhounian6688-like/dsh-postman-desktop
• GitHub：https://github.com/zhounian6688-like/dsh-postman-desktop