前言¶
在 DeepSeek Harness (DSH) Web 中调试智能体时,直接查看模型请求和响应的过程往往需要修改代码或依赖外部工具。dsh-llm-call-inspector 插件提供了一个本地、会话范围的检查器,它会在 Chat 和 Trajectory 视图旁边新增一个“LLM Calls”视图,允许开发者在不改变模型接收内容或调用者接收内容的前提下,检查每个与会话关联的规范化 llm/stream 调用。
插件介绍¶
这是一个由社区开发者 striveh 维护的开源插件,旨在解决 DSH Web 中缺乏原生 LLM 调用观测能力的问题。它通过拦截并展示规范化后的调用数据,帮助开发者快速定位问题。
核心功能¶
插件主要提供以下能力:
-
LLM Calls 视图
在 DSH Web 界面中新增一个视图,与 Chat 和 Trajectory 并列。该视图以最新优先的顺序展示当前会话的所有调用列表。 -
调用详情展示
列表项包含以下详细信息:Provider(提供商)、Model(模型)、Purpose(用途)、Status(状态)、Start Time(开始时间)、Duration(持续时间)、Chunk Count(块数)以及 Body-capture State(正文捕获状态)。 -
过滤与搜索
支持对调用列表进行搜索,并可以通过 Status(状态)和 Purpose(用途)进行过滤,以便快速定位特定调用。 -
主从详情布局
点击列表中的某次调用,进入详情页。详情页采用 Master/Detail 布局,提供三个选项卡:Request(请求)、Response(响应)和 API Comparison(API 比较)。- Request / Response:展示捕获的请求和响应数据,支持展开 JSON 和复制内容。
- API Comparison:提供语义投影功能,展示请求与标准 API 形状的对比(支持 OpenAI、Anthropic、Google、Bedrock、Mistral 等协议)。
-
上下文保留
当你在不同视图之间切换(例如从 LLM Calls 切换到 Chat 再切回)时,插件会保留当前的检查上下文,包括选中的调用、搜索关键词、过滤器、详情页选项卡以及滚动位置。 -
数据捕获
插件默认捕获请求和响应正文。捕获的请求字段包括:provider、model、reasoningEffort、messages、system、tools、temperature、maxTokens、stop、sessionId和purpose。捕获的响应为有序的 DSHStreamChunk值。
注意事项¶
- 版本兼容性:该插件目前仅支持 DeepSeek Harness 版本
0.1.2-alpha.2。如果你使用的是旧版本(如 0.1.0-rc.8 等),请使用插件版本v0.2.0。 - 隐私与数据安全:插件默认捕获请求和响应正文,这可能包含提示词、源代码、工具参数、敏感数据或个人信息。在使用涉及敏感信息的会话前,请务必查阅隐私文档并评估风险。
- 作用范围:插件仅监控 DSH 规范化边界内的数据,并非提供商的线缆代理。它不捕获原生的 HTTP 请求或响应包。
- 存储机制:插件使用浏览器内存缓存,不使用
localStorage、sessionStorage或IndexedDB。当插件生命周期结束时,客户端缓存会被清除。 - API Comparison 限制:API Comparison 是语义投影而非数据包捕获,它不会读取 HTTP 头、API 密钥,也不会发送额外的请求。
获取与安装¶
当前未提供具体的安装命令。你可以通过以下链接获取插件:
* 插件目录: https://www.skillhub.cn/plugins/striveh/dsh-llm-call-inspector
* 源码仓库: https://github.com/striveh/dsh-llm-call-inspector
总结¶
dsh-llm-call-inspector 是一个专注于会话级 LLM 调用观测的工具,通过语义投影和上下文保留功能,为 DSH Web 用户提供了直观的调试手段。在遵守其隐私和数据捕获范围的前提下,它能够有效辅助开发者进行智能体开发与调试。