騰訊雲出品的 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 個值得優先安裝的外掛,涵蓋各個分類。
