腾讯云出品的 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 二选一的鉴权信息
安装步骤
- 01
还没装 DSH CLI 的话先全局安装:`npm install -g @deepseek-ai/dsh`。
$ npm install -g @deepseek-ai/dsh
- 02
按你用的 profile 安装:`dsh plugin --profile web add tencentcloud-agentobs-sdk-dsh`(`headless`、`harness` 同理)。
$ dsh plugin --profile web add tencentcloud-agentobs-sdk-dsh
- 03
如果 pnpm v9+ 拦下了 protobufjs 的 install 脚本(`ERR_PNPM_IGNORED_BUILDS`),在对应 profile 目录(如 `~/.dsh/profiles/web`)里执行一次 `echo "enable-scripts=true" >> .npmrc` 和 `pnpm install`。
- 04
重启 DSH 服务——README 说明安装或更新后必须重启才生效。
- 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 的 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 会被丢弃。
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 让卸载生效。
07相关的 DSH 工作流
dsh-univer-office
作者 dream-num
在 DSH 内预览、创建与编辑表格、文档和幻灯片,由 Univer 驱动
clearai-dsh
作者 clearailhc
ClearAI:以本体为纲的原生 DSH 插件 —— 经证据核验的研究长成可浏览的领域本体。 · ClearAI: an ontology-first DSH agent preset — evidence-checked research that grows into a domain ontology.
dsh-fish-memory
作者 yuuyuko-uu
🐋 DSH 鱼的记忆:给会话一份会淡忘的长期记忆,每条都带时间。名字里的「鱼」来自 DeepSeek 的鲸鱼。
dsh-trading
作者 zhu1090093659
基于 DeepSeek Harness 的智能体原生交易终端,三栏界面聚合币圈、美股、A股与港股,内置 19+ 可热插拔连接器,默认模拟交易并需人工确认。
08数据与来源
`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 →…
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-21。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
