DeepSeek Harness (dsh) 的核心設計理念是“一切皆插件”，這使得用戶可以通過擴展來滿足特定的業務需求。在智能體開發與運維場景中，導出會話記錄常用於審計或合規歸檔。然而，直接導出的原始文本往往包含敏感信息，如 API 密鑰、JWT 令牌、環境變量或絕對路徑。dsh-session-export 旨在解決這個問題。它作爲一個依賴項，將任何當前或歷史會話轉化爲可驗證、已去敏的歸檔，並提供相應的管理工具。
這是一個 Session export, redaction and compliance archiving bundle for DeepSeek Harness (dsh)。該插件由 JohnXu22786 維護，採用 MIT 許可證。它不依賴模型本身，而是通過基於規則的引擎進行去敏處理，支持多種輸出格式，並具備完整的歸檔管理能力。
核心功能¶
該插件提供以下核心能力：
-
默認確定性去敏
默認開啓去敏模式，通過規則移除敏感數據。支持處理的敏感項包括：API 密鑰、JWT 令牌、高熵值令牌、.env風格的配置行、URL 憑據以及絕對路徑。去敏後的值會攜帶一個加鹽的 SHA-256 指紋（12位十六進制字符），確保歸檔文件在不同機器間保持可關聯性，而不會泄露原始祕密。該指紋由祕密值本身決定，與匹配到的規則無關。 -
多種輸出格式
支持將導出結果保存爲 Markdown（適合人類閱讀）、JSONL（機器可讀）、PDF（打印就緒）或全部格式。 -
歸檔管理
導出的文件按 session 和日期組織，存儲在默認目錄$DSH_HOME/exports（即~/.dsh/exports）下。歸檔支持搜索、列出和刪除操作，且在刪除操作中實現了路徑遍歷防護，確保只能訪問歸檔根目錄內的文件。 -
合規元數據
每個導出文件都會嵌入一個包含元數據的頭部，記錄 session id、使用的模型、去敏級別、事件計數以及可選的 SHA-256 內容哈希。此外，插件還提供/export-audit斜槓命令，用於按天、格式、session 或去敏級別聚合查看導出趨勢。 -
無模型依賴
去敏過程基於規則，不依賴大模型。如果需要更高級的去敏效果，可通過配置啓用可選的 LLM 輔助遮罩。
安裝與啓用¶
安裝該插件需要 DeepSeek Harness 環境以及 Node.js 20+（推薦 Node 24+ 以運行源碼測試）。
安裝命令如下：
dsh plugin --profile demo add github:JohnXu22786/session-export
安裝完成後，插件會自動注入配置，默認輸出目錄爲 $DSH_HOME/exports。你可以通過配置文件覆蓋該設置。
典型用法¶
插件提供工具和斜槓命令兩種調用方式。
工具命令¶
在 DSH 的上下文中，可以直接調用以下工具：
session_export { format?, sessionId?, redact? }
導出一個會話。如果未指定format，則使用默認格式。redact參數控制是否去敏，默認爲開啓。session_export_list { query?, sessionId?, format?, before?, after?, limit? }
列出或搜索歸檔。可以通過 session id、日期範圍或格式進行篩選。export_delete { target }
根據 archive id 或文件名刪除歸檔。
斜槓命令¶
用戶可以直接在對話中輸入以下命令：
/session-export：觸發會話導出。/session-export-list：查看導出列表。/export-delete：刪除指定歸檔。/sanitize-config：查看或修改去敏配置。/export-audit：查看合規審計趨勢。
適用場景與注意¶
該插件適合需要滿足合規要求、對數據安全性有高要求的 DSH 用戶。
- 環境要求：必須配置一個包含 base bundle 的 DeepSeek Harness profile，該 profile 需提供
sessions、sessionPersistence、tools和commands等基礎服務。 - 運行權限：插件以當前 DSH 進程的權限運行，因此在安裝前應檢查源碼與許可證。
- 數據安全：去敏指紋使用加鹽 SHA-256 生成，以保持可關聯性。索引寫入在進程內串行化，防止併發調用導致數據丟失。
總結¶
dsh-session-export 爲 DeepSeek Harness 提供了一套完整的會話導出與合規歸檔方案。它通過默認的確定性去敏機制解決了敏感信息泄露的問題，並通過歸檔管理和審計視圖滿足了運維與合規的需求。所有功能均通過命令行和斜槓命令提供，無需額外開發即可集成。
