前言¶
DeepSeek Harness(DSH)跑在本機,對話默認留在你的環境裏:沒有官方託管的「分享頁」,也沒有開箱即用的「把整段會話交給同事」入口。常見做法是截圖、手工複製 Markdown,或讓對方也裝同一套環境——前者丟結構,後者成本高。
下面介紹社區插件 dsh-session-forward(維護者 apollodsh,分類:客戶端)。它針對「只帶走看得見的對話文本」這一需求,提供三種產物:局域網分享鏈接、零安裝網頁記錄、以及雙方裝插件時可導入的可續聊會話文件。
這是什麼¶
dsh-session-forward 是 DSH 客戶端插件,當前版本 0.2.1(MIT 許可證)。它不改變 DSH 核心,而是在會話界面增加轉發入口,並在需要時在本機臨時提供分享頁或寫出靜態文件。
運行前提(以 package.json 中 engines.dsh 爲準):DSH >= 0.2.1-rc.2 且 < 0.3.0。DSH 升到 0.3 後可能需要插件另行適配。
核心功能¶
三種方式內容一致,但接收方條件和後續能力不同:
| 產物 | 接收方需要什麼 | 得到什麼 | 適用場景 |
|---|---|---|---|
分享鏈接 http://192.168.x.x:PORT/s/<token> |
無需安裝,瀏覽器打開 | 24 小時有效的排版頁,可粘到微信 / 飛書 | 與對方在同一 Wi-Fi / 局域網 |
網頁記錄 xxx.dshchat.html |
無需安裝,雙擊用瀏覽器 | 自包含對話記錄,可離線、可打印 | 異地或需要存檔 |
會話文件 xxx.dshchat.json |
對方也安裝本插件 | 在 DSH 中還原爲可繼續聊的真實會話 | 雙方都是 DSH 用戶 |
無論哪種方式,只會轉發可見的對話文本。工具調用、工具結果、推理過程、圖片與文件附件、子會話不會隨文件走;摘要裏會說明省略了多少條。分享鏈接不會把內容上傳到第三方服務器,僅在你本機提供;插件設計上不主動聯網上傳會話。
Agent 也可通過工具 session_forward 觸發三種動作:export(寫出 .dshchat.json)、import(導入並新建會話)、share(生成 24 小時有效的局域網鏈接)。
安裝與啓用¶
前提:滿足上述 DSH 版本範圍;從 GitHub 安裝時需要本機有 Git。
方式一:應用內安裝(推薦)¶
- 打開 插件 → 添加插件。
- 輸入下面任一目標並安裝,然後啓用插件;若應用提示重啓,按提示重啓 DSH。
github:apollodsh/dsh-session-forward#v0.2.1
也可填寫已下載的 .tgz 的絕對路徑。固定 #v0.2.1 可避免安裝內容隨 main 分支變化。已有安裝要升級時,先在插件頁卸載舊版本再裝目標版本;同版本已安裝且運行中時無需反覆安裝。v0.2.1 側欄菜單與會話頁頭轉發箭頭均朝上。
方式二:自定義插件市場¶
若 DSH 已開啓 插件 → 實驗性插件 → 自定義插件市場,可在 發現 → 索引源 添加:
https://cdn.jsdelivr.net/gh/apollodsh/dsh-session-forward@main/market/index.json
CDN 較慢時可改用 GitHub 原始地址:
https://raw.githubusercontent.com/apollodsh/dsh-session-forward/main/market/index.json
然後在發現頁搜索「會話轉發」安裝。
方式三:本地目錄(開發調試)¶
維護者在 README 中說明:克隆倉庫後,讓 agent 對絕對路徑執行:
install_bundle target "/絕對路徑/dsh-session-forward"
本地目錄屬於 link: 安裝,改代碼後按應用提示重啓 DSH 即可。
npm 包 dsh-session-forward 尚未發佈;發佈後可用 install_bundle target "dsh-session-forward"(以官方文檔更新爲準)。
典型用法¶
1. 分享鏈接(同局域網最省事)¶
- 點會話標題右側的轉發圖標;或在左側會話列表中對該會話打開「…」→ 轉發(無需切換當前會話)。
- 在「轉發本會話」中選擇 複製分享鏈接(鏈接已在剪貼板,界面也會顯示)。
- 粘到微信 / 飛書等處。對方打開即可閱讀;若要接着聊,可在頁面底部 複製全文(Markdown),粘進自己的 DSH 對話框。
第一次複製鏈接時,插件會在本機臨時起一個 HTTP 服務(隨機端口),僅提供 /s/<token>。token 爲 128 位隨機串,默認 24 小時過期,最多同時保留 50 份;插件卸載或 DSH 退出後服務關閉,鏈接失效。macOS 首次使用可能詢問是否允許傳入連接,允許即可。
2. 網頁記錄(異地或離線)¶
- 「轉發本會話」→ 保存網頁記錄,得到
xxx.dshchat.html。 - 通過郵件、即時通訊等發送文件。
- 對方雙擊在瀏覽器中閱讀;同樣可通過 複製全文(Markdown) 回到 DSH 繼續聊。
網頁完全自包含(內聯樣式與腳本,不引用外部資源),深色 / 淺色跟隨系統,可直接打印。倉庫內提供示例 docs/demo.dshchat.html,下載後雙擊可預覽樣式。
3. 會話文件(雙方裝插件)¶
- 選擇 保存會話文件(.dshchat) 併發送給對方。
- 對方在同一轉發入口選擇 打開別人轉發的會話 → 選文件 → 選目標工作區 → 導入。
導入會新建一條真實會話:標題沿用原會話,消息按 turn / step 寫入日誌,模型能看到這段歷史並可直接追問。導入的會話不含原會話的工作目錄、模型選擇、待辦等;繼續聊時使用本機默認模型,系統提示詞排在轉發歷史之後。
適用場景與注意¶
適合誰:需要在局域網內快速把一段 DSH 對話給同事看、需要給外網對方發離線可讀記錄、或需要在兩名 DSH 用戶之間交接可續聊會話時。
分享鏈接:使用本機局域網地址,僅同一 Wi-Fi / 局域網可打開;明文 HTTP,鏈接在 24 小時內等同憑據,勿發到公開羣。DSH 重啓後內存中的分享頁清空,舊鏈接全部失效,需重新複製。
網頁記錄:靜態閱讀稿,不能在網頁裏繼續聊;適合閱讀、複製、打印。
會話文件:未安裝本插件的 DSH 用戶無法導入;零安裝場景請用鏈接或 .dshchat.html。
體積與格式:單條消息上限 20 萬字符,整份 bundle 上限 24 MiB,超出會截斷或拒絕;比插件版本新的文件導入時會直接拒絕。
安全與權限:插件以當前 DSH 進程權限運行,安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證,確認轉發範圍與省略規則符合你的合規要求。
結尾¶
dsh-session-forward 用三種粒度解決「把本機會話交給別人」:鏈接適合局域網即時分享,網頁記錄適合異地與歸檔,.dshchat 適合兩名 DSH 用戶之間原樣續聊。功能與限制均以倉庫 README 爲準。