前言¶
DeepSeek Harness (DSH) 用戶在長期使用中會產生大量的會話歷史。直接查看原始日誌很難快速把握工作流效率、習慣或瓶頸。該插件通過讀取 DSH 的 sessionQuery 服務，將原始會話轉化爲結構化的本地回顧報告，幫助回答諸如“哪種工作類型花費最多精力”或“哪裏出現了工具故障或重試”等問題。
插件信息¶
- 名稱：dsh-session-insights
- 定位：工作流回顧插件
- 作者：GreenLv
- 許可證：MIT
核心功能¶
該插件生成包含會話歷史的本地 HTML 儀表板和 JSON 報告，提供以下視圖：
* 概覽與時間對比：查看會話、任務家族、Token 使用量及兩個時間段的變化。
* 工作流分解：分析項目、角色、代表性工作流及完成證據。
* 使用模式：查看每日活躍時間趨勢、會話類型、工具/插件/MCP 使用、文件類型及本地活躍時段。
* 贏與摩擦：基於證據的強度識別，以及失敗的信號、重試等需要調查的事項。
* 推薦：基於測量證據的 DSH 工作流建議及可複製的提示詞。
此外，它支持離線報告、多種隱私模式以及通過 CLI 和原生命令的自動化。
安裝與啓用¶
該插件需要 DeepSeek Harness 和 Python 3.11 或更新版本。當前驗證的兼容基線爲 DSH 0.1.5-rc.2。
- 安裝插件包：
dsh plugin --profile web add dsh-session-insights
- 啓動對應的 Profile：
dsh web
典型用法¶
在 DSH 的 Composer 中運行原生命令以生成回顧報告：
/session-insights --days 30 --locale en
該命令會將結果寫入 $DSH_HOME/insights/runs/<run-id>。
對於自動化或非 Bundle 環境，可以使用 CLI 工具：
python3 scripts/bootstrap.py install --dsh-home "$DSH_HOME"
然後通過 CLI 查看報告：
dsh-session-insights report --dsh-home "$DSH_HOME" --days 30 --locale en --format html --output ./dsh-insights.html
適用場景與注意事項¶
該插件是行爲回顧工具，而非遙測或質量判斷工具。它不提供實時監控或賬單計算。
- 隱私控制：插件提供三種隱私模式（
redacted、metrics、local），用於控制報告內容和語義分析階段的數據保留。 - 文件位置：生成的報告會被拒絕放入
$DSH_HOME/sessions目錄，以確保與源日誌樹分離。 - 依賴檢查：安裝前請確保系統環境滿足 Python 3.11+ 和 DSH 0.1.5-rc.2 的要求。
生態背景¶
該插件可通過 npm、GitHub Releases 或社區目錄（如 dsh.pub）獲取。
