zampie/request-frame-preview

request-frame-preview

预览并下载 DeepSeek Harness 为某个会话发送给模型的确切请求帧：完整的系统提示词、工具声明（tools），以及从会话日志重建的线上消息数组（system → user / assistant / tool-result，按顺序）。

一个小型 DSH 插件，包含宿主端（一个只读 HTTP 端点）和浏览器端（会话头部中的“请求预览 / Request preview”按钮）。

安装

dsh plugin --profile web add request-frame-preview

或从本地检出安装：

dsh plugin --profile web add /path/to/request-frame-preview

重启 dsh web（或让插件市场重启它）以加载该 bundle。随后会话头部的实用工具区域会出现一个请求预览按钮，位于内置的“Session log”按钮旁边。

功能说明

点击该按钮会打开一个覆盖层，从上到下显示：

1. ① system prompt — 线上数组的消息 #0（默认折叠）。
2. ② tools — 请求携带的工具声明，每个工具一行 tool；点击某一行可查看其参数。
3. ③ messages — 从 #1 开始的线上消息数组，带有 user、assistant、tool-result 标签、tool_call_id、推理内容，以及内联展开的 tool_calls。

下载 JSON / Download JSON 会将整个帧（config + system + 带完整参数 schema 的 tools + messages）保存为 dsh-request-.json。

数据是如何生成的

- 优先使用实时会话：requestHeader() 和 deriveMessages() —— 与 agent 循环在构建每个请求时所读取的完全相同的折叠逻辑。
- 冷会话回退：从持久日志中使用 sessionQuery.readSession + readSurface。
- 线上展开方式与 DeepSeek chat-completions 适配器的文本路径一致：系统提示词成为消息 #0；每个 tool-result 块成为其自己的 role: "tool" 消息；assistant 文本、推理和 tool_calls 被拆分到各自的线上字段中。

目录结构

package.json        dsh.bundle.patch -> ./cordis.patch.yml; dsh.client.platform web
cordis.patch.yml    将插件行插入 profile 层栈
lib/index.js        宿主端：注册 GET /request-frame-preview/api
lib/client.js       浏览器端（window.__ModuleLoader__ bundle）

安全说明

- 该端点是只读的（GET/HEAD），不执行任何状态变更。
- 当存在 Origin 头且与 Host 不匹配时，跨源请求会被拒绝；没有 Origin 的请求（curl、）则被允许，这与 dshmarket 的 GET 路由约定一致。
- 这是一个调试辅助工具：它会将会话的完整系统提示词、工具 schema 和消息内容暴露给任何能够访问该端点的人。宿主端点并非安全边界。