DSH 会话 HTTP 记录插件:按会话抓取真实 HTTP 报文

前言

在 DeepSeek Harness(DSH)里排查模型 API、联网搜索或 Agent 工具链问题时,常见做法是翻 Session log 或凭印象猜请求。Session log 往往经过抽象,未必保留原始 URL、头字段和响应体;大报文或流式 SSE 更难在日志里对齐。下面介绍社区插件 dsh-plugin-session-http-log(仓库 lwlwilliam/dsh-plugin-session-http-log):它不读已有 Session log,而是在宿主进程里包裹 globalThis.fetch,把该会话实际发出的 HTTP原样记下来,并在 Web GUI 里提供查看与导出。

这是什么

DeepSeek Harness 会话 HTTP 记录插件由维护者 lwlwilliam 发布,社区目录分类为 admin-security。它是一个 Host + Client 的 bundle:Host 侧拦截并持久化抓包数据,Client 侧在聊天界面和右侧边栏展示同一份记录。通过 Harness 的 initiator 链,模型调用(含流式响应)、搜索/抓取及其它 Agent 期间的 HTTP 都会归属到对应会话。

核心功能

抓什么、留多久

每条记录包含:请求方法、URL、请求头、请求体;响应状态、响应头、响应体;耗时与传输错误。默认每个会话只保留最新一轮抓包,进入下一轮时上一轮清空。超过 24 小时未更新的日志,以及归档/删除会话的日志,会在每日清理中删除;另有 512 MiB 的全局磁盘安全阀(README 中的策略说明,具体阈值以运行配置为准)。

在哪里看

安装并刷新一次 Web GUI 页面后有两个入口,数据同源:

  1. 主视图 Tab(推荐):聊天区顶部 对话 / 轨迹 / 统计 / … 一行会出现 HTTP 记录(宽度不足时在 … 菜单)。左侧请求列表、右侧详情并排,适合分析大报文。
  2. 右侧边栏:Ctrl/Cmd+Shift+. 或 guide 菜单打开边栏,选择 会话 HTTP 记录;窄布局,便于边聊边扫一眼。

面板支持展开/折叠、定位、筛选(方法、URL、状态码、模型或类型)、复制与 复制为 cURL、JSON 美化、导出 HAR 1.2、打开保存目录、清空当前会话 / 不活跃 / 全部,以及中/EN 切换(跟随全局语言,面板头部可单独记忆)。

记录保存在哪

数据写在 DSH 数据目录下的 session-http-log/(可通过 dataDir 自定义)。卸载插件不会删除抓包文件;卸载前可在面板点「清空全部」,或卸载后手动删目录。面板「打开目录」会尽量在文件管理器中选中当前会话的 .jsonl 正文文件。

安装与启用

推荐在侧边栏 Plugins(插件) 页面安装本地包目录或 registry 包。命令行等价(npx/全局 dsh/项目内 CLI 均可):

dsh plugin --profile web add <本包目录绝对路径>

若包已发布到 registry:

dsh plugin --profile web add <package-name>

从 GitHub 安装时,仓库根目录须即插件包根(含 package.json)。方式之一为直接填仓库地址:

dsh plugin --profile web add https://github.com/lwlwilliam/dsh-plugin-session-http-log

README 还说明可用 Release 里的 .tgz 固定版本(每次 push 到 main/master 可由 CI 打 build-<短 SHA> Release)。安装前 DSH 会校验 engines.dsh;当前 package.json 要求 dsh ^0.2.2-rc.1,不满足会拒绝安装。本地占位包名为 @local/dsh-plugin-session-http-log,版本 0.1.0。

卸载:

dsh plugin --profile web remove @local/dsh-plugin-session-http-log

卸载会还原 globalThis.fetch 包装并移除相关 HTTP 路由;Client 面板在刷新后消失。

典型用法

  1. 安装插件后刷新 Web GUI。
  2. 在目标会话里触发一次会发 HTTP 的操作(例如模型对话、联网、Agent 工具)。
  3. 打开 HTTP 记录 Tab 或边栏 会话 HTTP 记录,在列表中点选请求查看概览、头与体;需要给同事或 ticket 时 导出 HAR 或复制 cURL。
  4. 若只关心当前轮次,注意顶部策略提示:旧轮次会被新轮次替换;长期不占盘可在合适时机 清空不活跃(已归档或已删除会话的抓包,不影响现存会话)。

详情里请求体/响应体默认折叠,展开时才从 Host 按需读取,避免首屏过大;超长或二进制内容会有截断/base64 标记。

适用场景与注意

适合:需要对照真实 HTTP 排错 API、代理、搜索接口或流式响应的 DSH 用户;需要在 GUI 内快速筛选、导出 HAR 的场景。

分类 admin-security 的含义应结合目录站点说明理解:插件会记录会话期间敏感头字段与正文,数据落在本机磁盘。它以当前 DSH 进程权限运行并包裹全局 fetch,安装前应自行审阅 GitHub 源码 与许可证(README 截断处未完整列出许可证字段时,以仓库为准)。勿在不可信环境安装未审查的第三方 bundle。

社区插件目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系;DSH 生态走「一切皆插件」,本件是其中一条面向会话级 HTTP 可观测性的补充。

结尾

若你的痛点是「Session log 不够细、想看到会话真实发出的 HTTP」,该插件提供了从 fetch 拦截到 GUI/HAR 的完整链路。安装命令以 README 为准,启用后记得刷新页面。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye