前言¶
DeepSeek Harness 的設計理念是“一切皆插件”，旨在讓開發者通過插件擴展能力。在使用網頁端 chat.deepseek.com 進行開發或調試時，歷史對話往往散落在瀏覽器中，難以複用或整理。如何將這些對話安全地保存到本地，並精準地導入到 DSH 工作區中作爲新的 Agent 會話繼續開發？Convoport 插件解決了這一流程斷層問題，它負責自動捕獲網頁對話、本地化存儲，並提供消息級的導入功能。
插件定位¶
- 名稱：Convoport
- 維護者：MrElysium
- 一句話介紹：捕獲 AI 網頁對話到本地 JSON + SQLite，並將選定消息導入 agent harnesses 作爲可繼續會話。
核心功能¶
- 自動捕獲：通過瀏覽器擴展（MV3）監聽
chat.deepseek.com，利用官方 API 拉取對話並自動同步到插件。 - 本地存儲：數據存儲在
$DSH_HOME/capture/目錄下，以 JSON 格式保存，每條對話一個文件。數據完全本地化，不經過服務器上傳。 - Token 節省統計：提供累計節省 Token 數、對話數、今日捕獲數以及估算的金錢節省（基於參考價格計算）。
- 消息級導入：支持在導入前勾選具體消息，提供快速選擇（如“前 3 條/後 3 條”），導入後將選定內容作爲新 Harness 會話的歷史記錄。
安裝與啓用¶
安裝插件需要兩步：通過 DSH 安裝插件本體，以及手動加載瀏覽器擴展（Chrome 的安全限制要求此步驟）。
- 安裝插件本體：
dsh plugin --profile web add convoport
安裝完成後，重啓 dsh web 並刷新瀏覽器。
- 加載瀏覽器擴展：
擴展文件位於插件的extension/目錄（可在 npm 包的node_modules/convoport/extension/或倉庫根目錄找到）。- 打開 Chrome 擴展管理頁面：
chrome://extensions。 - 開啓右上角的“開發者模式”。
- 點擊“加載已解壓的擴展程序”，選擇
extension/目錄。 - （可選）點擊擴展圖標進入選項，確認後端地址爲
http://127.0.0.1:3080（即 dsh web 的端口）。
- 打開 Chrome 擴展管理頁面：
典型用法¶
啓用擴展後，在 chat.deepseek.com 上的正常對話會自動被捕獲。
- 查看狀態與列表：DSH Web 側邊欄底部會出現一個“⛁ Convoport”按鈕。點擊可查看統計卡片（總 Token、對話數、今日捕獲、預估節省）以及捕獲列表。
- 選擇消息：在捕獲列表中點擊某個對話，進入消息選擇界面。你可以手動勾選需要保留的消息，或使用快速選擇按鈕（如“前 3/後 3/全部/清除”）。
- 創建新會話：在消息選擇界面點擊“Import selected → new session (N)”，插件會在當前工作區創建一個新的 Harness 會話，並將選中的消息作爲該會話的歷史上下文。
- 查看統計：在任意 DSH 會話中輸入
/capture命令，可以快速查看統計概覽。
注意事項¶
- 手動加載限制：由於 Chrome 的安全策略，無法通過命令行直接加載未打包的擴展，必須手動執行“Load unpacked”操作。
- 數據位置：所有捕獲的 JSON 數據均存儲在
$DSH_HOME/capture/目錄中，內容爲純文本，任何開發者均可讀取。 - Token 計數邏輯：插件優先使用 DeepSeek 官方的
accumulated_token_count字段。如果未提供該字段，則回退到啓發式算法（4 字符/Token + 結構開銷）。 - 定價參考：估算的金錢節省基於 $0.02 / 1k tokens 的參考價格計算。
結尾¶
Convoport 專注於將網頁端的對話資產轉化爲 DSH 可直接使用的本地 Session。它不改變核心架構，而是作爲連接器，讓開發者可以自由管理歷史對話，並在本地環境中無縫繼續開發。
