dsh-session-export:將 DSH 會話導出爲 Markdown 與 JSON

前言

在 DSH 中,一次會話結束後,開發者常需要把對話記錄拿出來歸檔、閱讀、分享或交給後續流程處理。dsh-session-export 解決的是這個具體問題:把當前 DSH 會話導出成可移植、人類可讀的 Markdown,以及結構化 JSON。

它是 DSH 的社區插件,由 bwndlct 維護。DSH 的插件生態方向是「一切皆插件」;社區目錄是獨立站點,不與 DeepSeek / 幻方構成官方從屬關係,也不是官方應用商店。

這是什麼

bwndlct/dsh-session-export 是一個 DSH 插件,將 DeepSeek Harness(DSH)會話導出爲可移植、人類可讀的 Markdown 和結構化 JSON 文件。

許可證:MIT。

核心功能

下面介紹已覈實的幾類能力。

兩種入口

1、session_export() 工具:可讓模型執行導出。

2、/session-export 斜槓命令:在 Web UI 中觸發導出。

兩種格式

  • Markdown:人類可讀的會話導出文件。
  • JSON:結構化導出文件,包含 schemaVersion,採用穩定的導出 schema。

順序與健壯性

  • 按用戶消息、助手消息、工具調用、工具結果的發生順序還原會話。
  • 對未知事件類型、缺失元數據、代碼圍欄、超大工具結果等做了健壯處理。
  • 超過 8,000 字符的工具結果會被截斷並標記。

文件名與運行時

  • 生成跨平臺安全的文件名。
  • 不會覆蓋已有文件;重名導出文件會追加 -1-2 等後綴。
  • 運行時零依賴,僅使用 TypeScript 與 Node 內置模塊。

安裝與啓用

需要 dsh >= 0.1.0-rc.6。該插件基於 @deepseek-ai/dsh 0.1.0-rc.6(DSH Developer Preview)構建和驗證。

1、執行安裝命令:

dsh plugin --profile web add dsh-session-export

2、把插件加入當前 profile 的 package.jsonbundles 列表。配置項形如:

"dsh": {
  "profile": {
    "bundles": [
      "dsh-session-export"
    ]
  }
}

3、重啓 dsh

注意:斜槓命令僅在掛載了 commands 服務的 profile(如 web)中註冊;session_export() 工具在所有 profile 下均可使用。

典型用法

讓模型導出

對模型說:

把當前會話導出成 Markdown
Export this session, json only

在 Web UI 中導出

/session-export
/session-export markdown
/session-export json

也可以只導出某一格式:

/export-md
/export-json

適用場景與注意

適合:

  • 需要把當前 DSH 會話留檔爲 Markdown 或 JSON 的人。
  • 需要查看、分享會話記錄的人。
  • 需要在 Web UI 中用斜槓命令觸發導出的人。

注意:

  • 插件以當前 dsh 進程權限運行,安裝前應檢查源碼與 MIT 許可證。
  • 導出文件可能包含敏感數據,本插件不做脫敏處理。
  • 斜槓命令需要在掛載 commands 服務的 profile(如 web)中使用。
  • 分享導出文件前,請先檢查其中可能包含的源代碼、工具參數、工具結果和路徑等信息。

結尾

dsh-session-export 的價值在於把 DSH 會話轉成穩定、可讀、可攜帶的 Markdown/JSON 文件,便於後續歸檔和工具鏈處理。

GitHub:https://github.com/bwndlct/dsh-session-export。社區目錄地址未在本文事實中確認,因此不附具體 URL;可按插件名 dsh-session-export 在 DSH 社區目錄檢索。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜