前言¶
在 DSH Web UI 裏做智能體對話時，輪次、Token 用量和上下文佔用往往分散在自帶的小組件裏，數字也不夠細。若你希望在同一條輸入框（composer）下方看到整段會話的統計、累計 Token 明細以及上下文構成，而不用反覆點開多處入口，可以裝一個客戶端插件，把信息收成一張遙測卡片。
下面介紹社區插件 dsh-session-telemetry（npm 包名 @cendo91/dsh-session-telemetry），維護者爲 cendo91，歸類爲客戶端插件。
這是什麼¶
dsh-session-telemetry 是一個 DSH Web UI 插件：在 conversation.composer.dock（輸入框下方停靠區）渲染一張遙測卡片，跟隨當前活躍會話，彙總三類指標：
- 當前會話（Current session）：整段會話的輪次與步數、模型/工具耗時、首 token 延遲、解碼速度等。
- Token 用量（Token usage）：累計未緩存輸入、緩存讀、緩存寫、輸出、總計，以及緩存命中率。
- 上下文已用（Context used）：上下文佔用環、已用/容量數值，以及 system / tools / messages 的構成條。
啓用後會替換 DSH 自帶的 activity、usage 膠囊，並隱藏自帶的上下文佔用環，避免同一套數字顯示兩次。插件不新增 projection、工具、提示段、模型輸入、網絡請求或會話事件；除自身 React 樹外不寫 DOM。
核心功能¶
展示位置與數據從哪來¶
卡片通過 composer dock 標準的 useProjection 與 useSession 取數，來源如下（資料原文表格）：
| Projection | 來源 | 用途 |
|---|---|---|
sessionStats |
@deepseek-ai/dsh-session-stats（由本 bundle 注入） |
輪次、步數、LLM/工具時間、解碼速度 |
tokenUsage |
@deepseek-ai/dsh-token-meter |
輸入、緩存、輸出 Token |
contextPressure |
@deepseek-ai/dsh-token-meter |
上下文佔用與容量 |
contextBreakdown |
@deepseek-ai/dsh-token-meter |
system/tools/messages 構成 |
界面與本地化¶
- 表面、文字、邊框僅使用
--dsw-alias-*主題 token。 - 通過 Client locale 服務支持英文與簡體中文；文案在
locale/en.json、locale/zh.json。 - 條圖與環圖爲內聯 SVG/CSS，不用圖片或 canvas。
- 強調色使用藍、紅、黃、綠、橙；分段之間用分隔線，無外邊線。
- 上下文環在其分區右側，三個分區的條圖共用一條基線。
- 卡片佔滿 composer 可用寬度（上限爲
--dsh-composer-card-max-width）；視口寬度低於 560px 時三節縱向堆疊。 - 運行指示器遵循
prefers-reduced-motion。
依賴與環境¶
README 寫明：DeepSeek Harness 0.2.x 且帶 Web UI；無需構建步驟或額外運行時依賴。package.json 中 engines.dsh 爲 ^0.2.2-rc.1。許可證爲 MIT。
安裝與啓用¶
- 打開 Settings → Plugins → Add（中文界面：設置 → 插件 → 添加）。
- 在添加框中填入以下其一（版本以 README 安裝說明爲準）：
# npm
@cendo91/dsh-session-telemetry@1.0.0
# GitHub
github:cendo91/dsh-session-telemetry#v1.0.0
# 本地檢出（絕對路徑，示例爲 Windows）
C:\path\to\session-telemetry
- 安裝完成後刷新頁面。bundle 會注入
sessionStats的 host projection，並註冊 Client 插件行。
中文說明中給出的簡寫安裝串爲：
@cendo91/dsh-session-telemetry@1.0.0
或使用 GitHub 地址 github:cendo91/dsh-session-telemetry#v1.0.0，同樣需在安裝後刷新。
典型用法¶
沒有單獨的配置文件或 CLI 步驟：安裝並刷新後，在已有 Session 的對話裏打開 composer，卡片會自動出現在輸入框下方。
- 有活躍 Session 時，三節內容隨會話更新。
- 無 Session 時不渲染任何內容。
- 上下文佔用環需提供方上報用量且路由給出 context window 後纔會出現。
適用場景與注意¶
適合誰：經常在 DSH Web UI 里長對話、需要盯着 Token 緩存命中率、上下文佔比和 system/tools/messages 拆分的開發者。
使用限制（README Limits）：
- 卡片只跟隨 composer 的當前 Session。
contextBreakdown來自 token meter 的啓發式構成，是近似值，不與提供方計費壓力逐項對齊。- 環圖在 100% 處鉗制，數值分子仍可能大於容量。
- 隱藏自帶上下文環依賴較窄的 DOM/CSS 兼容規則；若未來 composer 改版，選擇器可能需要更新。
安全與權限：插件隨 DSH 客戶端在瀏覽器中運行，讀取的是 UI 已有的 projection 數據；安裝前仍建議查看 GitHub 倉庫 源碼與 MIT 許可證，確認與你的工作流一致。
結尾¶
dsh-session-telemetry 把會話統計、Token 明細和上下文構成收到 composer 下方一張卡里，並關掉重複的原生組件。社區目錄頁：https://www.skillhub.cn/plugins/cendo91/dsh-session-telemetry；源碼與說明：https://github.com/cendo91/dsh-session-telemetry。DSH 生態以插件擴展能力爲主，SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。
