前言¶

DSH 開發者在處理會話軌跡時，往往需要一份結構化的復盤材料。手動整理耗時且容易遺漏關鍵步驟。下面介紹 dsh-trace-narrator 插件，它可以直接將一次會話軌跡轉化爲脫敏的報告。

這是什麼¶

這是一個 DSH 插件，由 xiangyun0519 維護。它的功能是把一次會話 trajectory 變成脫敏的結構化報告，支持 HTML、Markdown 和 JSON 輸出。

核心功能¶

該插件提供以下能力：

• 生成結構化報告。
• 支持 HTML/Markdown/JSON 輸出。
• 內置 5 套 schema。
• 支持中英日三語。
• 默認嚴格脫敏。
• 數據不出本地。
• Agent/Inbox 集成複述總結。
• Schema 校驗。

安裝與啓用¶

安裝命令如下：

dsh plugin --profile web add dsh-trace-narrator

安裝完成後，在任意 DSH 會話中即可使用。

典型用法¶

• 基礎使用，默認生成當前會話的結構化報告：

    /trace-narrate

• 指定會話、schema、語言和格式：

    /trace-narrate sess_abc --schema postmortem --lang en --format md

• 使用自定義 schema 並調整脫敏級別：

    /trace-narrate --schema ./my-schema. --redact minimal

• 指定輸出格式和本地路徑：

    /trace-narrate --format  --output ./trace-narrate

適用場景與注意¶

該插件適合復盤會話、交接或教學場景，利用內置 schema 將長 trajectory 壓縮後交給 LLM 總結並生成報告。

需要注意以下幾點：

• 這是一個本地插件，不是公共在線報告站點。
• 插件不負責實時採集、多會話合併或雲端 viewer。
• 報告默認落在本地；需要多人訪問時，請自行提供受控的 viewer 和上傳端點。
• 默認嚴格脫敏，上傳是 opt-in 且只接受 HTTPS。
• 使用前應檢查源碼與許可證。

結尾¶

該插件通過命令行接口即可生成合規的結構化報告，適合需要在本地處理軌跡數據的開發者。相關代碼與文檔可前往 GitHub 倉庫 查看。