返回目录

tencentcloud-agentobs-sdk-dsh

精选清单收录维护状态: 活跃

tencentcloud/tencentcloud-agentobs-sdk-dsh

tencentcloud-agentobs-sdk-dsh 是一个 DeepSeek Harness (DSH) 可观测插件,直接将 GenAI trace 数据上报到腾讯云日志服务 (CLS)。 它观察 DSH 原生的 session、agent loop、LLM stream 和 tool 生命周期,将其转换为 腾讯云AI Agent可观测规范的 5 层 span 层级模型(entry → agent → step → chat → tool),并通过 tencentcloud-cls-sdk-js 直接上报到 CLS,无需额外部署 OTLP 收集器或 sidecar。

前往 GitHub项目主页
$ npm install -g @deepseek-ai/dsh

15

星标

3

Fork

TypeScript

语言

Apache-2.0

许可证

2026-08-18

创建于

2026-08-26

最近推送

腾讯云出品的 Apache-2.0 DSH 插件,把 GenAI trace 直传腾讯云 CLS:entry/agent/step/chat/tool 五层 span 模型、Protobuf 上报无需收集器、可调的批量与重试,以及内容捕获开关。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-21

许可证

Apache-2.0

01它能帮你完成什么?

  • 不搭收集器就把 DSH 的 GenAI trace 送进腾讯云 CLS

    一次 DSH turn 变成 ENTRY → AGENT(invoke_agent)→ STEP(react round_N)→ CHAT / TOOL 的 span,由插件进程直接以 Protobuf 上报

    已经在用腾讯云 CLS 收日志、希望 agent trace 也放在一起而不是另跑一条 OTLP 链路的团队

  • 控制什么内容离开本机、以及量有多大

    `captureContent`(或标准的 `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` 环境变量)可以关掉 prompt / response / tool 内容而保留 span 结构;`enabled: false` 只暂停采集、不卸载插件

    需要 trace 做延迟与错误分析,但不能把源码或凭证送进日志服务的运维者

02如何接入 DeepSeek Harness?

前置条件

  • DeepSeek Harness `>=0.1.0-rc.6 <0.2.0`(README 的兼容性表把上界卡在 0.2.0 之前)
  • Node.js 18.0.0 或更高版本
  • CLS 的接入点与日志主题 ID,以及 SecretId/SecretKey 或纯数字 UIN 二选一的鉴权信息

安装步骤

  1. 01

    还没装 DSH CLI 的话先全局安装:`npm install -g @deepseek-ai/dsh`。

    $ npm install -g @deepseek-ai/dsh

  2. 02

    按你用的 profile 安装:`dsh plugin --profile web add tencentcloud-agentobs-sdk-dsh`(`headless`、`harness` 同理)。

    $ dsh plugin --profile web add tencentcloud-agentobs-sdk-dsh

  3. 03

    如果 pnpm v9+ 拦下了 protobufjs 的 install 脚本(`ERR_PNPM_IGNORED_BUILDS`),在对应 profile 目录(如 `~/.dsh/profiles/web`)里执行一次 `echo "enable-scripts=true" >> .npmrc` 和 `pnpm install`。

  4. 04

    重启 DSH 服务——README 说明安装或更新后必须重启才生效。

  5. 05

    用环境变量(`CLS_ENDPOINT`、`CLS_TOPIC_ID`、`CLS_SECRET_ID`/`CLS_SECRET_KEY` 或 `CLS_UIN`、`CLS_SERVICE_NAME`)或 `$DSH_HOME/profiles/<profile>/cordis.patch.yml` 配置;显式插件配置优先于环境变量。

验证接入成功

作者未说明

回滚

  • `dsh plugin --profile web remove tencentcloud-agentobs-sdk-dsh`——装了 `headless` / `harness` 的话同样执行一遍。

03DSH 适配与能力边界

DSH 适配原生运行时

原生 DSH 可观测插件:挂接 DSH 的 session、agent loop、LLM stream 与 tool 生命周期,通过 `tencentcloud-cls-sdk-js` 直接上报到腾讯云 CLS,不需要 OTLP 收集器或 sidecar

  • 五层 GenAI span 模型

    DSH 的 session 事件、agent loop 轮次、LLM stream 与 tool 调用→符合腾讯云 AI Agent 可观测规范的 ENTRY / AGENT(invoke_agent)/ STEP(react round_N)/ CHAT(chat model_name)/ TOOL(execute_tool tool_name)span

    span 由插件自身通过 `tencentcloud-cls-sdk-js` 以 Protobuf 上报,不部署收集器或 sidecar
  • 批量、队列与重试控制

    `batchMaxSize`(32)、`flushIntervalMs`(5000)、`maxQueueSize`(2048)、`retryTimes`(3)、`debug`→按间隔刷新有上限的批次,上报失败会重试

    队列满时丢弃最旧的 span,而不是把 agent 阻塞住
  • 内容捕获与截断范围

    `captureContent`(默认 true)、`contentMaxChars`(128000),或环境变量 `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`→把 prompt、response 与 tool 参数/结果附加到 span 上(按属性截断),或完全不采集

    `cordis.patch.yml` 里的显式插件配置优先于环境变量

04适合谁?何时不该用?

适合

  • 已经在用腾讯云 CLS 收日志、希望 agent trace 也放在一起而不是另跑一条 OTLP 链路的团队
  • 需要 trace 做延迟与错误分析,但不能把源码或凭证送进日志服务的运维者

不适合

  • 文档给出的 DSH 范围是 `>=0.1.0-rc.6 <0.2.0`,Node.js `>=18.0.0`;装在 0.2.x 宿主上不在支持矩阵内。
  • 内容捕获默认开启,源代码、凭证、个人数据等敏感内容可能被发送到 CLS。可用 `captureContent: false` 或 `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=false` 关闭,并确认 CLS 的数据保留与访问控制策略符合安全要求。
  • `maxBatchBytes` 必须小于 SDK 的 19MB 硬限制,否则整批会在本地被拒;`maxQueueSize` 满了之后最旧的 span 会被丢弃。

05兼容性、维护与安全提示

  • 文档给出的 DSH 范围是 `>=0.1.0-rc.6 <0.2.0`,Node.js `>=18.0.0`;装在 0.2.x 宿主上不在支持矩阵内。
  • 内容捕获默认开启,源代码、凭证、个人数据等敏感内容可能被发送到 CLS。可用 `captureContent: false` 或 `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=false` 关闭,并确认 CLS 的数据保留与访问控制策略符合安全要求。
  • `maxBatchBytes` 必须小于 SDK 的 19MB 硬限制,否则整批会在本地被拒;`maxQueueSize` 满了之后最旧的 span 会被丢弃。
2026-08-182026-08-26v0.0.1

Apache-2.0 · 由腾讯云(TencentCloud)发布(最新 release v0.0.1,2026-08-18;最后推送 2026-08-26)

06常见问题

需要自己搭 OTLP 收集器吗?

不需要。插件直接调用 `tencentcloud-cls-sdk-js` 上报 Protobuf 批次,没有收集器或 sidecar 要部署,只要一个接入点和一个日志主题 ID。

支持哪些 DSH 版本?

README 的兼容性表写的是 DeepSeek Harness `>=0.1.0-rc.6 <0.2.0`,Node.js `>=18.0.0`。

我的提示词和代码会被送到 CLS 吗?

默认会。`captureContent` 是 `true`,prompt、response 与 tool 参数/结果都会附加到 span 上。设 `captureContent: false` 或导出 `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=false`,就能只保留 span 结构、不带载荷。

安装时报 ERR_PNPM_IGNORED_BUILDS 怎么办?

pnpm v9+ 默认禁止依赖包运行 install 脚本。在出问题的 profile 目录(例如 `~/.dsh/profiles/web`)把 `enable-scripts=true` 追加进 `.npmrc`,再跑一次 `pnpm install`;之后的安装与更新不再需要。

怎么卸载?

`dsh plugin --profile web remove tencentcloud-agentobs-sdk-dsh`;装过 `headless` 与 `harness` 的话各执行一遍。之后重启 DSH 让卸载生效。

08数据与来源

  • 作者声明github.come46575d24323…

    `tencentcloud-agentobs-sdk-dsh` 是一个 DeepSeek Harness (DSH) 可观测插件,直接将 GenAI trace 数据上报到腾讯云日志服务 (CLS)。

  • 作者声明github.come46575d24323…

    它观察 DSH 原生的 session、agent loop、LLM stream 和 tool 生命周期,将其转换为腾讯云AI Agent可观测规范的 5 层 span 层级模型(entry → agent → step → chat →…

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-21。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。