返回目錄

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 外掛,絕不濫發。