DeepSeek Harness 的 LoongSuite 可观测插件

English | 简体中文

@loongsuite/dsh-plugin-loongsuite 是面向 DeepSeek Harness（dsh）的独立开源可观测 插件。它观测 DSH 原生的会话、Agent 循环、LLM 流和工具生命周期，将其转换为 OpenTelemetry GenAI Trace 与 Metric，并通过标准 OTLP/HTTP Protobuf 上报到任意兼容后端。

LoongSuite 是阿里开源的统一可观测采集体系。本仓库是它面向 DSH 的原生集成；尽管仓库名称如此， 插件不依赖也不要求安装 LoongSuite Pilot，不需要 sidecar、本地 JSONL 采集点或阿里云后端。

当前状态：Beta 版本。可通过 @loongsuite/dsh-plugin-loongsuite@beta 安装 npm Beta 包；DSH 插件市场 条目尚未发布。

数据模型

DSH session/event + llm/stream
                │
                ▼
          生命周期协调器
                │
                ▼
   LoongSuite GenAI OTel 工具库
                │
                ▼
 私有 TracerProvider + MeterProvider
                │  OTLP/HTTP Protobuf
                ▼
   任意 OpenTelemetry 兼容后端

DSH 的每一轮对话生成一条调用链：

ENTRY
└── AGENT
    └── STEP
        ├── LLM
        └── TOOL

每次真实 LLM 调用都会生成独立的 LLM span，因此重试会保留为同一个 STEP 下的多次尝试。工具调用 通过 DSH call ID 与结果关联。错误、中止、不完整的流以及插件卸载都会以错误状态关闭未结束 span，不会 留下悬挂链路。Subagent 会话生成独立 trace，并携带 DSH 父会话和委派层级属性。

插件还会上报标准的 gen_ai.client.operation.duration 与 gen_ai.client.token.usage 指标。它不 上报 OpenTelemetry Log，可与独立的 DSH 日志导出插件同时使用。

GenAI Invocation 构建与语义属性由 @loongsuite/otel-util-genai SDK 提供。

兼容范围

组件	支持范围	已完整验证版本
DeepSeek Harness	>=0.1.0-rc.6 =22.19.0	macOS 上的 22.19、24.19 和 25.9

不支持早于 0.1.0-rc.6 的 DSH RC 版本。Beta 验证以 DSH 当前最新发布版为准，不会仅凭 bundle 能成功组合就宣称具备完整运行时兼容性。

安装与使用

Beta 阶段，在需要观测的每个 DSH profile 中安装 beta tag：

dsh plugin --profile web add @loongsuite/dsh-plugin-loongsuite@beta
dsh plugin --profile headless add @loongsuite/dsh-plugin-loongsuite@beta

本地开发时，把包名换成本仓库的绝对路径：

dsh plugin --profile web add /absolute/path/to/pilot-dsh

设置服务名和 OTLP/HTTP Collector 地址，然后照常启动该 profile：