前言¶

DeepSeek Harness（DSH）的理念是「一切皆插件」。在智能體開發中，調試往往面臨信息缺失的問題：我們只能看到輸入和最終輸出，卻無法追蹤中間的思考過程、工具調用鏈或報錯原因。

dsh-plugin-session-export 是 zhaoxuejie 維護的插件，屬於「記憶」分類。它通過旁路監聽的方式採集會話事件，不干擾 Agent 的正常運行。在需要復盤、調試或分享工作流時，它可以一鍵生成結構化的復盤報告。

安裝與啓用¶

前置條件¶

• DeepSeek Harness（dsh）已安裝並可運行。
• Node.js >= 18。

步驟¶

1. 獲取插件

    git clone https://github.com/zhaoxuejie/dsh-plugin-session-export.git

2. 在 dsh profile 中註冊
   編輯你的 dsh profile 的 package.json（通常位於 ~/.dsh/profiles/<profile-name>/package.json）。
   在 dependencies 中添加本地 link 依賴，並在 dsh.profile.bundles 中註冊：

    {
      "dependencies": {
        "dsh-plugin-session-export": "link:/path/to/dsh-plugin-session-export"
      },
      "dsh": {
        "profile": {
          "bundles": ["dsh-plugin-session-export"]
        }
      }
    }

3. 安裝依賴

    cd ~/.dsh/profiles/<profile-name>
    pnpm install

4. 重啓 dsh

    dsh web

啓動後，右上角導航欄應出現「會話黑匣子」按鈕。

核心功能¶

• 全量事件採集：訂閱 session/event，按會話隔離維護事件時間線，覆蓋輪次起止、用戶輸入、模型回覆、工具調用/返回、請求報錯。
• 快照補錄：插件加載後自動補錄加載前已發生的事件，避免歷史對話丟失。
• 雙格式導出：支持導出 Markdown 結構化文本和 HTML 自包含單文件。
• 實時統計：統計輪次數、工具調用分佈、總耗時、平均輪次耗時、報錯/中斷數、Token 用量。
• 智能截斷：單條文本超過 maxContentLength 會自動截斷並標註。
• 敏感脫敏：工具入參中的 api_key、token、password 等字段會自動掩碼。
• Web 面板：右上角導航欄按鈕，展示統計卡片與圖表，支持一鍵導出/清空。
• 配置熱更新：settings 服務 applies: live，改動即時生效。

使用方法¶

自然語言¶

直接對模型說以下指令：
* 「導出當前會話」
* 「生成復盤報告」
* 「會話統計」
* 「清空會話記錄」

工具調用¶

• export_session(session?, format?)
  • 參數：session（會話 ID，缺省最近活躍）、format（markdown / html / both）。
  • 作用：導出當前會話復盤報告。
• session_stats(session?)
  • 參數：session（缺省返回全部會話概覽）。
  • 作用：獲取會話統計數據。
• session_clear(session?)
  • 參數：session（缺省清空全部）。
  • 作用：清空會話記錄。

Web 面板¶

點擊右上角「會話黑匣子」按鈕，面板展示實時統計卡片、工具調用次數分佈條形圖以及導出/清空按鈕。

配置項與報告結構¶

配置項¶

在 dsh 設置面板中可調整以下配置（支持熱更新）：

• enable (boolean, 默認 true)：插件總開關。
• autoRecord (boolean, 默認 true)：自動旁路採集。
• maxContentLength (number, 默認 2000)：單條文本導出最大字符數。
• includeToolArgs (boolean, 默認 true)：是否保留工具入參。
• includeReasoning (boolean, 默認 true)：是否包含模型思考過程。
• exportFormat (enum, 默認 markdown)：工具缺省導出格式。
• htmlTheme (enum, 默認 light)：HTML 報告配色主題。
• maxEventsPerSession (number, 默認 500)：單會話事件上限。

報告結構¶

導出的報告包含以下內容：
1. 會話概覽：ID、起止時間、總耗時、輪次、工具調用、報錯、Token 用量。
2. 輪次時間軸：橫向可視化每輪耗時與狀態。
3. 逐輪復盤：用戶輸入 → 工具調用鏈 → 模型回覆 → 狀態與耗時。
4. 工具調用統計：工具名、調用次數、平均耗時、最長耗時。
5. 報錯彙總：時間、輪次、類型、錯誤消息。
6. 原始事件流：完整採集時間線。

適用場景與注意¶

該插件適合需要詳細復盤 Agent 行爲的開發者。安裝方式爲本地 link 依賴，需編輯 profile 的 package.json。請務必檢查源碼與許可證（MIT）後再在生產環境使用。插件以當前 dsh 進程權限運行，敏感信息會自動掩碼。

dsh-plugin-session-export¶

• 倉庫：https://github.com/zhaoxuejie/dsh-plugin-session-export
• 作者：zhaoxuejie
• 類別：記憶