跳到正文

loongsuite/dsh-plugin

31最近提交 2026年8月16日

dsh-plugin DSH 插件

@loongsuite/dsh-plugin 是一个独立的开源可观测性插件，用于 DeepSeek Harness (DSH)。它监听 DSH 的原生会话、代理循环、LLM 流和工具生命周期，将其转换为 OpenTelemetry GenAI 跟踪和指标，并通过标准 OTLP/HTTP protobuf 导出到任何兼容的后端。该插件不依赖任何特定厂商的 sidecar 或后端。

developer-tools

如何安装 dsh-plugin DSH 插件

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

复制不会执行命令。安装 dsh-plugin DSH 插件前请核对仓库和版本。

dsh-plugin DSH 插件数据来源

dsh-plugin DSH 插件快照日期：2026年8月16日

discovered

dsh-plugin DSH 插件能做什么

  • 将 DSH 会话、代理循环、LLM 流和工具调用转换为 OpenTelemetry GenAI 跟踪和指标。
  • 通过 OTLP/HTTP protobuf 导出跟踪和指标到任何兼容 OpenTelemetry 的后端。
  • 支持通过环境变量或 DSH 配置文件的插件设置进行配置。
  • 内容捕获（提示词、响应、工具模式）默认关闭以保护隐私；可显式启用。
  • 兼容 DSH >=0.1.0-rc.6 且 <0.2.0，Node.js >=22.19.0。

dsh-plugin DSH 插件适合哪些场景

  • 在 Grafana 或 Jaeger 等仪表板中监控 DSH 代理每次调用的延迟和令牌使用量。
  • 通过查看每个回合、工具调用和 LLM 重试的详细跟踪来调试多步骤代理工作流。
  • 收集 LLM 性能指标（持续时间、令牌数）以优化模型使用和成本。
  • 将 DSH 可观测性集成到现有 OpenTelemetry 管道中，无需添加专有后端。

dsh-plugin DSH 插件适合谁

  • 使用 DeepSeek Harness 构建和部署代理的开发者，需要可观测性。
  • 希望使用 OpenTelemetry 兼容工具在生产环境中监控 DSH 代理行为的 AI 工程团队。

dsh-plugin DSH 插件的限制

  • Beta 版本，尚未稳定到可用于生产环境。
  • 仅支持 DSH 版本范围 >=0.1.0-rc.6 且 <0.2.0。
  • 需要 Node.js 22.19 或更高版本。
  • 内容捕获可能暴露敏感数据（源代码、凭据、个人数据）；必须谨慎使用并确保后端访问控制。

dsh-plugin DSH 插件的仓库 README 摘录

以下文字摘自 dsh-plugin DSH 插件的上游仓库 loongsuite/dsh-plugin 的 README，版权归原作者，仅作引用。

English | [简体中文](README.zh-CN.md) `@loongsuite/dsh-plugin` is a standalone, open-source observability plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`). It observes DSH's native session, agent loop, LLM stream, and tool lifecycle, converts them into OpenTelemetry GenAI traces and metrics, and exports standard OTLP/HTTP protobuf to any compatible backend. LoongSuite is an open-source observability collection ecosystem built on OpenTelemetry. This repository is its native DSH integration. The plugin does **not** depend on or require LoongSuite Pilot, a sidecar, a local JSONL tap, or any particular vendor's backend. > Status: beta release. Install the npm beta with `@loongsuite/dsh-plugin@beta`. The plugin is > listed in the community registry, so it can also be installed from the DSH plugin market. <p align="center"> <img src="docs/assets/langfuse-trace.png" alt="One DeepSeek Harness turn as an OpenTelemetry GenAI trace, viewed in self-hosted Langfuse" width="900"> <br> <em>One DSH turn exported over OTLP into self-hosted Langfuse: four react steps, per-call latency and token counts, a failed <code>web_search</code> followed by <code>b

阅读完整 README仓库许可: Apache-2.0

dsh-plugin DSH 插件常见问题

如何安装 @loongsuite/dsh-plugin？

在 beta 阶段，使用 beta 标签：`dsh plugin --profile <profile> add @loongsuite/dsh-plugin@beta`。将 `<profile>` 替换为配置文件名（例如 web 或 headless）。如果该插件在 DSH 插件市场中列出，也可以从市场安装。

该插件支持哪些后端？

该插件导出 OTLP/HTTP protobuf，因此兼容任何支持 OpenTelemetry 的后端，例如 Jaeger、Langfuse、Grafana Tempo 或任何接受 OTLP 的收集器。快速入门示例使用本地 Collector 和 Jaeger。

如何启用内容捕获？

在启动 DSH 之前设置环境变量 `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=SPAN_ONLY`，或者在插件配置中设置 `captureContent: true`。请注意，这可能会暴露敏感数据；请先审查后端的安全性。

没有 DSH 配置文件可以使用该插件吗？

不行，该插件是按 DSH 配置文件安装的，必须使用 `dsh plugin` 命令将其添加到至少一个配置文件（例如 web 或 headless）中，才能为该配置文件启用可观测性。

兼容哪些 Node.js 和 DSH 版本？

需要 Node.js 22.19 或更高版本。DSH 版本 >=0.1.0-rc.6 且 <0.2.0 受支持。不支持更早的 DSH 候选版本。