前言¶
在 DeepSeek Harness（DSH）裏跑一段智能體會話後，常見的問題是：原始事件很多，但不容易看出 token 到底花在哪一輪、哪個工具最耗時、有沒有上下文壓縮、審批、子 Agent 或 LLM 重試。若要把結果發給協作方，直接貼原始事件也不夠方便。
dsh-session-lens 就是爲這類場景做的 DSH 插件：在會話內生成深度體檢報告，並把會話導出爲自包含單文件 HTML 回放頁。下面介紹它的功能邊界、安裝方式和導出選項。
這是什麼¶
dsh-session-lens 是由 bobostudio 維護的 DSH 插件，定位是「會話洞察與一鍵分享」。
它面向：
@deepseek-ai/dsh >= 0.1.0-rc.6
的 web profile，運行環境要求：
Node >= 20
許可證爲 MIT。
核心功能¶
會話內「洞察」視圖¶
啓用後，會話內會新增「洞察」Tab，用於查看即時分析。會話進行中，該視圖每 5 秒自動刷新。
聚合分析包括：
- Token 用量五段分解：輸入 / 輸出 / 緩存讀 / 緩存寫 / 思維鏈；其中壓縮摘要調用單列。
- 按 Turn 分解：每輪時長、token、工具調用數、錯誤數。
- 工具統計：調用次數、錯誤率、耗時。
- 活動統計：上下文壓縮、審批、子 Agent、LLM 重試。
導出單文件 HTML¶
點擊「導出 HTML」可以下載單文件報告。
導出結果滿足：
- 自包含單文件 HTML 回放頁；
- 零 JavaScript；
- 零外部請求。
導出內容包含完整會話回放、工具調用與結果、審批、上下文壓縮、子 Agent 標記。
界面支持中英雙語，導出語言可選。
隱私與導出邊界¶
dsh-session-lens 的導出邊界比較明確：
- 永不包含系統提示詞；
- 圖片附件永不離開本機；
- 內容安全策略爲
default-src 'none'； - 工具參數/結果默認截斷至
2000字符，可選完整保留； - 路徑脫敏默認開啓，本地路徑自動脫敏爲
~； - 工作目錄之外的絕對路徑默認保留原樣；
- API 路由
/api/session-lens/{analytics,export}僅迴環、GET-only。
如果你要分享導出文件，建議先檢查導出內容，尤其是保留原樣的工作目錄外絕對路徑。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add github:bobostudio/dsh-session-lens
安裝完成後，在 DSH Web 中打開一個會話，點擊「洞察」Tab 查看即時分析。
典型用法¶
1、打開一個會話，點擊「洞察」Tab，查看即時分析。
2、點擊「導出 HTML」，下載單文件報告。
3、導出選項會自動記憶：
- 完整工具結果：默認關閉，默認截斷至
2000字符； - 路徑脫敏：默認開啓；
- 主題：可選；
- 中/English：可選導出文件界面語言。
開發態掛載時，可以用下面命令指向本倉庫的 patch 文件：
dsh web --patch <本倉庫路徑>/cordis.patch.yml
適用場景與注意¶
適合以下場景：
- 需要查看 DSH 會話中的 token 分解、Turn 成本、工具錯誤率；
- 需要查看上下文壓縮、審批、子 Agent、LLM 重試等活動；
- 需要把會話導出爲單文件 HTML 回放頁，用於離線查看或分享；
- 需要控制導出內容中的工具結果、本地路徑和圖片附件。
注意：
- DSH 處於開發者預覽階段，插件依賴的內部接口可能隨版本變動；
- 所有可選服務均做了降級處理；
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證； - 工作目錄之外的絕對路徑默認保留原樣，分享前需自行確認導出內容。
結尾¶
dsh-session-lens 的價值在於把 DSH 會話裏的 token、工具、審批、上下文壓縮、子 Agent 等信息聚合成可閱讀的報告，並把回放導出爲自包含單文件 HTML。
源碼與許可證見 GitHub：
- https://github.com/bobostudio/dsh-session-lens
