PerryLink/dsh-observe

Plugin插件 Native原生 ⭐ 12 Apache-2.0 Usage & Cost用量与计费Prompts & Skills提示词与技能

用于DeepSeek Harness的OpenTelemetry和Langfuse可观测性导出器:轮次/步骤/工具/LLM跨度、token与成本指标、脱敏提示/完成捕获、异步批处理、有界离线缓冲、带退避的重试

Project Overview项目介绍

dsh-observe is a native plugin built exclusively for DeepSeek Harness (DSH) that captures DSH’s session event stream and converts it into standard OpenTelemetry observability data. It can export tracing and metrics to an OpenTelemetry OTLP endpoint, or send LLM observation data to Langfuse, or both, depending on your configuration. The plugin generates structured spans for each conversation turn, tool call, and LLM generation step, and tracks token usage and estimated cost per model and provider. To install, you can use DSH’s built-in plugin CLI, pulling either from the main git branch for the latest development version or from npm for stable published releases.

This plugin is designed for DSH users who need to track LLM usage costs, debug multi-step conversation workflows, or aggregate usage statistics across team members. Data collection is disabled by default, so you must explicitly enable it and configure at least one backend destination to start capturing events. All exported data is automatically sanitized to remove matching secrets and sensitive information, and you can add custom patterns to redact any additional private content you want to keep hidden.

The plugin requires Node.js version ^22.19.0 or >=24.0.0, and is verified compatible with DeepSeek Harness v0.1.5-rc.2 and newer. It uses async batching and a bounded persistent offline buffer to prevent data loss during network outages, and includes a remote kill switch to pause or resume exporting without restarting DSH. It is released under the open-source Apache 2.0 license, and after installation you can run dsh --profile web --dump-config | grep -A2 'id: dsh-observe' to verify it is mounted correctly.

dsh-observe 是专为 DeepSeek Harness (DSH) 开发的原生可观测性插件,用于将 DSH 的会话事件流转换为符合 OpenTelemetry 标准的追踪数据和性能指标,同时支持导出到 Langfuse 平台实现 LLM 全链路可观测。它会自动生成对话轮次、工具调用、LLM 生成的追踪跨度,同时统计不同模型和服务商的 token 用量与预估使用成本。用户可以通过 DSH 官方插件命令行完成安装,支持 git 仓库开发版和 npm 发布版两种安装渠道。

这个插件适合需要追踪 LLM 使用成本、调试多轮对话链路、统计团队使用情况的 DSH 用户。默认情况下数据采集功能处于关闭状态,用户需要手动开启并配置至少一个后端(OpenTelemetry 或 Langfuse)才会开始采集数据。所有输出的数据都会经过内置敏感信息脱敏处理,用户还可以添加自定义的脱敏规则来隐藏业务或个人敏感内容。

本插件要求 Node.js 版本为 22.19.0 以上或 24.0.0 以上,兼容 DeepSeek Harness v0.1.5-rc.2 及以上版本。它采用异步批量处理和持久化离线缓冲,保证数据不会因为网络问题丢失,还支持远程开关控制导出功能。插件采用 Apache 2.0 开源协议,免费使用,用户可以在安装后通过 DSH 配置转储命令验证插件是否正确挂载。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 12 stars - an early-stage project星标 12,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-observe

把 PerryLink/dsh-observe 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

📊 dsh-observe

  • 1024 store channel: npm i -g dsh1024 once, then dsh1024 plugin --profile web add dsh-observe (counts toward the deepseek1024.com install ranking). Gitee dshfind OpenSSF Scorecard

OpenTelemetry and Langfuse observability exporter for DeepSeek Harness.

Turn session events into OTLP traces and Langfuse observations — sanitized, buffered, off by default.

License DSH plugin dsh-doctor DSH Market Node CI Version npm version npm downloads

English · 简体中文 · Español · Português · हिन्दी


⭐ 如果它帮到了你

这个插件是 DSH 插件家族的一员(40+ 个,全部 Apache-2.0)。如果你在用,给个 star —— 它不会解锁任何功能,但会让下一个人在搜索里更容易找到它。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-token-usage 下一个 Next dsh-harness-mcp-server →