前言¶
在 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.json 的 bundles 列表。配置項形如:
"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 社區目錄檢索。