dsh-o11y-plugin
Unified observability (trace/log/metric) for deepseek-harness plugins: hooks dsh session telemetry where available, maintains OTel signals where not, and exports via standard OTLP.
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:fly3366/dsh-o11y-plugin说明文档
阅读完整 README ↗
dsh-o11y-plugin
deepseek-harness (dsh) 的统一 插件维度可观测（trace / log / metric）插件。
English | 中文
概述
dsh 自带会话级 OTel 遥测，但未向插件暴露 metric 或插件维度的可观测能力。
dsh-o11y-plugin 收敛该缺口：注册全局 OpenTelemetry providers，使任何使用标准
@opentelemetry/api 的插件都能经由单一、统一配置的管线导出 trace / metric /
log，并将 dsh 会话遥测桥接为 OTel log。面向希望获得标准、社区兼容可观测性而
不愿各自实现 OTel 的插件作者。
兼容性
| 项 | 值 |
|---|---|
| DSH 版本 | @deepseek-ai/dsh 0.1.0-rc.6（Cordis 4.0.1） |
| 最后验证 | 2026-08-14（基于 @deepseek-ai/cordis 4.0.1 的单元测试） |
| Node | ^22.19 || >=24 |
| 适用 profile | headless、web |
基于官方 OpenTelemetry Node.js SDK，与 dsh session-telemetry-otel 同依赖族。
安装 / 卸载
# 安装
dsh plugin --profile web add github:fly3366/dsh-o11y-plugin
# 从某 profile 移除
dsh plugin --profile web remove dsh-o11y-plugin
# 或运行时禁用：enabled=false
插件无状态，移除无需数据清理。
快速开始
dsh plugin --profile headless add github:fly3366/dsh-o11y-plugin
# 可选：指向 collector（无 collector 时静默丢弃）
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 dsh --profile headless "say hi"
任何插件经 @opentelemetry/api 调用 trace.getTracer(...) /
metrics.getMeter(...) / logs.getLogger(...) 即自动导出。
deepjit 为参考使用方，上报管线计数器与
GenAI（gen_ai.*）LLM span。
配置
| 配置 | 默认 | 说明 |
|---|---|---|
enabled | true | 总开关 |
serviceName | dsh-plugin | OTel resource service.name |