← 返回列表
D

dsh-request-flight-recorder

v1.0.0 · 2 天前发布

Content-free request and stream diagnostics for DeepSeek Harness

dshdsh-plugindeepseek-harnessdiagnosticsobservabilitydebuggingllmdeveloper-tools

README

dsh-request-flight-recorder

English

面向 DeepSeek Harness 的无正文模型请求诊断插件。插件通过 Cordis 观察官方
Agent Loop 请求,关联请求组装与流式结束状态,并在有界内存中保留飞行记录,
用于定位模型请求结构和流式生命周期问题。

能力

  • 精确记录 Session、Turn、Step 和请求 Attempt 坐标。

  • 记录 Provider、Model、生成参数、消息结构计数和工具 Schema 大小。

  • 记录 Prompt Section、Context、Tool 和变量名称,但不记录对应值。

  • 记录首个 Chunk 延迟、总耗时、Token Usage、Finish Reason 和结构化失败状态。

  • 提供进程健康状态、保留记录组合查询和确定性的无正文 Diff。

  • 当 Profile 提供 Commands 服务时,注册可选的官方 /flight 人类命令。
  • 记录器不会注册模型 Tool、Skill、Prompt Section 或 Context Provider,也不会
    改变 Agent Loop 或 Prompt 语义。

    兼容性

    版本 1.0.0 面向 DeepSeek Harness 0.1.0-rc.6、Cordis ^4.0.1
    Node.js ^22.19.0 || ^24.0.0。DSH RC 版本可能修改扩展契约,请使用与目标
    DSH 版本匹配的插件版本。

    安装

    npm

    通过 npm 安装时,使用官方 DSH 插件命令将包添加到 Profile:

    ```sh
    dsh plugin --profile web add dsh-request-flight-recorde

    查看完整 README →

    版本兼容矩阵

    DSH 版本状态说明
    dsh@0.1.0-rc.6 ✅ 兼容 cordis patch ✅
    dsh@0.1.0 ✅ 兼容 标准 patch ✅
    dsh@0.2.0 ⚠️ 待验证 待实测(API 可能在变)
    dsh@0.3.0+ ❓ 未知 尚未发布

    💡 兼容矩阵每周末自动跑实测,欢迎 PR 修正

    元数据

    License
    MIT
    npm
    dsh-request-flight-recorder
    Repo
    git+https://github.com/abinzhao/dsh-request-flight-recorder.git
    Engines
    {"node":"^22.19.0 || ^24.0.0"}
    Weekly DL
    0
    Monthly DL
    0
    dsh.bundle
    {"bundle":{"patch":"./cordis.patch.yml"}}