前言¶
DeepSeek Harness（DSH）採用插件化架構，允許擴展功能。在開發或使用智能體時，有時需要在官方網頁端進行更復雜的搜索或交互，隨後將討論內容沉澱到工作區中。dsh-chat-bridge 插件提供了這樣一個連接層，它不修改官方桌面端源碼，而是通過內嵌官方網頁和特定的接口，實現從聊天記錄到工作會話的導入。
插件定位¶
這是一個客戶端插件，用於在 DSH 內部集成官方網頁版聊天功能。項目由 FrostLeafKEE 維護，採用 MIT 許可證。它解決了“網頁討論”與“工作區管理”之間的割裂問題，提供了一鍵轉換和歷史上下文複用的能力。
核心功能¶
該插件提供以下能力：
* 聊天 / 工作切換：在主界面頂部切換，進入聊天區後可隨時返回原工作會話。
* 內嵌官方網頁：在 DSH 內部加載 DeepSeek 官方網頁，支持登錄和對話。
* 網頁歷史側欄：顯示已加載的網頁會話列表，支持搜索、刷新和加載更多。
* 一鍵轉工作：將選定的網頁會話導入工作區，支持預覽和快捷模式。
* 原生歷史上下文：導入時保留問答內容及來源，輸入框默認爲空，可直接下達下一條任務。
* 獨立聊天檔案：本地保存聊天檔案，支持搜索、重命名、導出和刪除。
* 手動導入：支持 UTF-8 的 .txt、.md 文件，以及插件自身的歷史 JSON 和檔案 JSON。
安裝與啓用¶
該插件適用於官方 DeepSeek Harness Desktop 0.2.0-rc.2。
在 Windows 的 PowerShell 中，使用以下命令安裝：
$dsh = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'
$package = Join-Path $env:USERPROFILE 'Downloads\dsh-chat-bridge-1.0.1.tgz'
& $dsh plugin --profile desktop add $package
安裝後需重啓 DSH。卸載時同樣使用 CLI 命令，或在 macOS 解壓目錄執行移除腳本。
使用流程¶
- 在新會話上方選擇「聊天區」，或點擊側欄下方的「聊天區」。
- 在內嵌的官方網頁完成登錄。展開網頁側欄，DSH 側欄的「網頁會話」會自動顯示已加載列表。點擊列表項即可打開對應會話，或使用「從網頁加載更多」。
- 點擊「轉爲工作」。此時會彈出預覽，需要選擇目標工作區，並確認採集範圍及上下文提示。
- 確認後，插件保存來源並創建帶歷史上下文的工作會話。此時輸入框爲空，可直接提出下一條工作任務。
- 勾選「記住目標」並開啓「一鍵轉換」後，下次點擊「一鍵轉工作」即可自動完成導入流程。
限制與注意事項¶
插件在運行機制和數據處理上有以下限制：
- 側欄刷新與計數：網頁側欄每 3 秒刷新一次，讀取已加載標題和鏈接。計數僅統計已加載條目。摺疊分組或未加載的記錄可能缺失。列表僅在本次運行期間保留。
- 高度限制：v1.0.1 版本對側欄高度進行了限制。聊天記錄區默認佔窗口高度的 30%，網頁列表佔 15%，已導入歷史佔 12%。超出後內部滾動。
- 數據採集範圍：目前採集當前已渲染分支，標記爲
partial。長對話中尚未渲染的消息、其他分支及附件原文不會自動補全。網頁採集限定已覈對的前端版本。 - 環境衝突：若網頁升級、處於生成中狀態、有未發送草稿或內容發生變化，轉換操作會停止並提示處理。
- 登錄狀態：首次登錄需在官方頁面完成。登錄狀態僅在本次應用運行期間儘量複用，重啓後可能需要重新登錄。插件不讀取或複製登錄憑據，聊天頁面使用隔離載體。
- 安全與隱私：選擇並導入工作會話後，纔會使用目標工作區的正常能力。本地檔案未加密。
- 導入限制：插件不估算模型上下文容量、不自動縮短正文。超長曆史和敏感內容需在轉換前核對。當前輸入限額爲普通文本 5 MiB、完整檔案文件 64 MiB、結構化消息 5000 條，超限會拒絕，不靜默截斷。
- 待實機確認：小窗口、鍵盤焦點和 macOS 佈局的兼容性仍需實機確認。
