DeepSeek Harness (DSH) 的 Web 會話通常包含調試日誌、推理過程或敏感憑證。官方導出的 Session ZIP 文件雖然完整,但體積較大且包含大量元數據。對於代碼審查、問題復現或知識傳遞,開發者往往需要一份更輕量、且經過脫敏處理的結果文檔。
dsh-local-share 是一個社區維護的插件,它爲 DSH Web 會話頭部新增了 Share 操作。該插件允許用戶在本地生成 Markdown、自包含 HTML 或長圖,且不涉及任何雲上傳或後端請求,專注於隱私保護。
插件定位¶
- 名稱:dsh-local-share
- 維護者:ChuanTianML
- 類別:客戶端
- 許可證:MIT
- 狀態:開發者預覽
核心能力¶
該插件提供以下本地化分享功能:
- 多格式輸出:支持將選中的對話回合或整個 Session 導出爲 Markdown、自包含 HTML 文件,或長圖 PNG。
- 隱私優先:默認不包含工具結果、推理過程、系統提示等元數據;所有生成均在本地瀏覽器完成,無網絡請求。
- 安全渲染:助手文本使用安全的 GitHub Flavored Markdown (GFM) 渲染,人類輸入保持原文,防止 XSS 風險。
- 沙箱預覽:生成的文檔在沙箱
srcdociframe 中預覽,並配置了嚴格的 Content Security Policy,禁止腳本和外部資源。
安裝與升級¶
安裝前請確保已安裝 DSH Home 並配置了 Web Profile。版本 0.4.1 是當前穩定版本。
安裝新插件¶
dsh plugin --profile web add dsh-local-share@0.4.1
從舊版 dsh-share 升級¶
版本 0.2.0 及以後使用了獨立的包名以避免衝突,需要先移除舊的 dsh-share 插件再安裝新版:
dsh plugin --profile web remove dsh-share
dsh plugin --profile web add dsh-local-share@0.4.1
使用方法¶
- 打開 DSH Web 會話,在非空會話的頭部找到 Share 按鈕。
- 選擇需要分享的對話回合(支持單選或多選,也可分享整個 Session)。
- 在彈出的對話框中,默認導出爲 Markdown,並已啓用隱私脫敏。
- 確認預覽無誤後,可複製文本或下載文件。
配置與限制¶
對於高頻率或長對話的場景,建議在配置文件中設置明確的限制,防止瀏覽器卡頓。
配置文件路徑¶
配置文件位於 $DSH_HOME/profiles/web/cordis.patch.yml(即 ~/.dsh/profiles/web/cordis.patch.yml)。
配置示例¶
在 cordis.patch.yml 中添加或修改 dsh-local-share 的配置項:
- id: dsh-local-share
config:
maxEvents: 20000
maxOutputChars: 2000000
maxToolArgumentChars: 12000
| 字段 | 默認值 | 含義 |
|---|---|---|
maxEvents |
20000 |
接受的原始會話事件最大數量 |
maxOutputChars |
2000000 |
輸出文件或預覽的最大字符數 |
maxToolArgumentChars |
12000 |
單個啓用的工具調用保留的最大參數字符數 |
配置後可通過 dsh --profile web --dump-config 驗證生效。
隱私行爲說明¶
默認生成的文檔僅包含直接的人類提示和可見的助手文本。插件提供了詳細的隱私控制策略:
- 默認包含:人類提示、可見助手文本。
- 默認排除:工具結果體、模型推理、系統提示、請求配置、插件注入的上下文、附件字節、會話元數據。
- 可選包含:工具名稱、有界參數、執行結果(需在預覽中開啓“Include tool calls”)。
脫敏規則¶
脫敏是啓發式的,旨在覆蓋常見場景,但並非絕對安全:
* 覆蓋項:常見憑證、Authorization 頭、包含密鑰的環境變量、郵箱地址、絕對本地路徑。
* 安全機制:如果禁用了脫敏,複製和下載功能將鎖定,直到用戶重新確認風險。
注意事項¶
- 開發者預覽:當前版本仍處於開發者預覽階段。
- 插件清理:安裝前建議檢查當前目錄中是否已存在名爲
dsh-share的舊插件,避免功能衝突。 - 本地運行:插件運行在本地瀏覽器環境,生成的長圖同樣不經過服務器,確保了數據安全。